Monitoringinstanzen (Sites)

In manchen Fällen möchte man die User-/Gruppen-ID des neu anzulegenden Benutzers festlegen. Dies geschieht mit den Optionen -u und -g, z.B.:

Eine Übersicht über weitere Optionen erhalten Sie mit omd create --help. Die wichtigsten Optionen sind:

Wer den interaktiven Modus nicht liebt oder mit Skripten arbeiten will, kann die einzelnen Variablen auch per Befehl setzen. Dafür gibt es den Befehl omd config set. Folgendes Beispiel setzte die Variable CORE auf cmc:

Wie immer können Sie das auch als root aufrufen, wenn Sie den Namen der Site als Argument mit angeben:

Die aktuelle Belegung aller Variablen bekommen Sie mit omd config show:

In omd config gibt es zahlreiche Einstellungen. Die Wichtigsten sind:

Wenn Sie eine größere Zahl von Hosts überwachen, können die Datenmengen, die kopiert werden müssen, schon ganz erheblich sein. Der Großteil wird dabei durch die Performancedaten verursacht, die in RRD-Dateien gespeichert sind. Aber auch die Logdateien mit historischen Ereignissen können größere Datenmengen erzeugen. Wenn Sie die Historie nicht benötigen (z.B. weil Sie einfach etwas testen möchten), können Sie diese beim Kopieren auslassen. Dazu dienen folgende Optionen, die Sie bei omd cp angeben können:

Die Position der Optionen ist dabei wichtig:

Das Umbenennen einer Instanz geht mit dem Befehl omd mv. Dies geschieht analog zum Kopieren und hat die gleichen Vorbedingungen. Die Optionen zum Beschränken der Datenmengen existieren hier nicht, weil die Dateien ja einfach nur in ein anderes Verzeichnis verschoben und nicht dupliziert werden. Beispiel:

Bei beiden Operationen werden genauso wie bei create neue Linux-Benutzer angelegt. Deswegen gibt es hier auch einige der Optionen von omd create:

Die Instanzverwaltung von Checkmk hat einen eingebauten Mechanismus zum Sichern und Wiederherstellen von Checkmk-Instanzen. Die Grundlage davon sind die Befehle omd backup und omd restore, welche alle Daten einer Instanz in ein tar-Archiv einpacken bzw. wieder auspacken.

Ab Version 1.4.0 verfügt Checkmk zusätzlich über das WATO-Modul Backup, welches Backup und Restore ohne Kommandozeile möglicht macht und auch das Einrichten von regelmäßigen Backupjobs erlaubt.

Das Sichern einer Instanz mit omd backup erfordet keine root-Rechte. Sie können es als Instanz-Benutzer ausführen. Geben Sie einfach als Argument den Namen einer zu erzeugenden Backupdatei an:

Bitte beachten Sie dabei:

Wenn das Zielverzeichnis der Sicherung nicht als Instanz-Benutzer schreibbar ist, können Sie die Sicherung auch als root-Benutzer durchführen. Dazu benötigen Sie wie immer als zusätzliches Argument den Namen der zu sichernden Instanz:

Die Sicherung enthält alle Daten der Instanz — außer den flüchtigen Daten unterhalb von tmp/. Sie können mit dem Befehl tar tzf einfach einen Blick in die Datei werfen:

Der Löwenanteil der Daten einer Instanzsicherung sind die in den RRDs aufgezeichneten Messdaten. Auch die Monitoringhistorie kann sehr groß werden. Wenn Sie beides nicht zwingend benötigen, können Sie mit folgenden Optionen auf historische Daten verzichten und so die Sicherung deutlich kleiner und schneller machen. Die Optionen müssen jeweils hinter das Wort backup gestellt werden:

Beispiel:

Die Sicherung ist nicht darauf angewiesen, dass die Instanz gestoppt ist und kann auch bei einem laufenden System durchgeführt werden. Um einen konsistenten Stand der für das Aufzeichnen der Messdaten verwendeten RRDs zu gewährleisten, versetzt der Befehl omd backup den Round-Robin-Cache automatisch in einen Modus, bei dem laufende Updates nur noch in das Journal und nicht mehr in die RRDs geschrieben werden. Die Journaldateien werden zu allerletzt gesichert. Damit wird erreicht, dass möglichst viele der Messdaten, die während der Sicherung angefallen sind, noch mitgesichert werden.

Das Zurückspielen einer Sicherung ist ebenso einfach wie das Sichern selbst. Der Befehl omd restore stellt eine Instanz aus einer Sicherung wieder her. Dies ist sogar als Instanz-Benutzer möglich. Die Instanz muss dabei gestoppt sein. Die Instanz wird dabei nicht neu angelegt (was root-Rechte erfordern würde), sondern komplett geleert und neu befüllt:

Nach dem Restore muss die Instanz noch gestartet werden:

Auch als root-Benutzer ist ein Wiederherstellen möglich. Falls noch eine Instanz mit dem gleichen Namen exisitert, müssen Sie diese allerdings vorher entfernen. Das können Sie entweder mit einem omd rm erledigen oder einfach die Option --reuse mit angeben. Ein --kill sorgt zusätzlich dafür, dass die noch bestehende Instanz vorher gestopp wird. Den Namen der Instanz brauchen Sie beim restore nicht anzugeben, da dieser in der Sicherung enthalten ist:

Bei Verwendung als root können Sie Instanzen auch mit einem anderen Namen als dem in der Sicherung wiederherstellen. Geben Sie dazu den gewünschten Namen als Argument hinter dem Wort restore an:

Die lange Liste der Konvertierungen, die hier stattfinden, hat den gleichen Grund wie bei dem weiter oben beschriebenen Umbenennen von Instanzen: Der Name der Instanz kommt in etlichen Konfigurationsdateien vor und wird hier automatisch durch den neuen Namen ersetzt.

Die Befehle omd backup und omd restore können — in guter alter Unix-Tradition — anstelle von Dateien auch über die Standard-Ein-/Ausgabe arbeiten. Geben Sie hierzu anstelle eines Pfads für die tar-Datei einfach einen Bindestrich an (-).

Auf diese Art können Sie eine Pipe aufbauen und die Daten ohne Zwischendatei direkt auf einen anderen Rechner „streamen“. Je größer die Sicherung ist, desto nützlicher ist das, denn so wird kein temporärer Platz im Dateisystem des gesicherten Servers benötigt.

Folgender Befehl sichert eine Instanz per SSH auf einen anderen Rechner:

Wenn Sie den SSH-Zugriff umdrehen, sich also lieber vom Sicherungsserver auf die Checkmk-Instanz verbinden möchten, so geht auch das, wie folgendes Beispiel zeigt. Dazu muss zuvor ein SSH-Login als Instanz-Benutzer erlaubt werden:

Wenn Sie das geschickt mit einem omd restore kombinieren, das die Daten von der Standardeingabe liest, können Sie eine komplette Instanz im laufenden Betrieb von einem Server auf einen anderen kopieren — und das ohne irgendeinen zusätzlichen Platz für eine Sicherungsdatei:

Und jetzt nochmal das Ganze mit umgedrehtem SSH-Zugriff — diesmal wieder vom Quellsystem auf das Zielsystem: