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 |