Available article translations:

Adding VDI Host

  • Parallels Remote Application Server 16.5

Searching for VDI hosts

To search for available VDI Hosts on your network:

  1. In the RAS console, navigate to Farm / Site / VDI.
  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 (see 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. On the Virtual Desktop Host tab page, click Tasks > Add to launch the Add VDI Host wizard.
  2. In the VDI host type field, select the hypervisor type.
  3. In the VDI host address field, specify the host's FQDN or IP address.
  4. Specify a user name and password to log in to the server.
  5. Type an optional description for the host.
  6. Click Next.
  7. On the next page, set the following options:
  • Use dedicated VDI Host Agent: Select this option if you will install (or have installed) the RAS VDI Agent yourself. This includes the virtual appliance scenario. Clear the option if you will use the built-in RAS VDI Agent.
  • Agent address: This option becomes enabled if you select the option above it. 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).
  • Preferred Publishing Agent: Select a RAS Publishing Agent to be the preferred agent for this VDI host. For the built-in RAS VDI Agent, the selection defaults to Automatically. Internally, the system selects the least loaded RAS Publishing Agent.
  1. Click Next.

The wizard will now try to connect to the RAS VDI Agent. If you specified Use dedicated VDI Host Agent and Agent address options in the previous step, and if the agent is not installed, you will need to to install it. Click Install and follow the instructions to push install the agent on the specified host. Please note that for the push installation to work, 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 firewall requirements here for further information. 
  • 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 target 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 manually. 

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. (If your VDI host 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.


Installing RAS VDI Agent Manually

You may need to install the RAS VDI Agent on a VDI host manually if the automatic push installation cannot be performed for any reason. Please note that the below instructions can only be used to install RAS VDI Agent in Windows. 

To install the agent:

  1. Log in to the server where the RAS VDI Agent is to be installed using an administrator account and close all other applications.
  2. Copy the Parallels RAS installation file (RASInstaller.msi) to the server and run it. Follow the onscreen instructions.
  3. On the Select Installation Type page, select Custom and click Next.
  4. Click on the RAS VDI Agent and select Entire Feature will be installed on local hard drive from the drop-down menu.
  5. Ensure that all other components are deselected and click Next.
  6. Click Install to start the installation. Click Finish once the installation is finished.

The RAS VDI Agent does not require any configuration. Once the agent is installed, highlight the server name in the RAS Console and click Troubleshooting > Check Agent. If the agent is installed properly, the status should change to Agent Installed.

Uninstalling RAS VDI Agent

To uninstall the RAS VDI Agent from a server:

  1. Navigate to Start > Control Panel > Programs > Uninstall a Program.
  2. Find Parallels Remote Application Server in the list of installed programs.
  3. If you don't have any other Parallels RAS components on the server that you want to keep, right-click Parallels Remote Application Server and then click Uninstall. Follow the instructions to uninstall the program. You may skip the rest of these instructions.
  4. If you have other RAS components that you want to keep on the server, right-click Parallels Remote Application Server and then click Change.
  5. Click Next on the Welcome page.
  6. On the Change, repair, or remove page, select Change.
  7. On the next page, select Custom.
  8. Select RAS VDI Agent, then click the drop-down menu in front of it, and click Entire feature will be unavailable.
  9. Click Next and complete the wizard.

1d70d1f9c41d01c5f7202a4290e434e1 ede48a144be425de4bf9a9d265a8dd3e

Was this article helpful?
Tell us how we may improve it.
Yes No