Platz vor jedem Snapshot pruefen, bei Mangel alte loeschen, per Mail warnen

Volle Ceph-Pools legen alle VMs darauf lahm. Vor jedem Snapshot gilt jetzt
je Storage des Gastes: frei >= sofortiger Verbrauch + space_min_free
(Vorgabe 20 %). Die Reserve bleibt also auch nach dem Snapshot frei.

Reicht es nicht, wird der aelteste pvesnap-Snapshot des Gastes geloescht und
neu geprueft, bis es reicht. Sind nur noch die neuesten space_keep (Vorgabe
7) uebrig, entfaellt der Snapshot und der naechste Gast kommt dran.

Gezaehlt wird je Gast ueber alle Gruppen, anders als bei der Vorhaltezeit.
Auf dem Testhost haette eine Grenze je Gruppe nie gegriffen: keep_count = 5
liegt unter 7, und 13 GiB steckten in einer Gruppe, die es nicht mehr gibt.

Sofortiger Verbrauch: Dicke ZFS-Zvols muessen ihre Reservierung auch nach
dem Snapshot garantieren, das kostet alles seit dem letzten Snapshot
Geschriebene. Exakt ist das refreservation - usedbyrefreservation; die Werte
kommen per zfs get, bei anderen Nodes per ssh ueber die IP aus dem
Clusterstatus, weil Node-Namen nicht ueberall aufloesen. Dazu kommt der RAM
bei vmstate. --dry-run zeigt die Rechnung je Storage.

Ceph und ZFS geben Platz erst im Hintergrund frei. Deshalb wird nach jedem
Loeschen gewartet, solange der Platz waechst, und erst nach space_settle
(Vorgabe 30s) ohne Zuwachs weitergemacht. Ohne das wurde auf Ceph ein Snapshot
zu viel geloescht. Laesst sich der Platz nicht feststellen, wird nichts
geloescht und der Snapshot trotzdem versucht.

Neu ist [mail]: eine Alarm-Mail je Gruppe und Lauf, wenn ein Snapshot wegen
Platzmangels ausfaellt. STARTTLS oder SSL/TLS mit Zertifikatspruefung, ohne
Rueckfall auf Klartext. Einzurichten im Editor (Taste m) oder von Hand, Test
mit pvesnap mail-test. Liegt ein Passwort in der Datei, setzt der Editor die
Rechte auf 600, auch fuer die .bak.

Das Handbuch beschreibt, wie man Ceph (Ratios) und ZFS (Notreserve) frueher
"voll" sagen laesst und was im Notfall zu tun ist. Ausserdem war
"pvesnap run --dry-run" ueberall falsch: Die Option ist global und muss vor
dem Unterbefehl stehen.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

handbuch/docs/nachschlagen/konfiguration.md

@@ -47,6 +47,7 @@ systemctl reload pvesnap
 | `retries` | `2` | zusätzliche Versuche, wenn eine Sperre belegt ist |
 | `retry_delay` | `60s` | Wartezeit vor dem nächsten Versuch |
 | `pause_between` | `0s` | Pause zwischen zwei Gästen |
+| `space_settle` | `30s` | Geduld, bis nach dem Löschen bei Platzmangel der Platz zurückkommt |
 | `run_on_start` | `no` | beim Dienststart sofort einen Durchlauf machen |
 | `dry_run` | `no` | `yes` = nichts wirklich tun, nur protokollieren |
 | `description` | siehe unten | Standard-Beschreibung aller Snapshots |
