Home ITHome ServerWazuh Update mit Docker planen und Backups wiederherstellen

Wazuh Update mit Docker planen und Backups wiederherstellen

by Dimitri Roschkowski
0 Kommentare

Wer seine Server überwacht, muss auch die Überwachung selbst pflegen. Bei Wazuh betrifft das mehrere Komponenten: Manager, Indexer, Dashboard, Agenten und die eigenen Anpassungen. Ein neuer Image-Tag allein ist noch kein kontrolliertes Update.

Ich habe meinen Docker-Stack von Wazuh 4.14.1 auf 4.14.8 aktualisiert. Vorher gab es eine Sicherung und danach Prüfungen der Datenstrecke, der Agenten und der Benachrichtigungen. Für den laufenden Betrieb habe ich zusätzlich Konfigurationsbackups und Indexer-Snapshots eingerichtet. Dieser Artikel beschreibt diesen Ablauf; die konkreten Versionswechsel müssen immer gegen die zugehörige Upgrade-Anleitung geprüft werden.

Vorher wissen, was tatsächlich läuft

Notiere die Versionen der drei zentralen Komponenten und der Agenten. In der Compose-Installation kannst du die Container und Images so ansehen:

docker compose ps
docker compose images

Prüfe zusätzlich freien Speicher und die tatsächlichen Mounts. Ein voller Datenträger kann schon vor einem Update die Aufnahme neuer Daten verhindern. Dass ein Container „running“ ist, sagt nichts darüber aus, ob der Indexer noch schreibt.

Lies die Docker-Upgrade-Anleitung und die Release Notes der Zielversion. Größere Sprünge können Zwischenschritte oder Konfigurationsänderungen erfordern. Verwende deshalb keine pauschale Suchen-und-Ersetzen-Anleitung für beliebige Versionen.

Drei verschiedene Sicherungen

Für meinen Betrieb unterscheide ich drei Ebenen:

Sicherung Was ich damit zurückholen will
Konfiguration Compose-Dateien, Zertifikate, Regeln, Decoder, Gruppen und Einstellungen
Indexer-Snapshot Indexierte Daten und gespeicherte Dashboard-Objekte im vorgesehenen Umfang
Kalte Sicherung vor dem Upgrade Konsistenter Rückweg für den konkreten Versionswechsel

Ein Tar-Archiv der Projektdateien enthält die benannten Docker-Volumes nicht automatisch. Eine laufende Datenbankdatei ist umgekehrt nicht schon deshalb konsistent, weil sie erfolgreich kopiert wurde.

Die Backups enthalten Zugangsdaten, Zertifikatsschlüssel und möglicherweise personenbezogene Logs. Ich halte sie in einem geschützten Verzeichnis. Für eine externe Kopie gehört auch der Transport- und Speicherschutz zur Planung.

Indexer mit seiner Snapshot-Funktion sichern

Für OpenSearch-Daten verwende ich ein registriertes Snapshot-Repository. Der Indexer benötigt dafür den passenden Repository-Pfad in seiner Konfiguration und einen tatsächlich eingebundenen, beschreibbaren Speicherort. Erst dann kann eine Snapshot-Policy erfolgreich schreiben. OpenSearch-Snapshots

Bei mir laufen täglich Konfigurationsbackups und ein geplanter Indexer-Snapshot. Die Aufbewahrung ist begrenzt und der Sicherungsort liegt auf dem Unraid-Array. Das schützt nicht vor einem Totalausfall desselben Servers; eine zusätzliche externe Kopie bleibt eine eigene Aufgabe.

Ich prüfe nicht nur das Vorhandensein eines Snapshot-Namens, sondern dessen Abschlussstatus und Fehler. Für die Konfigurationssicherung werden SQLite-Datenbanken über einen konsistenten Sicherungsweg kopiert und auf Lesbarkeit geprüft.

Eine Wiederherstellung ausprobieren

Vor dem Upgrade habe ich aus einem Snapshot einen Dashboard-Index unter einem separaten Testnamen wiederhergestellt und die erwarteten Dashboard-Objekte geprüft. Der Testindex wurde danach wieder entfernt. Damit war die Wiederherstellung dieses Teilbestands nachgewiesen.

