Upgrading i2 Analyze 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.

Before you begin

Complete the instructions in Upgrading to i2 Analyze version 4.3.1 to install the later version of the deployment toolkit on the Liberty, Solr, and ZooKeeper servers, and prepare the environment before you upgrade the deployment.

About this task

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. It is important to note which server you must run the command on, and whether you need to specify the hostname of that server.

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

Procedure

Upgrade and copy the i2 Analyze configuration.

  1. Upgrade the i2 Analyze configuration:
    setup -t upgradeConfiguration
    If the contents of the configuration directory is different on each server, run this command on each server and do not copy the upgraded configuration.
  2. 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 --hostname liberty.hostname
    Where liberty.hostname is the hostname of the Liberty server where you are running the command, and matches the value for the host-name attribute of the <application> element in the topology.xml file.

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

What to do next

After you upgrade and start i2 Analyze, return to perform the rest of the instructions to finish upgrading the system.

© Copyright IBM Corporation 2012, 2020.