Skip to main content
Active IQ Unified Manager 9.14

Upgrading the host OS from Red Hat Enterprise Linux 7.x to 8.x

Contributors
PDFs

If you previously installed Unified Manager on a Red Hat Enterprise Linux 7.x system and need to upgrade to Red Hat Enterprise Linux 8.x, you must follow one of the procedures listed in this topic. In both cases you must create a backup of Unified Manager on the Red Hat Enterprise Linux 7.x system, and then restore the backup onto a Red Hat Enterprise Linux 8.x system. Note that the supported versions of Red Hat Enterprise Linux are from 8.0 to 8.9.

The difference between the two options listed below is that in one case you are performing the Unified Manager restore onto a new 8.x server, and in the other case you are performing the restore operation onto the same server.

Because this task requires that you create a backup of Unified Manager on the Red Hat Enterprise Linux 7.x system, you should create the backup only when you are prepared to complete the entire upgrade process so that Unified Manager is offline for the shortest period of time. Gaps in collected data appear in the Unified Manager UI for the period of time during which the Red Hat Enterprise Linux 7.x system is shut down and before the new Red Hat Enterprise Linux 8.x is started.

See Managing backup and restore operations if you need to review detailed instructions for the backup and restore processes.

Follow these steps if you have a spare system on which you can install Red Hat Enterprise Linux 8.x software so that you can perform the Unified Manager restore on that system while the Red Hat Enterprise Linux 7.x system is still available.

  1. Install and configure a new server with Red Hat Enterprise Linux 8.x software.

    See Linux software and installation requirements.

  2. On the Red Hat Enterprise Linux 8.x system, install the same version of Unified Manager software that you have on the existing Red Hat Enterprise Linux 7.x system.

    See Installing Unified Manager on Linux.

    Do not launch the UI or configure any clusters, users, or authentication settings when the installation is complete. The backup file populates this information during the restore process.

  3. On the Red Hat Enterprise Linux 7.x system, from the Administration menu in the web UI, create a Unified Manager backup and then copy the backup file (.7z file) and the contents of the database repository directory (/database-dumps-repo subdirectory) to an external location.

  4. On the Red Hat Enterprise Linux 7.x system, shut down Unified Manager.

  5. On the Red Hat Enterprise Linux 8.x system, copy the backup file (.7z file) from the external location to /opt/netapp/data/ocum-backup/ and the database repository files to the /database-dumps-repo subdirectory under the /ocum-backup directory.

  6. Enter the following command to restore the Unified Manager database from the backup file:

    um backup restore -f /opt/netapp/data/ocum-backup/<backup_file_name>

  7. Enter the IP address or URL into your web browser to start the Unified Manager web UI, and then log in to the system.

Once you have verified that the system is operating properly you can remove Unified Manager from the Red Hat Enterprise Linux 7.x system.

Upgrading the host OS on the same server

Follow these steps if you do not have a spare system on which you can install Red Hat Enterprise Linux 8.x software.

  1. From the Administration menu in the web UI, create a Unified Manager backup and then copy the backup file (.7z file) and the contents of the database repository directory (/database-dumps-repo subdirectory) to an external location.

  2. Remove the Red Hat Enterprise Linux 7.x image from the system and completely wipe the system.

  3. Install and configure Red Hat Enterprise Linux 8.x software on the same system.

    See Linux software and installation requirements.

  4. On the Red Hat Enterprise Linux 8.x system, install the same version of Unified Manager software that you had on the Red Hat Enterprise Linux 7.x system.

    See Installing Unified Manager on Linux.

    Do not launch the UI or configure any clusters, users, or authentication settings when the installation is complete. The backup file populates this information during the restore process.

  5. Copy the backup file (.7z file) from the external location to /opt/netapp/data/ocum-backup/ and the database repository files to the /database-dumps-repo subdirectory under the /ocum-backup directory.

  6. Enter the following command to restore the Unified Manager database from the backup file:

    um backup restore -f /opt/netapp/data/ocum-backup/<backup_file_name>

  7. Enter the IP address or URL into your web browser to start the Unified Manager web UI, and then log in to the system.