Overview

Overview Copied

This document describes the steps required to upgrade an existing Opsview Monitor system running on either a single server instance or a distributed Opsview environment to the latest version of Opsview Monitor.

Prior to the installation or upgrade of Opsview Monitor to a newer version, please check the following documentation:

For information about performing an in-place upgrade to Opsview versions 6.3.x and 6.7.x, refer to the Opsview Knowledge Center.

Depending on the size and complexity of your current Opsview Monitor system, the upgrade process may take between a few hours to a full day. This includes the following:

Note

After an upgrade, we recommended that you clear your browser cache. This ensures the new features and functionality are being used from the latest code instead of the cached ones from before the upgrade.

Important Notes Copied

Before proceeding with your upgrade, please review the following upgrade considerations to help avoid issues during the process.

Upgrade path requirements Copied

You must have upgraded to Opsview 6.5.x or above and performed all post-upgrade tasks before upgrading to Opsview version 6.8.x or above. This includes completing the Database Migration for SQL Strict Mode. If the database migration has not been completed, the upgrade will be cancelled with a fatal warning.

Upgrade preparation Copied

Before performing any upgrade, we strongly recommend that you backup your system including configuration files and databases. This ensures you can restore your environment if a rollback is required.

You must also upgrade all your hosts to the latest operating system packages, excluding Opsview packages. Do not manually upgrade any package beginning with opsview-, or the infrastructure-agent package. These will be automatically handled during the upgrade process.

Operating system and database compatibility Copied

Starting with Opsview 6.11.1, new installations on the following operating systems use MariaDB 10.11 as the default database:

If you are upgrading from an older version, your existing database is retained to prevent unintended data loss from an automatic upgrade to MariaDB 10.11. For the manual instructions, refer to Upgrade to MariaDB 10.11.

Additionally, Opsview 6.11.x no longer supports Debian 10. If you are using Debian 10 on older Opsview versions, you must migrate to Debian 12 before upgrading. For the full instructions, refer to Upgrade from Debian 10 to Debian 12.

To view the full list of supported platforms, see the documentation on Supported databases and Supported operating systems.

Component version requirements Copied

For Opsview to run correctly, all Opsview components on all servers must be installed from the same release repository. Mixing Opsview component versions from different releases, such as using opsview-datastore from 6.8.x and opsview-messagequeue from 6.7.x, is not supported.

Opsview collectors must also be installed from the same release repository as the core servers, whether they are deploy-based or are remotely managed collectors. The only exception to this is the Infrastructure Agent installed on monitored devices. The agent version does not need to match the exact Opsview version you’re using. However, it is always recommended to install the latest version of the agent whenever possible.

Monitoring Collectors Copied

During the upgrade, the system may temporarily report non-OK or non-UP states due to ongoing monitoring script configuration. To avoid false alarms and disruption during the upgrade process, you can temporarily disable Host Check, Service Check, and Event Handler execution on all Monitoring Clusters including the Master Monitoring Server.

For Opsview versions 6.8.5 and below, access the Features Enabled modal in Configuration > Monitoring Collectors > Clusters under the Clusters tab.

For Opsview versions 6.8.6 and newer, you can disable execution in the Collector Management page.

Message Queue Copied

If there is a significant upgrade of opsview-messagequeue, existing queues will be rebuilt and all unprocessed messages will be removed. For more information on opsview-messagequeue errors, refer to Opsview 6.x Known Issues.

Activation key Copied

Ensure you have your activation key for your system. For more information, refer to the following software key documentation:

Back up your Opsview data and system Copied

For further guidance, refer to the Common Tasks documentation.

Run the following command as root which will back up all databases on the server (if upgrading from Opsview 6.7.x or older):

mysqldump -u root -p --add-drop-database --extended-insert --opt --all-databases | gzip -c > /tmp/databases.sql.gz

Run the following command instead if upgrading from Opsview 6.8.x or newer:

mysqldump -u root -p --default-character-set=utf8mb4 --add-drop-database --extended-insert --opt --all-databases | sed 's/character_set_client = utf8 /character_set_client = utf8mb4 /' | gzip -c > /tmp/databases.sql.gz

The MySQL root user password can be found in /opt/opsview/deploy/etc/user_secrets.yml. Ensure you copy your database dump (/tmp/databases.sql.gz in the preceding command) to a secure location.

["Opsview On-Premises"] ["User Guide", "Technical Reference"]

Was this topic helpful?