v5.4.0.3

Date of Release: April 2023

Resolved Issues

Upgrade

Prerequisites

$inline[badge,NOTE,primary] Before going through the below mentioned prerequisites for this section, ensure that all the Prerequisites for Installing Infoworks on AKS are validated.

• Ensure the current deployment’s chart is present in /opt/infoworks.
• Python 3.8 or later version with the pip module is installed in the Bastion VM.
• Stable internet connectivity on the Bastion VM to download the required python packages from the python repository during installation/upgrades.
• Validate that the version of the old chart is 5.4.0.

Upgrade Instructions

To upgrade Infoworks on Kubernetes:

Before selecting the type of upgrade execute the following commands.

Step 1: Create the required directories and change the path to that directory.

Internet-free Upgrade

$inline[badge,NOTE,primary] If you are upgrading via Internet-based procedure, skip to the next section.

Step 1: Download the upgrade tar files shared by the Infoworks team to the Bastion (Jump host) VM and place it under $IW_HOME/downloads.

Step 2: To configure Internet-free upgrade, execute the following command:

Internet-based Upgrade

Step 1: Download the Update script tar file.

Common Steps for Both Internet-free and Internet-based

$inline[badge,NOTE,primary] Once you have selected the type of upgrade, the below mentioned steps are common for both Internet-free and Internet-based.

Step 1: Extract the iwx_updater _k8s_5.4.0.3 tar.gz under $IW_HOME/downloads.

This should create two new files as follows - update-k8s.sh and configure.sh.

Step 2: Run the script.

$inline[badge,NOTE,primary] At the end of the above command's execution, if you want to run helm upgrade manually, then type N and press Enter. There is a 30-second timeout set to abandon the deployment of the upgraded version. If no input is received within the timeout duration, the deployment is triggered.

Step 3 (Applicable only for Databricks Persistent Clusters): A change in the Infoworks jar requires libraries being uninstalled and cluster restart. Without this step, there will be stale jars. Perform the following steps:

(i) Go to the Databricks workspace, navigate to the Compute page, and select the cluster that has stale jars.

(ii) In the Libraries tab, select all the Infoworks jars and click Uninstall.

(iii) From Infoworks UI or Databricks dashboard, select Restart Cluster.

Rollback

Prerequisites

• Before executing the rollback script, ensure that IW_HOME variable is set.
• Assuming Infoworks home directory is /opt/infoworks, run the below command to set the IW_HOME variable.
• Validate that the version of the old chart is 5.4.0.3

• Ensure the current deployment’s chart is present in /opt/infoworks.
• Execute the below command to check the appVersion.

Rollback Instructions

$inline[badge,NOTE,primary] Since IW_HOME has been exported in the Prerequisites section mentioned above, the following steps can be executed from any location for users with read/write access to the aforementioned IW_HOME.

Step 1: Download the rollback script.

Step 2: Place the Update script in the same directory as that of the existing iw-k8s-installer.

Step 3: Ensure you have permission to the $IW_HOME directory.

Step 4: Give executable permission to the rollback script using the below command.

Step 5: Run the script.

Step 6: You will receive the following prompt, "Enter N to skip running the above command to upgrade the helm deployment. (timeout: 30 seconds): ", type Y and press Enter.

$inline[badge,NOTE,primary] If you want to run helm upgrade manually, then type N and press Enter.

$inline[badge,NOTE,primary] There is a 30-second timeout set to abandon the deployment of the downgraded version. If no input is received within the timeout duration, the deployment is triggered.