Upgrading an i2 Analyze deployment

You can use an upgraded i2 Analyze deployment toolkit to upgrade an existing deployment of i2 Analyze. The new features in later versions are available only after the deployment is upgraded successfully.

Before you begin

Complete the instructions in Upgrading i2 Analyze to install the latest version of the deployment toolkit and prepare the environment before you upgrade the deployment.

Note: If your deployment of i2 Analyze uses multiple servers, follow the instructions in Upgrading an i2 Analyze deployment on multiple servers, rather than the procedure in this topic.

Procedure

Open a command prompt on the server, and navigate to the toolkit\scripts directory of the i2 Analyze toolkit.
To upgrade the deployment, run the following command:
```
setup -t upgrade
```
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.
To recreate the Solr collections, run the following command.
Warning: If you run this command, all the data in the database will be reindexed when you start i2 Analyze. While the data is being reindexed, the system is offline. In systems where there is a lot of data, the process can take some time. To reschedule the downtime, skip this step for now, and do not run the following command. You can reindex your data at another time by following the instructions in Reindexing data after a major version Solr upgrade.
```
setup -t upgradeAllSolrIndexes
```
When you run this task, you are warned about removing data from the existing indexes. You can continue by pressing Y and Enter. If a standby index has been created for a collection type, it will be used to reindex the data without modifying the live index.
To complete this part of the upgrade and start the application, run the following command:
```
setup -t start
```
If you are using a deployment with an Information Store and have configured system match rules, run the following command to instruct the system to use the upgraded match index:
```
setup -t switchStandbyMatchIndexToLive
```

What to do next

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