GuidesREST APISlack CommunitySupport PortalOpsview 6.8+ Documentation

Unfortunately, there is no support for a direct upgrade from Debian 8 (Jessie) to Debian 10 (Buster). An intermediate upgrade to Debian 9 (Stretch) is required. Follow the steps below to upgrade your Debian 8 Opsview system to Debian 10

Please note:

This documentation focuses on how to handle Opsview during the upgrade from Debian 8 to Debian 10. You may see Debian related errors during the upgrade which have not been mentioned in this documentation. It is advised to read the Debian documentation to resolve these issues if needed.

## Before the upgrade

Ensure your system is up-to-date by following the standard protocol implemented by Debian [Chapter 9. Keeping your Debian system up-to-date ](🔗)

Upgrade Opsview to the latest version that supports Debian 8 (which is version 6.6.3). If you are using a version lower than 6.4 follow the instruction in [In-Place Upgrade ](🔗) to upgrade your system to 6.4.

To upgrade to version 6.6.3 you will need to use the following repository: `https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346/deploy`.

You can simply follow the instructions on how to [ upgrade from 6.4.x or later to 6.6] (https://knowledge.opsview.com/docs/from-64-to-6x) using the new repo `https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346`:

  • When doing automated upgrade instead of `curl -sLo- https://deploy.opsview.com/6.6 | sudo bash -s -- --only repository,bootstrap` use:


  • When doing manual upgrade:

Finally, run the check-deploy playbook on your orchestrator and ensure any outputted issues are resolved

Stop Opsview Monitor on the orchestrator

## Upgrade to Debian 9 (Stretch)
Update the sources list to use Debian 9
As root user, edit `/etc/apt/sources.list` on each system - change all occurrences of `jessie` to `stretch`
Upgrade from Debian 8
Run these set of steps for each system to upgrade to Debian 9

Ignore warnings about _W: There is no public key available for the following key IDs_


Select default options when prompted during the upgrade
Running `reboot` will shut down your system and boot it back up again so you will need to reconnect to it
OPTIONAL: Remove remnants of Debian 8 (this is done for you in a later stage)

## Upgrade to Debian 10 (Buster)
Update the sources list to use Debian 10
As root user, edit `/etc/apt/sources.list` on each system - change all occurrences of `stretch` to `buster`
Also edit `/etc/apt/sources.list.d/opsview.list` - change all occurrences of `jessie` to `buster`
Upgrade from Debian 9
Run these set of steps for each system to upgrade to Debian 10


Select default options when prompted during the upgrade
Running `reboot` will shut down your system and boot it back up again so you will need to reconnect to it
## Update Opsview
Install the latest Opsview by following upgrade instructions in [From 6.4.x or later to 6.6](🔗). This step will ensure that you pull the latest 6.6 packages (later than 6.6.3).
On the orchestrator

Update and upgrade Opsview packages
On each system, run:

It is expected that apt update will claim that the system is up to date

It is expected that `apt upgrade` will say that it is downgrading `opsview-xxx from 6.6.3.<yyyymmddhhmm>-1jessie1` to `6.6.3.<yyyymmddhhmm>-1buster1`
On the orchestrator, run 

Stop  `php5-fpm`
This interferes with the setup and needs to be stopped on the orchestrator.

Run the `check-deploy` playbook on the orchestrator

Resolve any issues highlighted by  `check-deploy`
Run the `setup-everything` playbook on the orchestrator

If necessary, please follow the section below.
If not necessary, you have now successfully upgraded your system.
## Additional steps
Due to an apt issue through the upgrade, it is necessary to upgrade libcurl4 manually and restart the datastore on all Opsview hosts. To do so run the following commands on the master.