Adding VDI Host

0 users found this article helpful

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:
  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:

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.

Was this article helpful?

Tell us how we can improve it.