Feature pages are design documents that developers have created while collaborating on oVirt.

Most of them are outdated, but provide historical design context.

They are not user documentation and should not be treated as such.

Documentation is available here.

Guest Agent Debian

oVirt Guest Agent on Debian 7.x


Packaging the ovirt-guest-agent for Debian 7.x


Current status

  • Last updated: ,

Detailed Description

This feature should provide ovirt-guest-agent packages for Debian

Required changes

  • Debian packaging scripts [DONE]
  • SYS-V init script for Debian [DONE]
  • Adjustments to packaging [DONE]
  • Checkbashism checks on scripts [DONE]
  • Path adjustments for the Debian environment [DONE]
  • Update package list to report for SUSE naming conventions [DONE]
  • Create wrapper scripts for elevated tasks [DONE]

Benefit to oVirt

It’ll be easier to install the ovirt-guest-agent on Debian guests.


Documentation / External references

The guest agent reports the following things

  • Current active user
  • Memory usage (including swap usage)
  • Network Interfaces
  • IP Addresses
  • FQDN of the guest OS
  • Disks Usage
  • Configured RPMs to report (see /etc/ovirt-guest-agent.conf for the packages)
  • Hostname

The guest agent also provides the following actions

  • Desktop Locking for GNOME
  • Shutdown/Reboot from within the Guest OS


# echo "deb ./" >> /etc/apt/sources.list
# gpg -v -a \
> --keyserver \
> --recv-keys D5C7F7C373A1A299
# gpg --export --armor 73A1A299 | apt-key add -
# apt-get update
# apt-get install ovirt-guest-agent
# service ovirt-guest-agent start


Testing has to be executed on a Debian 7 system. Lower version do not fulfil the minimal requirements for the guest agent and testing/unstable are currently not supported by us.


  • Follow the installation instructions above to install the guest agent
  • After about 15-30 seconds the Web Admin Portal entry for the VM should show:
    • the IPv4 Addresses of the VM in the grid
    • the FQDN of the VM in the grid
    • kernel package and the ovirt-guest-agent-common package in the application list
    • The FQDN in the general tab
    • Logged-in User: in the Sessions tab should be filled if a user is logged in.
    • All IPs (IPv4 and IPv6) in the Network Interfaces tab in the Guest Agent Data section for each interface.
  • Verification via on the VDSM side:
    vdsClient -s 0 getVmStats <VM UUID>
    • Reported fields are non-empty:
      • guestFQDN
      • netIfaces
      • disksUsage
      • memoryStats
      • guestName
      • appsList
      • guestOs
      • username
      • guestIPs (if there are IPv4 addresses)

Note: The VM UUID can be found on the Admin Portal in the General tab for the VM

Note: The FQDN value is only only shown if the FQDN is not empty, not localhost and not localhost.localdomain