A.2. Explanation of settings in the Run Once window

The Run Once window defines one-off boot options for a virtual machine. For persistent boot options, use the Boot Options tab in the New Virtual Machine window. The Run Once window contains multiple sections that can be configured.

The standalone Rollback this configuration during reboots check box specifies whether reboots (initiated by the Manager, or from within the guest) will be warm (soft) or cold (hard). Select this check box to configure a cold reboot that restarts the virtual machine with regular (non-Run Once) configuration. Clear this check box to configure a warm reboot that retains the virtual machine’s Run Once configuration.

The Boot Options section defines the virtual machine’s boot sequence, running options, and source images for installing the operating system and required drivers.

Note

The following tables do not include information on whether a power cycle is required because these one-off boot options apply only when you reboot the virtual machine.

Table A.13. Boot Options Section

Field NameDescription

Attach CD

Attaches an ISO image to the virtual machine. Use this option to install the virtual machine’s operating system and applications. The CD image must reside in the ISO domain.

Attach Windows guest tools CD

Attaches a secondary virtual CD-ROM to the virtual machine with the virtio-win ISO image. Use this option to install Windows drivers. For information on installing the image, see Uploading the VirtIO and Guest Tool Image Files to a Storage Domain in the Administration Guide.

Enable menu to select boot device

Enables a menu to select the boot device. After the virtual machine starts and connects to the console, but before the virtual machine starts booting, a menu displays that allows you to select the boot device. This option should be enabled before the initial boot to allow you to select the required installation media.

Start in Pause Mode

Starts and then pauses the virtual machine to enable connection to the console. Suitable for virtual machines in remote locations.

Predefined Boot Sequence

Determines the order in which the boot devices are used to boot the virtual machine. Select Hard Disk, CD-ROM, or Network (PXE), and use Up and Down to move the option up or down in the list.

Run Stateless

Deletes all data and configuration changes to the virtual machine upon shutdown. This option is only available if a virtual disk is attached to the virtual machine.

The Linux Boot Options section contains fields to boot a Linux kernel directly instead of through the BIOS bootloader.

Table A.14. Linux Boot Options Section

Field NameDescription

kernel path

A fully qualified path to a kernel image to boot the virtual machine. The kernel image must be stored on either the ISO domain (path name in the format of iso://path-to-image) or on the host’s local storage domain (path name in the format of /data/images).

initrd path

A fully qualified path to a ramdisk image to be used with the previously specified kernel. The ramdisk image must be stored on the ISO domain (path name in the format of iso://path-to-image) or on the host’s local storage domain (path name in the format of /data/images).

kernel parameters

Kernel command line parameter strings to be used with the defined kernel on boot.

The Initial Run section is used to specify whether to use Cloud-Init or Sysprep to initialize the virtual machine. For Linux-based virtual machines, you must select the Use Cloud-Init check box in the Initial Run tab to view the available options. For Windows-based virtual machines, you must attach the [sysprep] floppy by selecting the Attach Floppy check box in the Boot Options tab and selecting the floppy from the list.

The options that are available in the Initial Run section differ depending on the operating system that the virtual machine is based on.

Table A.15. Initial Run Section (Linux-based Virtual Machines)

Field NameDescription

VM Hostname

The host name of the virtual machine.

Configure Time Zone

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

Authentication

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

AuthenticationUser Name

Creates a new user account on the virtual machine. If this field is not filled in, the default user is root.

AuthenticationUse already configured password

This check box is automatically selected after you specify an initial root password. You must clear this check box to enable the Password and Verify Password fields and specify a new password.

AuthenticationPassword

The root password for the virtual machine. Enter the password in this text field and the Verify Password text field to verify the password.

AuthenticationSSH Authorized Keys

SSH keys to be added to the authorized keys file of the virtual machine.

AuthenticationRegenerate SSH Keys

Regenerates SSH keys for the virtual machine.

Networks

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

NetworksDNS Servers

The DNS servers to be used by the virtual machine.

NetworksDNS Search Domains

The DNS search domains to be used by the virtual machine.

NetworksNetwork

Configures network interfaces for the virtual machine. Select this check box and click + or - to add or remove network interfaces to or from the virtual machine. When you click +, a set of fields becomes visible that can specify whether to use DHCP, and configure an IP address, netmask, and gateway, and specify whether the network interface will start on boot.

Custom Script

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.

Table A.16. Initial Run Section (Windows-based Virtual Machines)

Field NameDescription

VM Hostname

The host name of the virtual machine.

Domain

The Active Directory domain to which the virtual machine belongs.

Organization Name

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.

Active Directory OU

The organizational unit in the Active Directory domain to which the virtual machine belongs. The distinguished name must be provided. For example CN=Users,DC=lab,DC=local

Configure Time Zone

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

Admin Password

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

Admin PasswordUse already configured password

This check box is automatically selected after you specify an initial administrative user password. You must clear this check box to enable the Admin Password and Verify Admin Password fields and specify a new password.

Admin PasswordAdmin Password

The administrative user password for the virtual machine. Enter the password in this text field and the Verify Admin Password text field to verify the password.

Custom Locale

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

Custom LocaleInput Locale

The locale for user input.

Custom LocaleUI Language

The language used for user interface elements such as buttons and menus.

Custom LocaleSystem Locale

The locale for the overall system.

Custom LocaleUser Locale

The locale for users.

Sysprep

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. The definition will overwrite any values entered in the Initial Run fields. See Chapter 7, Templates for more information.

Domain

The Active Directory domain to which the virtual machine belongs. If left blank, the value of the previous Domain field is used.

Alternate Credentials

Selecting this check box allows you to set a User Name and Password as alternative credentials.

The System section enables you to define the supported machine type or CPU type.

Table A.17. System Section

Field NameDescription

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.

The Host section is used to define the virtual machine’s host.

Table A.18. Host Section

Field NameDescription

Any host in cluster

Allocates the virtual machine to any available host.

Specific Host(s)

Specifies a user-defined host for the virtual machine.

The Console section defines the protocol to connect to virtual machines.

Table A.19. Console Section

Field NameDescription

Headless Mode

Select this option if you do not require a graphical console when running the machine for the first time. See Section 4.9, “Configuring Headless Virtual Machines” for more information.

VNC

Requires a VNC client to connect to a virtual machine using VNC. Optionally, specify VNC Keyboard Layout from the drop-down list.

SPICE

Recommended protocol for Linux and Windows virtual machines. Using SPICE protocol with QXLDOD drivers is supported for Windows 10 and Windows Server 2016 and later virtual machines.

Enable SPICE file transfer

Determines whether you can 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 you can 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.

The Custom Properties section contains additional VDSM options for running virtual machines. See Table A.10, “Virtual Machine Custom Properties Settings” for details.