Skip to main content
Active IQ Unified Manager 9.8
9.8
A newer release of this product is available.

Upgrading Unified Manager

Contributors

You can upgrade from Unified Manager 9.6 or 9.7 to 9.8 by downloading and running the installation file on the Red Hat platform.

Before you begin

  • The system on which you are upgrading Unified Manager must meet the system and software requirements.

  • You must install, or upgrade to the correct version of OpenJDK prior to upgrading Unified Manager.

  • MySQL Community Edition is automatically upgraded during Unified Manager upgrade. If the installed version of MySQL on your system is earlier than 8.0.21, the Unified Manager upgrade process automatically upgrades MySQL to 8.0.21. You must not run a standalone upgrade of an earlier version of MySQL to 8.0.21. If the installed version of MySQL on your system is 5.7, then you must not attempt to directly upgrade MySQL to version 8.0.21. It results in application data loss.

    Note

    The installer of Unified Manager has been restricted to support only up to MySQL Community Edition 8.0.21, due to an interoperability issue. You must not upgrade MySQL to a release greater than 8.0.21.

  • You must have a subscription to the Red Hat Enterprise Linux Subscription Manager.

  • To avoid data loss, you must have created a backup of the Unified Manager database in case there is an issue during the upgrade. It is also recommended that you move the backup file from the /opt/netapp/data directory to an external location.

  • During upgrade, you may be prompted to confirm whether you want to keep the previous, default settings for retaining performance data for 13 months or to change it to 6 months. On confirming, the historical performance data after 6 months is purged.

  • You should have completed any running operations, because Unified Manager is unavailable during the upgrade process.

Steps

  1. Log in to the target Red Hat Enterprise Linux or CentOS server.

  2. Download the Unified Manager bundle to the server.

  3. Navigate to the target directory and expand the Unified Manager bundle: unzip ActiveIQUnifiedManager-<version\>.zip

    The required RPM modules for Unified Manager are unzipped to the target directory.

  4. Verify that the following module is available in the directory: ls *.rpm

    • netapp-um<version\>.x86_64.rpm

  5. For systems that are not connected to the Internet or that are not using the Red Hat Enterprise Linux repositories, perform the following steps to determine whether you are missing any required packages and download those packages:

    1. View the list of available and unavailable packages: yum install netapp-um<version\>.x86_64.rpm --assumeno

      The items in the “Installing:” section are the packages that are available in the current directory, and the items in the “Installing for dependencies:” section are the packages that are missing on your system.

    2. On a different system that has Internet access, run the following command to download the missing packages. yum install package_name --downloadonly --downloaddir=.

      The packages are downloaded in the directory specified as –downloaddir=.

      Because the plug-in “yum-plugin-downloadonly” is not always enabled on Red Hat Enterprise Linux systems, you might need to enable the functionality to download a package without installing it:yum install yum-plugin-downloadonly

    3. Create a new directory in the installation system and copy the downloaded packages from the Internet-connected system.

    4. Change directories to the new directory on the installation system and run the following command for installing MySQL Community Edition, along with its dependencies. yum install *.rpm

  6. Run the pre-installation script to ensure that there are no system configuration settings or any installed software that might conflict with the upgrade: sudo ./pre_install_check.sh

    The pre-installation script checks that the system has a valid Red Hat subscription, and that it has access to the required software repositories. If the script identifies any issues, you must fix the issues before upgrading Unified Manager.

  7. Upgrade Unified Manager using the following script: upgrade.sh

    This script automatically executes the RPM modules, upgrading the necessary supporting software and the Unified Manager modules that run on them. Additionally, the upgrade script checks whether there are any system configuration settings or any installed software that might conflict with the upgrade. If the script identifies any issues, you must fix the issues before upgrading Unified Manager.

    Note

    Do not attempt to upgrade by using alternative commands (such as rpm -Uvh). Running the yum install command to upgrade Unified Manager 9.6 to 9.8 might lead to errors and leave the system in an unusable state. A successful upgrade requires that all Unified Manager files and related files are upgraded in a specific order to a specific directory structure that are executed and configured automatically by the script.

  8. After the upgrade is complete, scroll back through the messages until you see the message displaying an IP address or URL for the Unified Manager web UI, the maintenance user name (umadmin), and the default password.

    The message is similar to the following:

    Active IQ Unified Manager upgraded successfully.
    Use a web browser and one of the following URLs to access the Unified Manager GUI:
    
    https://default_ip_address/    (if using IPv4)
    https://[default_ip_address]/  (if using IPv6)
    https://fully_qualified_domain_name/

After you finish

Enter the specified IP address or URL into a supported web browser to start the Unified Manager web UI, and then log in by using the same maintenance user name (umadmin) and password that you set earlier.