QNAP Virtualization Station: VMs manuell via SSH und Virsh steuern

Einleitung

Die Virtualization Station auf QNAP NAS-Systemen ist ein mächtiges Werkzeug. Doch was passiert, wenn die Weboberfläche hängt oder Sie eine virtuelle Maschine (VM) schnell per Skript steuern wollen? Hier kommt die Kommandozeile ins Spiel.

Da QNAP eigene Pfade für Bibliotheken nutzt, reicht der einfache Befehl virsh oft nicht aus. Dieses Tutorial zeigt, wie Sie die Umgebungsvariablen korrekt setzen und VMs sicher starten oder stoppen.

Voraussetzungen:

• SSH-Zugriff auf das QNAP NAS (als admin)
• Installierte Virtualization Station
• Namen oder UUIDs der VMs

Schritt 1: Umgebungsvariablen setzen

Das ist der wichtigste Schritt auf QNAP-Systemen. Ohne das Einbinden der QVS-Bibliotheken (Shared Libraries) werden Sie Fehlermeldungen erhalten. Führen Sie diese Befehle nach dem SSH-Login aus:

export LD_LIBRARY_PATH=/QVS/usr/lib:/QVS/usr/lib64/
export PATH=$PATH:/QVS/usr/bin/:/QVS/usr/sbin/

Schritt 2: Virsh Shell starten & Status prüfen

Starten Sie nun die interaktive Verwaltungsshell. Der Prompt ändert sich zu virsh #.

virsh

# Alle VMs auflisten (laufende und gestoppte)
list --all

[BILD 1: Terminal-Screenshot mit der Liste der VMs: Id, Name, State]

Schritt 3: VM Starten

Zum Hochfahren nutzen Sie den Namen (aus der Liste oben) oder die UUID. Der Befehl ist simpel:

start "Windows 11 VM"

Schritt 4: VM Herunterfahren (Shutdown vs. Destroy)

Es gibt zwei Wege, eine VM zu stoppen. Der «saubere» Weg und der «harte» Weg.

A. Regulärer Shutdown (ACPI)

Sendet ein Signal an das Gast-Betriebssystem, herunterzufahren. Dies erfordert, dass ACPI im Gast aktiviert ist.

shutdown "Windows 11 VM"

Hinweis für Windows: Wenn eine RDP-Sitzung aktiv ist oder der Sperrbildschirm hängt, ignoriert Windows dieses Signal oft. Prüfen Sie mit list --all, ob die VM wirklich aus ist.

B. Erzwungenes Ausschalten (Destroy)

Wenn die VM hängt (Freeze), hilft nur das «Ziehen des Stromsteckers». Nutzen Sie dies nur im Notfall, da Datenverlust im Dateisystem droht.

# Stromstecker ziehen (Sofort aus)
destroy "Windows 11 VM"

# Etwas sanfterer Versuch (Versucht Filesystem zu schonen)
destroy --graceful "Windows 11 VM"

Zusammenfassung der Befehle

Verlassen Sie die Shell am Ende mit exit.