Appendix A. Reference: Settings in Administration Portal and User Portal Windows

Cluster

The name of the host cluster to which the virtual machine is attached. Virtual machines are hosted on any physical machine in that cluster in accordance with policy rules.

Template

The template on which the virtual machine is based. This field is set to Blank by default, which allows you to create a virtual machine on which an operating system has not yet been installed. Templates are displayed as Name | Sub-version name (Sub-version number). Each new version is displayed with a number in brackets that indicates the relative order of the version, with a higher number indicating a more recent version.

The version name is displayed as base version if it is the root template of the template version chain.

When the virtual machine is stateless, there is an option to select the latest version of the template. This option means that anytime a new version of this template is created, the virtual machine is automatically recreated on restart based on the latest template.

Operating System

The operating system. Valid values include a range of Red Hat Enterprise Linux and Windows variants.

Instance Type

The instance type on which the virtual machine's hardware configuration can be based. This field is set to Custom by default, which means the virtual machine is not connected to an instance type. The other options available from this drop down menu are Large, Medium, Small, Tiny, XLarge, and any custom instance types that the Administrator has created.

Other settings that have a chain link icon next to them are pre-filled by the selected instance type. If one of these values is changed, the virtual machine will be detached from the instance type and the chain icon will appear broken. However, if the changed setting is restored to its original value, the virtual machine will be reattached to the instance type and the links in the chain icon will rejoin.

Optimized for

The type of system for which the virtual machine is to be optimized. There are two options: Server, and Desktop; by default, the field is set to Server. Virtual machines optimized to act as servers have no sound card, use a cloned disk image, and are not stateless. In contrast, virtual machines optimized to act as desktop machines do have a sound card, use an image (thin allocation), and are stateless.

Name

The name of the virtual machine. The name must be a unique name within the data center and must not contain any spaces, and must contain at least one character from A-Z or 0-9. The maximum length of a virtual machine name is 255 characters. The name can be re-used in different data centers in the environment.

VM ID

The virtual machine ID. The virtual machine's creator can set a custom ID for that virtual machine. If no ID is specified during creation a UUID will be automatically assigned. For both custom and automatically-generated IDs, changes are not possible after virtual machine creation.

Description

A meaningful description of the new virtual machine.

Comment

A field for adding plain text human-readable comments regarding the virtual machine.

Stateless

Select this check box to run the virtual machine in stateless mode. This mode is used primarily for desktop virtual machines. Running a stateless desktop or server creates a new COW layer on the VM hard disk image where new and changed data is stored. Shutting down the stateless VM deletes the new COW layer, which returns the VM to its original state. Stateless virtual machines are useful when creating machines that need to be used for a short time, or by temporary staff.

Start in Pause Mode

Select this check box to always start the virtual machine in pause mode. This option is suitable for virtual machines which require a long time to establish a SPICE connection; for example, virtual machines in remote locations.

Delete Protection

Select this check box to make it impossible to delete the virtual machine. It is only possible to delete the virtual machine if this check box is not selected.

Instance Images

Click Attach to attach a floating disk to the virtual machine, or click Create to add a new virtual disk. Use the plus and minus buttons to add or remove additional virtual disks.

Click Edit to reopen the Attach Virtual Disks or New Virtual Disk window. This button appears after a virtual disk has been attached or created.

Instantiate VM network interfaces by picking a vNIC profile.

Add a network interface to the virtual machine by selecting a vNIC profile from the nic1 drop-down list. Use the plus and minus buttons to add or remove additional network interfaces.

Memory Size

The amount of memory assigned to the virtual machine. When allocating memory, consider the processing and storage needs of the applications that are intended to run on the virtual machine.

Maximum guest memory is constrained by the selected guest architecture and the cluster compatibility level.

Total Virtual CPUs

The processing power allocated to the virtual machine as CPU Cores. Do not assign more cores to a virtual machine than are present on the physical host.

Virtual Sockets

The number of CPU sockets for the virtual machine. Do not assign more sockets to a virtual machine than are present on the physical host.

Cores per Virtual Socket

The number of cores assigned to each virtual socket.

Threads per Core

The number of threads assigned to each core. Increasing the value enables simultaneous multi-threading (SMT). IBM POWER8 supports up to 8 threads per core. For x86 (Intel and AMD) CPU types, the recommended value is 1.

Custom Emulated Machine

This option allows you to specify the machine type. If changed, the virtual machine will only run on hosts that support this machine type. Defaults to the cluster's default machine type.

Custom CPU Type

This option allows you to specify a CPU type. If changed, the virtual machine will only run on hosts that support this CPU type. Defaults to the cluster's default CPU type.

Custom Compatibility Version

