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 upgrade the Solr indexes, run the following command.
```
setup -t upgradeAllSolrIndexes
```
The command first checks whether any indexes require an upgrade. If they do, you are prompted to confirm whether to proceed: the upgrade re-creates the index, which triggers a full reindex of the main, chart, and match index types, while other index types are wiped.
When the data is being reindexed, the system is offline. In systems where there is a lot of data, this can take some time. You can continue by pressing Y and Enter or, to reschedule the downtime, quit the command and skip this step for now. You can reindex your data at another time by following the instructions in Reindexing data after a major version Solr upgrade.
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.