A host is called persistent when it is assigned to a particular user or device. To make a host persistent, do the following:
Begin publishing a desktop or a resource from a host.
When specifying Virtual Guest Settings options, select Enable static assignment to host.
Complete the publishing wizard.
As a result, the VM will be assigned to the first user or device who uses a desktop or a resource. For information on how to switch between user and device assignments see section Site defaults (VDI), subsection "General".
You can also manually assign a host to a user or device. To do so:
Navigate to Farm > <Site> > VDI > Desktops.
Select a host and click Tasks > Assign. You can assign a host to a user or device. For information on how to switch between user and device assignments see section Site defaults (VDI), subsection "General".
To assign to a user, specify the user registered in Active Directory.
To assign to a device, select one of the following options:
Add from Active Director allows you to add a device joined to a domain in Active Directory.
Add from known device allows you to add a device known to RAS Device Manager.
Add custom entry allows you to input the device name manually
As a result, the host will be assigned to the selected user.
To view persistent hosts, navigate to Farm > <Site> > VDI > Desktops. A persistent host is identified by the Persistent value in the Assignment column.
To remove persistence from a host, do one of the following:
Select a host on the Desktops tab and then click Tasks > Unassign.
Navigate to Farm > <Site> > VDI > Desktops and click Tasks > Site defaults. In the dialog that opens, use the Auto remove persistence if host was not used for option to select the time period after which persistence should be automatically removed. You can also type any desired time period, such as "1 week 3 days".
There are two basic types of hosts when using Parallels RAS VDI: template-based and non-template based. This topic describes management tasks for both host types, indicating whether a task applies to a particular host type.
To view the list of non-template based hosts, select Farm > <Site> > VDI > Desktops. If you have a filter applied to the list, remove it by click the magnifying glass icon. Without the filter, the list shows all desktops available in this RAS Farm, including hosts (both template-based and non-template based), hosts from a pool (RAS or native), and pool-based Remote PCs. Therefore, the Desktops tab is a location where you can view all of your desktops in one place. Here you can perform all of the standard desktop management tasks accessible from the Tasks menu, including Recreate, Delete, Assign, Unassign, Start, Stop, Restart, Suspend, Reset, Show sessions, and others.The Restart operation (graceful) has a 10 min timeout. If not completed during this time, the Reset operation (forced) will be used.
To view the list of hosts created from a template, select Farm > <Site> > VDI > Templates. Select a template and click Tasks > Show hosts. You will be switched to the Desktops tab where the list of desktops will be filtered to include only those that belong to the template. As was mentioned above, you can perform all of the standard desktop management operations on this tab, including power operations, which are described in detail later in this section.
For the list to include only the hosts from a particular pool, select a pool in the Pools tab and click Tasks > Show hosts in Pool.
The filter in the Desktop tab can also be applied manually by clicking the magnifying glass icon and entering the filter criteria in the fields that appear at the top of the list.
Hosts created from a template inherit the template settings. To view the settings, note on which template a host is based and then view properties of that template, specifically the Settings and Security tabs. For more information, see Site defaults. Note that you a template can inherit Site default settings or you can specify your own custom settings for it.
Non-template based hosts have their own settings, some of which (specifically Settings and Security) are inherited from Site defaults. To see settings for a non template-based VM, navigate to Farm > <Site> > VDI > Desktops. A host that doesn't belong to a template is identified by an empty value in the Template column. Right-click a template and choose Properties (note that template-based hosts do not have this menu option).
A host must have the RAS Guest Agent installed and the agent must match the Parallels RAS version. The agent is installed by default when a host is created from a template. If a host was created using the native hypervisor tools, it may not have the agent installed in it. In such a case, the host will be able to serve only the remote desktop. To enable it to server applications or documents, you'll need to install the agent yourself.
To check if the RAS Guest Agent is installed in a host and is up to date:
Select a host in the list and then click Tasks > Troubleshooting > Check agent.
The Guest Agent Information dialog opens displaying the information about the RAS Guest Agent.
If the agent is not installed, click the Install button and follow the instructions. The agent will be push installed in Windows running inside the host.
To delete a template-based host, select it and then click the Tasks > Delete.
Important: You should delete a host only from the RAS Console. You should not try to delete a host using the hypervisor's native client or web interface. If you do, it may delete not only the VM but its parent template as well (which will also invalidate all other hosts created as linked clones from this template). The reason for this is some native hypervisor clients treat linked clones as standalone VMs. Parallels RAS treats linked clones as clones, not as standalone VMs.
If a template-based host encounters a problem during the preparation stage, it remains on the server but cannot be used. You can identify such VMs by the "Failed to create" value in the Status column. Unless a VM like this is repaired, it will be automatically removed after the time period specified in the Site defaults. To see Site defaults:
Select Farm > <Site> > VDI > Desktop and then click Tasks > Site defaults.
In the dialog that opens, on the General tab, view or modify (if needed) the Auto remove hosts which failed preparation after option. You can set any of the available time periods by selecting it from the drop-down list or you can type a desired value, such as "8 days" or "12 hours".
If something happens to a template-based host and it becomes unusable, you don't have to delete it and create a new one. Instead, you can recreate it keeping its name, MAC address, and other properties. This way none of the other Site settings, which may rely on a broken host, will be affected. Another reason for recreating a host is to apply changes made to the template (when you exit from maintenance without executing the Recreate command).
Please note that recreated VMs can keep the the following properties:
MAC address is kept on ESXi, vCenter, Hyper-v, Hyper-v Failover Cluster, Nutanix AHV (AOS), and SC//HyperCore.
BIOS UUID is kept on ESXi and vCenter.
DRS groups are kept on vCenter.
To recreate one or more hosts:
In the Parallels RAS Console, navigate to Farm > <Site> > VDI > Templates.
To recreate all deployed hosts, click the Tasks drop-down list and choose Recreate all hosts.
To recreate a specific host (or multiple hosts), click Tasks > Show hosts. This will open the Desktops tab, which will list hosts. Select one or more hosts and then click the Tasks > Recreate.
When you recreate a host:
The procedure deletes a VM and creates a new one from the same template.
The new host retains the same computer name as the one it replaces.
If a host is running, all unsaved data in its memory will be lost. For this reason, an important data should be saved to an external storage.
RAS Guest Agent installed on a host discovers RAS Provider Agent by sending broadcast packets over UDP port 30006 to all devices in its subnet.
The discovery packet won't be received if the Agents are on different broadcast domains. In this case, you need to specify the Provider Agent's IP through the registry.
To specify the Provider Agent's IP:
On the host, open the Windows registry.
Add a new string value called 2XVDIAgent
at:
32-bit systems:HLKM > Software > Parallels>GuestAgent
64-bit systems: HLKM > Software > WOW6432Node > Parallels>GuestAgent
The value should be specified as follows:
If a dedicated RAS Provider Agent is used, the value must be set to the FQDN or IP address of the server where the Agent is installed.
If the built-in RAS Provider Agent is used with manual agent selection, the value must be set to the FQDN or IP address of the RAS Publishing Agent.
If the built-in RAS VDI Agent is used and the Agent is selected automatically (high availability), the string must contain FQDNs or IP addresses of all RAS Publishing Agents separated by a semicolon (i.e., <PA1 address>;<PA2 address>;<PA3 address>
).
Note: You can also include names or IP addresses of multiple Publishing Agents for the manual agent selection scenario (the second bullet in the list above). This way you will not need to change the value every time you switch the preferred Publishing Agent for a VDI provider.
Note: If you add the registry key to a host used as a template, its clones will inherit the key.
Restart the RAS Guest Agent service on the host to apply the changes.