- Overview
- Module Description - What the module does and why it is useful
- Setup - The basics of getting started with ovirt_guest_agent
- Usage - Configuration options and additional functionality
- Reference - An under-the-hood peek at what the module is doing and how
- Limitations - OS compatibility, etc.
- Development - Guide for contributing to the module
This module installs and configure ovirt-guest-agent.
ovirt-guest-agent is a daemon that resides within guest virtual machines and is required to supply information to the Virtualization Manager (such as oVirt-engine or Red Hat Enterprise Virtualization Manager) that is required to properly manage the virtual machines.
This module installs ovirt-guest-agent-common (or rhevm-guest-agent-common), enables and starts the ovirt-guest-agent daemon.
- Packages
- ovirt-guest-agent-common
- qemu-guest-agent
- Files
- /etc/ovirt-guest-agent.conf
- Services
- ovirt-guest-agent daemon
This module doesn't enable (possibly) repositories due to the following reasons:
- Required repository may be already enabled (e.g. EPEL)
- Repositories aren't handled by yum directly (e.g. when using Red Hat Satellite, Spacewalk, Katello,...)
- There are plenty of modules available for enabling repositories
The following repositories are required (also see Limitations section below):
-
CentOS 6/7:
-
Red Hat Enterprise Linux 6/7 (ovirt-guest-agent):
-
Red Hat Enterprise Linux 6 (rhevm-guest-agent):
- rhel-6-server-rhev-agent-rpms (subscription-manager) or
- rhel-x86_64-rhev-agent-6-server (RHN classic)
-
Red Hat Enterprise Linux 7 (rhevm-guest-agent):
- rhel-7-server-rh-common-rpms (subscription-manager)
-
Debian 8:
- available in jessie repository, but see limitations!
-
Debian 7:
-
Ubuntu 12.04:
-
Ubuntu 14.04:
-
Ubuntu 16.04:
For mninimal usage try:
include '::ovirt_guest_agent'
which will install the guest agent and enable it.
To pass additional parameters try something like this:
class {'::ovirt_guest_agent':
report_disk_usage => 1,
}
Install ovirt-guest-agent with default configuration file:
class {'::ovirt_guest_agent': }
Install rhevm-guest-agent instead of ovirt-guest-agent with default configuration file:
class {'::ovirt_guest_agent':
service_name => 'rhevm-guest-agent'
package_name => 'rhevm-guest-agent-common'
}
- ovirt_guest_agent: This is the main class which includes all other classes.
- ovirt_guest_agent::service: Starts/stops and enables/disables ovirt-guest-agent daemon.
- ovirt_guest_agent::package: Installs/uninstalls ovirt-guest-agent package.
The following parameters are available in ::ovirt_guest_agent class:
Name of the ovirt-guest-agent service. Override this value if you want to install
rhevm-guest-agent.
Default value: ovirt-guest-agent
Boolen value for enabling or disabling ovirt-guest-agent service. Default value: true
Handles status of ovirt-guest-agent service. Can be running or stopped. Default value: running
Name of the ovirt-guest-agent package. Override this value if you want to install
rhevm-guest-agent. The name differs on RedHat based systems and Debian based system.
Class ::ovirt_guest_agent::params takes care of the right default values.
Default value (RedHat): ovirt-guest-agent-common
Default value (Debian): ovirt-guest-agent
Handles status of ovirt-guest-agent package. Can be installed or absent.
Default value: installed
See operatingsystem_support for list of supported operating systems.
If you're using Debian 8, please note that there are 2 bugs in the ovirt-guest-agent package provided by jessie repository:
- https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=811481
- https://bugs.debian.org/cgi-bin/bugreport.cgi?bug=782005
These bugs are fixed ini package of sid repository.
If you're using Debian 7, please follow the instructions on how to add the required repository: https://software.opensuse.org/download.html?project=home%3Aevilissimo%3Adeb&package=ovirt-guest-agent or
https://www.ovirt.org/documentation/how-to/guest-agent/install-the-guest-agent-in-debian/
If you're using Ubuntu, please follow the instructions on how to add the required repository: https://www.ovirt.org/documentation/how-to/guest-agent/install-the-guest-agent-in-ubuntu/
Users found an issue with package ovirt-guest-agent-common from EPEL in CentOS 7.3 where ownership of /dev/vport2p1 is incorrect. This prevents ovirt-guest-agent from starting correctly. There's no fix for this in this puppet module as this issue has to be fixed in EPEL packages, but have a look at this documented workaround if you're facing the same problem: scrat14#4
Fork this module on Github and send a pull request.