Update procedure

Once a month, it is a good practice to update the LUGBZ servers. Thanks to the docker scripts, this is very easy.

In this guide, we refer to the documentation of the docker scripts (https://docker-scripts.gitlab.io/maintenance/update.html) but adapted to the applications and services of the LUGBZ.

1. Debian Host update

1.1. Small updates

All containers run on the host system. In our case, this is a Debian system. To keep it up to date, we run the following:

apt update
apt upgrade

1.2. Debian Version update

The host system needs to be updated every four years at the latest. This requires more organization and planning. Therefore, always discuss these updates with the rest of the SysTeam beforehand!

2. Docker Scripts

There is a script called update.sh in the /var/ds/_scripts/ folder. This can be easily executed with the following command:

root@lugbz1 /var/ds/_scripts # ./update.sh

What does the script do? You can find information on this in the documentation of the docker scripts. It does nothing more than download the latest version from the official repos of the scripts and apply it. However, a backup is made to undo the changes if necessary.

3. Incus Container

TODO

4. Test, Test & Test!

Often ignored, but very important: testing! Check whether the applications are still running after the update and whether all services and containers are still active. If there are only minor adjustments, you can solve these manually, otherwise you still have the backup. However, check the respective repo in the docker scripts beforehand.

https://gitlab.com/docker-scripts