Upgrade from Debian 8 to Debian 10

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 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:
curl -sLo- https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346/deploy | sudo bash -s -- --only repository,bootstrap
  • When doing manual upgrade:
# CentOS/RHEL/OL
[opsview]
name    = Opsview Monitor
baseurl = https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346/yum/rhel/$releasever/$basearch
enabled = yes
gpgkey  = https://downloads.opsview.com/OPSVIEW-RPM-KEY.asc

# Ubuntu/Debian
deb https://downloads.opsview.com/opsview-commercial/6.6.3.202110261346/apt xenial main

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

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

πŸ“˜

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)

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

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

πŸ“˜

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

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

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.<yyyymmddhhmm>-1jessie1 to 6.6.3.<yyyymmddhhmm>-1buster1

On the orchestrator, run

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

Stop php5-fpm

This interferes with the setup and needs to be stopped on the orchestrator.

service php5-fpm stop

Run the check-deploy playbook on the orchestrator

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

Resolve any issues highlighted by check-deploy

Run the setup-everything playbook on the orchestrator

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

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.

/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