Das ist ein hilfreicher Test, aber noch kein vollständiger Wiederaufbau auf leerer Hardware. Dafür müssten auch Containerkonfiguration, Zertifikate, Managerdaten, Indexer, Rechte und Verbindungen auf einem getrennten Ziel gemeinsam wieder funktionieren. Ich kennzeichne diese Grenze ausdrücklich, statt einen erfolgreichen Teiltest als vollständigen Notfallplan auszugeben.

Den Versionswechsel durchführen

Für einen geplanten Wechsel sichere ich zuerst den Ausgangsstand und schließe laufende Sicherungen ab. Dann vergleiche ich die originale Compose-Konfiguration der Zielversion mit meinen lokalen Anpassungen. Portbindungen, Speicherpfade und eigene Einstellungen dürfen dabei nicht verloren gehen.

Nach den für den jeweiligen Wechsel nötigen Anpassungen folgen in der vorbereiteten Projektkopie:

docker compose config --quiet
docker compose pull
docker compose up -d
docker compose ps

Diese vier Befehle ersetzen nicht die Prüfung des Upgradepfads. Sie starten nur die zuvor kontrollierte Zielkonfiguration. Benutze dabei kein docker compose down -v: Das Entfernen der Volumes würde gerade den persistenten Bestand gefährden, den du behalten möchtest.

Nach dem Start die Datenstrecke kontrollieren

Ich prüfe nacheinander den Indexer-Zustand, die Managerdienste, die Anmeldung am Dashboard und frische Ereignisse. Anschließend folgen Agentenstatus und Gruppensynchronisierung. Erst danach aktualisiere ich die Agenten entsprechend dem freigegebenen Verfahren.

Ein grüner Single-Node-Cluster ist möglich, ohne eine zweite Datenkopie auf einem anderen Server zu besitzen. Die Replikakonfiguration muss zur Knotenzahl passen. Sie ist kein Ersatz für Backups und keine versteckte Hochverfügbarkeit.

Zum Abschluss teste ich die Telegram-Strecke, kontrolliere die nächste Sicherung und schaue nach fehlgeschlagenen oder stehen gebliebenen Monitoren. Eine erreichbare Loginseite ist für mich noch kein abgeschlossener Funktionstest.

Betriebsübersicht meiner Wazuh-Installation
Die Liste meiner offenen Punkte ist für den Artikel unkenntlich gemacht.

Aufbewahrung bewusst festlegen

Unbegrenzte Aufbewahrung ist auf einem einzelnen Homelab-Host keine gute Voreinstellung. Bei mir werden Ereignisindizes zeitlich begrenzt aufbewahrt; aktuelle Zustandsindizes werden davon getrennt behandelt. Andernfalls könnte eine pauschale Löschregel ausgerechnet den aktuellen Inventarbestand entfernen.

Plane Roharchive, Alerts, Monitoringdaten, Snapshots und Konfigurationsbackups jeweils nach ihrem Zweck. Beobachte das tatsächliche Wachstum und prüfe, ob die ältesten vorgesehenen Daten auch wirklich gelöscht werden. Ein konfigurierter Löschplan und ein nachgewiesener Löschlauf sind nicht dasselbe.

Ein unabhängiger Wächter bleibt notwendig

Wazuh kann einige eigene Ausfälle melden, solange Indexer und Benachrichtigung noch arbeiten. Für den Totalausfall meines Wazuh-Hosts gibt es deshalb eine zusätzliche Kontrolle in Zabbix. Der dortige Sammler verwendet separate Lesekonten und prüft die Serverzertifikate.

Die Telegram-Einrichtung und das Zabbix-Dashboard ergänzen diesen Ablauf. Mir geht es dabei um eine nachvollziehbare Betriebskette: Daten kommen an, Probleme werden bewertet, Nachrichten erreichen mich und ein getesteter Rückweg steht bereit.

You may also like

Hinterlasse einen Kommentar