74 lines
2.5 KiB
Markdown
74 lines
2.5 KiB
Markdown
# Backup und Wiederherstellung
|
|
|
|
## Athena
|
|
|
|
`mike-ai-backup` erzeugt alle fünf Stunden ein Archiv unter
|
|
`/data/docker-backups` und behält 14 Tage. Gesichert werden:
|
|
|
|
- `/etc/mike-ai` mit lokaler Konfiguration,
|
|
- Router-Zustand und erzeugte Bilder,
|
|
- Piper-Daten,
|
|
- der kanonische Stack als zusätzlicher Snapshot.
|
|
|
|
Nicht in das Archiv gehören die großen Modellgewichte unter `/data/models`.
|
|
Sie bleiben auf der Daten-SSD oder werden anhand der gepinnten Angaben in
|
|
`config/install.env.example` erneut geladen. Die Dashboard-Historie liegt
|
|
dauerhaft unter `/data/llama-dashboard`.
|
|
|
|
Der optionale Portainer-Container gehört nicht zum Athena-Kern. Seine lokale
|
|
Konfiguration liegt im Docker-Volume `portainer_data`; ohne dessen Sicherung
|
|
kann Portainer jederzeit neu angelegt und einmalig eingerichtet werden, ohne
|
|
Router, Modelle oder Dashboard-Daten zu verlieren.
|
|
|
|
### Neuaufbau
|
|
|
|
1. Debian installieren und `/data` wieder am bisherigen Pfad einhängen.
|
|
2. Dieses Repository klonen.
|
|
3. Installationsdatei ausfüllen und Installation starten:
|
|
|
|
```bash
|
|
sudo ./install.sh --config /root/mike-ai-install.env
|
|
```
|
|
|
|
4. Letztes Datenarchiv einspielen:
|
|
|
|
```bash
|
|
sudo ./restore.sh --check /data/docker-backups/athena-latest.tar.gz
|
|
sudo ./restore.sh /data/docker-backups/athena-latest.tar.gz
|
|
sudo ./smoke-test.sh
|
|
```
|
|
|
|
`--check` liest das komplette gzip-Archiv und prüft dessen sichere
|
|
`/backup`-Struktur sowie die benötigten Konfigurations- und Volume-Bäume, ohne
|
|
Container oder Dateien zu verändern. Der reguläre Restore extrahiert und
|
|
verwendet anschließend ausschließlich diesen einen geprüften Baum.
|
|
|
|
Das Restore verändert weder SSH noch LAN, WireGuard, Kernel, Partitionen oder
|
|
Mounts.
|
|
|
|
## Unraid
|
|
|
|
Hermes und die Fach-MCPs sind kein Bestandteil des Athena-Backups. Sie werden
|
|
durch das vorhandene Unraid-Appdata-Backup gesichert:
|
|
|
|
- `/mnt/nvme-storage/appdata/Hermes-Agent`
|
|
- die jeweiligen Appdata-Verzeichnisse der MCP-Container
|
|
- DockerMan-Templates unter
|
|
`/boot/config/plugins/dockerMan/templates-user/`
|
|
|
|
Container-Images stammen aus den dokumentierten Registries beziehungsweise den
|
|
eigenen Gitea-Repositories. Damit besteht die Wiederherstellung aus
|
|
Appdata-Restore plus Neuerstellung über die jeweilige Template-XML.
|
|
|
|
## Kontrolle
|
|
|
|
```bash
|
|
docker compose --env-file /etc/mike-ai/stack.env ps
|
|
sudo ./restore.sh --check /data/docker-backups/athena-latest.tar.gz
|
|
curl -fsS http://192.168.1.212:8099/health
|
|
sudo ./smoke-test.sh
|
|
```
|
|
|
|
Anschließend einen Hermes-Chat, einen Router-Aufruf und je eine kleine
|
|
read-only-Abfrage der benötigten MCPs testen.
|