Updates und Upgrades

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 Sites verwendet, sofern Sie nicht mit omd -V myversion create mysite eine andere angeben. Bei der Arbeit mit bestehenden Sites ist sie nicht relevant. Die aktuelle Defaultversion können Sie mit omd version abfragen und mit omd setversion ändern:

Beim Akualisieren oder Verwalten von bestehenden Instanzen spielt die Defaultversion keine Rolle. Der omd-Befehl startet immer automatisch in der zur angegebenen Instanz passenden Version.

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:

Beim Update von einer Raw Edition auf die Checkmk Enterprise Standard Edition 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:

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

Softwareentwicklung 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, welche 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 Versionshinweisen. Zu diesen gelangen Sie mit einem Klick auf die Versionsnummer links oben in der Seitenleiste:

Checkmk verfolgt dabei automatisch neue inkompatible Änderungen und warnt Sie entsprechend:

Sie können diese „Werks“ dann ansehen und mit einem Mausklick bestätigen. Außerdem finden Sie eine Auflistung über die komplette Historie der Änderungen inklusive einer Suchfunktion:

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 Softwareupdate 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 1.6.0p13.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 eine Demo-Appliance können Sie ohne Datenverlust auf eine Vollversion mit 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, die mit der Raw Edition erstellt wurden voreingestellt. 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 Alarmspooler. 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: