Connecting to a Parallels RAS Farm
If you have more than one Parallels RAS Farm in your organization, you can use the same Parallels RAS Console instance to manage any of them. By default, the Parallels RAS Console is installed on the same server where you install other Parallels RAS components, but you can install the console on any computer on your network.
Connecting to a Parallels RAS Farm for the first time
When you open the Parallels RAS Console for the first time, it displays the logon dialog on which you need to specify the following:
Farm: A Parallels RAS Farm to connect to. Enter the FQDN or IP address of the server where you have RAS Connection Broker installed.
If you've installed the Parallels Single Sign-On component when installing the RAS Console, you will see the Authentication type field from which you can select whether to log on using your credentials or SSO. If you reboot after the installation and select SSO, select Single Sign-On and then click Connect. Your Windows credentials will be used to log in to the RAS Farm. If you select Credentials, enter your credentials as described below.
Username: A user account with administrative privileges on the server where Parallels RAS is installed (usually a domain or local administrator). The account name must be specified using the UPN format (e.g. administrator@domain.com). The specified user will be automatically configured as the Parallels RAS administrator with full access rights.
Password: The specified user account password.
If you select the Remember credentials option, this dialog will not be shown the next time you launch the Parallels RAS Console.
After entering the connection properties, click Connect to connect to the Farm and open the RAS Console.
Note that the Edit Connections button will not display any information on first connect (it is used to edit Farm connections that already exist), so you can ignore it at this point. We will talk about using this button closer to the end of this section.
Connecting to a different Parallels RAS Farm
When you need to connect to a different Parallels RAS Farm, you first need to log off from the Parallels RAS Console in order to see the logon dialog again. To do so:
In the Parallels RAS Console, click on the arrow icon next to your user name in the upper right-hand corner and then choose Log Off in the context menu.
The console will close and the RAS logon dialog will open. The dialog will be populated with the current Farm connection properties.
To connect to a different Farm, type the FQDN or IP address of the server where the other Farm is located. Once again, this should be the server where you have the RAS Connection Broker installed.
Specify a username and password and click Connect. The Parallels RAS Console will connect to the Farm using the connection properties that you specified.
Switching between Parallels RAS Farms
After you connect to more than one Farm from the same Parallels RAS Console instance, you can easily switch between them as follows:
In the Parallels RAS Console, click the Location drop-down list in the upper left-hand corner (right below the main application menu, where the current Site name is displayed).
The lower portion of the drop-down list will contain names of the Farms to which you connected at least once in the past (the upper portion contains one or more Site names for the current Farm). Click a desired Farm name to connect to it.
When you click the Farm name, the console will close momentarily and will re-open connected to the Farm that you selected.
Note that you can also switch between Farms by logging off from the console and choosing a desired Farm from the Farm drop-down list in the RAS logon dialog. The method described above is more convenient, so this one is just another way to do it.
Editing Parallels RAS Farm connections
As was mentioned in the beginning of this section, the RAS logon dialog has the Edit Connections button. When you click it, the Manage Parallels RAS Farm Connections dialog opens.
On the left side of the dialog, the Farm Connections pane lists Parallels RAS Farms to which you connected at least once in the past. If a connection is no longer relevant, you can remove it by selecting it and clicking the "minus sign" icon at the top. Once a connection is removed, it will no longer appear in the RAS logon dialog and in the Parallels RAS Console (the Location drop-down list).
On the right side of the dialog, the Connection Brokers pane lists RAS Connection Brokers for the selected Farm connection. By default, the primary Connection Broker is included in the list, but you can add more Connection Brokers if needed. When connecting to a Farm, the Parallels RAS Console will try the primary Connection Broker first. If a connection cannot be established, it will try other Connection Brokers in the order they are listed in the Connection Brokers pane. To add a Connection Broker to the list, click the "plus sign" icon and then specify the server FQDN or IP address.
Connecting to a Parallels RAS Farm via Command Prompt
You can connect to a Farm using Windows Command Prompt. This can be useful when you want to automatically connect to specific Farms.
To connect to a Farm using Windows Command Prompt:
Navigate to the folder where 2xConsole.exe is located.
Open Command Prompt and enter the following command:
2xconsole.exe <arguments>.The possible arguments are described below.
Arguments
| Argument | Description |
|---|---|
| The friendly name of the Farm connection. |
| A Parallels RAS Farm to connect to. Enter the FQDN or IP address of the server where you have RAS Connection Broker installed. |
| Username. |
| Password. |
| When set, the credentials are saved together with the Farm information. |
Examples
Create a new Farm without a friendly name and store the credentials:
2xconsole.exe -s 10.124.4.113 -u administrator@prls.dev -p password -savecreds
Connect to the previously created Farm using the IP:
2xconsole.exe -s 10.124.4.113
Create a new Farm with a friendly name and store the credentials:
2xconsole.exe -f myfarm -s 10.124.5.123 -u administrator@prls.dev -p password -savecreds
Connect to the previously created farm using the friendly name:
2xconsole.exe -f myfarm