Preparing for the AAI Upgrade

As an administrator, there is a series of preparatory steps you must take before upgrading your system.

This page includes the following:

Important Considerations for Upgrade to v24.x.x

With AAI v24.0.0 , the Reporting Server (also known as the BI Server) has been removed from AAI. With this the Insight reports, which were created and maintained via the Reporting Server, are removed. Before continuing with the upgrade, be sure to see Considerations When Upgrading to v24.x.x from v6.x.x.

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.

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.8 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 "1.8.0_241"
Java(TM) SE Runtime Environment (build 1.8.0_241-b07)
Java HotSpot(TM) 64-Bit Server VM (build 25.241-b07, mixed mode)

  • UNIX 

    /opt/automic/Automation_Analytics_Intelligence] java -versionjava version 1.8.0_121
Java SE Runtime Environment (build 1.8.0_121-b13)
Java HotSpot 64-Bit Server VM (build 25.121-b13, mixed mode) 
JAVA_HOME variable

To run the upgrade, make sure the JAVA_HOME environment variable points to the JDK 1.8 installed. This means you have to make sure you set the JAVA:HOME to the directory where JDK 1.8 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 Downloads.

For Windows: The standard WinZip tool fails to reliably extract all the files from the ZIP file for AAI. The recommended approach is to use another ZIP extractor tool such as 7-Zip.

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: