> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/run-the-platform/de/virtuelle-maschinen/vm-guest-agent.md). # VM-Gastagent Der Gastagent ist ein Programm, das im Gastbetriebssystem installiert ist und es dem Host ermöglicht, Befehle innerhalb der VM auszuführen. Dies ermöglicht konsistente, zuverlässige Backups, indem das Dateisystem des Gasts vor Snapshots eingefroren wird, sowie das ordnungsgemäße Herunterfahren eines Gasts ohne Abhängigkeit von ACPI, Richtlinien usw. ## Voraussetzungen * Den Gastagenten für die VM aktivieren * Installation des Gastagenten (im Gastbetriebssystem) ## Den Gastagenten aktivieren Der Gastagent muss pro VM aktiviert werden; dies kann während der VM-Erstellung oder durch Bearbeiten einer vorhandenen VM erfolgen. Das Kontrollkästchen „Gastagent“ im VM-Dashboard zeigt an, ob der Agent aktiviert ist. ![agent-enabled-notconnected.png](/files/e465d31551f513aa9ebbacdcb404680fbf0b2068) ### Den Gastagenten auf einer vorhandenen VM aktivieren 1. Zum VM-Dashboard navigieren 2. Klicken Sie **Bearbeiten** im linken Menü. 3. Klicken Sie, um das **QEMU-Gast-Agent** Kontrollkästchen. 4. Klicken Sie **Senden** um die Änderung zu speichern. ## Agentensoftware auf Windows-VMs installieren ### Zum Herunterladen/Installieren des Gast-Tools-Installationsprogramms Das Installationsprogramm für den Gastagenten kann über den folgenden Link heruntergeladen werden (und im Gast ausgeführt werden): {% hint style="success" %} Achten Sie während der Einrichtung des VirtIO-Installers darauf, die *Installieren* Schaltfläche für Gerätesoftware auszuwählen. {% endhint %} Die VM muss neu gestartet werden, um die Änderungen zu übernehmen und den Agenten zu verbinden. ### Um das vollständige VirtIO-ISO in das vSAN herunterzuladen Die folgenden Anweisungen beschreiben das Platzieren der Datei win-virtio.iso (die die erforderliche Agenten-Gastsoftware enthält) auf dem vSAN; dies ermöglicht das Laden der Software auf das CD-ROM-Laufwerk einer VM für eine einfache Installation im Gastbetriebssystem. 1. Klicken Sie auf den untenstehenden Link, um auf das VirtIO-ISO zuzugreifen. 2. Der Link „Hochladen von URL“ erscheint, wobei alle Felder automatisch ausgefüllt sind; normalerweise müssen keine Änderungen vorgenommen werden; optional können jedoch die Felder „Dateiname“, „Dateibeschreibung“ und/oder „Bevorzugte Stufe“ geändert werden, falls gewünscht. 3. Klicken Sie auf „Senden“, um die VirtIO-ISO-Datei in das vSAN herunterzuladen. 4. Wenn der Fortschritt 100 % abgeschlossen anzeigt (Fortschrittsbalken oben rechts), ist die Datei verfügbar, erscheint in der Dateiliste und als Auswahloption für jedes CD-Laufwerk. Siehe die untenstehenden Anweisungen zur Installation der Gastagentensoftware aus dem heruntergeladenen VirtIO-ISO. ### Gastagent (Windows) aus dem VirtIO-ISO installieren {% hint style="info" %} Die VM muss über ein CD-ROM-Gerät verfügen {% endhint %} 1. Navigieren Sie zum **VM-Dashboard**. 2. Klicken Sie auf die CD-ROM-Auswahltaste (oben links) ![fa-eject.png](/files/1e1730ec46ea342edeb96a9cc564c8624d78f7e1) 3. Wählen Sie **virtio-win.iso (oder der während des Downloads geänderte Dateiname)**. 4. Klicken Sie **Senden** um die CD-Änderung zu übernehmen. 5. Klicken Sie **Remote-Konsole** im linken Menü, um die Konsole des Gastbetriebssystems zu öffnen. 6. Gehen Sie zu **Windows-Geräte-Manager**. 7. Klicken Sie mit der rechten Maustaste auf **"PCI Simple Communications Controller"**. 8. Wählen Sie **Treiber aktualisieren**. 9. Navigieren Sie zum **Pfad des CD-ROM-Laufwerks** mit dem heruntergeladenen ISO. 10. Navigieren Sie zu: **vioserial\IHRE WINDOWS-VERSION (z. B. 2k12R2, WIN10 usw.)**. 11. Klicken Sie **Weiter** um die Treiberaktualisierung abzuschließen. 12. Im Windows-Datei-Explorer, **navigieren Sie zum CD-ROM** mit dem VirtIO-ISO. 13. Navigieren Sie in den **guest-agent** Ordner. 14. **Doppelklicken Sie** auf das richtige MSI **(qemu-ga-x86.msi\[64-Bit] oder qemu-ga-1386.msi\[32-Bit])** Datei, um das Installationsprogramm zu starten. {% hint style="success" %} Ein Neustart der VM kann erforderlich sein, um den Agenten mit dem Host zu verbinden. {% endhint %} ## Agentensoftware auf Linux-VMs installieren Auf Linux-VMs muss das **qemu-guest-agent-Paket** installiert werden. Die Installationsanweisungen variieren je nach spezifischer Linux-Distribution/Version. * Auf Systemen, die apt für die Installation verwenden **(Debian-/Ubuntu-basiert)**: ``` apt-get install qemu-guest-agent ``` * Auf Systemen mit **Yum (Red Hat)**: ``` yum install qemu-guest-agent ``` * Bei einigen Distributionen ist **ein Neustart oder manuelles Starten** des Agenten erforderlich: ``` systemctl start qemu-guest-agent ``` ## VM-Gastagentenverbindung überprüfen Wenn ein Gastagent erfolgreich verbunden ist, wird die Versionsnummer neben dem aktivierten Kontrollkästchen „Gastagent“ im VM-Dashboard angezeigt. ![agent-connected-version.png](/files/a3274a4efe2045d19aa3ed9e793a816895bb191b) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.verge.io/run-the-platform/de/virtuelle-maschinen/vm-guest-agent.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.