diff --git a/docs/betrieb-backup-restore.md b/docs/betrieb-backup-restore.md index 715ecc2..8d2e41a 100644 --- a/docs/betrieb-backup-restore.md +++ b/docs/betrieb-backup-restore.md @@ -61,17 +61,38 @@ systemctl start kc-backup && journalctl -u kc-backup -n 30 --no-pager -o cat Ein ausgefallenes Ziel lässt den Lauf als Fehler zählen (Meldung), das lokale Backup bleibt erhalten. ## Wiederherstellung (Notfall) -1. Neuer/repariertes Server mit MariaDB, Node und `age`; Kundencenter-Code nach `/srv/kundencenter` (Repo), `pnpm install && pnpm build`. -2. Sicherungsdatei holen (lokal, Ziel) und den **privaten Schlüssel** bereitlegen. +Voraussetzung: das **Backup-Passwort** (Einstellungen → Backup) bzw. bei Alt-Sicherungen der private age-Schlüssel – getrennt vom Server und vom Ziel verwahrt (#65). + +1. Neuer/reparierter Server mit MariaDB, Node 24, pnpm, `gpg` (und `age` für Alt-Sicherungen); Code nach `/srv/kundencenter`, `pnpm install --frozen-lockfile && pnpm build` (als Benutzer `kundencenter`), systemd-Units aus `ops/systemd/` installieren. +2. Sicherungsdatei vom Ziel holen (z. B. KeyDisc), Dateiname `kundencenter-DATUM-….tar.gz.gpg` (Alt: `….tar.gz.age`). 3. Entschlüsseln und entpacken: ```bash - age -d -i backup-age-key.txt -o archive.tar.gz kundencenter-DATUM-....tar.gz.age - mkdir restore && tar -xzf archive.tar.gz -C restore # enthält db.sql, config/*.env, manifest.json + gpg --decrypt -o archive.tar.gz kundencenter-DATUM-….tar.gz.gpg # fragt das Backup-Passwort + # Alt-Sicherung: age -d -i backup-age-key.txt -o archive.tar.gz kundencenter-DATUM-….tar.gz.age + mkdir restore && tar -xzf archive.tar.gz -C restore # db.sql, config/*.env, manifest.json, ticket-attachments/ ``` -4. Konfiguration zurück: `cp restore/config/*.env /etc/kundencenter/` (chmod 600), Datenbank und Benutzer anlegen (nur Rechte auf `kundencenter`). -5. Datenbank einspielen: `mysql -u… -p kundencenter < restore/db.sql` -6. Dienste starten (`kc-api`, `kc-worker`, `kc-web`), prüfen: `/v1/ready`, Anmeldung, Übersicht, **Audit-Protokoll → „Integrität prüfen“**. -7. Erwartung: Datenverlust höchstens bis zum letzten Backup (bis zu 24 h), Wiederherstellung ca. 30 Minuten. +4. Konfiguration zurück: `cp restore/config/*.env /etc/kundencenter/` (root, chmod 600). `KC_SECRET_KEY` muss der gesicherte sein, sonst sind 2FA-Geheimnisse und Zugangsdaten unlesbar. +5. Datenbank anlegen (`utf8mb4_unicode_ci`) und einspielen. Trigger der Audit-Tabelle tragen einen DEFINER – bei einem anderen DB-Benutzer vorher entfernen (gleiche Regel wie der automatische Restore-Test): + ```bash + sed -E 's#/\*!50017 DEFINER=`[^`]*`@`[^`]*`\*/ ?##g; s# DEFINER=`[^`]*`@`[^`]*`##g' restore/db.sql | mysql -u -p + ``` +6. Anhänge zurück: `cp -a restore/ticket-attachments /var/lib/kundencenter/` (Eigentümer `kundencenter`). Anzahl/Größe mit `manifest.json → attachments` vergleichen. +7. `pnpm migrate` (wendet nur Neueres an), Dienste starten, prüfen: `/v1/ready`, Anmeldung, Übersicht (Betriebsalarme leer, Worker-Herzschlag frisch), **Audit-Protokoll → „Integrität prüfen“**, ein Ticket-Anhang öffnen. +8. Erwartung: Datenverlust höchstens bis zum letzten Backup (bis zu 24 h), Wiederherstellung ca. 30–60 Minuten. + +Der wöchentliche automatische Wiederherstellungstest prüft die Schritte 3, 5 und 6 in der Wegwerf-Datenbank `kundencenter_restoretest` (Prüfsummen, Zeilenzahlen, Migrationen, Audit-Kette, Anhänge laut Manifest, Lesbarkeit der Geheimnisse). + +## Dienste, Health und Wiederanlauf + +| Dienst | Start nach | Health | Neustart | Logs | +|---|---|---|---|---| +| `kc-api` (:4100) | network-online, mariadb | `GET /v1/health` (lebt), `/v1/ready` (DB) | `Restart=always`, 3 s | `journalctl -u kc-api` | +| `kc-worker` | network-online, mariadb, kc-api | `127.0.0.1:4102/health` (Schleife), `/ready` (+DB); Herzschlag in `system_heartbeats` | `Restart=always`, 3 s | `journalctl -u kc-worker` | +| `kc-web` (:4101) | network-online, kc-api | HTTP 200 auf `/login` | `Restart=always`, 3 s | `journalctl -u kc-web` | +| `kc-backup.timer` / `kc-restore-test.timer` | – | `backup-status.json`, Dashboard | Persistent (holt nach) | `journalctl -u kc-backup` | +| `kc-backup-request.path` | – | Anfragen aus der Oberfläche | – | `journalctl -u kc-backup-request` | + +Nach einem Host-Neustart starten alle Dienste automatisch (enabled). Reihenfolge: MariaDB → API → Worker/Web. Ist die DB beim Start noch nicht bereit, beendet sich der Prozess und systemd startet ihn nach 3 s neu. Ausfälle melden die Betriebsalarme (Abschnitt unten); ein ausgefallener Worker wird von der API per Mail gemeldet. ## Vor größeren Änderungen Vor Migrationen oder Updates manuell sichern: `systemctl start kc-backup`. Rollback einer fehlerhaften Migration = Wiederherstellung (Abschnitt oben) in eine Wegwerf-Datenbank prüfen, dann produktiv einspielen.