Werk #8301: cmcdump: New tool for offline mirroring satellite sites into a central site

Component The Checkmk Micro Core
Title cmcdump: New tool for offline mirroring satellite sites into a central site
Date Sep 22, 2015
Checkmk Edition Checkmk Enterprise (CEE)
Checkmk Version 1.2.7i3
Level Major Change
Class New Feature
Compatibility Compatible - no manual interaction needed

The CMC now has a new replication mechanism for mirroring the state of satellite monitoring sites into a central site. This is much like livedump for the Nagios core but is much more powerful.

In order to setup this you need to call cmcdump -C > cmc.config on the remote site and transfer that file to the central site into etc/check_mk/conf.d/yourfile.mk. This will dump the configuration of all hosts and services. Afterwards activate the updated configuration with cmk -O. You need to repeat it from time to time so that your central site is up-to-date.

In a much shorter interval (e.g. once per minute) you call cmcdump > cmc.state on the same remote site. This can easily be done with a cron job. That file you also transfer to the central site via any mechanism you like (scp, http, rsync, ...). Over there read it into the core with:

OMD[mysite]:~$ unixcat < cmc.state tmp/run/live

This will update the core's complete state of all hosts and services that are contained in the dump. The transferred state will correctly reflect the following variables:

LI:The actual state (PEND, OK, WARN, ...) LI:The plugin output LI:The long (multiline) plugin output LI:The performance data LI:Whether the object is flapping and the current level of flappiness LI:The time of the last check execution LI:The time of the last state change LI:The check execution time LI:The check latency LI:The number of the current check attempt LI:Whether the current state is hard or soft LI:Whether a problem has been acknowledged LI:Whether the object is currently in a scheduled downtime

In the central site this will almost - but not entirely - be handled like a check execution. One difference is that no notifications will be sent. But performance data is being processed graphs will be created. Also the monitoring log is being updated and availability data can be processed. Depending on our synchronization interval of the data transfer the latter one might not be 100% precise however.

The tool cmcdump is in your path and can directly be executed. Call cmcdump --help for details on how to call this tool.

To the list of all Werks