handbuch
All checks were successful
Deploy mindnet to llm-node / deploy (push) Successful in 6s

This commit is contained in:
Lars 2025-12-15 08:27:52 +01:00
parent 56c1862205
commit 49dd91fee0

View File

@ -3,10 +3,10 @@ doc_type: operations_manual
audience: system_admin, devops audience: system_admin, devops
scope: server_lifecycle, disaster_recovery, maintenance, backup scope: server_lifecycle, disaster_recovery, maintenance, backup
status: active status: active
version: 1.7 version: 1.8
hostname: llm-node hostname: llm-node
ip_address: 192.168.2.144 ip_address: 192.168.2.144
context: "Zentrale Dokumentation für Host-Konfiguration, Mindnet-Applikation, Gitea und Backup-Strategie. Aktualisiert um Two-Stage Disaster Recovery." context: "Zentrale Dokumentation für Host-Konfiguration, Mindnet-Applikation, Gitea und Backup-Strategie. Aktualisiert um die Prozedur zur Erstellung und Wiederherstellung des Basis-Images."
created_date: 2025-12-14 created_date: 2025-12-14
last_updated: 2025-12-15 last_updated: 2025-12-15
--- ---
@ -149,11 +149,32 @@ on_error:
## 5. Disaster Recovery (Wiederherstellung) - Two-Stage DR ## 5. Disaster Recovery (Wiederherstellung) - Two-Stage DR
Das Wiederherstellungsverfahren basiert auf einer "Two-Stage DR"-Strategie, die die Geschwindigkeit eines Basis-Images mit der Datenkonsistenz des Borgmatic-Archives kombiniert. Das Wiederherstellungsverfahren basiert auf einer **"Two-Stage DR"**-Strategie, die die Geschwindigkeit eines Basis-Images mit der Datenkonsistenz des Borgmatic-Archives kombiniert.
### 5.1 Stage 1: Basis-Image (Bare Metal Restore) ### 5.0 Vorbereitung: Erstellung des Basis-Images (Monatlich/Quartalsweise)
Dieses Verfahren ersetzt die manuelle OS-Installation und setzt das System auf den Zustand des letzten Basis-Images zurück (inkl. OS, Users, Pakete, Mount-Einträge). **Voraussetzung ist ein identischer PC oder nur der Austausch der Festplatte.** Dieses Image sichert das bootfähige System (OS, Pakete, Konfiguration) und dient als schneller Startpunkt bei einem Festplattenausfall.
1. **System Bereinigen:** Führen Sie eine Systembereinigung durch, um die Image-Größe zu minimieren.
```bash
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).
3. **Mount NAS:** Stellen Sie die Verbindung zum NAS her, um das Image direkt dorthin zu schreiben.
```bash
sudo mkdir /mnt/nas_backup
sudo mount -t nfs 192.168.2.63:/volume1/Backup_LLM /mnt/nas_backup
```
4. **Image erstellen und streamen:** Ermitteln Sie die Root-Partition des Servers (z.B. `/dev/sda1`) und erstellen Sie das komprimierte Image direkt auf dem NAS.
```bash
# Das Image wird direkt zum NAS gestreamt (USB-Stick benötigt nur 8GB für Live OS)
sudo dd if=/dev/sda1 bs=1M status=progress | gzip > /mnt/nas_backup/base_image_$(date +%Y%m%d).img.gz
```
### 5.1 Stage 1: Basis-Image Restore (Bare Metal Recovery)
Dieses Verfahren setzt das System auf den Stand des letzten Basis-Images zurück.
**Prozedur (Von Live-Medium booten):** **Prozedur (Von Live-Medium booten):**
@ -175,11 +196,9 @@ Dieses Verfahren ersetzt die manuelle OS-Installation und setzt das System auf d
### 5.2 Stage 2: Daten-Update (Borgmatic) ### 5.2 Stage 2: Daten-Update (Borgmatic)
Nach dem Booten des wiederhergestellten Basis-Systems (Stage 1) werden die aktuellen Daten und die kritischen Applikations-Snapshots wiederhergestellt. Das OS und die User sind bereits vorhanden. Nach dem Booten des Basis-Systems (Stage 1) werden die aktuellen Daten und die kritischen Applikations-Snapshots wiederhergestellt.
#### Schritt 1: Basiskonfiguration prüfen (Entfällt nach Image Restore) #### Schritt 1: Aktueller Daten Restore (Borg)
#### Schritt 2: Aktueller Daten Restore (Borg)
Das Borg-Repository ist dank des Basis-Images bereits in `/etc/borgmatic/config.yaml` und `/etc/fstab` bekannt. Das Borg-Repository ist dank des Basis-Images bereits in `/etc/borgmatic/config.yaml` und `/etc/fstab` bekannt.
```bash ```bash
@ -187,7 +206,7 @@ Das Borg-Repository ist dank des Basis-Images bereits in `/etc/borgmatic/config.
sudo borgmatic extract --archive latest --path / --destination / sudo borgmatic extract --archive latest --path / --destination /
``` ```
#### Schritt 3: Dienste spezifisch wiederherstellen (Gitea/Qdrant/Ollama) #### Schritt 2: Dienste spezifisch wiederherstellen (Gitea/Qdrant/Ollama)
**A. Gitea (Aus Dump):** **A. Gitea (Aus Dump):**
1. Dump entpacken: `unzip /var/lib/gitea/gitea-dump.zip -d /tmp/gitea_restore` 1. Dump entpacken: `unzip /var/lib/gitea/gitea-dump.zip -d /tmp/gitea_restore`