# Managing RD Session Hosts based on a template

## **Viewing RD Session Hosts based on a specific template**

To view the list of RD Session Hosts based on a specific template:

1. Go to **Farm** > \<Site> > **RD Session Hosts** > **Templates.**
2. Select a template and click **Tasks** > **Show servers**.

## **Site defaults**

RD Session Hosts based on a template inherit the template settings. To view the settings, note on which template an RD Session Host is based and then view properties of that template, specifically the **Settings** and **Security** tabs. For more information, see [**Site defaults**](https://docs.parallels.com/parallels-ras-administrators-guide-21/parallels-ras-21-administrators-guide/virtual-desktop-infrastructure-vdi/site-defaults-vdi). Note that you a template can inherit Site default settings or you can specify your own custom settings for it.

## **Checking the RAS Guest Agent status**

A guest RD Session Hosts based on a template must have RAS Guest Agent installed and the agent must match the Parallels RAS version. The agent is installed by default when an RD Session Host is created from a template. If the RD Session Host was created using the native hypervisor tools, it may not have the agent installed in it. In such a case, the RD Session 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 and up to date:

1. Go to **Farm** > \<Site> > **RD Session Hosts** > **RD Session Hosts.**
2. Continue as described in [**Managing hosts**,](https://docs.parallels.com/parallels-ras-administrators-guide-21/parallels-ras-21-administrators-guide/virtual-desktop-infrastructure-vdi/manage-vdi/manage-hosts-vdi) subsection "Checking the RAS Guest Agent status".

The RD Session Host template must also have the RAS RD Session Host Agent installed.

To check if the RAS RD Session Host Agent is installed and up to date:

1. Go to **Farm** > \<Site> > **RD Session Hosts** > **Templates.**
2. Select a template in the list and then click **Tasks** > **Troubleshooting** > **Check agent**.

## **Deleting an RD Session Hosts based on a template**

See [**Managing hosts**](https://docs.parallels.com/parallels-ras-administrators-guide-21/parallels-ras-21-administrators-guide/virtual-desktop-infrastructure-vdi/manage-vdi/manage-hosts-vdi), subsection "Deleting a host".

## **Managing RD Session Hosts based on a template that failed preparation**

See [**Managing hosts**](https://docs.parallels.com/parallels-ras-administrators-guide-21/parallels-ras-21-administrators-guide/virtual-desktop-infrastructure-vdi/manage-vdi/manage-hosts-vdi), subsection "Managing hosts that failed preparation". Notice than in case of RD Session Hosts, you have to go to **Farm** > \<Site> > **RD Session Hosts** > **RD Session Hosts** and click **Tasks** > **Site defaults** to see Site Defaults.

## **Recreating an RD Session Hosts based on a template**

If something happens to a RD Session Hosts based on a template 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 RD Session Host, will be affected. Another reason for recreating an RD Session Host is to apply changes made to the template (when you exit from maintenance without executing the Recreate command).

Please note that recreated RD Session Hosts 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.

{% hint style="info" %}
**Note:** If an RD Session Host based on a template was already assigned to an RD Session Host host pool, it cannot be recreated.
{% endhint %}

To recreate one or more guest RD Session Host:

1. In the Parallels RAS Console, navigate to **Farm** > \<Site> > **RD Session Hosts** > **Templates.**
2. To recreate all deployed RD Session Host, click the **Tasks** drop-down list and choose **Recreate all servers**.
3. To recreate a specific host (or multiple hosts), click **Tasks** > **Show servers**. This will open the dialog which will list RD Session Hosts. Select one or more RD Session Hosts and then click the **Tasks** > **Recreate**.

When you recreate a RD Session Host based on a template:

* The procedure deletes the RD Session Host and creates a new one from the same template.
* The new RD Session Host retains the same computer name as the one it replaces.
* If an RD Session 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.
