⁠12.2. Virtual Machine Pool Tasks

12.2.1. Creating a Virtual Machine Pool
12.2.2. Explanation of Settings and Controls in the New Pool Window
12.2.3. Editing a Virtual Machine Pool
12.2.4. Explanation of Settings and Controls in the Edit Pool Window
12.2.5. Prestarting Virtual Machines in a Pool
12.2.6. Adding Virtual Machines to a Virtual Machine Pool
12.2.7. Detaching Virtual Machines from a Virtual Machine Pool
12.2.8. Removing a Virtual Machine Pool

⁠12.2.1. Creating a Virtual Machine Pool

Summary
You can create a virtual machine pool that contains multiple virtual machines that have been created based on a common template.
⁠

Procedure 12.1. Creating a Virtual Machine Pool

  1. Click the Pools tab.
  2. Click the New button to open the New Pool window.
    • Use the drop down-list to select the Cluster or use the selected default.
    • Use the Based on Template drop-down menu to select a template or use the selected default. If you have selected a template, optionally use the Template Sub Version drop-down menu to select a version of that template. A template provides standard settings for all the virtual machines in the pool.
    • Use the Operating System drop-down list to select an Operating System or use the default provided by the template.
    • Use the Optimized for drop-down list to optimize virtual machines for either Desktop use or Server use.
  4. Enter a Name and Description, any Comments and the Number of VMs for the pool.
  5. Select the Maximum number of VMs per user that a single user is allowed to run in a session. The minimum is one.
  6. Optionally, click the Show Advanced Options button and perform the following steps:
    1. Select the Console tab. At the bottom of the tab window, select the Override SPICE Proxy check box to enable the Overridden SPICE proxy address text field and specify the address of a SPICE proxy to override the global SPICE proxy, if any.
    2. Click the Pool tab and select a Pool Type:
      • Manual - The administrator is responsible for explicitly returning the virtual machine to the pool. The virtual machine reverts to the original base image after the administrator returns it to the pool.
      • Automatic - When the virtual machine is shut down, it automatically reverts to its base image and is returned to the virtual machine pool.
  7. Click OK.
Result
You have created and configured a virtual machine pool with the specified number of identical virtual machines. You can view these virtual machines in the Virtual Machines resource tab, or in the details pane of the Pools resource tab; a virtual machine in a pool is distinguished from independent virtual machines by its icon.

⁠12.2.2. Explanation of Settings and Controls in the New Pool Window

⁠12.2.2.1. New Pool General Settings Explained

The following table details the information required on the General tab of the New Pool window that is specific to virtual machine pools. All other settings are identical to those in the New Virtual Machine window.
⁠

Table 12.1. General settings

Field Name
Description
Number of VMs
Allows you to specify the number of virtual machines to be created and made available in the virtual machine pool. By default, the maximum number of virtual machines you can create in a pool is 1000. This value can be configured using the MaxVmsInPool key of the engine-config command.
Maximum number of VMs per user
Allows you to specify the maximum number of virtual machines a single user can take from the virtual machine pool at any one time. The value of this field must be between 1 and 32,767.

⁠12.2.2.2. New Pool Pool Settings Explained

The following table details the information required on the Pool tab of the New Pool window.
⁠

Table 12.2. Console settings

Field Name
Description
Pool Type
This drop-down menu allows you to specify the type of the virtual machine pool. The following options are available:
  • Automatic: After a user finishes using a virtual machine taken from a virtual machine pool, that virtual machine is automatically returned to the virtual machine pool.
  • Manual: After a user finishes using a virtual machine taken from a virtual machine pool, that virtual machine is only returned to the virtual machine pool when an administrator manually returns the virtual machine.

⁠12.2.2.3. New Pool and Edit Pool Console Settings Explained

The following table details the information required on the Console tab of the New Pool or Edit Pool window that is specific to virtual machine pools. All other settings are identical to those in the New Virtual Machine and Edit Virtual Machine windows.
⁠

Table 12.3. Console settings

Field Name
Description
Override SPICE proxy
Select this check box to enable overriding the SPICE proxy defined in global configuration. This feature is useful in a case where the user (who is, for example, connecting via the User Portal) is outside of the network where the hypervisors reside.
Overridden SPICE proxy address
The proxy by which the SPICE client will connect to virtual machines. This proxy overrides both the global SPICE proxy defined for the Red Hat Enterprise Virtualization environment and the SPICE proxy defined for the cluster to which the virtual machine pool belongs, if any. The address must be in the following format: 
protocol://[host]:[port]

⁠12.2.3. Editing a Virtual Machine Pool

