Upgrading to i2 Analyze 4.3.1 offline

When you upgrade to i2 Analyze 4.3.1, the Solr index is recreated. In the offline reindex, your system is unavailable to analysts while the index is recreated.

Before you begin

  • If you are upgrading a deployment of i2 Analyze that uses SQL Server for the Information Store database, you must install a later version of the ODBC Driver for SQL Server and sqlcmd utility. For more information, see Software prerequisites.
  • Ensure that you back up your deployment before you complete an upgrade. For more information about backing up your deployment, see Backing up a deployment.

About this task

Depending on the scale and complexity of your data, changes of this nature can take time. You might want to plan your upgrade to take place in a period where there is usually no activity, and backup your system before proceeding.

Procedure

To upgrade the deployment toolkit to version 4.3.1:

  1. Stop i2 Analyze:
  2. On each server where the deployment toolkit is installed, make a backup of the directory where i2 Analyze is installed. For example, IBM\i2analyze.
  3. Install the i2® Analyze deployment toolkit over your existing deployment toolkit on each server where it is installed.
    1. Remove the toolkit, license, and swidtag directories from your existing installations.
    2. Install i2 Analyze version 4.3.1. For more information, see Installing i2 Analyze.
  4. In each deployment toolkit in your deployment, copy the configuration directory that you backed up in step 2 to the i2analyze\toolkit directory of the upgraded deployment toolkit that you installed in step 3.
  5. If not already present, create and populate the credentials.properties file. This file must be stored in the following location: toolkit\configuration\environment in each deployment toolkit.
    For more information about the file, see The credentials.properties file.
  6. If you are using SQL Server for the Information Store database, update the JDBC driver for the deployment in your configuration.
    For more information about which driver to install, see Specifying the JDBC driver.
  7. Update the db.installation.dir setting in the environment.properties file to reference the directory where you installed the later version of the ODBC Driver for SQL Server and the sqlcmd utility.
    For example, db.installation.dir=C:/Program Files/Microsoft SQL Server/Client SDK/ODBC/170

To upgrade the deployment to version 4.3.1:

  1. Upgrade and start i2 Analyze:
  2. If you are using the IBM HTTP Server, restart it.

What to do next

If your deployment includes the ETL toolkit, you must upgrade the ETL toolkit to version 4.3.1 after you upgrade the rest of the deployment. For more information, see Upgrading the ETL toolkit.

After you upgrade, you might need to update the configuration of your deployment for any new configuration settings. For more information about any new configuration settings, see Configuration and database changes.

When you start the server after you upgrade, extra processing of the data in the Information Store is completed after the upgrade. During this processing, you might not be able to ingest, update, and delete data in the Information Store. For more information, see Information Store processing after you upgrade i2 Analyze.


© Copyright IBM Corporation 2012, 2020.