Preparing for an AAI Upgrade

As an administrator, there is a series of preparatory steps and considerations you must make before upgrading your system. They are covered in this topic.

This page includes the following:

Important Considerations for Upgrades to v24.2.x and v24.3.x

If you have configured TLS authentication for the Webswing server, which provides the AAI Configuration Tool on your web browser, then:

  • If you have your keystore and truststore files in the <AAI_installation>/config directory, move them to the <AAI_installation>/config/ssl directory.

  • If you have the authentication files outside the <AAI_installation> directory and have previously configured TLS with this location, you can leave them where they are.

Reason: Authentication files in the <AAI_installation>/config directory might be inadvertently deleted during this or a future AAI upgrade.

Disk Space Requirements for Upgrading

It is recommended to have free disk space at least three times the size of the AAI installation hierarchy available.

Considerations for Upgrading from 24.3 to v24.4

The AAI upgrade package contains schema updates that include the addition of a new index on the JobRun table (XIE14JobRun). This can take some additional time to apply as well as require enough space in the index tablespace/files. You might want to consult with your DBA before upgrading.

Backups Before Upgrading

Before applying the upgrade, it is recommended to make a full backup of the AAI installation directory. It is also recommended making a full backup of the AAI database.

Java Requirements for Upgrades

The AAI upgrade requires Java Development Kit (JDK) 1.17 in order to function properly. If you do not have this in place, an error is displayed when you execute the upgrade script.

To verify the Java version, run the following from the Command Prompt:

  • Windows 

    C:\Automation_Analytics_Intelligence> java -version
java version "17.0.13" 2024-10-15 LTS
Java(TM) SE Runtime Environment (build 17.0.13+10-LTS-268)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.13+10-LTS-268, mixed mode, sharing)

  • UNIX 

    /opt/automic/Automation_Analytics_Intelligence] java -version
java version "17.0.13" 2024-10-15 LTS
Java(TM) SE Runtime Environment (build 17.0.13+10-LTS-268)
Java HotSpot(TM) 64-Bit Server VM (build 17.0.13+10-LTS-268, mixed mode, sharing)
JAVA_HOME variable

To run the upgrade, make sure the JAVA_HOME environment variable points to the JDK 17 installed. This means you have to make sure you set the JAVA:HOME to the directory where JDK 17 is installed. Otherwise, when you execute the upgrade script, you get the message "Automation Analytics & Intelligence upgrade cannot run, because JAVA_HOME is not set.".

Linux Requirements for Upgrades

When you run AAI in Linux, make sure that you have the xvfb (X virtual framebuffer) server installed on your Linux server. This is required by the Webswing server that the AAI Configuration Tool runs on. If this is not installed, the upgrade stops and an error message is issued.

Note:

The message also contains the following remediation steps:

  1. Run the appropriate command:

    • On Redhat/derivatives: yum install xorg-x11-server-Xvfb

    • On Ubuntu/derivatives: apt-get install xvfb

  2. Re-run the upgrader.

Downloading the Product or Solution

Make sure you have downloaded the relevant product bundle or solution. For more information on how to download the relevant component(s), see Downloading AAI and Its Components.

Check the Compatibility Matrix (Compatibility Matrix) to find the relevant information on supported versions and possible dependencies. For more information, see Compatibility Information.

See also: