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
Updated over 1 year ago