User Tools

Site Tools


proxmox:guests_vms_and_containers:qemu-guest-agent:install_qemu-guest-agent

Proxmox - Guests (VMs and Containers) - Qemu-guest-agent - Install Qemu-guest-agent

Install the guest-agent in each VM

Debian/Ubuntu

sudo apt install qemu-guest-agent

Redhat

sudo yum install qemu-guest-agent

Windows

Download the virtio-win driver iso (see Windows VirtIO Drivers).

  • 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\<OSVERSION>\ where <OSVERSION> 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.

  • Validate this in the list of Window Services, or in a PowerShell with:
PS C:\Users\Administrator> Get-Service QEMU-GA

returns:

Status   Name               DisplayName
------   ----               -----------
Running  QEMU-GA            QEMU Guest Agent

NOTE: If it is not running, use the Services control panel to start it and make sure that it will start automatically on the next boot.


Start the Agent

Depending on the distribution, the guest agent might not start automatically after the installation.

Start it either directly with

sudo systemctl start qemu-guest-agent

Then enable the service to autostart (permanently) if not auto started, with

sudo systemctl enable qemu-guest-agent

Enable the guest-agent

In the Shell

qm set VMID --agent 1

In the Proxmox GUI

  • Navigate to Options.
  • Enable to Guest Agent.

Test 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/<my_vmid>.qga.

Test the communication qm agent:

qm agent <vmid> ping

NOTE: If the qemu-guest-agent is correctly runnning in the VM, it will return without an error message.


References

proxmox/guests_vms_and_containers/qemu-guest-agent/install_qemu-guest-agent.txt · Last modified: 2023/07/23 09:33 by peter

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki