OP5 Monitor - Upgrade and Migration Guide

Support Notices

• Support is available for OP5 Monitor versions 9.x and 8.4.x.
• Support for all versions of OP5 Monitor running on EL6 ended on 30 November 2020.
• Support for OP5 Monitor 7.5.x ended on 13 October 2021.
• End of availability for OP5 Monitor 8.x binaries will be on September 2023.
• Support for OP5 Monitor 8.4.x is set to end on April 2024.

Refer to the OP5 9.x Compatibility Matrix for more information.

Introduction

This guide goes over how to migrate an OP5 Monitor 7.5.x environment to a 9.x environment. Note that since there is no in-place upgrade for OP5 Monitor 8.x to 9.x, there is a need to set up a separate EL8 server for OP5 Monitor 9.x prior to running a migration backup.

If you are running OP5 Monitor 7.5.12 and below, proceed to Upgrading 7.5.x to 7.5.13 on EL6 for instructions to upgrade.

If you are running OP5 Monitor 8.3.7 and below on EL7, proceed directly to Upgrading to 8.x on EL7 for instructions to upgrade.

If you are running OP5 Monitor 8.3.8 and above, proceed directly to Migrating 8.x on EL7 to 9.x on EL8 for instructions to migrate.

Upgrading 7.5.x to 7.5.13 on EL6

Verify your OP5 Monitor and OS version by running:

cat /etc/*release*

Output similar to below should be seen. VERSION indicates the OP5 Monitor version.

[root@op5-el6 yum.repos.d]# cat /etc/*release*
CentOS release 6.10 (Final)
VERSION=7.5.13
CentOS release 6.10 (Final)
CentOS release 6.10 (Final)
cpe:/o:centos:linux:6:GA

Check that OP5 repositories are valid. Refer to changes in ITRS OP5 Monitor repositories.

Check that CentOS 6 repositories are still reachable. An alternate repository can be used if no local mirror is available. As an example, see: How to fix yum after CentOS 6 went EOL.

Disable any op5-epel repositories, as these are no longer maintained. There is no real reason to use this anymore, as most of the epel packages are managed and maintained through the official epel repository.

To install epel-release if it has not been installed yet, run:

yum install epel-release

To run the update, run:

yum clean all && yum update

To verify that 7.5.13 has been installed, run:

cat /etc/op5-monitor-release

It should show:

VERSION=7.5.13

Proceed to the next section to migrate to EL7.

Migrating 7.5.x on EL6 to EL7

Ensure that a new EL7 server has already been set up. Install OP5 Monitor version 7.5.13 on the new EL7 server.

On the EL6 server

Run the migration backup process:

mon stop
op5-backup -g

By default, it will create a migration backup file in the /root directory with the following naming convention: migration_backup.HOSTNAME.yyyy-mm-dd.backup.

Verify that there were no errors logged by the backup process by running this command:

grep -i error /var/log/op5-backup/*

If there are no errors, transfer the migration backup from the EL6 server to the EL7 server. This can be done through various methods (WinSCP, FileZilla, etc).

On the EL7 server

Ensure that the version of OP5 Monitor on the EL7 server is the same as the version of OP5 Monitor on the EL6 server where the backup was taken. You will encounter errors restoring the backup if the versions differ.

Verify that the migration backup is valid by running:

tar tvf migration_backup.HOSTNAME.yyyy-mm-dd.backup

Then restore the migration backup by running:

op5-restore -b migration_backup.HOSTNAME.yyyy-mm-dd.backup

Verify there were no errors in the restore log by running:

grep -i error /var/log/op5-backup/*

If there were no errors reported, reboot the server.

Proceed to the next section to upgrade the OP5 Monitor version to version 8.x.

Upgrading to 8.x on EL7

Refer to the section "Upgrade from OP5 Monitor 7 to OP5 Monitor 8" in the documentation.

To update to OP5 Monitor 8 from any previous version of OP5 Monitor 7, run the following commands:

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

For more information, see the 8.4.x upgrade documentation.

Migrating 8.x on EL7 to 9.x on EL8

There is no in-place upgrade from Monitor 8.x to Monitor 9.x as Monitor 9.x is designed to run on EL8 operating systems.

Ensure that a new EL8 server has already been setup and that version 9.x of OP5 Monitor has already been installed.

On the EL7 server

Running a migration from version 8.x to 9.x requires at least OP5 Monitor version 8.3.8.

Verify the version of OP5 Monitor by running:

cat /etc/op5-monitor-release

It should show:

VERSION=8.4.3

If the version is 8.3.7 and below, follow the section "Upgrade from one minor version to another" in the documentation to upgrade to a newer version. If the versions is 8.3.8 and above, continue on with the steps.

Run the pre-migration tasks. More details can be found in the documentation.

After running op5-check-migration and confirming there are no errors, proceed with the migration process.

Run the migration process:

mon stop
op5-backup -g

By default, it will create a migration backup file in the /root directory with the following naming convention: migration_backup.HOSTNAME.yyyy-mm-dd.backup.

Verify that there were no errors logged by the backup process by running this command:

grep -i error /var/log/op5-backup/*

If there are no errors, transfer the migration backup from the EL7 server to the EL8 server. This can be done through various methods (WinSCP, FileZilla, etc).

On the EL8 server

Verify that the migration backup is valid by running:

tar tvf migration_backup.HOSTNAME.yyyy-mm-dd.backup

Then restore the migration backup by running:

op5-restore -b migration_backup.HOSTNAME.yyyy-mm-dd.backup

Verify there were no errors in the restore log by running:

grep -i error /var/log/op5-backup/*

If there were no errors reported, reboot the server.

At this point, you should be on OP5 Monitor version 9.x.

Further reading

• OP5 version 9 installation documentation
• OP5 version 9 migration documentation
• How to migrate from EL6 to EL7 (CentOS6 to CentOS7)
• OP5 Monitor - How to update to a later version
• OP5 Monitor 8.x Release Notes
• OP5 Monitor 9.x Release Notes
• OP5 9.x Compatibility Matrix 
• Cannot find "op5-extra-tools-check-migration"