Upgrade Procedure

NOTE: Before you upgrade, read the Release Notes for the updates in the version.

Prerequisites

• Ensure that the Mongo DB is up and running.
• If Mongo HA is enabled, ensure that the Mongo DB is in primary or secondary state on all nodes. If the Mongo HA node is in unrecoverable state, perform the procedure mentioned in Resync Member of Replica Set.
• Cleanup the logs that are not required, using the following script. You can create a cron job to schedule this in your Infoworks environment.
• If Infoworks is configured with SSL-enabled LDAP Auth, ensure to add the LDAP server certificate to the Java Keystore on the edge node before performing the upgrade.

Upgrade Procedures

The upgrade logs will be available in <path_to_Infoworks_home>/platform/iw-installer-metadata/logs/upgrade.log.

CentOS/RHEL6

NOTE: Before starting the upgrade, ensure that MongoDB is running and no Infoworks jobs are running.

To upgrade the Infoworks DF version, execute the following commands on the edge node:

• Run the following command: source $IW_HOME/bin/env.sh
• Navigate to the scripts directory using the following command: cd $IW_HOME/scripts; where, $IW_HOME is the directory where the Infoworks DF is installed. If scripts folder is not available (2.4.x, 2.5.x, 2.6.x base versions), create scripts folder in $IW_HOME.
• Download the update script using the following command: wget <link-to-download>; reach out to your Infoworks support representative to get the link to download and replace with the link.
• Upgrade the Infoworks DF version using the following commands: ./update.sh -v 2.7.2

If the base version is below version 2.7.2, the upgrade procedure upgrades Metadata DB (Mongo) from 3.6 to 4.0 version. The upgrade of metadata DB includes the following:

• updates the metadata DB binaries
• sets up feature compatibility version

CentOS/RHEL7

NOTE: Before starting the upgrade, ensure that MongoDB is running and no Infoworks jobs are running.

To upgrade the Infoworks DF version, execute the following commands on the edge node:

• Run the following command: source $IW_HOME/bin/env.sh
• Navigate to the scripts directory using the following command: cd $IW_HOME/scripts; where, $IW_HOME is the directory where the Infoworks DF is installed. If scripts folder is not available (2.4.x, 2.5.x, 2.6.x base versions), create scripts folder in $IW_HOME.
• Download the update script using the following command: wget <link-to-download>; reach out to your Infoworks support representative to get the link to download and replace with the link.
• Upgrade the Infoworks DF version using the following commands: ./update.sh -v 2.7.2-rhel7

If the base version is below version 2.7.2, the upgrade procedure upgrades Metadata DB (Mongo) from 3.6 to 4.0 version. The upgrade of metadata DB includes the following:

• updates the metadata DB binaries
• sets up feature compatibility version

AZURE

NOTE: Before starting the upgrade, ensure that MongoDB is running and no Infoworks jobs are running.

To upgrade the Infoworks DF version, execute the following commands on the edge node:

• Run the following command: source $IW_HOME/bin/env.sh
• Navigate to the scripts directory using the following command: cd $IW_HOME/scripts; where, $IW_HOME is the directory where the Infoworks DF is installed. If scripts folder is not available (2.4.x, 2.5.x, 2.6.x base versions), create scripts folder in $IW_HOME.
• Download the update script using the following command: wget <link-to-download>; reach out to your Infoworks support representative to get the link to download and replace with the link.
• Upgrade the Infoworks DF version using the following commands: ./update.sh -v 2.7.2-azure

If the base version is below version 2.7.2, the upgrade procedure upgrades Metadata DB (Mongo) from 3.6 to 4.0 version. The upgrade of metadata DB includes the following:

• updates the metadata DB binaries
• sets up feature compatibility version

GCP

NOTE: Before starting the upgrade, ensure that MongoDB is running and no Infoworks jobs are running.

To upgrade the Infoworks DF version, execute the following commands on the edge node:

