Updates und Upgrades

Bei einem Update auf eine Major-Version sollten Sie immer direkt auf die nächste Version aktualisieren und nicht einfach welche überspringen. Wenn Sie also beispielsweise von 1.6.0 auf 2.1.0 aktualisieren wollen, aktualisieren Sie zunächst auf die 2.0.0. Der Grund ist simpel: Zwischen zwei Major-Versionen gibt es bisweilen schlicht so viele Änderungen, dass es beim Überspringen zu Problemen kommen kann. Diese Empfehlung setzt omd update durch eine Sperre um und gibt gegebenenfalls eine entsprechende Warnmeldung aus. Dennoch können Sie ein solches Updates durchführen, indem Sie den Vorgang mit der Option -f erzwingen:

Achtung: Auf diese Weise aktualisierte Instanzen werden von uns nicht mehr unterstützt!

Der Befehl update ermöglicht auch Downgrades zwischen Major-Versionen, allerdings sind viele Anpassungen nötig, um Konfiguration und Laufzeitumgebung wieder kompatibel zu machen. Daher raten wir von diesem Vorgehen ab und können auch hier keinen Support mehr bieten.

Mit lokalen Dateien können Sie die von Checkmk bereitgestellte Funktionalität anpassen und erweitern. Diese Dateien befinden sich im lokalen Teil der Instanzverzeichnisstruktur, d. h. in ~/local. Lokale Dateien können bei einem Update Probleme bereiten, da sie eventuell nicht mehr zur neuen Checkmk-Version passen.

Da es für Checkmk bei einem Update nicht möglich ist, die lokalen Anpassungen und jede von einem Drittanbieter hergestellte Erweiterung abzufangen und zu behandeln, sollten Sie Ihre Checkmk-Instanz vor einem Update daraufhin überprüfen, ob lokale Dateien bei Ihnen verwendet werden und gegebenenfalls welche.

Verschaffen Sie sich einen Überblick über die lokalen Dateien Ihrer Checkmk-Instanz, indem Sie als Instanzbenutzer das folgende Kommando ausführen (bei dem die Option -L dafür sorgt, dass auch symbolischen Links gefolgt wird):

In einer frischen Installation von Checkmk wird Ihnen derzeit nur eine Datei namens README.TXT aufgelistet. Alles, was darüber hinaus angezeigt wird, sollte ganz oben auf Ihrer Liste zur Fehlerdiagnose stehen, falls es beim Update Probleme gibt.

Über die Checkmk Erweiterungspakete (MKPs) lässt sich Ihr Monitoringsystem recht einfach und bequem erweitern. Auf der einen Seite kommt es dabei vor, dass solche MKPs nicht weiter gepflegt werden und dann ggf. mit neuen Versionen von Checkmk nicht mehr kompatibel sind. Auf der anderen Seite nehmen wir immer wieder neue Plugins und Funktionserweiterungen in Checkmk auf, weshalb MKPs mitunter obsolet werden. Ihre Funktionalität wird schlicht von Checkmk selbst sichergestellt.

Falls Sie MKPs installiert haben, ist aus diesem Grund eine Prüfung dieser MKPs dringend geboten. So verhindern Sie, dass inkompatible Pakete das Update behindern oder im Anschluss an das Update doppelte oder zumindest sehr ähnliche Services entstehen.

Prüfen Sie hierzu Ihre installierten MKPs gegen unseren Katalog der Checkplugins und entfernen Sie Pakete, welche inzwischen nativ von Checkmk bereitgestellt werden. Bei dieser Gelegenheit können Sie auch MKPs entfernen, die eventuell nur mal für einen Probelauf installiert worden sind. Eine Auflistung finden Sie im Setup-Menü unter Maintenance > Extension packages. Auf der Kommandozeile können Sie sich installierte Erweiterungen und auch unpaketierte Dateien mit den folgenden Befehlen anzeigen lassen:

Überprüfen Sie die Ausgaben dieser Befehle auf Erweiterungen und Dateien, die nicht mehr benötigt werden oder die Sie gar nicht mehr zuordnen können. Um deren Einfluss auf das Update zu prüfen, können Sie Kopien dieser Erweiterungen und Dateien anlegen und zumindest vorübergehend aus Ihrer Checkmk-Instanz entfernen.

