Upgrading AAI in Non-Automated Mode

This section describes the procedure for AAI upgrading an instance of AAI.

General Upgrade Overview

When upgrading the AAI server and connectors with a new release package, you perform the following tasks:

1. Do all preparation steps and make sure all prerequisites are fulfilled.

   For information, see Preparing for an AAI Upgrade.

2. Take down the connectors that you want to upgrade.

   For information, see the topics related to your connectors under Connectors.

3. Upgrade and start your AAI system, as described in this topic in Upgrading the AAI Server.

4. Upgrade and start each connector.

   Again, for information, see the topics related to your connectors under Connectors.

This topic covers only the steps related to C. Upgrade and start your AAI system. Use the links in the previous overview for instructions for the other tasks.

Upgrading the AAI Server

1. Shut down the AAI server. The upgrade will not execute if the server is running.

2. If you have not done so yet, download the relevant AAI product or solution. For more information, see Downloading AAI and Its Components.

   Important !

   Use the compatibility matrix (Compatibility Matrix) to find the relevant information on supported versions, setup, or prerequisites. Check all AAI components and prerequisites for vendor, version or setup information. For more information, see Compatibility Information.

3. Extract the upgrade bundle into a temporary directory. Ensure the following directories and file are present:

   • install\build.xml

   • install\log\log4j.properties

   • install\properties

4. Execute the upgrade script.

5. Select the directory for the AAI installation.

6. If your database type is Oracle, specify the Oracle Table Space Definitions.

   

7. A dialog will be displayed if the AAI upgrade is successful. Click OK to continue.

   The upgrade will perform the following:

   1. Create a timestamped tarball from the existing AAI server installation in the directory install\backup

   2. If there are any database schema updates with the new release, generate an SQL script for upgrading the database schema called <Automation_Analytics_Intelligence>\scripts\upgradeJawsDbTo<version>.sql .

   3. Log the details in the install\l\og\upgrade.log

   4. Store upgrade related properties in install\properties\upgrade.properties

8. A second dialog will be displayed if the AAI upgrade is successful. Click OK to continue.

9. Check for database schema updates and, if so, apply them.

   1. Open the scripts directory of your AAI installation, for example, /opt/Automation_Analytics_Intelligence/scripts/.

   2. If you see an upgradeJawsDbTo<version>.sql file for your new version, then open it to find out which database schema updates need to be applied, and apply them. Otherwise, continue with the next step.

      To do this, use an administration tool specific to your DBMS (a command line or GUI) to run the SQL upgrade script to update the AAI database schema.

10. Restart AAI and confirm the server operates properly.

Registering Your AAI Instance

Broadcom requires every AAI instance to be registered in the Broadcom Product Registration Platform so that Broadcom can collect necessary usage metrics about execution load. This registration opens up benefits of personalized content, exclusive training resources, and critical update notifications for all your AAI users. If your AAI instance has not already been registered in a previous version of AAI, then you will be prompted to register when you log into this upgraded version.

This is a one-time registration that applies to all users of the current and all future upgrade versions. For information, see Unlock Premium Value with Broadcom Product Registration.

Post V24.4 Upgrade Tasks for EEM Environments

For AAI installations that already use EEM for user management of AAI v24.3.x or older, be aware that AAI v24.4 introduced two new access policies, BusinessArea and JobstreamV2. These replace and enhance the access control that this Jobstream access policy provided previously. After you complete the AAI upgrade, you must do some additional upgrade steps for the EEM policies to implement these new access policies in your EEM environment for AAI. For information, see Post V24.4 Upgrade Tasks for EEM Environments.

 

See also:

• Preparing for an AAI Upgrade

• Stopping, Starting, Restarting the AAI Server

• Securing AAI: TLS and Kerberos

• Installation and Upgrade