pvereport und Co.: System-Report für Proxmox VE, Backup Server und Mail Gateway
Der System-Report ist die Grundlage für die drei Proxmox-Analyzer. So erstellst du ihn für Proxmox VE, Proxmox Backup Server und Proxmox Mail Gateway, über die Web-Oberfläche oder die Shell, auch für ganze Cluster.
Alle drei Proxmox-Produkte bringen ein Werkzeug mit, das den Zustand eines Hosts in eine einzige Textdatei schreibt: Versionen, Kernel, Netzwerk, Storage und die Konfiguration. Der Proxmox-Support verlangt diesen Report bei Tickets, und meine drei Analyzer nutzen ihn als Eingabe:
- Proxmox VE:
pvereport, ausgewertet vom Proxmox Virtual Environment (PVE) Analyzer. - Proxmox Backup Server:
proxmox-backup-manager report, ausgewertet vom Proxmox Backup Server (PBS) Analyzer. - Proxmox Mail Gateway:
pmg-system-report, ausgewertet vom Proxmox Mail Gateway (PMG) Analyzer.
Proxmox VE
Der pvereport enthält neben dem System auch ZFS-Pools, den Ceph-Status und die Konfiguration aller VMs und Container.
Web-Oberfläche
- Links im Rechenzentrum den gewünschten Node auswählen.
- Im Menü des Nodes den Punkt Subscription öffnen.
- Oben rechts auf System Report klicken.
- Im Fenster auf Download klicken. Die Datei landet als Textdatei im Download-Ordner.
Shell
Per SSH oder über die Konsole in der Web-Oberfläche:
pvereport > pvereport-$(hostname).txt
Der Hostname im Dateinamen hilft später, die Reports eines Clusters auseinanderzuhalten. Die Datei anschliessend z. B. mit scp auf den eigenen Rechner kopieren:
scp root@pve01:/root/pvereport-pve01.txt .
Cluster
Der Report beschreibt immer nur den Host, auf dem er erzeugt wurde. Für Cluster-Checks wie die N-1-Reserve oder die Konsistenz von DNS und /etc/hosts braucht der Analyzer die Reports aller Nodes. Diese gemeinsam hochladen, dann erkennt das Tool den Cluster automatisch.
Wer alle Reports auf einmal einsammeln möchte, kann das von einem Node aus erledigen:
for n in pve01 pve02 pve03; do
ssh root@$n pvereport > pvereport-$n.txt
done
Proxmox Backup Server
Web-Oberfläche
- Links im Menü unter Configuration den Punkt Subscription öffnen.
- Oben auf System Report klicken und herunterladen. Die Datei heisst
localhost-pbs-report-….txt.
Dieser Weg läuft ohne Root-Rechte, deshalb fehlen der Zustand der Boot-Partitionen und der BIOS-Stand.
Shell
Als root, das ist der vollständigere Weg:
proxmox-backup-manager report > $(hostname)-pbs-report.txt
Mehrere Server
Zieht ein Server per Sync-Job von einem anderen ab, lohnt es sich, den Haupt-PBS und den Offsite-PBS gemeinsam hochzuladen. Der Analyzer erkennt die Beziehung: Die Quelle gilt dann als abgesichert, und das Ziel wird als Kopie geführt.
Proxmox Mail Gateway
Web-Oberfläche
- Links im Menü Configuration aufklappen und Subscription öffnen.
- Oben in der Leiste auf System Report klicken (rechts neben Check).
- Im Fenster auf Download klicken. Die Datei heisst
<hostname>-report-<datum>.txt.
Der Knopf funktioniert auch ohne Subscription-Schlüssel.
Shell
Als root auf dem Gateway:
pmg-system-report > $(hostname)-report.txt
Cluster
Bei einem PMG-Cluster die Reports aller Nodes gemeinsam hochladen. Reports mehrerer Gateways in einem Durchgang werden automatisch getrennt und einzeln bewertet.
Was steht drin?
Alle drei Reports enthalten Hostnamen, IP-Adressen und die Konfiguration des Systems. Dazu kommt je nach Produkt:
- Proxmox VE: die komplette Netzwerk- und Storage-Konfiguration, der Subscription-Status und die Konfiguration aller VMs und Container. Passwörter sind nicht enthalten.
- Proxmox Backup Server: Datastores, Jobs, Benutzer, Tokens und Rechte. Dazu die Datei
remote.cfgmit den nur Base64-kodierten Passwörtern der Sync-Verbindungen. Wer das nicht weitergeben möchte, entfernt die Zeilepasswordvorher aus der Datei. - Proxmox Mail Gateway: Kundendomains, vertrauenswürdige Netze und das komplette Regelwerk.
Interne Strukturen stehen also in jedem Fall drin. Vor dem Weitergeben an Dritte lohnt sich ein Blick in die Datei.
Alle drei Analyzer verarbeiten die Dateien nur während der Anfrage und speichern nichts.