Installing prerequisite software

All deployments of i2 Analyze require a Java runtime, the Open Liberty application server, the Apache Solr search server, and the Apache ZooKeeper process coordinator. If you need to, you can replace the supplied version of a prerequisite by installing another supported version of the software.

Note: For more information about the system requirements and prerequisites for i2 Analyze, see the release notes.

You can find the supplied versions of all the prerequisite software in the toolkit/bin directory of the i2 Analyze distribution. The wlp, solr, and zookeeper directories each contain a single archive file, while the java directory has subdirectories for linux and windows distributions.

To replace any of the prerequisites before you deploy i2 Analyze, you can substitute a new archive for the supplied one. To replace one after deployment, follow the instructions in the sections below.

Java

By default, i2 Analyze uses the Eclipse Temurin JDK 17, versions of which are available for download from the Adoptium website.

To use a different distribution of Java 17, see Specifying the Java distribution. Alternatively, to use a different version of the Temurin JDK:

  1. Download a supported version of the JDK from Adoptium.

  2. Stop the application server and all Solr nodes.

  3. Replace the archive file in the toolkit/bin/java/linux or toolkit/bin/java/windows directory with the downloaded archive.

  4. Run setup -t installJava on all servers.

  5. Start the application server and all Solr nodes.

Liberty

i2 Analyze uses an Open Liberty runtime package, versions of which are available for download from the Maven repository website.

To use a different version of Open Liberty:

  1. Download a supported version of Open Liberty from Maven.

  2. Stop the application server and all Solr nodes.

  3. Replace the archive file in the toolkit/bin/wlp directory with the downloaded archive.

  4. Run setup -t installLiberty on all servers.

  5. Start the application server and all Solr nodes.

Solr

i2 Analyze uses the "slim" distribution of the Apache Solr search server. You can download the latest version from the main download page, or earlier versions from Apache's archive.

To use a different version of Apache Solr:

  1. Download a supported version of the Apache Solr distribution.

  2. Stop the application server and all Solr nodes.

  3. Replace the archive file in the toolkit/bin/solr directory with the downloaded archive.

  4. Run setup -t installSolr on all servers.

  5. Start the application server and all Solr nodes.

ZooKeeper

Any new version of Apache ZooKeeper that you use with i2 Analyze must be compatible with your version of Apache Solr, and supported by your version of i2 Analyze. Downloads are available from the Apache ZooKeeper website.

To use a different version of Apache ZooKeeper:

  1. Download a supported version of the Apache ZooKeeper distribution.

  2. Stop the application server and all Solr nodes.

  3. Replace the archive file in the toolkit/bin/zookeeper directory with the downloaded archive.

  4. Run setup -t installZookeeper on all servers.

  5. Start the application server and all Solr nodes.