Wie in der Einleitung beschrieben, ist der erste Schritt beim Update die Installation der gewünschten neuen Version von Checkmk. Dies erfolgt genau wie bei der ersten Installation  —  allerdings wird es wohl etwas schneller gehen, weil die meisten abhängigen Pakete jetzt schon installiert sind. In folgendem Beispiel installieren wir das Paket für Ubuntu 20.04 (Focal Fossa):

Hinweis: Wenn Sie ein lokal vorliegendes Paket mit apt install installieren, müssen Sie den vollständigen Pfad zu der .deb-Datei angeben.

Die Liste der installierten Checkmk-Versionen können Sie jederzeit mit dem Befehl omd versions abrufen:

Eine dieser Versionen ist mit (default) markiert. Diese Defaultversion wird automatisch beim Anlegen von neuen Instanzen verwendet, sofern Sie nicht mit omd -V myversion create mysite eine andere angeben. Die aktuelle Defaultversion können Sie mit omd version abfragen und mit omd setversion ändern:

Beim Verwalten bestehender Instanzen spielt die Defaultversion keine Rolle. Der omd-Befehl startet immer mit der Version, die zur Instanz passt, für die der Befehl aufgerufen wird.

Eine Auflistung der aktuellen Instanzen und welche Versionen diese verwenden liefert der Befehl omd sites:

Nachdem die gewünschte neue Version installiert ist, können Sie das Update der Instanz durchführen. Dazu sind keine root-Rechte erforderlich. Machen Sie das Update am besten als Instanzbenutzer:

Stellen Sie sicher, dass die Instanz gestoppt ist:

Das Updaten — also eigentlich das Umschalten auf eine andere Version — geschieht nun einfach mit dem Befehl omd update:

Falls es mehr als eine mögliche Zielversion gibt, bekommen Sie diese zur Auswahl:

Bestätigen Sie in der folgenden Dialogbox das gewählte Update auf die neue Version:

Beim Update von einer Raw Edition auf eine der Checkmk Enterprise Editions werden Sie sicherheitshalber noch einmal auf diesen Umstand hingewiesen:

Ein wichtiger Teil des Updates ist das Aktualisieren von mitausgelieferten Konfigurationsdateien. Dabei werden von Ihnen evtl. vorgenommene Änderungen in diesen Dateien nicht einfach verworfen, sondern zusammengeführt. Dies funktioniert sehr ähnlich zu Versionskontrollsystemen, die versuchen, gleichzeitige Änderungen mehrerer Entwickler in der gleichen Datei automatisch zusammenzuführen.

Manchmal — wenn die Änderungen die gleiche Stelle der Datei betreffen — funktioniert das nicht und es kommt zu einem Konflikt. Wie Sie diesen lösen können, zeigen wir weiter unten.

Das Update zeigt eine Liste aller angepassten Dateien und Verzeichnisse (im folgenden Beispiel gekürzt):

Wenn alles erfolgreich durchgelaufen ist, ist die Instanz auf die neue Version umgeschaltet:

… und kann gestartet werden:

Software-Entwicklung bedeutet Änderung. Und da wir immer daran arbeiten, Checkmk modern zu halten, kommen wir manchmal nicht drumherum, alte Zöpfe abzuschneiden und Änderungen zu machen, die inkompatibel sind. Das bedeutet, dass Sie nach einem Update eventuell Ihre Konfiguration anpassen oder wenigstens überprüfen sollten.

Ein typisches Beispiel dafür sind neue Check-Plugins, die bestehende Plugins ersetzen. Falls Sie eines der betroffenen Plugins einsetzen, ist nach dem Update eine erneute Serviceerkennung auf den betroffenen Hosts notwendig.

Eine Übersicht über alle Änderungen in Checkmk inklusive einer Suchfunktion finden Sie online in unseren Werks.

Noch praktischer ist aber die in Checkmk eingebaute Funktion zur Recherche in den Release Notes. Nachdem Sie sich an der Instanz angemeldet haben, finden Sie im Help-Menü den rot hinterlegten Link:

Checkmk verfolgt die beim Update von der ursprünglichen zur aktuellen Version angefallenen inkompatiblen Änderungen und fordert Sie auf, diese zu überprüfen und dann zu bestätigen (acknowledge):

