Previous page

Next page

Locate page in Contents

Adding a VDI Host

Preparing a VDI Host server for Parallels RAS

Before adding a VDI Host to a Parallels RAS farm, you need to determine where the RAS VDI Agent will be installed. Depending on the hypervisor type, the RAS VDI Agent can be installed on one of the following:

  • The host server on which the hypervisor is running (Microsoft Hyper-V only).
  • A supported version of Windows Server running on a physical box or in a virtual machine. For supported Windows Server versions, see Software Requirements > RAS VDI Agent.
  • A preconfigured Linux-based virtual appliance (provided by Parallels). The appliance can be deployed on any hypervisor on your network.

Important: The hypervisor software, the RAS VDI Agent, guest VMs, and the RAS Publishing Agent must all be deployed in the same subnet.

The following table contains the RAS VDI Agent installation information for each supported hypervisor type:

Hypervisor Type

Agent Runs on the VDI Host

Agent Runs on a Windows Server host (VM or HW)

Agent Runs on Appliance

Microsoft Hyper-V

Yes

No

No

Microsoft Hyper-V Failover Cluster

No

Yes

No

VMware VCenter

No

Yes

Yes (OVA or VMDK)

VMware ESXi

No

Yes

Yes (OVA or VMDK)

Citrix XenServer

No

Yes

Yes (OVA or VMDK)

QEmu KVM with libvirt

No

No

Yes (VMDK)

Nutanix Acropolis

No

Yes

Yes (VMDK)

Remote PC (see the Note below)

No

Yes

No

Note: The Remote PC is a special type that can be used to create and manage pools of remote PCs as part of hosted desktop infrastructure (HDI). When you add a VDI host of this type, you can manage it like one of the real VDI hosts with some limitations, such as you cannot create templates and some other strictly VDI-specific functions. The main feature when using this type is the ability to create pools of HDI-based remote PCs and making PCs persistent by assigning an individual PC to a specifics user.

In the table above, find the hypervisor type that you are using and see where the RAS VDI Agent can be installed. Depending on the available choices, do one of the following:

  • Agent runs on the VDI Host. This option is only available if you are using Microsoft Hyper-V. You don't need to do anything special and can proceed to Searching for VDI Hosts or Manually Adding a VDI Host subsections below.
  • Agent runs on a Windows Server (VM or HW). Make sure you have a physical box or virtual machine running a supported version of Windows Server. You will need to specify its FQDN or IP address when adding a VDI Host server to the farm.
  • Agent Runs on Appliance. If this is your choice, you need to download and deploy a virtual appliance as described in the Deploying a Virtual Appliance subsection below.

Please note that if both Windows Server and virtual appliance can be used with your hypervisor type, you can choose one or the other according to your preferences.

Deploying a virtual appliance

To download and install a virtual appliance:

  1. Visit https://www.parallels.com/products/ras/download/links/
  2. On the download page, scroll down to the "VDI Agent Appliances" section and click the VDI Agent Appliance OVA or the VDI Agent Appliance VMDK link to download the appliance. See the table above for the appliance type (OVA or VMDK) compatible with the hypervisor that you are using.
  3. After downloading the virtual appliance, you need to deploy it on a hypervisor. For the information about deploying a virtual appliance, please refer to your hypervisor documentation.

You can now add the VDI Host server to the Parallels RAS farm. You can search your network for available VDI Hosts or you can add a specific VDI Host to the farm manually. The following subsections describe how to do it.

Requirements to push install RAS VDI Agent on a VDI Host

To push install the RAS VDI Agent on a VDI host, the following requirements must be met:

  • The firewall must be configured on the server to allow push installation. Standard SMB ports (139 and 445) need to be open. See also Port Reference for the list of ports used by Parallels RAS.
  • SMB access. The administrative share (\\server\c$) must be accessible. Simple file sharing must be enabled.
  • Your Parallels RAS administrator account must have permissions to perform a remote installation on the server. If it doesn't, you'll be asked to enter credentials of an account that does.
  • The VDI Host server should be joined to an AD domain. If it's not, the push installation may not work and you will have to install the Agent on the server manually. Please see Installing RAS VDI Agent Manually.

Searching for VDI Hosts

To search for available VDI hosts on your network:

  1. In the RAS console, navigate to Farm / Site / VDI Hosts.
  2. On the Virtual Desktop Hosts tab page, click Tasks > Discover VDI hosts.
  3. A dialog opens displaying the discovered VDI hosts (you may have to wait until the discovery completes). If no VDI hosts are found, you can add a host manually (jump to the Manually Adding a VDI Host subsection below).
  4. You can select the Show all hosts option to display all available hosts, including the hosts that don't meet the minimum system requirements. To refresh the list, click Refresh.
  5. Click OK to add the VDI host to the Parallels RAS farm.

Manually adding a VDI Host

To add a VDI host manually:

  1. In the Tasks drop-down menu, click Add to launch the Add VDI Server wizard.
  2. In the VDI Type field, select the hypervisor type that your VDI host is running and specify the host's FQDN or IP address.
  3. Select the Add Firewall Rules option to automatically configure the firewall on the server. See Port Reference for details.
  4. If applicable, select the VDI Agent Service is running on Appliance option.
  5. If the VDI Agent field is enabled, specify the FQDN or IP address of the server where the RAS VDI Agent is (or will be) installed. This can be either a virtual appliance (if you use one) or a Windows Server host (physical box or virtual machine).
  6. Click Next.

The wizard will advance to the VDI Agent Information dialog and will try to connect to the VDI Agent that you specified in the VDI Agent field in the previous step. If the Agent is not installed, do the following:

  1. Click Install to push install the agent on the specified server.
  2. In the Installing RAS VDI Agent dialog, select the appropriate OS in the OS drop-down list. If the Agent is to be installed in a virtual appliance, select "RAS Appliance".
  3. Click Install to install the Agent. When prompted, enter the server (or virtual appliance) administrator credentials.
  4. Click Done. If the automatic installation of the RAS VDI Agent fails for any reason, refer to the Installing RAS VDI Agent Manually section.

Once the RAS VDI Agent is installed, do the following:

  1. In the VDI Agent Information dialog, click Add to add the VDI Host to the Parallels RAS farm.

    Note: If your VDI Host server is running Nutanix Acropolis or KVM and you see a warning message that Nutanix Acropolis (or KVM) was not found, ignore it and continue.

  2. In the Host Properties dialog that opens, click the Credentials tab.
  3. Type the VDI Host administrator credentials and click the Check Credentials button.
  4. Click OK to close the Host Properties dialog.
  5. In the main Parallels RAS Console window, click Apply to apply the changes to Parallels RAS.