Werk #19719: omd restore: Prevent 'KeyError: "linkname'

Component

Site management

Title

omd restore: Prevent 'KeyError: "linkname'

Date

Aug 7, 2026

Level

Prominent Change

Class

Bug Fix

Compatibility

Compatible - no manual interaction needed

Checkmk versions & editions

3.0.0b1 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT
2.5.0p12 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT
2.4.0p36 Not yet released	Checkmk Community, Checkmk Pro, Checkmk Ultimate, Checkmk Cloud, Checkmk Ultimate MT

The backup of a running site could fail to restore. While the backup is created, the monitoring core could rotate the generated helper configuration below var/check_mk/core/helper_config/. This could corrupt the backup file and omd restore failed with an error like:

KeyError: "linkname 'var/check_mk/core/helper_config/89/autochecks/....mk' not found"

The helper configuration is now excluded from omd backup altogether. It is generated data and is recreated automatically (via cmk -U) when a backup is restored.

To the list of all Werks