#023 Feldtest auf Proxmox Backup Server und Mail Gateway #23

New Issue

2026-09-18T16:45:44Z

florian.wilde commented

2026-09-18 16:45:44 +00:00

Ziel

Der Feldtest in #018 lief auf zwei Proxmox-VE-Hosts. Für Backup Server und Mail Gateway beruht die
Auswertung im Agent bisher nur auf Annahmen – und bei PVE hat sich genau eine solche Annahme als
falsch erwiesen (--output-format json gibt es dort nicht). Das gehört vor 1.0.0 geprüft.

Ausgangslage

PBS: Hosts stellt Florian bereit, allerdings nur unlizenziert. Damit lässt sich der Fall
„aktive Subscription“ auf PBS nicht prüfen – wohl aber Produkterkennung, Version, Server-ID und der
Zustand notfound, der bei PVE die meisten Überraschungen geliefert hat.
PMG: derzeit kein Host verfügbar. Der Zweig bleibt ungeprüft; das ist im Handbuch zu vermerken.

Aufgaben

scripts/feldtest-erheben.sh auf einem PBS-Host laufen lassen (liest nur, ändert nichts)
Prüfen, ob proxmox-backup-manager subscription get Text oder JSON liefert und welche Felder
ohne Subscription überhaupt erscheinen
Ausgabe von proxmox-backup-manager version gegen produkt_version() prüfen
Erhobene Ausgaben als Testfälle in tests/agent-skript.test.ts aufnehmen – der heutige
PBS-Testfall ist erfunden (JSON) und damit womöglich am echten Verhalten vorbei
Agent auf einem PBS-Host installieren, einen Report abwarten, wieder deinstallieren
PMG offen lassen und die Lücke im Handbuch benennen

Notizen

Der Cluster-Abgleich aus #022 betrifft nur PVE: PBS und PMG kennen kein pvecm, dort bleibt die
Mitgliederliste leer.

Ergebnis (18.09.2026, `bup-ste-pbs-01`, PBS 4.2 auf Debian 13, ohne Subscription)

Ein echter Fehler gefunden – und er war kein kleiner. proxmox-backup-manager subscription get
gibt ohne weitere Angabe eine Rahmentabelle aus:

┌──────────┬────────────────────────────────┐
│ Name     │ Value                          │
╞══════════╪════════════════════════════════╡
│ status   │ notfound                       │

Der Agent suchte nach feld: wert oder JSON – beides passt nicht. Auf einem echten PBS hätte er
alle Felder als null gemeldet, nicht einmal die Server-ID. Der erfundene Testfall hatte genau das
verdeckt, weil er JSON unterstellte.

Behoben in drei Schritten:

Für PBS wird --output-format json verwendet. Anders als PVE kann PBS das (auf 4.2 geprüft).
Bleibt die Ausgabe leer, wird die Textform genommen und die Rahmentabelle ausgewertet
(awk -F'│') – für Fassungen, die das JSON-Format nicht kennen.
proxmox-backup-manager version liefert „proxmox-backup-server 4.2.6-1 running version: 4.2.1“;
gemeldet wird jetzt die installierte Fassung ohne den Zusatz.

Beide Formen sind als Testfälle hinterlegt, mit den echten Ausgaben des Hosts.

Nebenbefund: Der Agent meldete „Neue Agent-Version verfügbar: 0.2.0 (installiert: 0.2.1)“ – er
verglich nur auf Ungleichheit. Jetzt wird mit sort -V geprüft, ob die Fassung wirklich neuer ist.

Ende-zu-Ende geprüft: Installation → Registrierung → erster Report → Warnungen. Im Dashboard kamen
an: Produkt PBS, Version proxmox-backup-server 4.2.6-1, Server-ID 69AED6…, 1 Sockel, 106
ausstehende Pakete, leere Cluster-Liste (PBS kennt kein pvecm), Warnungen „Keine Subscription
gefunden“ und „Host ist keinem Kunden zugewiesen“. Anschließend --uninstall: Timer, Dienst,
/usr/local/bin/proxledger-agent, /etc/proxledger und /var/lib/proxledger restlos entfernt. Damit
ist auch der letzte offene Punkt aus #018 erledigt.

Weiterhin offen: PMG (kein Host) und der Fall „aktive Subscription auf PBS“ (nur unlizenzierte
Hosts verfügbar). Dieses Issue bleibt deshalb offen.

Quelle: docs/issues/023-feldtest-pbs-pmg.md – dort wird dieses Issue gepflegt.

