Upgrading Unified Assurance on an Existing Linux System

You can upgrade Oracle Communications Unified Assurance on an existing Linux system by first upgrading your existing Linux 7 environment to Linux 8 and then updating to the latest version of Unified Assurance. This is also known as an in-place upgrade.

An in-place upgrade involves the following high-level steps:

1. Preparing for the Linux and Unified Assurance upgrade by backing up key files and removing the old RPM.

2. Upgrading your Linux 7 environment to Linux 8 using the Leapp utility. For information about using the Leapp utility, see Oracle Linux 8 Upgrading Systems With Leapp.

3. Updating Unified Assurance packages on all servers.

In-Place Upgrade Process Placeholders

The in-place upgrade procedure uses the following placeholders, marked with angled brackets in the commands (<>):

• UA_home: Your Unified Assurance home directory. For example, /opt/assure1.

• installation_file_directory: The directory where you store installation files. For example, /opt/install.

Performing an In-Place Upgrade

Perform all commands in this procedure as the root user.

To perform an in-place upgrade:

1. For each Unified Assurance server, back up the Assure1.conf file, located in the UA_home/etc directory, to a safe location.

2. For each Unified Assurance server, remove the Unified Assurance RPM using the noscripts flag with the following command:

   sudo yum --setopt=tsflags=noscripts erase Assure1
   

3. Upgrade your Linux 7 environment to Linux 8 using the Leapp utility as described in Oracle Linux 8 Upgrading Systems With Leapp.

4. Confirm that Linux prerequisites are met for all servers. See Linux Prerequisites.

5. On the primary presentation server:

   1. Reset the Unified Assurance packages to their base versions:

      a1mysql
      UPDATE Packages SET PackageVersion = '6.0.0.0.0.0';
      

   2. Download the latest Unified Assurance release package from Oracle Software Delivery Cloud:

      https://edelivery.oracle.com

      The package contains the Oracle-Communications-Unified-Assurance-6.X.X.X.X-el8.zip collection file for installation.

   3. Extract the collection file to the location on the Unified Assurance primary presentation server where the packages were placed during the initial Unified Assurance installation. This is typically /opt/install/.

      unzip -d <installation_file_directory> Oracle-Communications-Unified-Assurance-6.X.X.X.X-el8.zip
      

6. Copy the Assure1-6.X.X.X.X-X.el8.x86_64.rpm file to each of your Unified Assurance servers.

7. On each of your Unified Assurance servers, starting with the primary presentation server:

   1. Install the latest Unified Assurance RPM for Linux 8:

      sudo dnf -y install Assure1-6.X.X.X.X-X.el8.x86_64.rpm
      

   2. Restore the backup of the Assure1.conf file and place it in the UA_home/etc/ directory.

   3. Start the Unified Assurance Broker:

      sudo systemctl start assure1-broker
      

   4. Remove the Linux 7 Unified Assurance packages by removing the contents of the UA_home/distrib/packages directory:

      rm -f <UA_home>/distrib/packages/*
      

8. Run Package update for each of your Unified Assurance servers:

   1. On the primary presentation server:

      <UA_home>/bin/Package update --depot <installation_file_directory>
      

   2. On all other servers:

      <UA_home>/bin/Package update
      

The in-place upgrade is complete.