diff --git a/docs/04_Operations/04_server_operation_manual.md b/docs/04_Operations/04_server_operation_manual.md index 5608913..e28cb92 100644 --- a/docs/04_Operations/04_server_operation_manual.md +++ b/docs/04_Operations/04_server_operation_manual.md @@ -1,12 +1,12 @@ --- doc_type: operations_manual audience: system_admin, devops -scope: server_lifecycle, disaster_recovery, maintenance, backup +scope: server_lifecycle, disaster_recovery, maintenance, backup, monitoring status: active -version: 1.8 +version: 1.9 hostname: llm-node ip_address: 192.168.2.144 -context: "Zentrale Dokumentation für Host-Konfiguration, Mindnet-Applikation, Gitea und Backup-Strategie. Aktualisiert um die Prozedur zur Erstellung und Wiederherstellung des Basis-Images." +context: "Zentrale Dokumentation für Host-Konfiguration, Mindnet-Applikation, Gitea und Backup-Strategie. Aktualisiert um die Two-Stage Disaster Recovery und Backup-Monitoring." created_date: 2025-12-14 last_updated: 2025-12-15 --- @@ -160,7 +160,7 @@ Dieses Image sichert das bootfähige System (OS, Pakete, Konfiguration) und dien sudo apt clean sudo journalctl --vacuum-time=7d ``` -2. **Booten vom Live-Medium:** Starten Sie den Server von einem **Ubuntu Live USB-Stick** (oder einem ähnlichen Tool wie Clonezilla). +2. **Booten vom Live-Medium:** Starten Sie den Server von einem **Ubuntu Live USB-Stick** (Größe min. 8 GB). 3. **Mount NAS:** Stellen Sie die Verbindung zum NAS her, um das Image direkt dorthin zu schreiben. ```bash sudo mkdir /mnt/nas_backup @@ -237,7 +237,45 @@ Das Tar-Archiv liegt im Home-Verzeichnis (`/home/llmadmin/`) und muss in das Vol --- -## 6. Log- und Fehleranalyse +## 6. Log- und Fehleranalyse & Wartung -* **Backup-Logs:** `journalctl -u borgmatic` -* **Qdrant Container Logs:** `docker logs qdrant` \ No newline at end of file +### 6.1 Backup-Überwachung (Monitoring) + +Die Überprüfung der Backup-Korrektheit erfolgt über das Systemd Journal und die Borgmatic-Befehle. + +| Aktion | Befehl | Zweck | +| :--- | :--- | :--- | +| **Prüfung letzter Lauf** | `sudo journalctl -u borgmatic --since "yesterday"` | Zeigt das Journal der letzten 24 Stunden, inklusive der Hooks und Fehler. | +| **Liste Archive** | `sudo borgmatic list` | Zeigt alle existierenden Archive, sortiert nach Datum/Uhrzeit. Dient zur Bestätigung, dass das Backup erstellt wurde. | +| **Repo-Integrität** | `sudo borgmatic check` | Führt eine Konsistenzprüfung des gesamten Repositorys durch (kann lange dauern). | + +### 6.2 Granulare Wiederherstellung (Einzelne Dateien) + +Um auf einzelne Dateien oder Verzeichnisse in einem Archiv zuzugreifen, wird das Archiv als virtuelles Dateisystem gemountet. + +1. **Mount-Punkt erstellen:** + ```bash + mkdir /tmp/borg_mount + ``` +2. **Archiv einhängen:** Hängen Sie das gewünschte Archiv (hier: `latest`) in den Mount-Punkt ein. Geben Sie bei Bedarf den vollständigen ARCHIVNAMEN an. + ```bash + sudo borgmatic mount --destination /tmp/borg_mount --archive latest + ``` +3. **Dateizugriff:** Das gesamte Backup-Dateisystem ist nun unter `/tmp/borg_mount` verfügbar. Dateien können mit `cp` kopiert werden. + ```bash + # Beispiel: Eine Datei aus dem Home-Verzeichnis wiederherstellen + sudo cp /tmp/borg_mount/home/llmadmin/wichtige_datei.txt /home/llmadmin/ + ``` +4. **Archiv aushängen:** Nach dem Kopieren muss das virtuelle Dateisystem immer ausgehängt werden. + ```bash + sudo umount /tmp/borg_mount + # Oder: + # sudo borgmatic umount /tmp/borg_mount + ``` + +--- + +## 7. Anhang + +* **Qdrant Container Logs:** `docker logs qdrant` +* **Applikations-Logs:** `journalctl -u mindnet-prod` \ No newline at end of file