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.

Before you begin

You must upgrade from a supported version of i2 Analyze. See Upgrade paths for the current minimum supported version.

Complete the instructions in Upgrading 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.

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.

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.

Procedure

Upgrade and copy the i2 Analyze configuration.
1. Upgrade the i2 Analyze configuration:
```
setup -t upgradeConfiguration
```
2. Provided that all servers have the same configuration, copy the upgraded toolkit\configuration 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.
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.
Start the ZooKeeper component of i2 Analyze.
On each ZooKeeper server, start the ZooKeeper hosts:
```
setup -t startZkHosts --hostname zookeeper.hostname
```
Upload the Solr configuration to ZooKeeper.
On the Liberty server, run:
```
setup -t createAndUploadSolrConfig --hostname liberty.hostname
```
Start the Solr component of i2 Analyze.
On each Solr server, start Solr:
```
setup -t startSolrNodes --hostname solr.hostname
```
Upgrade the Solr collections, and upgrade and start Liberty.
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.