duffyduckandClaude Opus 5
d9d9345d03
Zwei Luecken, die seit dem Umbau offenstanden.
1. Transfer-Laufwerke waren aus dem Explorer nicht erreichbar
F2 zeigte nur die Dateisysteme des Snapshots. Jetzt stehen die
Transfer-Laufwerke in derselben Liste - aus Sicht des Bedieners ist es
dieselbe Frage ("wo soll ich hinschauen?"), und der Weg ueber
pvesnap-recovery entfaellt.
Das gewaehlte Laufwerk landet im rechten Fenster, links bleibt der
Snapshot. Damit laesst sich direkt aus einem Snapshot auf das
Austauschmedium kopieren, das anschliessend in die wiederhergestellte
Maschine wandert - ohne Zwischenlager auf dem Host.
Ausgehaengt wird beim Verlassen, und zwar nur, was wir selbst eingehaengt
haben: ein Laufwerk, das schon vorher am Host hing, gehoert jemand
anderem. Das finally faengt auch Absturz und Strg-C ab - bliebe es
eingehaengt, gaelte es spaeter als belegt.
2. cleanup fand geschuetzte Snapshots ohne Klon nicht
Loescht jemand eine Wiederherstellung in der Proxmox-Oberflaeche, raeumt
Proxmox den Klon durchaus mit ab - aber nicht den Schutz seines
Quell-Snapshots (rbd snap protect, den setzt es beim Klonen selbst).
Zurueck bleibt ein geschuetzter Snapshot ohne Klon: die Vorhaltezeit
scheitert an ihm jede Nacht mit "snapshot is protected", und
find_orphans() findet prinzipiell nichts, weil es den Datentraeger, nach
dem es sucht, wirklich nicht mehr gibt. Dasselbe entsteht nach einem von
Hand ausgefuehrten rbd flatten.
find_stale_protections() sucht deshalb direkt nach der Ursache: jeder
geschuetzte Snapshot, an dem kein Klon haengt. Ein solcher Schutz hat
keinen Zweck - er existiert einzig dafuer, dass ein Klon seine Grundlage
behaelt. Geloest wird nur der Schutz, geloescht wird nichts. Vor jedem
Loesen wird ein zweites Mal nachgesehen, ob inzwischen doch ein Klon
daran haengt.
cleanup laeuft damit in zwei Durchgaengen und liegt neu auch in der
Oberflaeche auf Taste c - man sucht sonst lange nach einem Befehl, den
man nur im Notfall braucht.
Getestet gegen die Kulisse der Handbuch-Werkstatt: die rbd-Attrappe
kennt jetzt snap ls und children und enthaelt beide Zustaende
nebeneinander - ein geschuetzter Snapshot mit Klon (muss in Ruhe
gelassen werden) und einer ohne (muss gefunden werden).
Handbuch und README nachgezogen, zwei Bildschirmfotos dazu.
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
244 lines
7.8 KiB
Markdown
244 lines
7.8 KiB
Markdown
# Alle Befehle
|
|
|
|
## `pvesnap`
|
|
|
|
Der Snapshot-Dienst und seine Verwaltung.
|
|
|
|
```bash
|
|
pvesnap [globale Optionen] <befehl> [optionen]
|
|
```
|
|
|
|
### Globale Optionen
|
|
|
|
| Option | Vorgabe | |
|
|
|---|---|---|
|
|
| `-c`, `--config <pfad>` | `/etc/pvesnap/pvesnap.conf` | andere Konfiguration verwenden (auch über `PVESNAP_CONFIG`) |
|
|
| `-n`, `--dry-run` | — | nichts wirklich anlegen oder löschen, nur anzeigen |
|
|
| `-v`, `--verbose` | — | ausführliche Ausgabe |
|
|
| `-V`, `--version` | — | Version anzeigen |
|
|
|
|
### Unterbefehle
|
|
|
|
| Befehl | |
|
|
|---|---|
|
|
| `status` | Übersicht über Gruppen, letzte und nächste Läufe — **auch die Vorgabe ohne Befehl** |
|
|
| `vms` | alle VMs und Container mit den Gruppen, in denen sie stecken |
|
|
| `list` | vorhandene pvesnap-Snapshots |
|
|
| `check` | Konfiguration prüfen |
|
|
| `config` (oder `edit`) | [ncurses-Editor](../sichern/editor.md) |
|
|
| `run` | fällige Gruppen jetzt ausführen |
|
|
| `prune` | nur aufräumen, nichts anlegen |
|
|
| `daemon` | Dienst im Vordergrund starten (für systemd) |
|
|
|
|
### `run`
|
|
|
|
| Option | |
|
|
|---|---|
|
|
| `-g`, `--group <name>` | nur diese Gruppe (mehrfach möglich) |
|
|
| `-f`, `--force` | unabhängig vom Zeitplan ausführen |
|
|
| `--no-prune` | nicht aufräumen |
|
|
|
|
```bash
|
|
pvesnap run # was fällig ist
|
|
pvesnap run --force -g taeglich # diese Gruppe sofort
|
|
pvesnap run --force --dry-run # Probelauf
|
|
pvesnap run -g taeglich -g monatlich # zwei Gruppen
|
|
```
|
|
|
|
### `prune`
|
|
|
|
| Option | |
|
|
|---|---|
|
|
| `-g`, `--group <name>` | nur diese Gruppe |
|
|
|
|
### `list`
|
|
|
|
| Option | |
|
|
|---|---|
|
|
| `-g`, `--group <name>` | nur diese Gruppe |
|
|
| `-a`, `--all` | auch fremde und von Hand angelegte Snapshots anzeigen |
|
|
|
|
---
|
|
|
|
## `pvesnap-explorer`
|
|
|
|
```bash
|
|
pvesnap-explorer [vmid] [snapshot] [optionen]
|
|
```
|
|
|
|
| Parameter | Vorgabe | |
|
|
|---|---|---|
|
|
| `vmid` | — | Gast direkt vorwählen |
|
|
| `snapshot` | — | Snapshot direkt vorwählen |
|
|
| `-l`, `--local <pfad>` | aktuelles Verzeichnis | Startverzeichnis im rechten Fenster |
|
|
| `-p`, `--path <pfad>` | — | beliebiges Verzeichnis öffnen, ohne Proxmox zu fragen |
|
|
| `--cleanup` | — | hängengebliebene Einbindungen lösen und beenden |
|
|
| `-v`, `--verbose` | — | ausführliches Protokoll |
|
|
| `-V`, `--version` | — | Version anzeigen |
|
|
|
|
```bash
|
|
pvesnap-explorer # alles auswählen
|
|
pvesnap-explorer 101 # Snapshot von VM 101 wählen
|
|
pvesnap-explorer 101 auto-taeglich-20260809-023000 # direkt öffnen
|
|
pvesnap-explorer --local /srv/restore # rechtes Fenster startet dort
|
|
pvesnap-explorer --path /mnt/x # ohne Proxmox
|
|
pvesnap-explorer --cleanup # aufräumen
|
|
```
|
|
|
|
Braucht `root`, außer bei `--path`.
|
|
|
|
---
|
|
|
|
## `pvesnap-web`
|
|
|
|
```bash
|
|
pvesnap-web [vmid] [snapshot] [optionen]
|
|
```
|
|
|
|
| Parameter | Vorgabe | |
|
|
|---|---|---|
|
|
| `-P`, `--port <nummer>` | `8823` | Port, auf dem gelauscht wird |
|
|
| `-b`, `--bind <adresse>` | `0.0.0.0` | Netzwerkadresse; `127.0.0.1` = nur lokal |
|
|
| `-a`, `--auth pve\|token\|none` | `pve` | Anmeldeart |
|
|
| `--require-privilege <recht>` | `VM.Snapshot` | nötiges Recht auf dem Gast |
|
|
| `--allow-user <user@realm>` | — | dieser Benutzer darf alles (mehrfach möglich) |
|
|
| `-t`, `--token <schlüssel>` | zufällig | Zugangsschlüssel selbst vorgeben |
|
|
| `--no-token` | — | Kurzform für `--auth none` |
|
|
| `-p`, `--path <verzeichnis>` | — | beliebiges Verzeichnis statt eines Snapshots |
|
|
| `--cleanup` | — | hängengebliebene Einbindungen lösen und beenden |
|
|
| `-v`, `--verbose` | — | ausführliches Protokoll |
|
|
| `-V`, `--version` | — | Version anzeigen |
|
|
|
|
Als Dienst stehen dieselben Parameter in `/etc/pvesnap/web.conf`:
|
|
|
|
```
|
|
PVESNAP_WEB_ARGS=--bind 0.0.0.0 --port 8823 --auth pve
|
|
```
|
|
|
|
---
|
|
|
|
## `pvesnap-recovery`
|
|
|
|
```bash
|
|
pvesnap-recovery # ncurses-Oberfläche
|
|
pvesnap-recovery <befehl> [optionen]
|
|
```
|
|
|
|
### Unterbefehle
|
|
|
|
| Befehl | |
|
|
|---|---|
|
|
| `live <VMID> [snapshot]` | abgeschottet starten (ohne Snapshot: der neueste) |
|
|
| `recover <VMID> [snapshot]` | mit Netzwerk und gleicher Identität starten |
|
|
| `list` | vorhandene Wiederherstellungen anzeigen |
|
|
| `start <VMID>` | starten |
|
|
| `stop <VMID>` | herunterfahren |
|
|
| `console <VMID>` | noVNC-Adresse ausgeben |
|
|
| `spice <VMID>` | Verbindungsdatei für `remote-viewer` |
|
|
| `flatten <VMID>` | [vom Quell-Snapshot lösen](../wiederherstellen/loesen.md) |
|
|
| `cleanup` | [aufräumen: Klone ohne Gast und geschützte Snapshots ohne Klon](../wiederherstellen/verwerfen.md#cleanup) |
|
|
| `destroy <VMID>` | [restlos verwerfen](../wiederherstellen/verwerfen.md) |
|
|
|
|
### Optionen von `live` und `recover`
|
|
|
|
| Parameter | |
|
|
|---|---|
|
|
| `--newid <ID>` | VMID der neuen Maschine (Vorgabe: nächste freie) |
|
|
| `--node <name>` | auf welchem Node sie laufen soll |
|
|
| `--net none\|down\|on` | keine Karte / Karte ohne Leitung / voll am Netz |
|
|
| `--resume` / `--no-resume` | Arbeitsspeicher laden bzw. bewusst kalt starten |
|
|
| `--transfer <name>` | [Austauschlaufwerk](../wiederherstellen/transfer.md) anhängen (mehrfach möglich) |
|
|
| `--spice` | SPICE-Anzeige (`vga: qxl`), zusätzlich zu noVNC |
|
|
| `--usb <n>` | so viele USB-Weiterleitungen über SPICE (schaltet `--spice` mit ein) |
|
|
| `--iso <volid>` | Abbild als CD einlegen, z. B. `local:iso/virtio-win.iso` |
|
|
| `--memory <MB>` | abweichender Arbeitsspeicher (nicht mit `--resume`) |
|
|
| `--cores <n>` | abweichende Kernzahl (nicht mit `--resume`) |
|
|
| `--name <name>` | Name der neuen Maschine |
|
|
| `--keep-binds` | durchgereichte Host-Verzeichnisse des Originals übernehmen |
|
|
| `--no-start` | nur einrichten, nicht starten |
|
|
| `-y`, `--yes` | Routinefragen überspringen |
|
|
| `--force` | auch anlegen, wenn das Original noch läuft |
|
|
|
|
!!! danger "`-y` deckt `--force` nicht ab"
|
|
|
|
`recover` mit `-y` bei laufendem Original wird **abgewiesen** (Rückgabewert
|
|
2). Siehe [Mit Netzwerk](../wiederherstellen/netzwerk.md).
|
|
|
|
### Optionen der übrigen Befehle
|
|
|
|
| Befehl | Option | |
|
|
|---|---|---|
|
|
| `spice` | `-o <datei>` | in eine Datei schreiben statt auf die Standardausgabe |
|
|
| `flatten` | `--force` | auch bei knappem Speicherplatz |
|
|
| `cleanup` | `--all` | auch Datenträger ohne Elternteil |
|
|
| `cleanup`, `destroy`, `flatten` | `-y`, `--yes` | ohne Rückfrage |
|
|
|
|
### Beispiele
|
|
|
|
```bash
|
|
# Kurz hineinschauen, mit Werkzeugen
|
|
pvesnap-recovery live 101 --transfer werkzeuge
|
|
|
|
# Ein bestimmter Snapshot, kalt gestartet, mit Dongle
|
|
pvesnap-recovery live 105 auto-taeglich-20260809-023000 --usb 2 --no-resume
|
|
|
|
# Ernstfall: Original steht, Wiederherstellung übernimmt
|
|
qm stop 101
|
|
pvesnap-recovery recover 101 --newid 9101
|
|
pvesnap-recovery flatten 9101
|
|
|
|
# Verbindungsdatei für den Arbeitsplatz
|
|
ssh root@pve2 pvesnap-recovery spice 9104 > vm.vv && remote-viewer vm.vv
|
|
|
|
# Aufräumen
|
|
pvesnap-recovery destroy 9101
|
|
pvesnap-recovery cleanup
|
|
```
|
|
|
|
---
|
|
|
|
## systemd
|
|
|
|
```bash
|
|
systemctl status pvesnap
|
|
systemctl reload pvesnap # Konfiguration neu einlesen (SIGHUP)
|
|
systemctl restart pvesnap
|
|
journalctl -u pvesnap -f
|
|
|
|
systemctl status pvesnap-web
|
|
systemctl restart pvesnap-web # nach Änderungen in web.conf
|
|
systemctl stop pvesnap-web
|
|
journalctl -u pvesnap-web -f
|
|
```
|
|
|
|
---
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
./install.sh [optionen]
|
|
./uninstall.sh [--purge]
|
|
```
|
|
|
|
| Option | |
|
|
|---|---|
|
|
| `--with-webexplorer` | Web-Oberfläche als Dienst einrichten (erfordert `--port`) |
|
|
| `--port <nummer>` | Port der Web-Oberfläche |
|
|
| `--bind <adresse>` | Adresse, auf der sie lauscht (Vorgabe `0.0.0.0`) |
|
|
| `--no-start` | installieren, aber Dienste nicht starten |
|
|
| `--no-install-deps` | `parted` und `exfatprogs` nicht nachinstallieren |
|
|
| `--force` | auch ohne erkanntes Proxmox VE installieren |
|
|
| `--help` | Übersicht |
|
|
|
|
---
|
|
|
|
## Hilfswerkzeug
|
|
|
|
```bash
|
|
tools/get-guest-tools.sh <iso-storage>
|
|
```
|
|
|
|
Holt die virtio-win-Treiber auf einen ISO-Storage — für Windows-Gäste, die
|
|
Treiber brauchen, oder für Zwischenablage und Mauszeiger unter
|
|
[SPICE](../wiederherstellen/dongle.md).
|