Typische Fehlermeldungen#
Diese Meldungen tauchen auf, wenn der Agent nicht richtig eingerichtet ist:
- In Proxmox: „QEMU guest agent is not running“ in der Übersicht der VM
- In der VM: „The unit files have no installation config“ bei
systemctl enable - In der VM: Der Dienst startet nicht und meldet, dass ein Gerät fehlt
In fast allen Fällen fehlt der erste der folgenden Schritte.
Schritt 1: Option in Proxmox aktivieren#
Der Agent kommuniziert über ein spezielles virtuelles Gerät, und das bekommt die VM erst, wenn du die Option einschaltest.
In der Weboberfläche gehst du auf deine VM, dann Optionen → QEMU Guest Agent → Bearbeiten und setzt den Haken bei QEMU Guest Agent verwenden.
Oder in der Shell des Proxmox-Hosts, wobei 100 die ID deiner VM ist:
qm set 100 --agent enabled=1Schritt 2: Agent in der VM installieren#
Debian und Ubuntu#
apt update && apt install qemu-guest-agent -y
systemctl start qemu-guest-agentEin systemctl enable brauchst du nicht. Der Dienst startet automatisch, sobald das Gerät aus Schritt 1 vorhanden ist. Genau deshalb meldet enable den Fehler mit der fehlenden Installationskonfiguration, und den kannst du ignorieren.
Fedora, Rocky Linux und Co.#
dnf install qemu-guest-agent -y
systemctl start qemu-guest-agentWindows#
Unter Windows installierst du den Agent über die VirtIO-Treiber. Binde die ISO mit den VirtIO-Treibern als CD-Laufwerk ein und starte darauf den Installer virtio-win-guest-tools.exe. Damit bekommst du den Agent und alle passenden Treiber auf einmal.
Schritt 3: Prüfen, ob alles läuft#
In der VM:
systemctl status qemu-guest-agentDort sollte active (running) stehen.
Auf dem Proxmox-Host:
qm agent 100 pingKommt keine Fehlermeldung zurück, spricht Proxmox mit dem Agent. In der Weboberfläche siehst du jetzt in der Übersicht der VM auch ihre IP-Adressen.
Weitere nützliche Befehle für die Proxmox-Shell findest du in meiner Übersicht der Proxmox-Befehle.
