15.2.6. Red Hat Enterprise Virtualization Manager Configuration Options Explanations, Limitations, and Best Practices

Table 15.1. Red Hat Enterprise Virtualization Manager Configuration Options, Explanations, Limitations, and Best Practices

Option Name Description Possible values Recommended (default) values Comments
AsyncTaskPollingRate Async Task Polling Rate (in seconds) Integer 10 How often (in seconds) RHEV-M queries the status of an async task currently running.
AsyncTaskZombieTaskLifeInMinutes Zombie tasks lifetime in minutes Integer 3000 How long (in minutes) a task is allowed to run before assuming it has become a zombie and should be killed. The value affects large storage manipulations especially. When using slow storage and large virtual images, or when a task is known to take longer than 3000 minutes (50 hours), the value should be increased.
AuditLogAgingThreshold Audit Log Aging Threshold (in days) Integer 30 How long an audit log is kept before being rotated.
AuditLogCleanupTime Time to check for Audit Log cleanup Time 03:35:35 At what time the Audit Log is checked for Aging and cleaned up.
AuthenticationMethod Authentication Method used by RHEV-M String LDAP The API used for querying users. Currently LDAP is the only supported value.
BlockMigrationOnSwapUsagePercentage Host swap percentage threshold (for scheduling) Integer 0 The maximum percentage of swap space on the host that a VM run or migration is allowed to consume on the host. If the host is swapping beyond this percentage, a VM will not migrate over and will not be started.
BootstrapMinimalVdsmVersion Minimum VDSM version String 4.9 The minimum version of VDSM that is acceptable when adding hosts to the Engine. Newer versions have more features.
CABaseDirectory CA Base Directory String /etc/pki/ovirt-engine Where the RHEV-M Certificate Authority is located on the RHEV-M host.
CertificateFileName Certificate File Name String /etc/pki/ovirt-engine/certs/engine.cer Points to the certificate file used by RHEV-M for SSL/TLS communication with VDSM.
CpuOverCommitDurationMinutes The duration in minutes of CPU consumption to activate selection algorithm Integer 2 When the cluster policy is set to Even Distribution, wait for this amount of minutes after detecting CPU overcommit before triggering virtual machine migrations to rebalance the host load. This configuration value applies only for the default.
DisableFenceAtStartupInSec Disable Fence Operations At RHEV-M Startup in Seconds Integer 300 Allow this amount of seconds after RHEV-M starts to detect hosts, before assuming the hosts are non-responsive and proceed to fence hosts. This value should be increased when RHEV-M is on a machine that has slow network startup (a VMWare guest, for example).
EmulatedMachine Supported machine types String RHEL 6.2.0: v3.0 RHEL 6.3.0: v3.1 RHEL 6.4.0: v3.2
WANDisableEffects Disabled WAN Effects value to send to the SPICE console StringMultiple animation The list of effects which will be disabled for SPICE. Possible values: animation, wallpaper, font-smooth, and all.
WANColorDepth WAN Color Depth value to send to the SPICE console Integer 16 The color depth used by the SPICE. Possible values are 16 and 32.
EnableSpiceRootCertificateValidation Enable Spice Root Certification Validation String true If 'true', the certificate of the host on which the virtual machine is running and the RHEV-M setup CA certificate are sent to the SPICE client when attempting to connect to the virtual machine with SPICE, as an extra security mechanism.
EnableUSBAsDefault Enable USB devices attachment to the virtual machine by default String true -
EnableVdsLoadBalancing Enables Host Load Balancing system String true This config value allows the user to turn on or off (true and false, respectively) the virtual machine load balancing according to the policy configured for the cluster.
FreeSpaceCriticalLowInGB Critical low disk space alert threshold (in GB) Integer 5 Produces an alert when a Storage Domain has this amount of space left. This setting is also used in various preliminary tests for action sanity when users try to use storage domains, to prevent reaching this critical amount. Adding and importing disks will fail if the amount of space is less than the value specified here.
FreeSpaceLow Limit of percentage of free disk space below which it is considered low Integer 10 When a storage domain has this percentage of space left, it is considered low on disk space.
HighUtilizationForEvenlyDistribute High Utilization Limit For Evenly Distribute selection algorithm Integer 75 Maximum number of virtual machines per host in the Evenly Distribute algorithm.
HighUtilizationForPowerSave High Utilization Limit For Power Save selection algorithm Integer 75 A default for newly created clusters, in use with PowerSave load balancing algorithm, marks the higher limit of host utilization for populating hosts.
LDAPQueryTimeout Read Timeout in seconds for LDAP queries Integer 30 The amount of time an LDAP query will read before the query is stopped.
LDAPOperationTimeout Search timeout at LDAP server side Integer 30 The amount of time an LDAP search will operate before it is stopped.
LDAPConnectTimeout Connect timeout in seconds for LDAP queries Integer 30 The amount of time an LDAP query will connect before it is stopped.
LocalAdminPassword Local Administrator Password Password Populated during initial setup The password for admin@local default user.
LogPhysicalMemoryThresholdInMB Threshold for logging low host memory in MB Integer 1024 The minimum amount of RAM left before a host is considered low on memory. If a host's RAM is lower than this setting, it is recorded on the audit log and no action is taken.
LowUtilizationForEvenlyDistribute Low Utilization Limit for Evenly Distribute selection algorithm Integer 0 Minimum number of virtual machines per host in the Evenly Distribute algorithm.
LowUtilizationForPowerSave Low Utilization Limit for Power Save selection algorithm Integer 20 A default for newly created clusters, in use with PowerSave load balancing algorithm, marks the lower limit of host utilization for populating hosts.
MacPoolRanges MAC Addresses Pool Ranges String 00:1A:4A:23:18:00-00:1A:4A:23:18:FF The MAC address pool range to be automatically assigned to virtual machines.
MaxDiskSize Max size of newly created disk (in GB) Integer 16384 The maximum size (in GB) for a new virtual disk image assigned to virtual machines.
MaxMacsCountInPool Maximum MAC Addresses count in Pool Integer 100000 Maximum number of MAC addresses allowed in the MAC pool.
MaxNumberofHostsInStoragePool Maximum number of hosts in Storage Pool Integer 250 Limits the maximum number of hosts assigned to the clusters of a single Data Center. This can be increased after testing more hosts, if necessary.
MaxNumOfCpuPerSocket Maximum Number of CPU per socket Integer 16 Maximum number of virtual CPU cores that can be assigned to a single virtual CPU socket.
MaxNumOfVMCpus Total Numbers of Virtual Machine CPUs Integer 160 Maximum total amount of CPU cores assigned to a virtual machine (determined by number of cores multiplied by number of sockets).
MaxNumofVmSockets Maximum number of sockets per virtual machine Integer 16 Maximum number of virtual CPU sockets assigned to a virtual machine.
MaxRerunVmOnVdsCount Maximum virtual machine rerun attempts on a host Integer 3 Maximum number of attempts to start a virtual machine on a host before an error ("unable to start VM") is reported.
MaxStorageVdsDelayCheckSec Max delay for check of domain in seconds Integer 5 Maximum amount of seconds to wait for storage domain status to be returned before reporting an error.
MaxStorageVdsTimeoutCheckSec Maximum timeout for last check of domain in seconds Integer 30 When monitoring storage, vdsmd on the hosts reports a "lastCheck" value for each domain. This setting is used to decide whether the last check happened too long ago and domain is considered in error.
MaxVDSMemOverCommit Max Host Memory Over-Commit (%) for virtual desktops load Integer 200 The percentage of memory overcommit permitted to occur when using virtual desktop loads.
MaxVdsMemOverCommitForServers Maximum Host Memory Over-Commit (%) for Virtual Servers load Integer 150 The percentage of memory overcommit permitted to occur when using virtual server loads.
MaxVdsNameLength Max VDS name length Integer 255 Maximum name length for a Hypervisor host.
MaxVmNameLengthNonWindows Maximum virtual machine name length for non-Windows operating system Integer 64 Maximum name length for a non-Windows virtual machine.
MaxVmNameLengthWindows Maximum name length in Windows Integer 15 Maximum name length for Windows virtual machine (limitation imposed by Windows hostnames).
MaxVmsInPool Max virtual machines in pool Integer 1000 Maximum number of virtual machines in a single data center.
VmPoolMaxSubsequentFailures Maximum number of subsequent VM creation failures before giving up Integer 3 The maximum number of subsequent failed virtual machine creations that can occur in a virtual machine pool before the operation is stopped.
NumberofFailedRunsOnVds Number of Failed Runs on Host Integer 3 Number of attempts to run virtual machines on hosts before setting host status to "Error".
NumberOfVmsForTopSizeVms Number of virtual machines with highest disk size to display Integer 10 Number of virtual machines to display in the storage domain's virtual machine tab. Will display this amount of virtual machines, sorted by the most storage space per used virtual machine.
NumberVmRefreshesBeforeSave Number of Virtual Machine Data Refreshes Before Saving to Database Integer 5 The number of host monitor iterations between refreshing virtual machines from VDSM (determines if virtual machines should be refreshed one upon each iteration)
oVirtISOsRepositoryPath The RHEV-H installation files path String /usr/share/rhev-hypervisor The location of RHEV-H ISO images used for upgrading Hypervisor hosts.
ProductKey2003 Product Key (for Windows 2003) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKey2003x64 Product Key (for Windows 2003 x64) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKey2008 Product Key (for Windows 2008) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKey2008R2 Product Key (for Windows 2008 R2) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKey2008x64 Product Key (for Windows 2008 x64) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKey Product Key (for Windows XP) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKeyWindow7 Product Key (for Windows 7) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductKeyWindow7x64 Product Key (for Windows 7 x64) String - Windows serial key to be used with sysprepped virtual machines created from a template.
ProductRPMVersion Red Hat Enterprise Virtualization Manger RPM Version String Automatically populated The PRM version of the currently used rhevm package.
RDPLoginWithFQN Connect to RDP console with Fully Qualified User-Name (user@domain) String true -
SANWipeAfterDelete Initializing disk image is more secure but it can be time consuming and I/O intensive depending on the size of the image String false Represents the default value (checked/unchecked) of the "wipe after delete" check box in the "New Virtual Disk" dialog if the newly-created Disk belongs to a SAN (FC/iSCSI) Data Center (i.e. about to be created on a SAN storage domain).
SearchResultsLimit Max Quantity of Search Results Integer 100 The number of results to return for search queries if no specific figure is given in the web administration portal or REST.
ServerRebootTimeout Host Reboot Timeout (in seconds) Integer 300 Wait this amount of seconds when a host is rebooted or fenced, before determining that the host is Non Responsive. Can be increased for hosts that take longer to reboot.
SpiceProxyDefault The address of the SPICE Proxy. String none When this key is set to a value, the SPICE proxy is activated (turned on). When this key is not set to a value, the SPICE proxy is not activated (turned off).
SpiceReleaseCursorKeys Keyboard keys combination that causes the mouse cursor to be released from its grab on SPICE String Shift+F12 -
SpiceSecureChannels SPICE Secure Channels String smain, sinputs, scursor, splayback, srecord, sdisplay, susbredir, ssmartcard Which SPICE channels should be secured with SSL.
SpiceToggleFullScreenKeys Keyboard keys combination that toggles the full-screen state of SPICE client window String Shift+F11 -
SpiceUsbAutoShare Enable USB devices sharing by default in SPICE String true Represents the default value (checked/unchecked) of the "Enable USB Auto-Share" check box in the SPICE Console Options dialog in the User Portal.
SpmCommandFailOverRetries Number of retries to failover the Storage Pool Manager on failed commands Integer 3 Number of SPM selection failover retries. In case an SPM command fails, backend performs a failover - it selects a new SPM and re-runs the command.
SPMFailOverAttempts Number of attempts to connect to the Storage Pool Manager before Failover Integer 3 When monitoring a Storage Pool, if the current SPM fails, failover does not happen immediately (see description of SpmCommandFailOverRetries). This setting defines the number of retries before deciding that the current SPM is down and a failover is required.
SpmVCpuConsumption The CPI consumption of SPM embodied as number of VCPUs on the Host Integer 1 When a host is the SPM, it is considered to be using this amount of extra virtual CPUs, to make up for the overhead that SPM operations generate.
SSHInactivityTimeoutSeconds SSH Inactivity Timeout (in seconds) Integer 600 The maximum amount of time backend allows for an SSH session to remote hosts. After this timeout the session is killed.
SSHInactivityHardTimoutSeconds SSH Inactivity Hard Timeout (in seconds) Integer -
NumberOfUSBSlots Number of USB slots in VMs with native USB support Integer 4 -
SSLEnabled SPICE SSL Enabled String true Whether SPICE Secure channels should be SSL encrypted.
StorageDomainFailureTimeoutInMinutes Storage Domain failure timeout Integer 5 Defines the amount of time taken before deciding domain is problematic, starting at the first failure reported by VDSM (in minutes).
StoragePoolRefreshTimeInSeconds Storage Pool Manager Polling Rate (in seconds) Integer 10 Storage Pool monitoring frequency.
SysPrep2K3Path Path to a Windows 2003 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.2k3 Path to the operating system specific sysprep file template.
SysPrep2K8Path Path to a Windows 2008 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.2k8x86 Path to the operating system specific sysprep file template.
SysPrep2K8R2Path Path to a Windows 2008 R2 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.2k8 Path to the operating system specific sysprep file template.
SysPrep2K8x64Path Path to a Windows 2008 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.2k8 Path to the operating system specific sysprep file template.
SysPrepWindows7Path Path to a Windows 7 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.w7 Path to the operating system specific sysprep file template.
SysPrepWindows7x64Path Path to a Windows 7 x64 machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.w7x64 Path to the operating system specific sysprep file template.
SysPrepWindows8Path Path to a Windows 8 machine Sys-Prep file String /etc/ovirt-engine/sysprep/sysprep.w8 Path to the operating system specific sysprep file template.
SysPrepWindows8x64Path Path to a Windows 8 x64 machine Sys-Prep file String /etc/ovirt-engine/sysprep/sysprep.w8x64 Path to the operating system specific sysprep file template.
SysPrepWindows2012x64Path Path to a Windows 2012 x64 machine Sys-Prep file String /etc/ovirt-engine/sysprep/sysprep.2k12x64 Path to the operating system specific sysprep file template.
SysPrepXPPath Path to a Windows XP machine sysprep file string /etc/ovirt-engine/sysprep/sysprep.xp Path to the operating system specific sysprep file template.
TimeoutToResetVdsInSeconds Communication timeout in seconds before attempting reset Integer 60 The amount of time a host is nonresponsive before a fence command is issued. This is used in conjunction with VDSAttemptsToResetCount.
TimeToReduceFailedRunOnVdsInMinutes Time to Reduce Failed Run on Host (in minutes) Integer 30 The amount of time that the host will be in Error status after failing to run virtual machines.
UserDefinedVMProperties User-defined virtual machine properties String Custom properties set by user Mostly used with VDSM hooks.
UserRefreshRate Refresh Rate of Users' Data from Active Directory (in seconds) Integer 3600 How often the directory server is polled for user account updates.
UtilizationThresholdInPercent The Utilization Threshold (in percent) Integer 80 In load balancing, this is a default value used to calculate the maximum CPU limit to determine if the host is over-utilized. This is the percent of the value that the user set in high-utilization in the cluster.
ValidNumOfMonitors Valid Numbers of Monitors Integer 1,2,4 Number of monitors available for SPICE-enabled virtual machines.
VdcVersion Red Hat Enterprise Virtualization Manager Version String Automatically set to the current version of RHEV-M -
VDSAttemptstoResetCount Number of attempts to communicate with Host before trying to reset Integer 2 The amount of times to retry communications with a host before a fence command is issued. Used in conjunction with TimeoutToResetVdsInSeconds.
VdsLoadBalancingIntervalInMinutes Host Load Balancing Interval (in minutes) Integer 1 The interval between running the virtual machines' load balancer in minutes (also defines the first invocation of the load balancer).
VdsRecoveryTimeoutInMinutes Host Timeout when Recovering (in minutes) Integer 3 When VDSM fails/restarts, it can sometimes be in recovering mode (VDSM reports "initializing" or "recovering from reports").
VdsRefreshRate Time interval in seconds to poll a Host's status Integer 2 How often a Hypervisor host's status is checked.
vdsTimeout Host Control Communication Timeout (in seconds) Integer 180 Timeout for a VDSM call - the time engine will wait for sync call to VDSM.
VMGracefulShutdownMessage Message displayed in Virtual Machine when Virtual Machine is being shut down from Red Hat Enterprise Virtualization Manager String The Red Hat Enterprise Virtualization Manager is shutting down this Virtual Machine -
VMMinMemorySizeInMB Minimal memory size of virtual machine in MB Integer 256 -
VncKeyboardLayout Keyboard Layout configuration for VNC String en-us Possible values: ar, da, de-ch, en-us, et, fo, fr-be, fr-ch, hu, it, li, mk, nl, no, pt, ru, sv, tr, de en-gb, es, fi, fr, fr-ca, hr, is, ja, lv, nl-be, pl, pt-br, sl, th.
WaitForVdsInitInSec Wait for a host to complete init in SPM selection Integer 60 This is a timeout for initializing host as in VdsRecoveryTimeoutInMinutes, but this timeout is shorter and is used during the SPM selection algorithm. If the selected host is initialized, wait for it to recover.
FenceQuietTimeBetweenOperationsInSec Quiet time between Power Management operations in seconds Integer 180 The minimum time in seconds between two power management operations activated manually by a user.
MaxAuditLogMessageLength Maximum length of an Audit Log message Integer 10000 -
SysPrepDefaultUser Default sysprep user name String - This user is used if the domain for sysprep is unknown or no domain is specified.
SysPrepDefaultPassword Default SysPrep user password Password Empty This password is used if the domain for sysprep is unknown or no domain is specified.
UserSessionTimeOutInterval Session timeout interval in minutes Integer 30 User session timeout. Global for all types of access - User Portal/Admin Portal/Web Admin/API.
AdminPassword admin user password Password ****** Password of admin user (used if no directory service is used for authentication).
IPTablesConfig Iptables configuration used to autoconfigure the Manager. String The complete set of iptables rules that are used when automatic firewall configuration is selected during rhevm-setup
OvirtIsoPrefix oVirt ISOs files prefix String rhevh
OvirtInitialSupportedIsoVersion oVirt node initial Supported ISO Version String 5.8
VdsLocalDisksLowFreeSpace Amount of free disk space on a host local storage domain that should be considered low, in MB. Integer 1000 Setting this value lower than the default of 1000MB reduces the time available to add additional space to your data domains before virtual machine performance is affected. If you have many virtual machines, generating or recieving data, it may make sense to set this value higher.
VdsLocalDisksCriticallyLowFreeSpace Amount of free disk space on a host local storage domain that should be considered critically low, in MB. Integer 500 Setting this value lower than the default of 500MB reduces the time between when critical disk shortage messages begin being displayed and when virtual machine performance is affected. If you have many virtual machines, generating or receiving data quickly, you might find that the default value is too low, and does not provide enough time to add more storage.
AllowDuplicateMacAddresses Enable duplicate MAC address for VM network interface String false If enabled, allows that the same MAC address be set explicitly on several virtual NICs. Otherwise, setting a MAC address that is already in use on another virtual NIC is prohibited.
JobCleanupRateInMinutes Frequency of jobs clean-up process Integer 10
SucceededJobCleanupTimeInMinutes Time to keep successfully ended jobs Integer 10
FailedJobCleanupTimeInMinutes Time to keep failed jobs Integer 60
VmPoolMonitorIntervalInMinutes Interval in minutes for monitoring number of Prestarted Vms in Vm Pools Integer 5
VmPoolMonitorBatchSize Maximum number of Vms that the Vm Pool Monitor will attempt to Prestart in a single cycle Integer 5
NetworkConnectivityCheckTimeoutInSeconds The time to wait before rolling back network changes in case the engine losses connectivity with the host in seconds Integer 120
AllowClusterWithVirtGlusterEnabled Allows to create a Cluster with both Virt and Gluster services enabled String false If enabled, the user can create a cluster with both Virt and Gluster support or one of them, otherwise the user cannot create a cluster that supports both.
EnableMACAntiSpoofingFilterRules Indicates if Network Filtering should be enabled or not String v3.0: false v3.1: false v3.2: true If enabled, MAC anti-spoofing rules are set on each virtual NIC, enforcing that the ethernet frames this NIC sends have the source MAC that is assigned to it in the engine.
EnableHostTimeDrift Indicates if host time-drift validation is enabled String false If time drift validation is enabled, the Manager will require that host system time be within a given variation of the Manager system time. The allowed difference is set by HostTimeDriftInSec
EngineMode Engine working mode String Active
HostTimeDriftInSec Allowed time drift between any Host and Engine Integer 300