## Ziel Der Feldtest in #018 lief auf zwei Proxmox-VE-Hosts. Für Backup Server und Mail Gateway beruht die Auswertung im Agent bisher nur auf Annahmen – und bei PVE hat sich genau eine solche Annahme als falsch erwiesen (`--output-format json` gibt es dort nicht). Das gehört vor 1.0.0 geprüft. ## Ausgangslage - **PBS:** Hosts stellt Florian bereit, allerdings **nur unlizenziert**. Damit lässt sich der Fall „aktive Subscription“ auf PBS nicht prüfen – wohl aber Produkterkennung, Version, Server-ID und der Zustand `notfound`, der bei PVE die meisten Überraschungen geliefert hat. - **PMG:** derzeit kein Host verfügbar. Der Zweig bleibt ungeprüft; das ist im Handbuch zu vermerken. ## Aufgaben - [x] `scripts/feldtest-erheben.sh` auf einem PBS-Host laufen lassen (liest nur, ändert nichts) - [x] Prüfen, ob `proxmox-backup-manager subscription get` Text oder JSON liefert und welche Felder ohne Subscription überhaupt erscheinen - [x] Ausgabe von `proxmox-backup-manager version` gegen `produkt_version()` prüfen - [x] Erhobene Ausgaben als Testfälle in `tests/agent-skript.test.ts` aufnehmen – der heutige PBS-Testfall ist erfunden (JSON) und damit womöglich am echten Verhalten vorbei - [x] Agent auf einem PBS-Host installieren, einen Report abwarten, wieder deinstallieren - [ ] PMG offen lassen und die Lücke im Handbuch benennen ## Notizen Der Cluster-Abgleich aus #022 betrifft nur PVE: PBS und PMG kennen kein `pvecm`, dort bleibt die Mitgliederliste leer. ## Ergebnis (18.09.2026, `bup-ste-pbs-01`, PBS 4.2 auf Debian 13, ohne Subscription) **Ein echter Fehler gefunden – und er war kein kleiner.** `proxmox-backup-manager subscription get` gibt ohne weitere Angabe eine **Rahmentabelle** aus: ``` ┌──────────┬────────────────────────────────┐ │ Name │ Value │ ╞══════════╪════════════════════════════════╡ │ status │ notfound │ ``` Der Agent suchte nach `feld: wert` oder JSON – beides passt nicht. Auf einem echten PBS hätte er **alle Felder als null gemeldet, nicht einmal die Server-ID**. Der erfundene Testfall hatte genau das verdeckt, weil er JSON unterstellte. Behoben in drei Schritten: 1. Für PBS wird `--output-format json` verwendet. Anders als PVE **kann** PBS das (auf 4.2 geprüft). 2. Bleibt die Ausgabe leer, wird die Textform genommen und die Rahmentabelle ausgewertet (`awk -F'│'`) – für Fassungen, die das JSON-Format nicht kennen. 3. `proxmox-backup-manager version` liefert „proxmox-backup-server 4.2.6-1 running version: 4.2.1“; gemeldet wird jetzt die installierte Fassung ohne den Zusatz. Beide Formen sind als Testfälle hinterlegt, mit den echten Ausgaben des Hosts. **Nebenbefund:** Der Agent meldete „Neue Agent-Version verfügbar: 0.2.0 (installiert: 0.2.1)“ – er verglich nur auf Ungleichheit. Jetzt wird mit `sort -V` geprüft, ob die Fassung wirklich neuer ist. **Ende-zu-Ende geprüft:** Installation → Registrierung → erster Report → Warnungen. Im Dashboard kamen an: Produkt `PBS`, Version `proxmox-backup-server 4.2.6-1`, Server-ID `69AED6…`, 1 Sockel, 106 ausstehende Pakete, leere Cluster-Liste (PBS kennt kein `pvecm`), Warnungen „Keine Subscription gefunden“ und „Host ist keinem Kunden zugewiesen“. Anschließend `--uninstall`: Timer, Dienst, `/usr/local/bin/proxledger-agent`, `/etc/proxledger` und `/var/lib/proxledger` restlos entfernt. Damit ist auch der letzte offene Punkt aus #018 erledigt. **Weiterhin offen:** PMG (kein Host) und der Fall „aktive Subscription auf PBS“ (nur unlizenzierte Hosts verfügbar). Dieses Issue bleibt deshalb offen. --- Quelle: `docs/issues/023-feldtest-pbs-pmg.md` – dort wird dieses Issue gepflegt.

florian.wilde added this to the v1.0.0 milestone 2026-09-18 16:45:44 +00:00

florian.wilde added the agent feldtest labels 2026-09-18 16:45:44 +00:00

florian.wilde referenced this issue from a commit

2026-09-18 21:27:04 +00:00

fix(agent): PBS-Ausgaben richtig auswerten (#023)

florian.wilde referenced this issue

2026-09-18 21:27:10 +00:00

#018 Agent auf echten Proxmox-Hosts prüfen #18

florian.wilde referenced this issue from a commit

2026-10-23 12:01:02 +00:00

release: ProxLedger 1.0.0

Sign in to join this conversation.