Werk #13320: omd update: Add version compatibility barrier

Component Site management
Title omd update: Add version compatibility barrier
Date Dec 1, 2021
Checkmk Editon Checkmk Raw (CRE)
Checkmk Version 2.1.0b1
Level Prominent Change
Class New Feature
Compatibility Compatible - no manual interaction needed

For some time now, we have been recommending that, in the case of major updates over several versions, the updates to the individual versions should be made in stages, e.g. in the case of a migration from 1.5 to 2.0, the version 1.5 should first be updated to 1.6 and then to 2.0.

Furthermore, omd update does support downgrades to older major versions. However, a lot of manual adjustments are necessary to make the configuration and runtime data of the site compatible to an older major version again. So we don't recommend to do this step either.

This change now introduces a hard barrier in the omd update command, which forces the above recommendations.


  • 1.6 to 2.0 is allowed
  • 2.0 to 2.1 is allowed
  • 1.6 to 2.1 is blocked

You can disable this new check by using the omd -f update [site] command. However, sites that have been updated this way will no longer be supported by us.

To the list of all Werks