# Miyagi-Sicherung Stand 11/2026 - ZFS Replikation und Proxmox Backup aus der Deckung

<div class="container-fluid px-0 miyagi-guide" id="bkmrk-sysops.tv-%C2%B7-praxiswo"><header>sysops.tv · Praxisworkshop 16. + 18. März 2026 · Stand: 22. November 2026

# Komplette Miyagi-Sicherung ab dem Blech

<span style="color: rgb(0, 0, 0);">Proxmox VE auf **4 × 2 TB SSD (RAIDZ1)**, PBS im LXC, ZFS-Pull-Replikation, Miyagi, Checkmk, Wake-on-LAN und Restore.</span>

<div class="warn"><span style="color: rgb(0, 0, 0);">**Netzplan:** Quell-PVE `192.168.168.21` · Miyagi `192.168.168.250` · PBS `192.168.168.252` · Domäne `sysops.tv`. Gateway/DNS `192.168.168.1` ist nur eine Annahme. **Achtung:** Diese Anleitung enthält destruktive Installations- und ZFS-Befehle; Gerät und Daten vor Ausführun</span>g prüfen.</div></header><details><summary>Kapitelübersicht einblenden</summary>

<div class="navlinks">[1. Ziel und technische Architektur](#bkmrk-1.-ziel-und-technisc)[2. Hardware und Vorprüfung](#bkmrk-2.-hardware-und-vorp)[3. Proxmox VE auf RAIDZ1 installieren](#bkmrk-3.-proxmox-ve-auf-ra)[4. Proxmox-Grundkonfiguration und SSH absichern](#bkmrk-4.-proxmox-grundkonf)[5. sysops/Bashclub Postinstaller](#bkmrk-5.-sysops%2Fbashclub-p)[6. Replikationsziel als ZFS-Dataset](#bkmrk-6.-replikationsziel-)[7. PBS mit der Zamba LXC Toolbox installieren](#bkmrk-7.-pbs-mit-der-zamba)[8. SSH und 2FA für PBS](#bkmrk-8.-ssh-und-2fa-f%C3%BCr-p)[9. PBS-Backup-Benutzer und Token einrichten](#bkmrk-9.-pbs-backup-benutz)[10. PBS als Storage in der Quelle eintragen](#bkmrk-10.-pbs-als-storage-)[11. ZFS auf dem Quell-PVE markieren](#bkmrk-11.-zfs-auf-dem-quel)[12. Miyagi herunterladen und konfigurieren](#bkmrk-12.-miyagi-herunterl)[13. Erster manueller Komplettlauf](#bkmrk-13.-erster-manueller)[14. Automatik: Wake-on-LAN, Cron und Shutdown](#bkmrk-14.-automatik%3A-wake-)[15. Checkmk und Piggyback](#bkmrk-15.-checkmk-und-pigg)[16. Restore: PBS und direktes ZFS-Replikat](#bkmrk-16.-restore%3A-pbs-und)[17. Abschluss-Checkliste](#bkmrk-17.-abschluss-checkl)[18. Referenzen](#bkmrk-18.-referenzen-bashc)</div></details><div class="row"><div class="col-md-12"><section class="panel" id="bkmrk-1.-ziel-und-technisc">## 1. Ziel und technische Architektur

[![image.png](https://aow.de/uploads/images/gallery/2026-11/scaled-1680-/image.png)](https://aow.de/uploads/images/gallery/2026-11/image.png)

Wir bauen einen dedizierten Miyagi-Backup-Host auf **vier 2-TB-SSDs im ZFS-RAIDZ1** auf. Proxmox VE läuft auf diesem RAIDZ1, darin arbeitet ein Proxmox Backup Server (PBS) als LXC. Drei Produktiv-PVE-Hosts werden gesichert. Miyagi koordiniert die Sicherungsläufe, PBS, optional Zsync, Wartung, Monitoring und Shutdown.

### Netzwerkplan · sysops.tv

<div class="panel"><table><tbody><tr><th>Rolle</th><th>DNS-Name</th><th>IP</th></tr><tr><td>Produktiv-PVE 1</td><td>`pve21.sysops.tv`</td><td>`192.168.168.21`</td></tr><tr><td>Produktiv-PVE 2</td><td>`pve22.sysops.tv`</td><td>`192.168.168.22`</td></tr><tr><td>Produktiv-PVE 3</td><td>`pve23.sysops.tv`</td><td>`192.168.168.23`</td></tr><tr><td>Miyagi-Host</td><td>`miyagi.sysops.tv`</td><td>`192.168.168.250`</td></tr><tr><td>PBS-LXC</td><td>`pbs.sysops.tv`</td><td>`192.168.168.252`</td></tr><tr><td>Gateway/DNS *(Beispiel)*</td><td>–</td><td>`192.168.168.1`</td></tr></tbody></table>

</div>PVE-Weboberfläche: `https://192.168.168.250:8006` · PBS-Weboberfläche: `https://192.168.168.252:8007`. Gateway und DNS sind als Beispiele zu prüfen.

### Welche Sicherungsart schützt welche Daten?

<div class="panel"><table><tbody><tr><th>Art</th><th>Quell-Storage</th><th>Ergebnis</th></tr><tr><td>**Zsync / ZFS-Replikation**</td><td>Ausschließlich **ZFS-basierte** VM-Disks und LXC-Volumes</td><td>Direkt nutzbare replizierte ZVOLs/Datasets mit Snapshots (bei passendem Notfall-PVE)</td></tr><tr><td>**PBS**</td><td>VMs und LXC auf **ZFS, Ceph, LVM-thin, Directory, SAN** und anderen von Proxmox unterstützten Storages, soweit der jeweilige Gast korrekt gesichert werden kann</td><td>Versionierte VM-/CT-Backups; Restore unabhängig von ZFS auf der Quelle</td></tr><tr><td>**Miyagi mit PBS-only**</td><td>Auch vollständig **ohne ZFS auf dem Quell-PVE**</td><td>Automatisierte **Deckungssicherung** mit Backup-Job, Kontrolle, Wartung und Shutdown des Backup-Servers</td></tr></tbody></table>

</div>**Wichtig:** Eine VM auf Ceph oder LVM-thin wird durch eine ZFS-Markierung nicht Zsync-fähig. Sie muss über PBS gesichert werden. Bei gemischten Storages kann Miyagi beide Wege parallel verwenden.

### Vektor-Architektur (SVG)

<div class="panel">![Drei Quell-Proxmox-Hosts sichern per PBS, ZFS-basierte Gäste zusätzlich per Zsync zum Miyagi-Host](https://aow.de/miyagi_architektur_1.png)</div>BookStack-kompatible PNG-Grafik. In BookStack über den Bild-Manager hochladen und das Bild dort einfügen (der relative Pfad funktioniert nur bei gemeinsamer Dateiablage).

**Speicherrisiko:** PBS und Zsync auf demselben RAIDZ1 liegen in einem gemeinsamen physischen Fehlerbereich. Eine getrennte Offsite-Sicherung ist weiterhin empfehlenswert.

</section><section class="panel" id="bkmrk-2.-hardware-und-vorp">## 2. Hardware und Vorprüfung

<div class="table-responsive"><table class="table table-sm table-striped"><tbody><tr><th>CPU</th><td>x86-64, beispielsweise Intel N100 oder besser</td></tr><tr><th>RAM</th><td>16 GB als unterer Ausgangspunkt, 32 GB empfehlenswert</td></tr><tr><th>Laufwerke</th><td>4 × 2 TB SSD, möglichst baugleich</td></tr><tr><th>Controller</th><td>Einzelplatten direkt sichtbar (AHCI/HBA/JBOD), kein Hardware-RAID</td></tr><tr><th>Netzwerk</th><td>1 Gbit/s mindestens, 2,5/10 Gbit/s bei größeren Datenmengen</td></tr><tr><th>Startmodus</th><td>UEFI; Wake-on-LAN im BIOS/UEFI aktivieren</td></tr></tbody></table>

</div>- Vorher prüfen, ob sich auf den SSDs noch benötigte Daten befinden: **die Installation löscht sie**.
- Bei vorhandenem RAID-Controller HBA/JBOD konfigurieren und physische Platten-IDs prüfen.
- Die nutzbare Kapazität liegt grob bei 6 TB vor Dateisystem-, Reserve- und Systemabzügen; für Betrieb und Snapshots eine deutliche Freiplatzreserve einplanen.

</section><section class="panel" id="bkmrk-3.-proxmox-ve-auf-ra">## 3. Proxmox VE auf RAIDZ1 installieren

- Proxmox-VE-ISO von [proxmox.com](https://www.proxmox.com/en/downloads) laden und vom USB-Medium starten.
- Im Installer **ZFS (RAIDZ-1)** wählen und exakt die vier 2-TB-SSDs zuweisen.
- Als Hostname `miyagi.sysops.tv`, als Management-IP `192.168.168.250/24` konfigurieren. Gateway und DNS anhand des tatsächlichen Netzes eintragen.
- Installation beenden, UEFI-Boot prüfen und über `https://192.168.168.250:8006` anmelden.

```
zpool status
zpool list
zfs list
lsblk -o NAME,SIZE,MODEL,TYPE
pveversion -v
```

Erwartetes Ergebnis: ein `rpool` mit einem `raidz1`-VDEV aus vier SSDs, alle `ONLINE`. Der Installer erzeugt unter anderem die Root- und Storage-Datasets.

</section><section class="panel" id="bkmrk-4.-proxmox-grundkonf">## 4. Proxmox-Grundkonfiguration und SSH absichern

Vor dem Abschalten der SSH-Passwortanmeldung **zuerst funktionierende Schlüsselanmeldung** sicherstellen. Da Miyagi später auf die Quelle und den PBS zugreift, werden die Schlüssel auf dem Miyagi-Host erzeugt.

```
apt update
apt install -y git wget openssh-client
test -f /root/.ssh/id_ed25519.pub || ssh-keygen -t ed25519 -f /root/.ssh/id_ed25519

for host in 21 22 23; do
  ssh-copy-id -i /root/.ssh/id_ed25519.pub root@192.168.168.$host
  ssh -o BatchMode=yes root@192.168.168.$host hostname
done
```

Den Host-Key-Fingerprint unabhängig prüfen. Erst nach erfolgreicher Anmeldung SSH-Passwortlogin auf den beteiligten Hosts deaktivieren, beispielsweise über den Postinstaller bzw. eine geeignete `sshd_config`-Einstellung. Root über SSH nur mit Schlüssel zulassen.

</section><section class="panel" id="bkmrk-5.-sysops%2Fbashclub-p">## 5. sysops/Bashclub Postinstaller

Im Workshop dient der Postinstaller zur einheitlichen Einrichtung von Repositorys, ZFS-Autosnapshots, ARC, Swappiness, SSH-Härtung und weiteren Werkzeugen. Vor Ausführung den Code bzw. die aktuell dokumentierten Installationsbefehle des Projekts prüfen.

```
git clone https://github.com/bashclub/proxmox-zfs-postinstall.git /root/proxmox-zfs-postinstall
cd /root/proxmox-zfs-postinstall
ls -la
```

Anschließend die in der Projekt-README dokumentierte Startmethode verwenden. Empfehlungen für diesen Host:

<div class="table-responsive"><table class="table table-sm table-striped"><tbody><tr><th>Proxmox-Repository</th><td>No-Subscription oder Enterprise bei vorhandener Subskription</td></tr><tr><th>Ceph</th><td>Nicht aktivieren</td></tr><tr><th>SSH-Härtung</th><td>Ja, nach funktionierendem Schlüsselzugang</td></tr><tr><th>ZFS ARC</th><td>Bei 16 GB RAM zunächst vorsichtig, etwa 4 GB Maximum als Startwert</td></tr><tr><th>Swappiness</th><td>Niedrig (z. B. 5–10), RAM-Auslastung beobachten</td></tr><tr><th>ZFS Auto-Snapshots</th><td>Ja, mit passender Retention</td></tr><tr><th>Local Storage</th><td>Keine regulären VM-Backups auf kleiner Systempartition zulassen</td></tr><tr><th>Autotrim / Autoexpand</th><td>Bei geeigneter Hardware aktivieren</td></tr></tbody></table>

</div>```
apt update
apt full-upgrade
reboot
```

Nach dem Neustart `zpool status` und SSH-Zugriff erneut prüfen.

</section><section class="panel" id="bkmrk-6.-replikationsziel-">## 6. Replikationsziel als ZFS-Dataset

Wir halten die ZFS-Replikate logisch von PBS-Daten getrennt. Beide liegen dennoch auf demselben RAIDZ1-Pool.

```
zfs create -o canmount=off -o mountpoint=none rpool/repl
zfs get canmount,mountpoint rpool/repl
zfs list -r rpool/repl
```

Für jeden PVE-Host einen eindeutigen Zielpfad verwenden: `rpool/repl/pve21`, `rpool/repl/pve22` und `rpool/repl/pve23`. Die konkrete Unterstruktur legt die Zsync-Version an; nicht manuell mit vorhandenen Replikaten kollidieren.

</section><section class="panel" id="bkmrk-7.-pbs-mit-der-zamba">## 7. PBS mit der Zamba LXC Toolbox installieren

Wir verwenden im Workshop-Aufbau PBS als LXC. Prüfen, ob die konkrete Toolbox-Version und PBS-Version für den Host geeignet sind. Container-Sicherheitsgrenzen und Mountpoints sind bewusst zu beachten.

```
cd /root
git clone https://github.com/bashclub/zamba-lxc-toolbox.git
cd zamba-lxc-toolbox
cp conf/zamba.conf.example conf/zamba.conf
nano conf/zamba.conf
```

Die folgenden Werte **innerhalb der vollständigen Konfigurationsdatei** setzen; weitere Felder der Vorlage bleiben erhalten:

```
LXC_TEMPLATE_STORAGE="local"
LXC_ROOTFS_SIZE="32"
LXC_ROOTFS_STORAGE="local-zfs"
LXC_SHAREFS_SIZE="3500"
LXC_SHAREFS_STORAGE="local-zfs"
LXC_MEM=4096
LXC_SWAP=512
LXC_HOSTNAME="pbs"
LXC_DOMAIN="sysops.tv"
LXC_DHCP=false
LXC_IP="192.168.168.252/24"
LXC_GW="192.168.168.1"
LXC_DNS="192.168.168.1"
LXC_BRIDGE="vmbr0"
```

*Gateway und DNS sind hier Beispielwerte. Die Größe von 3,5 TB ist lediglich ein Startwert, kein Kapazitätsversprechen. RAIDZ1-Replikate und PBS benötigen gemeinsamen Poolplatz; Reservierungen und Belegung kontrollieren.*

```
bash install.sh
pct list
pct config <CONTAINER-ID>
```

Im Installer die Funktion **Proxmox Backup Server** auswählen (keine fest kodierte Menünummer voraussetzen). Im PBS unter `https://192.168.168.252:8007` kontrollieren, ob der Datastore `backup` auf dem großen eingebundenen Datenvolume liegt und nicht auf dem 32-GB-Container-Rootfs.

</section><section class="panel" id="bkmrk-8.-ssh-und-2fa-f%C3%BCr-p">## 8. SSH und 2FA für PBS

PBS-Rootkonto mit eigenem starkem Passwort und 2FA absichern. Recovery-Codes sicher offline aufbewahren. Das Einloggen von Miyagi auf PBS muss separat über SSH-Schlüssel funktionieren.

```
ssh-copy-id -i /root/.ssh/id_ed25519.pub root@192.168.168.252
ssh -o BatchMode=yes root@192.168.168.252 hostname
```

Danach SSH-Passwortlogin auf PBS deaktivieren und erneuten Zugang testen. Die administrativen Proxmox-/PBS-Logins nicht mit dem Backup-API-Token verwechseln.

</section><section class="panel" id="bkmrk-9.-pbs-backup-benutz">## 9. PBS-Backup-Benutzer und Token einrichten

- Im PBS unter **Access Control → User Management** Benutzer `backup@pbs` anlegen.
- API-Token `miyagi` erzeugen, Kennung `backup@pbs!miyagi`.
- Dem Benutzer *und* dem Token die für den Datastore `/datastore/backup` nötigen Backup-Rechte geben (Least Privilege).
- Token-Secret sicher aufbewahren; nicht im unverschlüsselten Kursmaterial dokumentieren.
- Administrativen Login per 2FA absichern.

Der Produktivhost soll Backups schreiben, aber regulär keine alten Backups löschen können.

</section><section class="panel" id="bkmrk-10.-pbs-als-storage-">## 10. PBS als Storage in der Quelle eintragen

**Mehrere Quell-PVE:** Gehören `.21`, `.22` und `.23` zum *selben Proxmox-Cluster*, wird der PBS-Storage in der Regel auf Datacenter-Ebene einmal angelegt und für die relevanten Nodes freigeschaltet. Bei drei unabhängigen Proxmox-Installationen muss er auf jedem Host einzeln eingetragen werden. Bei überlappenden VM-IDs geteilte PBS-Namespaces und separate Jobs sorgfältig planen.

**Wichtig:** PBS sichert VMs und Container unabhängig davon, ob deren Disks auf ZFS, Ceph, LVM-thin oder SAN liegen. Proxmox benötigt Zugriff auf die Gast-Datenträger und die unterstützte Backup-Methode; für LXC müssen insbesondere zusätzliche Mountpoints und deren Backup-Optionen geprüft werden.

Bei einem Cluster im Datacenter des Clusters, sonst auf jedem einzelnen Quell-PVE `.21`, `.22`, `.23`, unter **Datacenter → Storage → Add → Proxmox Backup Server** eintragen:

<div class="table-responsive"><table class="table table-sm table-striped"><tbody><tr><th>ID auf Quell-PVE</th><td>`backup`</td></tr><tr><th>Server</th><td>`192.168.168.252`</td></tr><tr><th>Datastore auf PBS</th><td>`backup`</td></tr><tr><th>Username</th><td>`backup@pbs!miyagi`</td></tr><tr><th>Password</th><td>API-Token-Secret</td></tr><tr><th>Fingerprint</th><td>Fingerprint des PBS aus vertrauenswürdiger Quelle</td></tr></tbody></table>

</div>Bei einem Cluster im Datacenter des Clusters, sonst auf jedem einzelnen Quell-PVE `.21`, `.22`, `.23`, unter **Datacenter → Storage → Add → Proxmox Backup Server** eintragen:

</section><section class="panel" id="bkmrk-11.-zfs-auf-dem-quel">## 11. ZFS auf dem Quell-PVE markieren

**Nur ZFS:** Diesen Schritt auf jedem PVE-Host *nur für tatsächlich vorhandene ZFS-Pools* durchführen. VMs/LXC auf Ceph, LVM-thin, SAN oder Directory werden nicht über Zsync repliziert; dafür läuft die PBS-Sicherung unabhängig weiter. Ein Host ohne ZFS braucht keine Zsync-Markierung.

Beispiel mit dem Standard-Dataset `rpool/data`; tatsächlich verwendeten Pool-/Dataset-Namen vorab prüfen:

```
ssh root@192.168.168.21
zpool status
zfs list -r rpool/data
zfs set bashclub:zsync=subvols rpool/data
zfs get bashclub:zsync rpool/data
```

Die Auswahl `subvols` ist für die untergeordneten VM-/Container-Datasets gedacht. Ausgeschlossene Datasets kontrollieren und anwendungsabhängig konfigurieren. **Unbedingt die VM- und LXC-Konfigurationsdateien aus `/etc/pve` sichern.** Im Workshop wurde ein fehlendes Konfigurationsbackup als Restore-Falle demonstriert. Den vom verwendeten Postinstaller bereitgestellten `pveconf`-Mechanismus prüfen und für die Replikation mit markieren.

</section><section class="panel" id="bkmrk-12.-miyagi-herunterl">## 12. Miyagi herunterladen und konfigurieren

### Drei Hosts: drei Konfigurationen, drei aufeinanderfolgende Läufe

Die dokumentierte Miyagi-Konfiguration verwendet jeweils `SOURCEHOST` für genau einen Host. Daher ist für die Quellen `.21` bis `.23` jeweils eine eigene Konfigurationsdatei anzulegen. Nur auf Hosts mit ZFS wird `ZSYNC='yes'` gesetzt; ohne ZFS gilt `ZSYNC='no'`. **`BACKUPSERVER='yes'` bleibt auch bei PBS-only aktiv.**

```
cp /etc/miyagi.conf /etc/miyagi-pve21.conf
cp /etc/miyagi.conf /etc/miyagi-pve22.conf
cp /etc/miyagi.conf /etc/miyagi-pve23.conf

# In jeder Datei individuell ändern:
# /etc/miyagi-pve21.conf: SOURCEHOST='192.168.168.21' ; ZFSTRGT='rpool/repl/pve21'
# /etc/miyagi-pve22.conf: SOURCEHOST='192.168.168.22' ; ZFSTRGT='rpool/repl/pve22'
# /etc/miyagi-pve23.conf: SOURCEHOST='192.168.168.23' ; ZFSTRGT='rpool/repl/pve23'
# Ohne ZFS auf einem Quellhost: ZSYNC='no' ; BACKUPSERVER='yes'

chmod 600 /etc/miyagi-pve2{1,2,3}.conf
```

**Cluster-Sonderfall:** Die PBS-Gastsicherung darf nicht blind dreifach dieselben Cluster-VMs verarbeiten. Proxmox kennt die aktuelle Node-Zuordnung; Miyagi-Jobs und PBS-Backup-Jobs müssen so abgestimmt werden, dass jeder Gast genau einmal je Sicherungsfenster gesichert wird. Migrationen, VM-Ausschlüsse und parallele Jobs berücksichtigen. Die ZFS-Replikation darf nicht auf passive Proxmox-Replikate angesetzt werden. Die konkrete Steuerung muss anhand der Miyagi-Version geprüft werden.

### Deckungssicherung mit ausschließlich PBS

```
# In /etc/miyagi-pve21.conf (analog für weitere Hosts)
ZSYNC='no'
BACKUPSERVER='yes'
PBSHOST='192.168.168.252'
BACKUPSTORE='backup'
BACKUPSTOREPBS='backup'
```

Das ist ein vollwertiger Miyagi-Einsatz: Der Backup-Host wird zeitgesteuert eingeschaltet, koordiniert PBS-Backups, prüft das Ergebnis, führt konfigurierte Wartung und Monitoring aus und fährt wieder herunter. Eine ZFS-Replikation ist dafür **keine Voraussetzung**. Die wiederherstellbaren Sicherungen sind in diesem Modus die PBS-Backups und keine direkt startbaren ZFS-Replikate.

Das ältere Miyagi-Repository und die neuere Entwicklung können unterschiedliche Parameter haben. Diese Anleitung verwendet die beschriebene Skriptstruktur als Workshop-Beispiel; **vor produktivem Start Parameter gegen die tatsächlich geklonte `config.example` prüfen**.

```
apt install -y git open-iscsi
git clone https://gitea.perlbach24.de/scripte/miyagi-backup.git /opt/miyagi-backup
cd /opt/miyagi-backup
ls -la
cp config.example /etc/miyagi.conf
chmod 600 /etc/miyagi.conf
nano /etc/miyagi.conf
```

Grunddaten:

```
UPDATES='no'
SHUTDOWN='no'
DYNROUTE='no'
DDNS_GATEWAY='192.168.168.1'
REBOOT='no'
SOURCEHOST='192.168.168.21'  # pro Host in eigener Konfiguration anpassen
SOURCEPORT='22'
```

ZFS-Replikation:

```
ZFSROOT='none'
ZFSSECOND='none'
ZFSTRGT='rpool/repl/pve21'  # pro Host: pve21 / pve22 / pve23
ZSYNC='yes'
ZPUSHTAG='bashclub:zsync'
ZPUSHMINKEEP='3'
ZPUSHKEEP='14'
ZPUSHLABEL='zsync'
ZPUSHFILTER='hourly|daily|weekly|monthly'
```

PBS-Wartung und Ziel:

```
BACKUPSERVER='yes'
MAINTDAY='7'
PBSHOST='192.168.168.252'
PBSPORT='22'
BACKUPSTORE='backup'
BACKUPSTOREPBS='backup'
PBS_NAMESPACE='none'
```

Monitoring-Werte aus dem Beispiel:

```
CHECKZFS_DISABLED='0'
CHECKZFS_LOCAL='0'
CHECKZFS_MAX_AGE='1500,2000'
CHECKZFS_MAX_SNAPSHOT_COUNT='180,200'
CHECKZFS_SPOOL='1'
CHECKZFS_SPOOL_MAXAGE='90000'
```

Erst nach vollständigem Test `UPDATES` und `SHUTDOWN` aktivieren. Der Port `PBSPORT=22` dient der SSH-Steuerung; die eigentlichen PBS-Backups werden von der Quelle auf TCP 8007 geschrieben.

</section><section class="panel" id="bkmrk-13.-erster-manueller">## 13. Erster manueller Komplettlauf

Für Hosts mit `ZSYNC='no'` entfallen die Replikationsprüfungen – **ein erfolgreicher PBS-Lauf ist dort das maßgebliche Sicherungsergebnis**. Bei drei Hosts die erfolgreichen PBS-Backups für jeden relevanten Gast und die korrekte Node-Zuordnung kontrollieren.

Die nachfolgenden Aufrufe gelten, wenn das geklonte Repository die genannten Skripte bereitstellt; gegebenenfalls ausführbare Datei und Optionen in der README prüfen.

```
for n in 21 22 23; do
  bash -n /etc/miyagi-pve$n.conf
  /opt/miyagi-backup/miyagi-check.sh /etc/miyagi-pve$n.conf
  /opt/miyagi-backup/miyagi-backup.sh -c /etc/miyagi-pve$n.conf
done
# Aufrufsyntax unbedingt mit der tatsächlich eingesetzten Version abgleichen.
```

- SSH-Zugriff auf Quelle und PBS funktioniert.
- Replikationsfilter findet die erwarteten Datasets.
- Erster Lauf transferiert vollständig; weitere Läufe verwenden Snapshots für Delta-Übertragung.
- Der PBS-Backup-Job wurde auf `192.168.168.21` erfolgreich ausgeführt.
- Maintenance, Prune, Garbage Collection und Verify verhalten sich wie vorgesehen.
- Fehler und Berichte werden im Log und Monitoring sichtbar.

```
zpool status
zfs list -r rpool/repl
zfs list -t snapshot -r rpool/repl
ls -l /var/lib/check_mk_agent/spool/ 2>/dev/null || true
```

Die genaue Logdatei und die Aufrufsyntax hängen vom Miyagi-Stand ab; `/var/log/miyagi-backup.log` ist nicht automatisch auf jeder Version vorhanden.

</section><section class="panel" id="bkmrk-14.-automatik%3A-wake-">## 14. Automatik: Wake-on-LAN, Cron und Shutdown

### Drei Quellen in einem gesicherten Job

**Achtung:** `SHUTDOWN='yes'` innerhalb eines Einzeljobs könnte den Host bereits nach der ersten Quelle abschalten. Deshalb für den gemeinsamen Ablauf zunächst in **allen drei** Konfigurationsdateien `SHUTDOWN='no'` verwenden und *erst danach* zentral herunterfahren. Die tatsächlich verwendete Miyagi-Version muss dies unterstützen.

Beispielwrapper als root unter `/usr/local/sbin/miyagi-alle-hosts.sh` anlegen:

```
#!/bin/bash
set -Eeuo pipefail
exec 9>/run/lock/miyagi-alle-hosts.lock
flock -n 9 || exit 0

rc=0
for n in 21 22 23; do
  /opt/miyagi-backup/miyagi-backup.sh -c "/etc/miyagi-pve$n.conf" || rc=1
done

# Nur nach erfolgter Prüfung, Dokumentation und Monitoring-Freigabe:
# /usr/sbin/shutdown -h now
exit "$rc"
```

Vor Einsatz das Skript ausführbar machen: `chmod 700 /usr/local/sbin/miyagi-alle-hosts.sh`. Die auskommentierte Shutdown-Zeile erst aktivieren, wenn die drei Jobs einschließlich PBS-Maintenance, Locking und Reporting geprüft sind. Wenn die Miyagi-Version globale Jobs wie PBS-Garbage-Collection pro Host ausführt, diese nur einmal pro Zyklus planen, um unnötige Mehrfachwartung zu vermeiden.

Nach erfolgreichem manuellem Test in der Miyagi-Konfiguration:

```
UPDATES='yes'
SHUTDOWN='yes'
```

Cron als Root einrichten. Vorher sicherstellen, dass die eingesetzte Version parallele Sicherungsläufe verhindert:

```
crontab -e
```

```
# Besser: gemeinsamer Wrapper mit Locking für drei Konfigurationen.
@reboot /usr/local/sbin/miyagi-alle-hosts.sh >> /var/log/miyagi-cron.log 2>&1
5 19 * * * /usr/local/sbin/miyagi-alle-hosts.sh >> /var/log/miyagi-cron.log 2>&1
```

Die zweite Zeile ist ein Sicherheitslauf für den Fall, dass Miyagi nicht wie vorgesehen heruntergefahren ist. In OPNsense unter **Services → Wake-on-LAN** die physische MAC-Adresse von `miyagi.sysops.tv` registrieren und die Kiste zum geplanten Zeitpunkt aufwecken. Dazu Wake-on-LAN im BIOS und Betriebssystem aktivieren.

Wichtige Testfolge: **Shutdown → WoL → Start → Sicherungsjob → Berichte → Shutdown**. Der Host muss sich selbst wieder ausschalten. Das WoL-Steuerelement möglichst nicht dem Produktivhost überlassen.

</section><section class="panel" id="bkmrk-15.-checkmk-und-pigg">## 15. Checkmk und Piggyback

<div class="table-responsive"><table class="table table-sm table-striped"><tbody><tr><th>ZFS-Replikation</th><td>Snapshot-GUID, Alter, Anzahl, erfolgreiche Quell-/Ziel-Kopie</td></tr><tr><th>PBS-Backup</th><td>Erfolg beziehungsweise Exit-Status des PBS-Backup-Jobs</td></tr><tr><th>Miyagi-Hardware</th><td>SMART, RAIDZ1-Status, Pool-Kapazität, Hostzustand</td></tr><tr><th>Offline-Host</th><td>Piggyback-Daten mit definierter Gültigkeit</td></tr></tbody></table>

</div>- Checkmk-Agent auf den relevanten Hosts einrichten.
- SMART-/ZFS-Checks aktivieren; reine Proxmox-Startseite reicht nicht für SSD-Ausfälle.
- Miyagi-Piggyback-Daten vor dem Shutdown auf ein dauerhaft erreichbares System übertragen.
- In Checkmk Service Discovery und Übernahme neuer Dienste prüfen.
- Sicherstellen, dass auch **fehlende neue Reports** einen Alarm auslösen.

</section><section class="panel" id="bkmrk-16.-restore%3A-pbs-und">## 16. Restore: PBS und direktes ZFS-Replikat

**Wiederherstellung nach Storage-Typ:** Für Ceph-/LVM-thin-/SAN-basierte Gastplatten gibt es in dieser Architektur **kein Zsync-ZVOL**. Diese Gäste werden aus PBS zurückgespielt. Nur bei ZFS-basierten und erfolgreich replizierten Gästen ist ein direkter Notstart aus ZFS-Replikaten möglich.

**Variante A (PBS):** PBS-Storage auf einem geeigneten Notfall-PVE einbinden, Backup auswählen, Gast wiederherstellen. Bei Wiederherstellung auf denselben Storage beachten: VM-Datenträger und lokale Snapshots können ersetzt werden. **Variante B (ZFS):** Replizierte ZVOLs auf Miyagi identifizieren und zusammen mit einer gesicherten VM-Konfiguration in Betrieb nehmen.

```
zfs list -r rpool/repl/pve21  # für Hosts .22/.23 entsprechend ändern
zfs list -t snapshot -r rpool/repl/pve21  # für Hosts .22/.23 entsprechend ändern
```

- VM-ID und passendes ZVOL identifizieren.
- ZFS-Pool bzw. Dataset als Proxmox-Storage verfügbar machen.
- Gesicherte `201.conf` beziehungsweise entsprechende VM-/CT-Konfiguration wiederherstellen.
- Storage-IDs auf das Notfall-ZFS anpassen, RAM und CPU passend dimensionieren.
- Falsche ISO-/PCI-/Netzwerkgeräte entfernen, MAC-Kollisionen vermeiden.
- Für einen nichtdestruktiven Test Snapshot-Klon statt destruktivem Rollback verwenden.

**Beispielprinzip für `zfs clone` (Platzhalter, nicht blind ausführen):**

```
zfs clone QUELL_ZVOL@SNAPSHOT ZIEL_ZVOL
```

Das tatsächliche ZVOL und Snapshot müssen aus der Liste übernommen werden. Beim Restore möglicherweise kompromittierter Systeme Netzwerk zunächst deaktivieren oder in ein isoliertes Segment legen. Danach Starttest, Anwendungsprüfung und gegebenenfalls forensische Kopie durchführen.

</section><section class="panel" id="bkmrk-17.-abschluss-checkl">## 17. Abschluss-Checkliste

- \[ \] PBS sichert die ausgewählten Gäste auf allen drei PVE-Hosts unabhängig von deren Quell-Storage.
- \[ \] Zsync verarbeitet ausschließlich markierte, aktive ZFS-Datasets.
- \[ \] Auf PBS-only-Hosts ist `ZSYNC='no'` gesetzt.
- \[ \] Kein Gast wird wegen Cluster-Backupjobs versehentlich dreifach gesichert oder vollständig übersehen.
- \[ \] Gemeinsamer Wrapper führt alle Jobs aus, bevor Miyagi herunterfährt.

- \[ \] Vier SSDs im RAIDZ1 sind ONLINE.
- \[ \] Miyagi 192.168.168.250 ist per PVE-Weboberfläche und SSH erreichbar.
- \[ \] PBS 192.168.168.252:8007 verwendet den richtigen Datastore.
- \[ \] Quellen 192.168.168.21–23 erreicht PBS auf TCP 8007.
- \[ \] SSH-Key-Zugriff von Miyagi auf Quell-PVEs und PBS funktioniert.
- \[ \] Für PVE und PBS sind 2FA und sichere Recovery-Codes eingerichtet.
- \[ \] Der Backup-Benutzer und API-Token haben nur benötigte Rechte.
- \[ \] ZFS-Datasets der VMs sind korrekt markiert.
- \[ \] VM-/CT-Konfigurationen aus /etc/pve werden gesichert.
- \[ \] Erste ZFS-Vollreplikation erfolgreich; zweiter Lauf inkrementell.
- \[ \] PBS-Backup erfolgreich und auf dem richtigen Volume gespeichert.
- \[ \] Wartung, Monitoring und Fehlermeldungen sind nachvollziehbar.
- \[ \] Wake-on-LAN, Cron und Shutdown getestet.
- \[ \] Ein PBS-Restore und ein ZFS-Notstart wurden praktisch getestet.

</section><section class="panel" id="bkmrk-18.-referenzen-bashc">## 18. Referenzen

- [Bashclub Proxmox ZFS Postinstaller](https://github.com/bashclub/proxmox-zfs-postinstall)
- [Zamba LXC Toolbox](https://github.com/bashclub/zamba-lxc-toolbox)
- [Miyagi-Backup (Gitea)](https://gitea.perlbach24.de/scripte/miyagi-backup)
- [Bashclub Zsync](https://github.com/bashclub/zsync)
- [Check ZFS Replication](https://github.com/bashclub/check-zfs-replication)
- [Proxmox VE Dokumentation](https://pve.proxmox.com/pve-docs/)
- [Proxmox Backup Server Dokumentation](https://pbs.proxmox.com/docs/)
- [Checkmk Dokumentation](https://docs.checkmk.com/)

</section></div></div><footer>Kursunterlage für Moodle. Versionsabhängige Projektparameter und Befehle vor produktiver Nutzung anhand der installierten Skripte prüfen.

</footer></div>