Werk #9548: Platform update to Debian bookworm

The update from firmware 1.6 to 1.7 is a major platform update. In this step we move the underlying OS from Debian buster, which reached it's end of regular support EOL in 2023-09 and will reach it's LTS EOL in 2024-06, to Debian bookworm.

The changes we get with this update affect the CMA platform in several ways. Here are the most important changes:

• The upgrade from buster to bookworm involves a lot of packages being updated. Have a look at the ChangedPackages file, which can be found on the download page, for details. In case custom software components you installed manually rely on some of these packages, you may have to update them manually.
• The upgrade from buster to bookworm requires a change of the overlay filesystem we use to store the configuration you make to the CMA system. We migrate the filesystem from aufs to overlayfs, since the former one is not available anymore by the new Linux kernel. The migration is done automatically during the firmware update. Details can be looked up in werk #9545.
• The new platform requires all Checkmk versions to be reinstalled or updated to the new platform. Checkmk sites using platform incompatible versions can not be started anymore. To solve this, you need to either replace the previously installed Checkmk version with a platform compatible one or install a new platform compatible version and update your site to this version. Do it like this (clusters: on the active node only):
  • First go to the "Site management" page and check your sites Checkmk version. In case it is marked as compatible you can simply start it now and you are done.
  • If it's incompatible proceed with opening the Checkmk download page and download the exact same Checkmk version for the CMA 1.5+ platform. Or, in case it's not available, download a following Checkmk version that is compatible with the new platform. For example, if you site runs Checkmk 2.2.0p10, you need to download one of the newer Checkmk 2.2.0p-versions that have a CMA 1.7+ package. In case you already use e.g. 2.2.0p17, you can download 2.2.0p17 and proceed with this version. You could also advance from Checkmk 2.1 to a 2.2 release, but since this is a upgrade from one Checkmk major release to the next, you will likely need to do additional migrations within your Checkmk configuration. We recommend to do these things in a separate step.
  • Now that you have downloaded the CMA 1.7+ Checkmk package to your computer, navigate to the "Checkmk versions page" and upload the file there.
  • Then go to the "Site management" page again and update your sites to the 1.7+ compatible versions if needed. In case you replaced the old platform package with the new platform package, the site update step is not needed.
  • Now you can start the site as usual on the "Site management" page.
• If you have configured two appliances as cluster, the update to CMA 1.7 needs a special procedure when updating clusters. The update can only be done offline, which means you will have a downtime. You need to proceed like this:
  • Disconnect the cluster nodes using "Disconnect cluster" on the cluster page
  • Update both nodes to 1.7+
  • Open up the cluster page and use "Reconnect cluster" to re-establish the cluster connection. The cluster page should show all resources in "OK" state after a short time. The secondary node will be in a standby state.
  • Then you need to check your Checkmk versions to update them to the new platform as written above. Afterwards you can start your sites again.
  • Finally mark the secondary node as active again. The cluster should now re-sync and everything should go back to green.

To the list of all Werks