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

Upgrading Unified Manager

Contributors
PDFs

You can upgrade Unified Manager 9.7 or 9.8 to 9.9 by downloading and running the installation file on the Windows platform.

Before you begin

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

    Hardware system requirements

    Windows software and installation requirements

    Note

    Starting with Unified Manager 9.5, OpenJDK is provided in the installation package and installed automatically. Oracle Java is not supported starting with Unified Manager 9.5.
    Note

    Ensure that Microsoft .NET 4.5.2 or greater is installed on your system before starting the upgrade.

  • 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 should have Windows administrator privileges. Ensure that your user name does not begin with an exclamation mark “!”. Installation of Unified Manager might fail if the user name of user running the installation begins with “!”.

  • You should have valid credentials to log in to the NetApp Support Site.

  • To avoid data loss, you should have created a backup of the Unified Manager machine in case there is an issue during the upgrade.

  • You should have adequate disk space available to perform the upgrade.

    The available space on the installation drive should be 2.5 GB larger than the size of the data directory. The upgrade stops and displays an error message indicating the amount of space to be added if there is not enough free space.

  • 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.

  • Before upgrading, you should close any open files or folder in <InstallDir\>\JDK and MySQL Data Directory.

About this task

During the upgrade process, Unified Manager is unavailable. You should complete any running operations before upgrading Unified Manager.

If Unified Manager is paired with an instance of OnCommand Workflow Automation, and there are new versions of software available for both products, you must disconnect the two products and then set up a new Workflow Automation connection after performing the upgrades. If you are performing an upgrade to only one of the products, then you should log into Workflow Automation after the upgrade and verify that it is still acquiring data from Unified Manager.

Steps

  1. Log in to the NetApp Support Site, and navigate to the Download page for Unified Manager: NetApp Support Site

  2. Select the required version of Unified Manager and accept the end-users license agreement (EULA).

  3. Download the Unified Manager Windows installation file to a target directory on the Windows system.

  4. Right-click and run the Unified Manager installer executable (.exe) file as an administrator.

    Unified Manager prompts you with the following message:

    This setup will perform an upgrade of Unified Manager. Do you want to continue?

  5. Click Yes, and then click Next.

  6. Enter the MySQL8 root password that was set during installation, and then click Next.

  7. Log in to the Unified Manager web UI, and verify the version number.

After you finish

Note

To perform a silent upgrade of Unified Manager, run the following command: ActiveIQUnifiedManager-<version\>.exe /s /v"MYSQL_PASSWORD=netapp21! /qn /l*v C:\install.log