Qemu-guest-agent - Proxmox VE (https://pve.proxmox.com/mediawiki/opensearch_desc.php) (Proxmox VE (en)) (https://pve.proxmox.com/mediawiki/api.php?action=rsd) (Proxmox VE Atom feed) (https://pve.proxmox.com/mediawiki/index.php?title=Special:RecentChanges&feed=atom) (https://pve.proxmox.com/wiki/Qemu-guest-agent) Qemu-guest-agent From Proxmox VE Jump to navigation Jump to search Contents 1 Introduction - What is qemu-guest-agent 2 Installation 2.1 Host 2.2 Guest 2.2.1 Linux 2.2.2 Windows 2.3 Testing that the communication with the guest agent is working 3 See Also Introduction - What is qemu-guest-agent The qemu-guest-agent is a helper daemon, which is installed in the guest. It is used to exchange information between the host and guest, and to execute command in the guest. In Proxmox VE, the qemu-guest-agent is used for mainly three things: To properly shutdown the guest, instead of relying on ACPI commands or windows policies To freeze the guest file system when making a backup/snapshot (on windows, use the volume shadow copy service VSS). If the guest agent is enabled and running, it calls guest-fsfreeze-freeze and guest-fsfreeze-thaw to improve consistency. In the phase when the guest (VM) is resumed after pause (for example after shapshot) it immediately synchronizes its time with the hypervisor using qemu-guest-agent (as first step). Installation Host You have to install guest-agent in each VM and then enable it, you can do that in the Proxmox VE Webinterface (GUI) (https://pve.proxmox.com/wiki/File:Proxmox_VE_-_QEMU_Guest_Agent_Option.png) (QEMU Guest Agent Option) (QEMU Guest Agent Option) or via CLI: qm set VMID --agent 1 Guest Linux On Linux you have to simply install the qemu-guest-agent, please refer to the documentation of your system. We show here the commands for Debian/Ubuntu and Redhat based systems: on Debian/Ubuntu based systems (with apt-get) run: apt-get install qemu-guest-agent and on Redhat based systems (with yum): yum install qemu-guest-agent Depending on the distribution, the guest agent might not start automatically after the installation. Start it either directly with systemctl start qemu-guest-agent Then enable the service to autostart (permanently) if not auto started, with systemctl enable qemu-guest-agent (should work for most distributions) or reboot the guest. Windows (https://pve.proxmox.com/wiki/File:Screen-vioserial-device-manager.png) (Screen-vioserial-device-manager.png) (https://pve.proxmox.com/wiki/File:Screen-vioserial-device-manager.png) (Enlarge) (https://pve.proxmox.com/wiki/File:Screen-vioserial-driver.png) (Screen-vioserial-driver.png) (https://pve.proxmox.com/wiki/File:Screen-vioserial-driver.png) (Enlarge) First you have to download the virtio-win driver iso (see (https://pve.proxmox.com/wiki/Windows_VirtIO_Drivers) (Windows VirtIO Drivers) Windows VirtIO Drivers ). Then install the virtio-serial driver: Attach the ISO to your windows VM (virtio-*.iso) Go to the windows Device Manager Look for "PCI Simple Communications Controller" Right Click -> Update Driver and select on the mounted iso in DRIVE:\vioserial\\ where is your Windows Version (e.g. 2k12R2 for Windows 2012 R2) After that, you have to install the qemu-guest-agent: Go to the mounted ISO in explorer The guest agent installer is in the directory guest-agent Execute the installer with double click (either qemu-ga-x86_64.msi (64-bit) or qemu-ga-i386.msi (32-bit) After that the qemu-guest-agent should be up and running. You can validate this in the list of Window Services, or in a PowerShell with: PS C:\Users\Administrator> Get-Service QEMU-GA Status Name DisplayName ------ ---- ----------- Running QEMU-GA QEMU Guest Agent If it is not running, you can use the Services control panel to start it and make sure that it will start automatically on the next boot. Testing that the communication with the guest agent is working The communication with the guest agent takes place over a unix socket located in /var/run/qemu-server/.qga You can test the communication qm agent: qm agent ping if the qemu-guest-agent is correctly runnning in the VM, it will return without an error message. See Also (http://wiki.qemu.org/Features/GuestAgent) http://wiki.qemu.org/Features/GuestAgent (https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/virtualization_deployment_and_administration_guide/chap-kvm_guest_timing_management) https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/7/html/virtualization_deployment_and_administration_guide/chap-kvm_guest_timing_management Retrieved from "" (https://pve.proxmox.com/wiki/Special:Categories) (Special:Categories) Categories : (https://pve.proxmox.com/wiki/Category:HOWTO) (Category:HOWTO) HOWTO (https://pve.proxmox.com/wiki/Category:Installation) (Category:Installation) Installation Cookies help us deliver our services. By using our services, you agree to our use of cookies. (https://www.proxmox.com/en/privacy-policy) More information (OK) OK Navigation menu (https://pve.proxmox.com/mediawiki/index.php?title=Special:UserLogin&returnto=Qemu-guest-agent) (You are encouraged to log in; however, it is not mandatory [alt-shift-o]) Log in (https://pve.proxmox.com/wiki/Qemu-guest-agent) (View the content page [alt-shift-c]) Page (https://pve.proxmox.com/mediawiki/index.php?title=Talk:Qemu-guest-agent&action=edit&redlink=1) (Discussion about the content page (page does not exist) [alt-shift-t]) Discussion (https://pve.proxmox.com/wiki/Qemu-guest-agent) Read (https://pve.proxmox.com/mediawiki/index.php?title=Qemu-guest-agent&action=edit) (This page is protected. You can view its source [alt-shift-e]) View source (https://pve.proxmox.com/mediawiki/index.php?title=Qemu-guest-agent&action=history) (Past revisions of this page [alt-shift-h]) View history (More options) Search (Search Proxmox VE) (Search Proxmox VE [alt-shift-f]) (Search the pages for this text) (Search) (Go to a page with this exact name if it exists) (Go) (https://pve.proxmox.com/wiki/Main_Page) (Visit the main page) (https://pve.proxmox.com/wiki/Main_Page) Proxmox VE (https://pve.proxmox.com/pve-docs/) Documentation (current) (https://pve.proxmox.com/pve-docs-7/) Documentation (7.x) (https://pve.proxmox.com/wiki/Downloads) Downloads (https://pve.proxmox.com/wiki/Installation) Installation (https://pve.proxmox.com/wiki/Get_support) Get support Sites (https://www.proxmox.com/) proxmox.com (https://forum.proxmox.com/) Support forum (https://bugzilla.proxmox.com/) Bugtracker (https://git.proxmox.com/) Source code (https://pve.proxmox.com/wiki/FAQ) FAQ Tools (https://pve.proxmox.com/wiki/Special:WhatLinksHere/Qemu-guest-agent) (A list of all wiki pages that link here [alt-shift-j]) What links here (https://pve.proxmox.com/wiki/Special:RecentChangesLinked/Qemu-guest-agent) (Recent changes in pages linked from this page [alt-shift-k]) Related changes (https://pve.proxmox.com/wiki/Special:SpecialPages) (A list of all special pages [alt-shift-q]) Special pages (Printable version of this page [alt-shift-p]) Printable version (https://pve.proxmox.com/mediawiki/index.php?title=Qemu-guest-agent&oldid=11691) (Permanent link to this revision of this page) Permanent link (https://pve.proxmox.com/mediawiki/index.php?title=Qemu-guest-agent&action=info) (More information about this page) Page information (https://pve.proxmox.com/mediawiki/index.php?title=Special:CiteThisPage&page=Qemu-guest-agent&id=11691&wpFormIdentifier=titleform) (Information on how to cite this page) Cite this page This page was last edited on 16 June 2023, at 08:28. (https://pve.proxmox.com/wiki/Proxmox_VE:Privacy_policy) Privacy policy (https://pve.proxmox.com/wiki/Proxmox_VE:About) About Proxmox VE (https://pve.proxmox.com/wiki/Proxmox_VE:General_disclaimer) Disclaimers (https://www.mediawiki.org/) (Powered by MediaWiki) ()