The compatibility version determines which features are supported by the cluster, as well as, the values of some properties and the emulated machine type. By default, the virtual machine is configured to run in the same compatibility mode as the cluster as the default is inherited from the cluster. In some situations the default compatibility mode needs to be changed. An example of this is if the cluster has been updated to a newer compatibility version but the virtual machines have not been restarted. These virtual machines can be set to use a custom compatibility mode that is older than that of the cluster. See Changing the Cluster Compatibility Version in the Administration Guide for more information.

Hardware Clock Time Offset

This option sets the time zone offset of the guest hardware clock. For Windows, this should correspond to the time zone set in the guest. Most default Linux installations expect the hardware clock to be GMT+00:00.

Provide custom serial number policy

This check box allows you to specify a serial number for the virtual machine. Select either:

Use Cloud-Init/Sysprep

Linux, Windows

This check box toggles whether Cloud-Init or Sysprep will be used to initialize the virtual machine.

VM Hostname

Linux, Windows

The host name of the virtual machine.

Windows

The Active Directory domain to which the virtual machine belongs.

Windows

The name of the organization to which the virtual machine belongs. This option corresponds to the text field for setting the organization name displayed when a machine running Windows is started for the first time.

Windows

The organizational unit in the Active Directory domain to which the virtual machine belongs.

Configure Time Zone

Linux, Windows

The time zone for the virtual machine. Select this check box and select a time zone from the Time Zone list.

Windows

The administrative user password for the virtual machine. Click the disclosure arrow to display the settings for this option.

Linux

The authentication details for the virtual machine. Click the disclosure arrow to display the settings for this option.

Windows

Custom locale options for the virtual machine. Locales must be in a format such as en-US. Click the disclosure arrow to display the settings for this option.

Networks

Linux

Network-related settings for the virtual machine. Click the disclosure arrow to display the settings for this option.

Custom Script

Linux

Custom scripts that will be run on the virtual machine when it starts. The scripts entered in this field are custom YAML sections that are added to those produced by the Manager, and allow you to automate tasks such as creating users and files, configuring yum repositories and running commands. For more information on the format of scripts that can be entered in this field, see the Custom Script documentation.

Windows

A custom Sysprep definition. The definition must be in the format of a complete unattended installation answer file. You can copy and paste the default answer files in the /usr/share/ovirt-engine/conf/sysprep/ directory on the machine on which the Red Hat Virtualization Manager is installed and alter the fields as required. See Chapter 7, Templates for more information.

Headless Mode

Enables and disables the graphical console for the virtual machine. If Headless Mode is set, the virtual machine will run after next restart without a graphical console and display device.

Video Type

Defines the graphics device. QXL is the default and supports both graphic protocols. VGA and CIRRUS support only the VNC protocol.

Graphics protocol

Defines which display protocol to use. SPICE is the default protocol. VNC is an alternative option. To allow both protocols select SPICE + VNC.

VNC Keyboard Layout

Defines the keyboard layout for the virtual machine. This option is only available when using the VNC protocol.

USB Support

Defines SPICE USB redirection. This option is only available for virtual machines using the SPICE protocol. Select either:

Console Disconnect Action

Defines what happens when the console is disconnected. This is only relevant with SPICE and VNC console connections. This setting can be changed while the virtual machine is running but will not take effect until a new console connection is established. Select either:

Monitors

The number of monitors for the virtual machine. This option is only available for virtual desktops using the SPICE display protocol. You can choose 1, 2 or 4. Note that multiple monitors are not supported for Windows 8 and Windows Server 2012 virtual machines.

Smartcard Enabled

Smart cards are an external hardware security feature, most commonly seen in credit cards, but also used by many businesses as authentication tokens. Smart cards can be used to protect Red Hat Virtualization virtual machines. Tick or untick the check box to activate and deactivate Smart card authentication for individual virtual machines.

Single Sign On method

Enabling Single Sign On allows users to sign into the guest operating system when connecting to a virtual machine from the User Portal using the Guest Agent.

Disable strict user checking

Click the Advanced Parameters arrow and select the check box to use this option. With this option selected, the virtual machine does not need to be rebooted when a different user connects to it.

By default, strict checking is enabled so that only one user can connect to the console of a virtual machine. No other user is able to open a console to the same virtual machine until it has been rebooted. The exception is that a SuperUser can connect at any time and replace a existing connection. When a SuperUser has connected, no normal user can connect again until the virtual machine is rebooted.

Disable strict checking with caution, because you can expose the previous user's session to the new user.

Soundcard Enabled

A sound card device is not necessary for all virtual machine use cases. If it is for yours, enable a sound card here.

Enable SPICE file transfer

Defines whether a user is able to drag and drop files from an external host into the virtual machine's SPICE console. This option is only available for virtual machines using the SPICE protocol. This check box is selected by default.

Enable SPICE clipboard copy and paste

Defines whether a user is able to copy and paste content from an external host into the virtual machine's SPICE console. This option is only available for virtual machines using the SPICE protocol. This check box is selected by default.

Enable VirtIO serial console

