In order to add a Remote PC to a RAS Farm, RAS Remote PC Agent must be installed on it. The requirements to push install RAS Remote PC Agent are as follows:
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 PC. If it doesn't, you'll be asked to enter credentials of an account that does.
The PC 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 it manually. Please see Installing Remote PC Agent manually.
Follow the below procedure to add a Remote PC to a Farm:
In the RAS Console, select the Farm category and click the Remote PCs node in the navigational tree.
Click Add in the Tasks drop-down list to launch the setup wizard.
Specify the IP address or FQDN of a Remote PC. Click the Get MAC button to obtain the PC's MAC address. To automatically resolve IP address to FQDN, enable the global Name Resolution option. For details, see Host name resolution.
Click Next.
In this step, the Parallels RAS checks if the Remote PC Agent is installed on the specified PC. If it's not installed, click Install to push install the agent on the PC. If the push installation of Remote PC Agent fails for any reason, you can install it manually. See Installing Remote PC Agent Manually below.
Click Add to add the Remote PC to the Parallels RAS Farm.
You may need to install the Remote PC Agent manually if the automatic push installation cannot be performed for any reason. To do so:
Log into the PC where the Remote PC Agent is to be installed using an administrator account and close all other applications.
Copy the Parallels RAS installation file (RASInstaller.msi
) to the PC and double click it to launch the installation.
Follow the onscreen instructions and proceed to the installation type page. Select Custom and click Next.
Click on the Remote PC Agent and select Entire Feature will be installed on local hard drive from the drop-down list.
Ensure that all other components are deselected and click Next.
Click Install to start the installation. Click Finish once the installation is finished.
Remote PC Agent does not require any configuration. Once the agent is installed, select the Remote PC name in the Parallels RAS Console and click Troubleshooting > Check Agent. If the agent is installed properly, the status should change to Agent Installed.
To uninstall Remote PC Agent from a server:
Navigate to Start > Control Panel > Programs > Uninstall a Program.
Find Parallels Remote Application Server in the list of installed programs.
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.
If you have other RAS components that you want to keep on the server, right-click Parallels Remote Application Server and then click Change.
Click Next on the Welcome page.
On the Change, repair, or remove page, select Change.
On the next page, select Custom.
Select Remote PC Agent, then click the drop-down list in front of it, and click Entire feature will be unavailable.
Click Next and complete the wizard.
Remote PCs can be added to a RAS Farm using one of the following methods:
Admin-initiated enrollment from the RAS Console by specifying the PC's IP and MAC addresses and installing (remotely or directly) RAS Remote PC Agent on it.
By allowing users to use self-service Remote PC enrollment.
Read the subsequent sections for the description of each method.
As an alternative to the admin-initiated Remote PC enrollment described above, end users can add their preferred PCs to a RAS Farm in a self-service manner. A computer enrolled this way is automatically added to a RAS Farm as a Remote PC and a corresponding published desktop is created with access granted (through automatic filtering) to the user who performed the self-enrollment. The Remote PC can then be accessed by the user from any device, anywhere.
Note: This feature applies to standalone Remote PCs. It is not intended for Remote PCs configured through VDI technology.
Users enrolling their PCs must have local administrator privileges in Windows to install Parallels RAS Remote PC Agent.
Mailbox must be configured in a RAS Farm to send an invitation email to end users.
To configure self-service Remote PC enrollment:
In the RAS Console, navigate to Farm > Site > Remote PCs.
In the right pane, click the Tasks menu and choose Self-service enrollment. In the dialog that opens, specify the options described below.
To enable self-service enrollment, select Allow or Allow until. For the latter, specify the date and time. To disable the functionality (e.g. temporarily), select Do not allow.
In the Settings section, specify a publishing folder in which the PCs will appear as published resources. You can select an existing folder or create a new one. Click the [..] button to select or create a folder.
The Remote PC invitation hash field contains a hash that must be specified when enrolling a PC. The hash can also be copied from here and used separately for scripting purposes. IT administrators can make use of this hash along with the msiexec
command to silently install and configure Remote PC on users’ behalf. For details, see Enrolling a PC below.
To send an invitation email to users that will contain instructions on how to enroll their PCs, click the Send via email button.
In the dialog that opens, specify the recipients by typing (or pasting) their email addresses. You can also click the [..] button and select the recipients.
In the Review the invitation email text box, review or modify (if needed) the email. The variables used in the email are set internally and are substituted with their values in the actual email. To preview the final email text, click Tasks > Preview.
Click Send to send the email. If you don't want to send the email at this time, click Cancel to return to the previous dialog where you can click OK to save the changes.
When a user receives the invitation email, they will follow the instructions that it contains to enroll their PC. The installation process consists of the steps described below.
Log in to the Remote PC. Download or copy the RASInstaller.msi file (the Parallels RAS installer) and run the following command with administrative privileges (the invitation email will contain this command with the hash value already in it):
The following arguments can be used to customize the enrollment. Such arguments are required if a Remote PC is not in the Active Directory domain:
OVERRIDEPAIP: The IP address of one of the Connection Brokers in the Farm Site. Use this if the standard installation fails to connect using the system detected IP address.
OVERRIDEUSER: Use this argument if you don't want to register the Remote PC to the user logged in to the machine.
OVERRIDEHOST: Use this argument if you want to change the published item name from the hostname of the Remote PC.
Once the installation is complete, launch Parallels Client and log in using the local machine credentials or the ones specified in the OVERRIDEUSER argument. Look for your Remote PC using the IP address or the name specified via OVERRIDEHOST in the list of published resources and launch the desktop.