Sie können jedes „Werk“ einzeln aufrufen, ansehen, per Mausklick bestätigen — und damit die Zahl der offenen inkompatiblen Änderungen sukzessive verringern. Zusätzlich können Sie mit dem Filter-Knopf die Filterleiste einblenden und haben so Zugriff auf die komplette Historie der Änderungen.

Sind Sie neugierig, was beim Update genau „unter der Haube abläuft“? Oder haben Sie beim Durchlauf von omd update Konflikte in Dateien bekommen? Dann sollten Sie hier weiterlesen.

Bei omd update geschehen drei Dinge:

Möchten Sie das Software-Update von Checkmk automatisieren? Dann werden Sie vielleicht erstmal an den interaktiven Rückfragen von omd update gescheitert sein. Dafür gibt es eine einfache Lösung: Der Befehl kennt nämlich Optionen, die speziell für den Einsatz in Skripten gedacht sind:

Mögliche Werte für --conflict= sind:

Ein Beispiel für den kompletten Befehl für ein automatisches Update der Instanz mysite auf die Version 2.1.0p1.cee:

Durch das && vor dem omd start wird ein Starten der Instanz verhindert, falls das omd update mit einem Fehler abbricht. Ersetzen Sie das && durch ein Semikolon (;), falls Sie einen Start auch in diesem Fall unbedingt versuchen wollen.

Falls Sie sicher sind, dass Sie nur eine einzige Checkmk-Instanz auf dem Server haben, können Sie deren Namen zur Verwendung in einem Shellskript einfach in einer Variable einfangen:

Das ermöglicht Ihnen, obige Zeile vom Namen der Instanz unabhängig zu machen. Ein kleines Shellskript könnte z.B. so aussehen:

Auch die Appliance der Free Edition können Sie ohne Datenverlust auf eine Vollversion einer der Enterprise Editions upgraden:

Auch ein Upgrade der Checkmk Raw Edition auf eine der Enterprise Editions ist möglich. Auch hier ist das Vorgehen wie gehabt: Gewünschtes Paket installieren und Instanzen mit omd update umstellen.

Da der Raw Edition etliche Module und Features der Enterprise Editions fehlen, gibt es allerdings nach der Umstellung ein paar Dinge zu beachten. Der entscheidende Punkt ist, dass beim Anlegen von neuen Instanzen der Raw Edition bzw. Enterprise Editions unterschiedliche Defaulteinstellungen gesetzt werden.

Da die Raw Edition nur Nagios als Kern unterstützt, ist dieser bei Instanzen voreingestellt, die mit der Raw Edition erstellt wurden. Diese Einstellung bleibt beim Upgrade auf die Checkmk Enterprise Standard Edition erhalten. Das bedeutet, dass Sie nach einem Upgrade zunächst weiterhin mit Nagios als Kern fahren. Eine Umstellung auf den CMC erfolgt mit omd config und wird in einem eigenen Artikel beschrieben.

Die Enterprise Editions unterstützen ein alternatives Format für die Speicherung historischer Messdaten, welches deutlich weniger Platten-I/O erzeugt. Bei neuen Enterprise Editions-Instanzen ist dies automatisch voreingestellt. Raw Edition-Instanzen werden auch hier beim Upgrade nicht automatisch umgestellt. Wie das Umstellen geht, beschreibt ein eigener Abschnitt im Artikel über Messwerte und Graphen.

Die Raw Edition hat keinen Benachrichtigungs-Spooler. Deswegen ist dieser nach dem Umstieg auf eine der Enterprise Editions ausgeschaltet. Wie dieser eingeschaltet werden kann, erfahren Sie hier.

Das Deinstallieren von nicht mehr benötigten Checkmk-Versionen geschieht mit dem Paketmanager des Betriebssystems. Geben Sie hier den Namen des installierten Pakets an, nicht den Dateinamen der ursprünglichen RPM/DEB-Datei. Wichtig: Löschen Sie nur solche Checkmk-Versionen, die von keiner Instanz mehr verwendet werden!

Nicht mehr benötigte Checkmk-Instanzen können Sie einfach mit omd rm entfernen (und dabei alle Daten löschen!):

So finden Sie bei RPM-basierten Systemen heraus, welche Checkmk-Pakete installiert sind:

Das Löschen geschieht mit rpm -e:

So finden Sie heraus, welche Pakete installiert sind:

Die Deinstallation geschieht mit dpkg --purge: