Upgrading an i2 Analyze deployment on multiple servers

To upgrade i2 Analyze in a multiple-server deployment topology, you must run the commands to upgrade and start the components of i2 Analyze on each server.

Complete the instructions in Upgrading to version 4.3.4 of i2 Analyze to install the latest version of the deployment toolkit on the Liberty, Solr, and ZooKeeper servers, and prepare the environment before you upgrade the deployment.
To upgrade i2 Analyze in a multiple server deployment topology, you must provide an upgraded configuration to each deployment toolkit. Then, you can run the commands to upgrade the components of i2 Analyze on each server.

As you follow the procedure, it is important to keep track of which server each command runs on, and whether you need to specify the hostname of that server to the command.

Run all toolkit commands from the toolkit\scripts directory in the deployment toolkit on the specified server in your environment.

Upgrade and copy the i2 Analyze configuration.

  1. Upgrade the i2 Analyze configuration:
    setup -t upgradeConfiguration
    If the contents of the configuration directory are different on each server in the deployment, run this command on every server instead of copying the upgraded configuration as Step 3 describes.
  2. If you see the following message, you can enter 'y' to enable the Chart Store with its default settings as part of the upgrade process:
    The "Analyst's Notebook Chart" item type is added to the i2 Analyze schema.
    The version of the i2 Analyze schema is incremented to: "2"
    The schema found in: C:\IBM\i2analyze\toolkit\configuration\fragments\common\WEB-INF\classes\
    does not have a chart item type. Would you like the toolkit to add it to your schema? (y/n)

    Alternatively, if you enter 'n', the upgrade process exits without enabling the Chart Store. Instead of accepting the default settings, you can open the Information Store schema in Schema Designer to add the "Analyst's Notebook Chart" item type. You can then customize the item type by adding property types before you complete the upgrade.

  3. Provided that all servers have the same configuration, copy the upgraded toolkit\configuration directory to the toolkit directory on each Solr and ZooKeeper server in your environment. Accept any file overwrites.

Upgrade the ZooKeeper and Solr components of i2 Analyze.

  1. On each ZooKeeper server, run the following command:
    setup -t upgradeZookeeper --hostname zookeeper.hostname
    Where zookeeper.hostname is the hostname of the ZooKeeper server where you are running the command, and matches the value for the host-name attribute of a <zkhost> element in the topology.xml file.
  2. On each Solr server, run the following command:
    setup -t upgradeSolr --hostname solr.hostname
    Where solr.hostname is the hostname of the Solr server where you are running the command, and matches the value for the host-name attribute of a <solr-node> element in the topology.xml file.

Upgrade the Information Store database.

  1. On the Liberty server, run the following command:
    setup -t upgradeDatabases
    If the create-databases attribute in the topology.xml file is set to false, you must run the scripts to update the database manually. The scripts are created in the toolkit\scripts\database\db2\InfoStore\generated\upgrade directory. Run the scripts in ascending alphanumeric order. The user that you run the scripts as must have permission to drop and create database tables and views.

    If you are using IBM Db2 v10.5, you must also run the following script to set the temporary tablespace size to 32K: toolkit\scripts\database\db2\InfoStore\create-ts-for-10-5.db2.

Start the ZooKeeper component of i2 Analyze.

  1. On each ZooKeeper server, start the ZooKeeper hosts:
    setup -t startZkHosts --hostname zookeeper.hostname

Upload the Solr configuration to ZooKeeper.

  1. On the Liberty server, run:
    setup -t createAndUploadSolrConfig --hostname liberty.hostname

Start the Solr component of i2 Analyze.

  1. On each Solr server, start Solr:
    setup -t startSolrNodes --hostname solr.hostname

Upgrade the Solr collections, and upgrade and start Liberty.

  1. On the Liberty server, run the following commands:
    setup -t upgradeSolrCollections --hostname liberty.hostname
    setup -t upgradeLiberty
    setup -t startLiberty
After you upgrade and start i2 Analyze, return to perform the rest of the instructions to finish upgrading the system.