Upgrade from Debian 8 to Debian 10

Overview

This section is only applicable for users who are using Opsview 6.6.x.

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.

Note

This section focuses on how to handle Opsview Monitor 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 Monitor to the latest version that supports Debian 8. For more information, see Upgrade notes.

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 using the new repository https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346. Please take note of the following:

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

/opt/opsview/deploy/bin/opsview-deploy /opt/opsview/deploy/lib/playbooks/check-deploy.yml

Stop Opsview Monitor on the orchestrator:

cd /opt/opsview/deploy
./bin/rc.ansible ansible -m command -a "/opt/opsview/watchdog/bin/opsview-monit stop all" 'opsview_all'

Upgrade to Debian 9 (Stretch)

Update the sources list to use Debian 9.

As root user, edit /etc/apt/sources.list on each system then change all occurrences of jessie to stretch.

Upgrade from Debian 8

Run these set of steps for each system to upgrade to Debian 9.

Note

Ignore warnings about W: There is no public key available for the following key IDs. 
apt-get update
apt-get upgrade
apt-get dist-upgrade
reboot

Running reboot will shut down your system and boot it back up again so you will need to reconnect to it. Optionally, you can remove remnants of Debian 8 (this is done for you in a later stage).

rm -rf /etc/apt/sources.list.d/jessie-backports.list

Upgrade to Debian 10 (Buster)

Update the sources list to use Debian 10.

As root user, edit /etc/apt/sources.list on each system then change all occurrences of stretch to buster.

Also edit /etc/apt/sources.list.d/opsview.list then change all occurrences of jessie to buster.

Upgrade from Debian 9

Run these set of steps for each system to upgrade to Debian 10:

apt-get update
apt-get upgrade
apt-get dist-upgrade
reboot

Note

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).

  1. On the orchestrator, run:

    /opt/opsview/deploy/bin/opsview-deploy /opt/opsview/deploy/lib/playbooks/create-config-debian10.yml

  2. Update and upgrade Opsview packages. On each system, run:

    apt update

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

    apt upgrade

    It is expected that apt upgrade will say that it is downgrading opsview-xxx from 6.6.3.-1jessie1 to 6.6.3.-1buster1.

  3. On the orchestrator, run:

    /opt/opsview/deploy/bin/opsview-deploy /opt/opsview/deploy/lib/playbooks/remove-config-debian10.yml

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

    service php5-fpm stop

  5. Run the check-deploy playbook on the orchestrator.

    cd /opt/opsview/deploy
./bin/opsview-deploy ./lib/playbooks/check-deploy.yml

  6. Resolve any issues highlighted by check-deploy.

  7. Run the setup-everything playbook on the orchestrator.

    cd /opt/opsview/deploy
./bin/opsview-deploy ./lib/playbooks/setup-everything.yml

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.

/opt/opsview/deploy/bin/rc.ansible ansible -m command -vvv -a "apt-get -y install libcurl4" opsview_datastore_all
/opt/opsview/deploy/bin/rc.ansible ansible -m command -vvv -a "/opt/opsview/watchdog/bin/opsview-monit restart opsview-datastore" opsview_datastore_all
["Opsview"] ["User Guide", "Technical Reference"]

Was this topic helpful?