Upgrading i2 Explore for iBase

You can upgrade to a new version of i2 Explore for iBase using an Installation Manager.

If you're installing i2 Explore for iBase for the first time, refer to Installing i2 Explore for iBase instead.

Before you begin

Verify that the prerequisites from your previous installation are still valid by reviewing the Before you begin section of Installing i2 Explore for iBase, then return to this document.

Before the installation

NOTE: All the commands below should be run from a terminal in the analyze-deployment-tooling directory of your installation folder.

To upgrade an existing deployment of i2 Explore for iBase to a new version, follow these steps:

  1. Create a local backup of your existing Configurations directory, ensuring it is stored outside the installation directory:

    • <installation_location>/explore-for-ibase/analyze-deployment-tooling/configs

  2. Create a local backup of your existing Environment Secrets directory, again ensuring it is stored outside the installation directory:

    • <installation_location>/explore-for-ibase/analyze-deployment-tooling/environment-secrets

  3. Stop the i2 Explore services, running the command line:

    • setup -t stop

  4. Uninstall the existing version of i2 Explore for iBase.

  5. When the uninstallation wizard has completed, manually remove any remaining files from the installation folder:

    • <installation_location>/

Installation

Follow the installation steps in the Installation section of Installing i2 Explore for iBase.

NOTE: You do not need to provide any certificates when running through the installer steps, as they will be copied from your existing environment secrets as part of the upgrade process.

After the installation

In order to complete the upgrade process, follow these steps:

  1. Create a new upgrade folder under this directory:

    • <installation_location>/explore-for-ibase

  2. Copy the backed-up Configurations directory and Environment Secrets into the newly created upgrade folder, obtaining the following structure:

    • <installation_location>/explore-for-ibase/upgrade/configs

    • <installation_location>/explore-for-ibase/upgrade/environment-secrets

Deploying the upgraded i2 Explore for iBase application takes the same steps as a new deployment, but using the -t upgrade task. Follow Starting the application to deploy the i2 Explore for iBase application, ensuring you execute the -t upgrade task instead of -t deploy.

NOTE: You do not need to create the ISTORE database again, so disregard the Manually creating the ISTORE database section in Starting the application if you have already supplied an admin user.