• Run the following command: source $IW_HOME/bin/env.sh
• Download the update script using the following command: wget <link-to-download>; reach out to your Infoworks support representative to get the link to download and replace with the link.
• Upgrade the Infoworks DF version using the following commands: ./update.sh 2.7.2-gcp

If the base version is below version 2.7.2, the upgrade procedure upgrades Metadata DB (Mongo) from 3.6 to 4.0 version. The upgrade of metadata DB includes the following:

• updates the metadata DB binaries
• sets up feature compatibility version

EMR

NOTE: Before starting the upgrade, ensure that MongoDB is running and no Infoworks jobs are running.

To upgrade the Infoworks DF version, execute the following commands on the edge node:

• Run the following command: source $IW_HOME/bin/env.sh
• Navigate to the scripts directory using the following command: cd $IW_HOME/scripts; where, $IW_HOME is the directory where the Infoworks DF is installed. If scripts folder is not available (2.4.x, 2.5.x, 2.6.x base versions), create scripts folder in $IW_HOME.
• Download the update script using the following command: wget <link-to-download>; reach out to your Infoworks support representative to get the link to download and replace with the link.
• Upgrade the Infoworks DF version using the following commands: ./update.sh -v 2.7.2-emr

If the base version is below version 2.7.2, the upgrade procedure upgrades Metadata DB (Mongo) from 3.6 to 4.0 version. The upgrade of metadata DB includes the following:

• updates the metadata DB binaries
• sets up feature compatibility version

Upgrade Considerations

• If metadata backup is not successful, the upgrade will be discontinued.
• If jobs are run during upgrade, the upgrade will be discontinued.
• If any step fails during upgrade, the Infoworks upgrade process will automatically rollback to the base version, without any inconsistency.
• The HDFS temp directory cache will be cleared after the upgrade.

NOTE: Rollback is automatically handled during the upgrade process.

Post Upgrade

After upgrading the Infoworks services, perform the following post-upgrade tasks:

• Verify if all the Infoworks services are running
• Obtain the Infoworks license key from Infoworks support (for upgrade from versions below 2.5.0)

Verifying Infoworks Services

Perform the following:

• Trigger a simple Ingestion, Data Transformation and Workflow job.
• Verify that the jobs are running correctly.

Obtaining Infoworks License Key

An admin can perform the following License Management operations from the Infoworks DF:

• Add license keys
• Update license keys
• View features added to the product

Adding License Key

To add a new license key follow the below steps:

• Login to the Infoworks DF.
• Navigate to Admin > License Manager. The Infoworks License page is displayed which includes the following sections:

Summary: Summary of the Infoworks License

• License Violation: The list of license compliance anomalies. For details see the License Violations section below.
• Installation Id: Unique installation ID for each server
• License Type: Type of license like dl_basic, dl_enterprise, etc.
• License Starts: Timestamp when the license was activated.
• License Ends: Timestamp when the license expires.

Features - Details of features added to the product

• License Feature: list of features.
• Value: value assigned to each feature. The features that are activated using the license key are displayed as Yes.

Install Your New Infoworks License: text box to paste the license key.

• Copy the Installation ID and mail it to Infoworks. The license key will be sent to you via mail.
• Copy the license key and paste in the Install Your New Infoworks License text box.
• Click Install New License. The license will be installed.

To update the license key, follow the same procedure. Adding a new license key will replace the existing license.

License Violations

Following is the list of license violations:

• Server not having a license.
• License being expired or not started.
• Registered users not being licensed.
• Usage of unlicensed source types.
• Usage of unlicensed feature (Data Transformation, Cube, etc).

License Warning Messages

The license compliance anomalies are displayed in the License Management page and warnings are displayed in the respective source, pipeline, workflow and cube pages.

• All the license violations are displayed in the License Management page.
• When you use an unlicensed source type, a warning is displayed for the particular Source Type in the Manage Source page.
• When you edit a pipeline without the required license, a warning is displayed in the pipeline editor page.
• When you edit a workflow without the required license, a warning is displayed in the workflow editor page.
• When you edit a cube without the required license, a warning is displayed in the cube editor page.