handbuch

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`
+### 6.1 Backup-Überwachung (Monitoring)
-* **Qdrant Container Logs:** `docker logs qdrant`
+
+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`