.werks/8301

   1 Title: cmcdump: New tool for offline mirroring satellite sites into a central site
   2 Level: 3
   3 Edition: cee
   4 Component: cmc
   5 Version: 1.2.7i3
   6 Date: 1442925600
   7 Class: feature
   8
   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.
  12
  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.
  19
  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:
  24
  25 C+:
  26 OM:unixcat < cmc.state tmp/run/live
  27 C-:
  28
  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
  31 following variables:
  32
  33 LI:The actual state (PEND, OK, WARN, ...)
  34 LI:The plugin output
  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
  41 LI:The check latency
  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
  46
  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.
  53
  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.