@@ -68,6 +69,47 @@ description = pvesnap | Gruppe: {group} | erstellt: {datetime} | Vorhaltezeit: {
 
 ---
 
+## `[mail]`
+
+Meldet per Mail, wenn wegen Platzmangels ein Snapshot ausfällt. Am bequemsten
+im Editor: `pvesnap config`, Taste ++m++, dort sendet ++t++ eine Test-Mail. Von
+der Kommandozeile geht das mit `pvesnap mail-test`.
+
+```ini
+[mail]
+enabled = yes
+server = mail.example.org
+security = starttls
+user = pvesnap@example.org
+password = geheim
+sender = pvesnap@example.org
+recipients = admin@example.org, technik@example.org
+```
+
+| Schlüssel | Vorgabe | |
+|---|---|---|
+| `enabled` | `no` | Alarm einschalten |
+| `server` | — | SMTP-Server |
+| `security` | `starttls` | `starttls` (TLS nach dem Verbinden), `ssl` (SSL/TLS von Anfang an) oder `none` |
+| `port` | passend zu `security` | `587`, `465` bzw. `25` |
+| `tls_verify` | `yes` | Zertifikat des Servers prüfen; `no` nur bei selbstsignierten Zertifikaten |
+| `user`, `password` | — | Anmeldung; ohne `user` wird nicht angemeldet |
+| `sender` | — | Absender |
+| `recipients` | — | Empfänger, mehrere mit Komma |
+
+* Bietet der Server kein STARTTLS an, schlägt der Versand fehl. Auf Klartext
+  ausgewichen wird nie.
+* Eine Anmeldung mit `security = none` lehnt `pvesnap check` ab, weil das Passwort
+  sonst im Klartext übertragen würde.
+* Das Passwort steht im Klartext in der Datei. Der Editor setzt beim Speichern
+  die Rechte `600`; wer von Hand einträgt, macht das selbst. `pvesnap check` warnt,
+  wenn jeder die Datei lesen darf.
+* Je Gruppe und Lauf geht höchstens eine Mail heraus, in der alle betroffenen
+  Gäste stehen. Bleibt das Problem bestehen, kommt sie bei jedem Lauf erneut.
+* Scheitert der Versand, steht das im Protokoll. Die Snapshots laufen weiter.
+
+---
+
 ## `[defaults]`
 
 Vorgaben für **alle** Gruppen. Jede Gruppe darf sie einzeln überschreiben.
@@ -121,9 +163,12 @@ Einzelheiten unter [Zeitpläne](../sichern/zeitplan.md).
 | `keep_count` | `0` | höchstens so viele je VM und Gruppe (`0` = unbegrenzt) |
 | `keep_time` | `0` | nichts älter als (`0` = unbegrenzt) |
 | `keep_min` | `0` | so viele bleiben in jedem Fall stehen |
+| `space_min_free` | `20%` | so viel muss vor dem Snapshot frei sein, auch absolut (`20G`); `0` = keine Prüfung |
+| `space_keep` | `7` | so viele bleiben je VM auch bei Platzmangel stehen, über alle Gruppen gezählt |
 
 **Mindestens eine von `keep_count` und `keep_time` muss gesetzt sein.**
-Einzelheiten unter [Vorhaltezeit](../sichern/vorhaltezeit.md).
+Einzelheiten unter [Vorhaltezeit](../sichern/vorhaltezeit.md) und
+[Platz vor dem Snapshot](../sichern/vorhaltezeit.md#platz-vor-dem-snapshot).
 
 ### Auswahl der Gäste
 
@@ -193,6 +238,13 @@ Damit die Datei lesbar bleibt, versteht pvesnap eine Reihe deutscher Synonyme:
 | `anzahl`, `max_anzahl`, `behalte_anzahl` | `keep_count` |
 | `vorhaltezeit`, `behalte_zeit`, `max_alter` | `keep_time` |
 | `mindestens` | `keep_min` |
+| `mindestens_frei` | `space_min_free` |
+| `verschluesselung` | `security` |
+| `benutzer` | `user` |
+| `passwort` | `password` |
+| `absender` | `sender` |
+| `empfaenger` | `recipients` |
+| `platzmangel_behalten` | `space_keep` |
 | `alle` | `all` |
 | `namen` | `names` |
 | `typen` | `types` |