The VirtIO serial console is emulated through VirtIO channels, using SSH and key pairs, and allows you to access a virtual machine's serial console directly from a client machine's command line, instead of opening a console from the Administration Portal or the User Portal. The serial console requires direct access to the Manager, since the Manager acts as a proxy for the connection, provides information about virtual machine placement, and stores the authentication keys. Select the check box to enable the VirtIO console on the virtual machine.

Start Running On

Defines the preferred host on which the virtual machine is to run. Select either:

Migration Options

Migration mode

Defines options to run and migrate the virtual machine. If the options here are not used, the virtual machine will run or migrate according to its cluster's policy.

Use custom migration policy

Defines the migration convergence policy. If the check box is left unselected, the host determines the policy.

Use custom migration downtime

This check box allows you to specify the maximum number of milliseconds the virtual machine can be down during live migration. Configure different maximum downtimes for each virtual machine according to its workload and SLA requirements. Enter 0 to use the VDSM default value.

Auto Converge migrations

Only activated with the Legacy migration policy. Allows you to set whether auto-convergence is used during live migration of the virtual machine. Large virtual machines with high workloads can dirty memory more quickly than the transfer rate achieved during live migration, and prevent the migration from converging. Auto-convergence capabilities in QEMU allow you to force convergence of virtual machine migrations. QEMU automatically detects a lack of convergence and triggers a throttle-down of the vCPUs on the virtual machine. Auto-convergence is disabled globally by default.

Enable migration compression

Only activated with the Legacy migration policy. The option allows you to set whether migration compression is used during live migration of the virtual machine. This feature uses Xor Binary Zero Run-Length-Encoding to reduce virtual machine downtime and total live migration time for virtual machines running memory write-intensive workloads or for any application with a sparse memory update pattern. Migration compression is disabled globally by default.

Pass-Through Host CPU

This check box allows virtual machines to take advantage of the features of the physical CPU of the host on which they are situated. This option can only be enabled when Do not allow migration is selected.

Configure NUMA

NUMA Node Count

The number of virtual NUMA nodes to assign to the virtual machine. If the Tune Mode is Preferred, this value must be set to 1.

Tune Mode

The method used to allocate memory.

NUMA Pinning

Opens the NUMA Topology window. This window shows the host's total CPUs, memory, and NUMA nodes, and the virtual machine's virtual NUMA nodes. Pin virtual NUMA nodes to host NUMA nodes by clicking and dragging each vNUMA from the box on the right to a NUMA node on the left.

CPU Allocation

The CPU profile assigned to the virtual machine. CPU profiles define the maximum amount of processing capability a virtual machine can access on the host on which it runs, expressed as a percent of the total processing capability available to that host. CPU profiles are defined on the cluster level based on quality of service entries created for data centers.

CPU Shares

Allows users to set the level of CPU resources a virtual machine can demand relative to other virtual machines.

CPU Pinning topology

Enables the virtual machine's virtual CPU (vCPU) to run on a specific physical CPU (pCPU) in a specific host. The syntax of CPU pinning is v#p[_v#p], for example:

In order to pin a virtual machine to a host, you must also select the following on the Host tab:

Memory Allocation

Physical Memory Guaranteed

Memory Balloon Device Enabled

Enables the memory balloon device for this virtual machine. Enable this setting to allow memory overcommitment in a cluster. Enable this setting for applications that allocate large amounts of memory suddenly but set the guaranteed memory to the same value as the defined memory. Use ballooning for applications and loads that slowly consume memory, occasionally release memory, or stay dormant for long periods of time, such as virtual desktops. See Optimization Settings Explained in the Administration Guide for more information.

Storage Allocation

The Storage Allocation option is only available when the virtual machine is created from a template.

Thin

Provides optimized usage of storage capacity. Disk space is allocated only as it is required. When selected, the format of the disks will be marked as QCOW2 and you will not be able to change it.

Clone

Optimized for the speed of guest read and write operations. All disk space requested in the template is allocated at the time of the clone operation. When selected, you can select either QCOW2 or RAW as the disk format.

VirtIO-SCSI Enabled

Allows users to enable or disable the use of VirtIO-SCSI on the virtual machines.

Disk Allocation

The Disk Allocation option is only available when the virtual machine is created from a template.

Alias

An alias for the virtual disk. By default, the alias is set to the same value as that of the template.

Virtual Size

The total amount of disk space that the virtual machine based on the template can use. This value cannot be edited, and is provided for reference only.

Format

The format of the virtual disk. The available options are QCOW2 and Raw. If Thin is selected in the Storage Allocation section, then QCOW2 will be automatically selected and cannot be changed.

Target

The storage domain on which the virtual disk is stored. By default, the storage domain is set to the same value as that of the template.

Disk Profile

The disk profile to assign to the virtual disk. Disk profiles are created based on storage profiles defined in the data centers.