Upgrade

Overview

There are two different ways to upgrade OP5 Monitor:

  • Red Hat Enterprise Linux yum command for online servers.
  • ISO file with yum for offline servers.

Note: If you are running OP5 Monitor in a distributed or load-balanced environment, you must ensure that servers are running the same version of the software. For more information, see Scale up your monitoring environment.

Before you begin

Before you upgrade OP5 Monitor, we strongly advise you perform the following tasks:

  • Read What's new in OP5 Monitor.
  • Read the OP5 Monitor release notes for the version you are upgrading to, paying particular attention to the Known issues section.
  • Read the Prequisites section, paying particular attention to the OP5 Monitor 8.x compatibility matrix.
  • Deploy the upgrade in a development or UAT environment first, which is as similar to your production environment as possible. Perform tests in that environment and ensure there is no incompatibility with your current deployment.
  • Perform necessary backups and snapshots of your production system before deploying the upgrade, and establish a rollback plan in case the upgrade fails.

Upgrade with yum (online)

Your server must have internet connectivity to use this upgrade method.

Check which updates are available

You can check which updates are available at any time by running the following command:

# yum check-update

Upgrade from OP5 Monitor 7 to OP5 Monitor 8

To update to OP5 Monitor 8 from any previous version of OP5 Monitor 7, type these commands:

# yum clean all 
# yum update
# yum install op5-release-up-7-to-8					
# yum --enablerepo='*7-to-8*' update					

Upgrade from one minor version to another

  1. Log in to the console locally or remotely using SSH.

    Note: If you are logging in remotely with SSH, it is recommended to perform your update in a tmux or screen session so that the process is not interrupted if there is a network problem.

  2. Enter the following command:

    # yum clean all && yum update

If there are any updates, information about what is going to be updated is displayed on the screen and you need to confirm if you want to continue or not.

Upgrade with an ISO file and yum (offline)

If your OP5 Monitor system is offline, you can upgrade by downloading the latest ISO image file. The image file contains all the dependencies required to upgrade OP5 Monitor to the specified version in the file name.

  1. Download the ISO package (op5-monitor-<version>.centos7-x64.iso) from the ITRS downloads page:
  2. Log on to the server directly or using SSH, as root.
  3. Mount the ISO image file in the OP5 Monitor server file system.

    # mkdir -p /media/cdrom/
    # mount -o loop op5-System-7.4.1708-Monitor-7.4.3-20180612-0748.iso /media/cdrom/
  4. Clean out old data, if required.
    # yum --enablerepo=* clean all
  5. Upgrade the system from the mounted ISO file.
    # yum --disablerepo=* --enablerepo=*media* update

    You will now get a summary of all packages that will be updated or installed.

  6. At the confirmation prompt, enter y.

    The upgrade process will take a few minutes.

After upgrade

After the upgrade is complete, perform the following tasks:

  • Check the correct version is installed.
  • Run the same tests in your production environment as you ran in preparation for upgrade. For more information, see Before you begin.
  • If you encounter any critical problems, consider rolling back the upgrade.