1 Title: cmcdump: New tool for offline mirroring satellite sites into a central site
9 The CMC now has a new replication mechanism for mirroring the state
10 of satellite monitoring sites into a central site. This is much like
11 <tt>livedump</tt> for the Nagios core but is much more powerful.
13 In order to setup this you need to call <tt>cmcdump -C > cmc.config</tt>
14 on the remote site and transfer that file to the central site into
15 <tt>etc/check_mk/conf.d/yourfile.mk</tt>. This will dump the configuration
16 of all hosts and services. Afterwards activate the updated configuration
17 with <tt>cmk -O</tt>. You need to repeat it from time to time so that
18 your central site is up-to-date.
20 In a much shorter interval (e.g. once per minute) you call <tt>cmcdump >
21 cmc.state</tt> on the same remote site. This can easily be done with a cron
22 job. That file you also transfer to the central site via any mechanism
23 you like (scp, http, rsync, ...). Over there read it into the core with:
26 OM:unixcat < cmc.state tmp/run/live
29 This will update the core's complete state of all hosts and services that
30 are contained in the dump. The transferred state will correctly reflect the
33 LI:The actual state (PEND, OK, WARN, ...)
35 LI:The long (multiline) plugin output
36 LI:The performance data
37 LI:Whether the object is flapping and the current level of flappiness
38 LI:The time of the last check execution
39 LI:The time of the last state change
40 LI:The check execution time
42 LI:The number of the current check attempt
43 LI:Whether the current state is hard or soft
44 LI:Whether a problem has been acknowledged
45 LI:Whether the object is currently in a scheduled downtime
47 In the central site this will almost - but not entirely - be handled
48 like a check execution. One difference is that no notifications will be
49 sent. But performance data is being processed graphs will be created. Also
50 the monitoring log is being updated and availability data can be processed.
51 Depending on our synchronization interval of the data transfer the latter
52 one might not be 100% precise however.
54 The tool <tt>cmcdump</tt> is in your path and can directly be executed.
55 Call <tt>cmcdump --help</tt> for details on how to call this tool.