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.


  1. Open a command prompt on the server, and navigate to the toolkit\scripts directory of the i2 Analyze toolkit.

  2. 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.

    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.

  3. If you see the following message, type '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 type '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.

  4. To complete this part of the upgrade and start the application, run the following command:

    setup -t start

What to do next

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