KVM-Gäste mit virsh verwalten: auflisten, starten, shutdown versus destroy und Autostart

Ziel

KVM-Gäste, die von libvirt verwaltet werden, mit virsh einsehen, starten, stoppen und für den Autostart konfigurieren, ohne die persistente Domain-Definition zu beschädigen.

Voraussetzungen

Root-Rechte oder Mitgliedschaft in der Gruppe libvirt auf dem Hypervisor-Host; der Dienst libvirtd (oder das socket-aktivierte virtqemud) muss laufen. Als root verbindet sich virsh mit qemu:///system; als gewöhnlicher Benutzer verwendet es standardmässig die private Verbindung qemu:///session dieses Benutzers (sofern nicht LIBVIRT_DEFAULT_URI oder die Client-Konfiguration etwas anderes vorgibt). Diese zeigt die System-Gäste nicht an. Daher -c qemu:///system explizit angeben und mit virsh uri prüfen.

Schritte

1. Gäste auflisten: virsh list --all zeigt alle definierten Domains mit ihrem Zustand (running, shut off, paused). virsh list allein zeigt nur laufende Domains.
2. Einen Gast untersuchen: virsh dominfo <name> gibt Zustand, CPU-Anzahl, Arbeitsspeicher, Autostart-Flag und Persistenz aus. virsh domstate <name> gibt nur den Zustand aus.
3. Einen definierten, aber gestoppten Gast starten: virsh start <name>.
4. Geordnetes Stoppen: virsh shutdown <name> fordert das Gast-Betriebssystem zum Herunterfahren auf und kehrt sofort zurück. Der Erfolg ist nicht garantiert, und die Dauer kann variieren. Bei QEMU wählt der Hypervisor die Methode (normalerweise ein ACPI-Power-Button-Ereignis, das das Gast-Betriebssystem verarbeiten muss); --mode agent verwendet stattdessen den QEMU Guest Agent, sofern im Gast einer läuft. virsh domstate <name> wiederholt abfragen, bis shut off gemeldet wird.
5. Hartes Stoppen: virsh destroy <name> beendet die Domain sofort, ohne dem Gast-Betriebssystem eine Möglichkeit zur Reaktion zu geben; das entspricht dem Ziehen des Netzsteckers, und noch nicht geschriebene Daten des Gasts können verloren gehen. Nur verwenden, wenn shutdown nach angemessener Wartezeit nicht abgeschlossen ist. Der Befehl löscht keine Platten, und eine persistente Domain kann erneut gestartet werden; eine transiente Domain verschwindet nach dem Stoppen samt ihren Snapshot-Metadaten.
6. Start einer persistenten Domain beim Booten aktivieren oder deaktivieren: virsh autostart <name> (libvirt startet den Gast, wenn der Host bootet) und virsh autostart --disable <name>, um dies zu entfernen.
7. Konsolenzugriff: virsh console <name> verbindet mit einer im Gast-XML definierten seriellen Konsole (erfordert ein Gerät <console type='pty'> und einen im Gast konfigurierten getty); Beenden mit Ctrl+].
8. Domain-Definitionen liegen als XML unter /etc/libvirt/qemu/<name>.xml; diese Dateien nicht von Hand bearbeiten, da libvirt solche Änderungen nicht übernimmt. Stattdessen virsh edit <name> verwenden: Der Befehl öffnet die persistente (inaktive) Definition in $VISUAL/$EDITOR, prüft sie auf Fehler und definiert die Domain beim Speichern neu. Bei einem laufenden Gast wirkt die Änderung erst beim nächsten Start. Zuvor mit virsh dumpxml --inactive <name> > <name>.xml sichern; virsh dumpxml <name> zeigt die laufende Definition.

Erwartetes Ergebnis

virsh dominfo <name> gibt den neuen Zustand beziehungsweise die neue Autostart-Einstellung sofort wieder; virsh list --all zeigt nach einem destroy oder nach abgeschlossenem shutdown shut off an (nicht unbedingt schon, wenn virsh shutdown zurückkehrt).

Grenzen und Prüfbasis

Das Verhalten hängt davon ab, ob das Gast-Betriebssystem auf die Shutdown-Anforderung reagiert. Ein Gast, der das ACPI-Power-Button-Ereignis nicht verarbeitet (zum Beispiel ein minimales Image, in dem nichts darauf lauscht, oder ein Windows-Gast, dessen Power-Button-Richtlinie auf «nichts tun» gesetzt ist), reagiert nicht und erfordert ein Herunterfahren im Gast, --mode agent oder destroy. Dieses Modul behandelt weder die Installation von libvirt noch die Einrichtung von Netzwerk- oder Storage-Pools, soweit dies nicht angeführt ist.