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 Name Description Attach Floppy Attaches a diskette image to the virtual machine. Use this option to install Windows drivers. The diskette image must reside in the ISO domain. 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. 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 Name Description 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 Name Description 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. Authentication User Name Creates a new user account on the virtual machine. If this field is not filled in, the default user is root . Authentication Use 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. Authentication Password The root password for the virtual machine. Enter the password in this text field and the Verify Password text field to verify the password. Authentication SSH Authorized Keys SSH keys to be added to the authorized keys file of the virtual machine. Authentication Regenerate 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. Networks DNS Servers The DNS servers to be used by the virtual machine. Networks DNS Search Domains The DNS search domains to be used by the virtual machine. Networks Network 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 Name Description 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 Password Use 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 Password Admin 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 Locale Input Locale The locale for user input. Custom Locale UI Language The language used for user interface elements such as buttons and menus. Custom Locale System Locale The locale for the overall system. Custom Locale User 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 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 Name Description 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 Name Description 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 Name Description 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 without QXL drivers is supported for Windows 8 and Server 2012 virtual machines; however, support for multiple monitors and graphics acceleration is not available for this configuration. 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.

Commands: