# restore.sh

Windmill Backup Restore Worker `v1.0.8`

Wird von Windmill per SSH non-blocking auf dem Proxmox Restore-Server gestartet und läuft komplett eigenständig. Am Ende sendet es einen Webhook zurück an Windmill mit allen Messwerten.

---

## Ablauf

| Schritt | Was passiert |
|---|---|
| **[0]** Keys holen | PBS Encrypt-Keyfile + 7z-Passwort per Rsync vom PBS-Server |
| **[1]** Space-Check | Freier Platz auf `--restore-mount` prüfen |
| **[2]** VM-ID | Original-ID aus Backup-Pfad, freie Restore-ID ab 1000 |
| **[3]** qmrestore | Direkt vom PBS-PVE-Storage mit `--keyfile` |
| **[4]** VM vorbereiten | unlock → cdrom/ide0 entfernen → alle Netzwerkkarten löschen → Agent aktivieren |
| **[5]** Agent prüfen | VM starten, 120s auf qm-Agent warten (10s Schritte) — kein Agent = kein Abbruch, `qm_agent_ok=false` in DB |
| **[6]** VM stoppen | Sauberes Shutdown, nach 30s force-stop |
| **[7]** 7z | VM-Images verschlüsselt zippen (Passwort aus `password_7z.txt`) |
| **[8]** Rsync | ZIP zum Backup-Server, 3 Versuche + Größenvergleich |
| **[9]** Aufräumen | VM destroy, ZIP löschen, Keys bleiben gecacht |
| **[10]** Webhook | JSON mit allen Messwerten → Windmill |

---

## Parameter

```bash
/opt/windmill-restore/restore.sh \
  --job-uuid        'abc-123-...' \
  --backup-path     'tnp-Invest-GmbH:vm/100/2024-01-15T02:00:00Z' \
  --client          'vm/100' \
  --restore-mount   '/mnt/4TB' \
  --restore-path    'local-lvm' \
  --rsync-target    '/backup/incoming/TNP' \
  --pbs-storage     'pbs-tnp-invest-gmbh' \
  --webhook-url     'https://windmill.stines.de/...' \
  --webhook-token   '...'
```

Alle Parameter sind Pflicht — kein Fallback. Fehlt einer bricht das Script vor dem Start ab.

---

## Keys

Werden automatisch per Rsync vom PBS-Server geholt (`PBS_HOST` aus `pbs.conf`):

| Datei auf PBS-Server | Zweck | Lokal gecacht |
|---|---|---|
| `/root/Scripte/${DATASTORE}.keyfile` | PBS Encrypt-Key für `qmrestore --keyfile` | `/opt/windmill-restore/keys/${DATASTORE}.keyfile` |
| `/root/Scripte/password_7z.txt` | 7z-Passwörter pro Datastore | `/opt/windmill-restore/keys/password_7z.txt` |

Format `password_7z.txt`:
```
tnp-Invest-GmbH: Passwort123
oactec: AndersPasswort456
```

Ein Key gilt für alle VMs eines Kunden (pro Datastore). Bei mehreren VMs desselben Datastores werden die Keys nur einmal geholt.

---

## Konfiguration

`/opt/windmill-restore/pbs.conf` (chmod 600, deployt von Windmill Step C):
```bash
PBS_HOST=192.168.1.50
PBS_PORT=8007
PBS_USER=backup@pbs
PBS_PASSWORD=geheim
PBS_FINGERPRINT=AB:CD:...
```

`/opt/windmill-restore/backup_server_host`:
```
backup.stines.de
```

---

## Webhook-Payload

```json
{
  "job_uuid":               "abc-123-...",
  "client_name":            "vm/100",
  "status":                 "success",
  "error_message":          "",
  "vm_id_original":         100,
  "vm_id_restored":         1001,
  "restore_duration_sec":   120,
  "actual_disk_used_bytes": 10737418240,
  "zip_size_bytes":         5368709120,
  "zip_duration_sec":       300,
  "rsync_size_bytes":       5368709120,
  "rsync_ok":               true,
  "rsync_retries":          0,
  "qm_agent_ok":            true,
  "log_file":               "/opt/windmill-restore/logs/vm_100_20240115_001100.log"
}
```

---

## Voraussetzungen

- Proxmox VE mit `qm`, `qmrestore`, `pvesh`, `7z`
- SSH-Zugang vom Restore-Server zum PBS-Server (für Rsync der Keys)
- SSH-Zugang vom Restore-Server zum Backup-Server (für Rsync des ZIP)
- PBS als PVE-Storage registriert (wird von Windmill Step C automatisch via `pvesm add pbs` eingetragen)