Dateien und Verzeichnisse des CMC

Letzte Aktualisierung: 10. März 2016


Folgende Übersicht zeigt Ihnen alle wichtigen Dateien und Verzeichnisse, die den Check_MK Micro Core betreffen. Alle Pfade vestehen sich relativ vom Homeverzeichnis der Instanz aus. Heißt die Instanz z. B. mysite, so sind alle Pfade von /omd/sites/mysite aus zu verstehen.

1. Laufzeitdaten

Pfad Bedeutung
var/log/cmc.logHier finden Sie Meldungen zum Start und Stop des CMC und evtl. Warnungen oder Fehler genereller Art. Die Historie von Hosts und Services (bei Nagios beides in nagios.log) ist in eine eigene Datei ausgelagert und hier nicht enthalten.
var/check_mk/core/Verzeichnis mit allen Laufzeitdaten des CMC.
var/check_mk/core/configKonfiguration für den Core. Diese Datei entspricht bei Nagios den Dateien unter etc/nagios/conf.d und enthält alle statischen Daten zu Hosts, Services, Gruppen, Benutzern und globalen Einstellungen.
var/check_mk/core/stateAktueller Laufzeitzustand des Cores. Die Datei speichert Informationen über den aktuellen Status von Hosts und Services sowie über Downtimes, Acknowledgements und Kommentare. Die Datei entspricht der Datei retention.dat von Nagios, ist aber binär kodiert. Die Datei wird regelmäßig und beim Anhalten des Cores aktualisiert. Wenn sie beim Start des Cores nicht vorhanden oder nicht kompatibel ist, beginnt der Core mit einem leeren Zustand.
var/check_mk/core/state-* Sicherheitskopien des Status nach Migration von einer alten CMC-Version oder wenn der CMC feststellt, dass die Zahl der Hosts in der Konfiguration stark gesunken ist. So können Sie zum alten Status zurückkehren (und Ihre Downtimes und Quittierungen wiederbekommen), wenn Sie z. B. durch eine Fehlkonfiguration alle Hosts vorübergehend aus dem Monitoring entfernt hatten.
var/check_mk/core/coreDie core-Datei ist normalerweise nicht vorhanden. Falls doch, deutet sie auf einen früheren Absturz des Cores hin und hilft den Entwicklern beim Finden der Fehlerursache.
var/check_mk/core/historyDie Historie aller Hosts und Services ist in dieser Datei im Textformat gespeichert. Sie entspricht vom Inhalt und Aufbau der Datei nagios.log von Nagios und ist mit ihr weitgehend kompatibel.
var/check_mk/core/archive/In dieses Verzeichnis werden alte Versionen von history bei der Logfilerotation verschoben. Nur wenn diese Dateien unkomprimiert vorhanden sind, kann man mit Livestatus und Multisite auf historische Daten zugreifen (Events, Verfügbarkeit).
tmp/run/liveLivestatus-Socket des CMC. Dies liegt an der gleichen Stelle, wie das von Nagios. Da der CMC Livestatus-kompatibel zu Nagios und Icinga ist, können so alle Erweiterungen, die auf Livestatus basieren, ohne Anpassung genutzt werden (z. B. NagVis).
tmp/run/cmc.pidAktuelle Prozess-ID des CMC.

2. Konfiguration

Der CMC hat keine eigene Konfigurationsdatei. Alle Einstellungen für den CMC finden Sie im WATO-Modul Global Settings unter Monitoring Core und werden zusammen mit den anderen globalen Optionen unter etc/check_mk/conf.d/wato/global.mk gespeichern.

3. Software

Pfad Bedeutung
bin/cmcAusführbares Programm für den CMC selbst. Dieser ist in C++ entwickelt und benötigt außer der Standard-C++-Bibliothek keine weiteren Bibliotheken (insbesondere kein Boost). Zu Testzwecken kann man den CMC auch von Hand aufrufen (probieren Sie cmc --help).
lib/cmc/checkhelperHilfsprozess, der vom CMC mehrfach gestartet wird und das effiziente Ausführen von aktiven Checks übernimmt.
lib/cmc/icmpsenderHilfsprozess, der vom CMC gestartet wird und das Senden ICMP-Paketen für das Smart-Ping übernimmt. Dieser muss unbedingt mit SUID-root installiert sein.
lib/cmc/icmpreceiverHilfsprozess, der vom CMC gestartet wird und das Empfangen von ICMP- und TCP-Connection-Paketen für das Smart-Ping übernimmt. Dieser muss unbedingt mit SUID-root installiert sein.
etc/init.d/cmcStartskript des Micro Core.
share/check_mk/web/plugins/wato/cmc.pyWATO-Erweiterungen mit globalen Einstellungen und Regelsätzen für den CMC.
share/check_mk/web/plugins/sidebar/cmc.pyEin Sidebarplugin für Multisite mit Performancedaten zum CMC.
share/check_mk/modules/cmc.pyCheck_MK-Modul, das die Konfiguration für den CMC erzeugt.
share/check_mk/modules/rrd.pyCheck_MK-Modul für das Anlegen von RRD-Dateien.