After a virtual machine pool has been created, its properties can be edited. The properties available when editing a virtual machine pool are identical to those available when creating a new virtual machine pool except that the Number of VMs property is replaced by Increase number of VMs in pool by.
⁠

Procedure 12.2. Editing a Virtual Machine Pool

  1. Click the Pools resource tab and select a virtual machine pool in the results list.
  2. Click Edit to open the Edit Pool window.
  3. Edit the properties of the virtual machine pool.
  4. Click Ok.

⁠12.2.4. Explanation of Settings and Controls in the Edit Pool Window

⁠12.2.4.1. Edit Pool General Settings Explained

The following table details the editable fields on the General tab of the Edit Pool window.
⁠

Table 12.4. General settings

Field Name
Description
Description
A meaningful description of the virtual machine pool.
Prestarted VMs
Allows you to specify the number of virtual machines in the virtual machine pool that will be started before they are taken and kept in that state to be taken by users. The value of this field must be between 0 and the total number of virtual machines in the virtual machine pool.
Increase number of VMs in pool by
Allows you to increase the number of virtual machines in the virtual machine pool by the specified number.
Maximum number of VMs per user
Allows you to specify the maximum number of virtual machines a single user can take from the virtual machine at any one time. The value of this field must be between 1 and 32,767.

⁠12.2.5. Prestarting Virtual Machines in a Pool

The virtual machines in a virtual machine pool are powered down by default. When a user requests a virtual machine from a pool, a machine is powered up and assigned to the user. In contrast, a prestarted virtual machine is already running and waiting to be assigned to a user, decreasing the amount of time a user has to wait before being able to access a machine. When a prestarted virtual machine is shut down it is returned to the pool and restored to its original state. The maximum number of prestarted virtual machines is the number of virtual machines in the pool.
Summary
Prestarted virtual machines are suitable for environments in which users require immediate access to virtual machines which are not specifically assigned to them. Only automatic pools can have prestarted virtual machines.
⁠

Procedure 12.3. Prestarting Virtual Machines in a Pool

  1. Use the Pools resource tab, tree mode, or the search function to find and select the virtual machine pool in the results list.
  2. Click Edit to open the Edit Pool window.
  3. Enter the number of virtual machines to be prestarted in the Prestarted VMs field.
  4. Select the Pool tab. Ensure Pool Type is set to Automatic.
  5. Click OK.
Result
You have set a number of prestarted virtual machines in a pool. The prestarted machines are running and available for use.

⁠12.2.6. Adding Virtual Machines to a Virtual Machine Pool

Summary
If you require more virtual machines than originally provisioned in a virtual machine pool, add more machines to the pool.
⁠

Procedure 12.4. Adding Virtual Machines to a Virtual Machine Pool

  1. Use the Pools resource tab, tree mode, or the search function to find and select the virtual machine pool in the results list.
  2. Click Edit to open the Edit Pool window.
  3. Enter the number of additional virtual machines to add in the Increase number of VMs in pool by field.
  4. Click OK.
Result
You have added more virtual machines to the virtual machine pool.

⁠12.2.7. Detaching Virtual Machines from a Virtual Machine Pool

Summary
You can detach virtual machines from a virtual machine pool. Detaching a virtual machine removes it from the pool to become an independent virtual machine.
⁠

Procedure 12.5. Detaching Virtual Machines from a Virtual Machine Pool

  1. Use the Pools resource tab, tree mode, or the search function to find and select the virtual machine pool in the results list.
  2. Ensure the virtual machine has a status of Down because you cannot detach a running virtual machine.
    Click the Virtual Machines tab in the details pane to list the virtual machines in the pool.
  3. Select one or more virtual machines and click Detach to open the Detach Virtual Machine(s) confirmation window.
  4. Click OK to detach the virtual machine from the pool.

Note

The virtual machine still exists in the environment and can be viewed and accessed from the Virtual Machines resource tab. Note that the icon changes to denote that the detached virtual machine is an independent virtual machine.
Result
You have detached a virtual machine from the virtual machine pool.

⁠12.2.8. Removing a Virtual Machine Pool

Summary
You can remove a virtual machine pool from a data center. You must first either delete or detach all of the virtual machines in the pool. Detaching virtual machines from the pool will preserve them as independent virtual machines.
⁠

Procedure 12.6. Removing a Virtual Machine Pool

  1. Use the Pools resource tab, tree mode, or the search function to find and select the virtual machine pool in the results list.
  2. Click Remove to open the Remove Pool(s) confirmation window.
  3. Click OK to remove the pool.
Result
You have removed the pool from the data center.