Upgrade Incorta Analytics 4.x to 4.1
Incorta Analytics released version 4.1 in early December, 2018, including new features and bug fixes. For more details, see Incorta Analytics 4.1 release notes.
This article describes the steps required to upgrade Incorta Analytics from version 4.x to version 4.1. For information on how to upgrade from Incorta Release 4.x to Incorta Release 4.3, we will be releasing another doc and will link it here when ready.
Upgrading Incorta Analytics from 4.0 to 4.1 is similar to the usual upgrade process for the versions prior to 4.0. Simply run the installer (as described in the steps below) and select the "Upgrade" option, when asked to choose between "Install" and "Upgrade".
Since Incorta Analytics 4.x separated the analytics from the loader services, the upgrade process must be executed on each node (i.e. server) where Incorta is installed. If you are upgrading a cluster, then it is highly recommended to upgrade the Center Management Console (CMC) for that cluster, then you must upgrade each node separately.
The following steps provide step-by-step instructions for the upgrade process:
Step 1: Export tenants from a 4.0 environment, using the TMT utility
It is recommended that you back up the tenant(s) from the 4.0 environment as a precaution. To back up a tenant:
Connect via SSH to your 4.0 environment.
Go to the "TMT" directory in the 4.0 environment, in the following path:
Export the tenant definition, by running the following command:
./tmt.sh -clnm <CLUSTER_NAME> -ex <TENANT_NAME> <DESTINATION_SHARED_FOLDER.zip>
Step 2: Stop all the analytics and loader services
Before proceeding, ensure that all the analytics and loader services are stopped within the cluster you are upgrading. To stop all cluster services from the CMC UI:
Admins may navigate to the following URL:
Click on the "Clusters" tab on the left-hand side.
Click on a cluster to upgrade.
Navigate to the "Details" tab, then click Stop. Ensure that the "Analytics" and "Loader" services indicate "Stopped".
Step 3: Stop the Central Management Console (CMC) and nodeAgent
- It is important that you stop the CMC prior to upgrading, by running the following commands:
- Now, stop the "node agent" for each node where Incorta Analytics is installed. The node agent is used by the CMC to communicate with all the nodes (i.e. servers) within a cluster. Before upgrading, stop the node agent by running the following commands:
Step 3: Kill Tomcat, Zookeeper, NodeAgent, Derby, and PhantomJS (Recommended)
It is recommended that you ensure that the following Incorta services are stopped:
by running the following commands, respectively:
ps -ef | grep tomcat ps -ef | grep nodeAgent ps -ef | grep zookeeper ps -ef | grep phantomJS ps -ef | grep derby
If any of the services are still not stopped, kill the process by running the following command:
kill -9 <pid>
Step 3: Run the Incorta Analytics version 4.1 installer
In this step, you will be instructed to run the Incorta Analytics installer for version 4.1 and choose "Upgrade" during the installation.
Locate and unzip the "incorta-package.zip" file, found in the unzipped "incorta-package" folder, to start the installation wizard.
Start the installation process on each of the nodes where you want to upgrade the CMC or Incorta Analytics node.
Incorta Analytics offers two installation modes:
GUI mode - Open the “incorta-installer.jar” file or type the following command, the installation wizard open:
Console mode (CLI) - Type the following command to start the installation wizard:
java -jar incorta-installer.jar -i console
Accept the product License Agreement, then click Next or hit Enter.
Choose "Upgrade", then click Next or hit Enter.
If you are upgrading a "Typical" installation instance, the upgrader will automatically upgrade the CMC and the IncortaNode. In this case, no further actions are required.
If you are upgrading a cluster, select "Custom" when prompted to choose an option in the "Installation Set" step.
Select whether you want to upgrade the CMC or an Incorta node (i.e. HA node).
Provide the same installation path for 4.1 as the one used for 4.0.
Follow the installation wizard.
Repeat steps 3 through 10 for each node where Incorta Analytics is installed.
Then select the option 1 to start the cmc and exit
Go to the cmc url http://<server>:6060/cmc/
Start the cluster