Parallels Remote Application Server - 16.5 User Guide
Parallels Remote
Application Server
Parallels Client for Linux User's Guide
v16.5
Parallels International GmbH
Vordergasse 59
8200 Schaffhausen
Switzerland
Tel: + 41 52 672 20 30
www.parallels.com
Copyright © 1999-2018 Parallels International GmbH. All rights reserved.
This product is protected by United States and international copyright laws. The product’s underlying technology,
patents, and trademarks are listed at http://www.parallels.com/about/legal/.
Microsoft, Windows, Windows Server, Windows Vista are registered trademarks of Microsoft Corporation.
Apple, Mac, the Mac logo, OS X, macOS, iPad, iPhone, iPod touch are trademarks of Apple Inc., registered in the US
and other countries.
Linux is a registered trademark of Linus Torvalds.
All other marks and names mentioned herein may be trademarks of their respective owners.
Contents
Getting Started .......................................................................................................... 5
System Requirements ..................................................................................................... 5
Installing Parallels Client for Linux ..................................................................................... 6
Configuring Parallels Client for Linux ................................................................................ 8
Checking for Updates...................................................................................................... 9
Using Parallels Client for Linux ............................................................................... 11
Adding a New Connection ............................................................................................. 11
Configuring a RAS Connection ...................................................................................... 13
Connection ............................................................................................................................ 14
Display .................................................................................................................................. 16
Printing .................................................................................................................................. 18
Local Resources .................................................................................................................... 20
Experience ............................................................................................................................ 23
Network ................................................................................................................................ 24
Authentication ....................................................................................................................... 24
Advanced Settings ................................................................................................................ 25
Configuring an RDP Connection .................................................................................... 26
Connection ............................................................................................................................ 27
Display .................................................................................................................................. 29
Local Resources .................................................................................................................... 31
Programs .............................................................................................................................. 34
Experience ............................................................................................................................ 34
Network ................................................................................................................................ 35
Authentication ....................................................................................................................... 35
Advanced Settings ................................................................................................................ 36
Configuring Global Options ............................................................................................ 38
Using a RAS Connection ............................................................................................... 40
Using an RDP Connection ............................................................................................. 41
Exporting and Importing Parallels Client Settings ............................................................ 41
Parallels Client Network Configuration File ...................................................................... 42
Format ................................................................................................................................... 42
Contents
Parameters ............................................................................................................................ 42
Parallels Client Command Line Interface ........................................................................ 44
General Options .................................................................................................................... 44
RDP Options ......................................................................................................................... 45
Device Options ...................................................................................................................... 47
Other Options ........................................................................................................................ 48
Examples .............................................................................................................................. 48
Index ........................................................................................................................ 50
C HAPTER 1
Getting Started
Parallels Client for Linux is an app that allows you to connect to Parallels Remote Application Server
(Parallels RAS) from a Linux computer.
In This Chapter
System Requirements ............................................................................................ 5
Installing Parallels Client for Linux ............................................................................ 6
Configuring Parallels Client for Linux ....................................................................... 8
Checking for Updates ............................................................................................. 9
System Requirements
Supported Linux distributions for 32-bit Parallels Client for Linux:
• Ubuntu 14.04 LTS (x86)
• Ubuntu 16.04 LTS (x86)
• Linux Mint 18 (x86)
• Linux Mint 18.2 (x86)
• Debian 8.7 (x86)
• Fedora 25 (x86)
• Fedora 26 (x86)
Supported Linus distributions for 64-bit Parallels Client for Linux:
• Ubuntu 16.04 LTS (x64)
• Linux Mint 18.2 (x64)
• Fedora 25 (x64)
• Fedora 26 (x64)
• CentOS7
Supported ARM distribution:
• Raspbian OS Stretch
Getting Started
Installing Parallels Client for Linux
Your system administrator will send you an invitation email with the instructions on how to install
Parallels Client for Linux and configure a Parallels RAS connection in it. The invitation email will
contain the following information and action links:
• A message from your system administrator.
• A link to download Parallels Client for Linux.
• A link to automatically configure Parallels Client on your computer.
• Parallels RAS connection properties. You can use this information to manually create a Parallels
RAS connection. The automatic configuration via the link (see above) is the preferred and the
easiest method, but you can use this information to create a connection manually if needed.
To install Parallels Client for Linux using an invitation email:
1 Make sure you are logged into your computer as a user with administrative privileges.
2 In the invitation email, click the Linux thumbnail to download Parallels Client for Linux installer.
3 Download the installer and store it locally.
Installation Procedure — GUI
Installation via GUI is only valid on DEB and RPM versions:
• Install the package using the default package installer.
Installation Procedures — CLI
DEB Version
To install Parallels Client, switch to the root user and type the following at the command prompt:
dpkg -i parallelsclient.deb
If the installation fails because of missing dependencies, try installing these dependencies using the
following command:
apt-get -f install
Parallels Client for Linux binaries are now installed in the following directory:
/opt/2X/Client/bin
Run the following command to launch Parallels Client:
/opt/2X/Client/bin/2XClient
You can also run the following commands to obtain a list of all usage parameters for a Parallels
Client session:
cd /opt/2X/Client/bin
6
Getting Started
/appserverclient -?
RPM Version
To install Parallels Client, switch to the root user and type the following command:
rpm –ivh 2XClient.i386.rpm
Parallels Client binaries are now installed in the following directory:
/opt/2X/Client/bin
Run the following command to launch Parallels Client:
/opt/2X/Client/bin/2XClient
You can also run the following commands to obtain a list of all usage parameters for a Parallels
Client session:
cd /opt/2X/Client/bin
/appserverclient -?
.TAR.BZ2 Version
To install Parallels Client, switch to the root user and then switch to the root directory:
cd /
To install, type the following command:
tar jxvf 2XClient.tar.bz2
Parallels Client binaries are now installed in the following directory:
/opt/2X/Client/bin
It is recommended that the post-install script is launched in order to register icons, mimetypes, URL
schema, and databases configurations. This script is located under: /opt/2X/Client/scripts/install.sh
Run the following command to launch Parallels Client:
/opt/2X/Client/bin/2XClient
You can also run the following commands to obtain a list of all usage parameters for a Parallels
Client session:
cd /opt/2X/Client/bin
/appserverclient -?
To unregister the components registered during installation, it is recommended to launch the
uninstall script located under: /opt/2X/Client/scripts/uninstall.sh
The SSO (Single Sign On) Module Installation Procedures
A separate package to install the SSO module is provided for each version of Linux (32-bit and 64bit versions):
• RASClient-sso_x86_64.deb
• RASClient-sso_x86_64.tar.bz2
7
Getting Started
• RASClient-sso.x86_64.rpm
Debian SSO packages can be installed and removed using standard installers.
Tar SSO packages can be installed and uninstalled by running /opt/2X/Client/scripts/install_sso.sh
or /opt/2X/Client/scripts/uninstall_sso.sh respectively.
Rpm SSO packages need to be configured manually after the installation, as there is no tool
available to configure the module correctly. For manual configurations refer to README.SSO that is
being shipped inside the /opt/2X/Client/doc/ folder.
Known issues and limitations
In RPM environments (eg Fedora, OpenSUSE), where the pam-auth-update tool is not available,
the configuration of the pam module needs to be done manually. There are instructions in the
README.SSO file.
Configuring Parallels Client for Linux
Once Parallels Client for Linux is installed on your computer, you need to configure it, so you can
connect to Parallels RAS.
To configure Parallels Client:
1 In the invitation email that you received from your system administrator, find the Configure
section and click the Click Here to auto configure the downloaded client link and follow the
instructions.
2 Once the Parallels Client is configured, it will open and ask you to log into Parallels RAS.
8
Getting Started
3 Select the Authentication type from the following:
• Credentials. Select this option to connect to Parallels RAS by supplying your credentials,
such as your domain user name and password.
• Smart card. Select this option to connect to Parallels RAS using a smart card.
• Single Sign-On. This option will be included in the list only if the Single Sign-On module is
installed during Parallels Client installation. Select this option to use local system credentials
to connect to the remote server
Note for Administrators: The allowed authentication type(s) must be specified in the RAS Console in
Connection / Authentication.
4 Depending on the authentication type selected, type your user name and password or insert a
smart card into a reader. If using a smart card, enter a PIN when prompted.
5 Click Connect. If the login is successful, the main Parallels Client window opens displaying the
published resources that you can use.
To open a resource, navigate the published folder tree and double-click a desired resource to open
it.
Checking for Updates
To check for the latest available version of Parallels Client for Linux:
1 In the main Parallels Client for Linux window, click Tools > Options.
9
Getting Started
2 In the Options dialog, click the General tab.
3 Click the Check for updates now button to see if a newer version of Parallels Client for Linux is
available.
4 You can also select the Check for updates on startup option to check for Parallels Client
updates every time you open it.
5 Select the Enable FIPS 140-2 encryption option only if your IT administrator instructed you to
do so. If the option is selected, Parallels Client will use FIPS 140-2 encryption when connecting
to Parallels RAS. This is required when the encryption is enforced on the Parallels RAS side. If
the encryption is allowed (but not required), you can select or clear the option, depending on
your organization's policy.
The rest of the options are described in the Configuring Global Options section (p. 38).
10
C HAPTER 2
Using Parallels Client for Linux
Read this chapter to learn how to use Parallels Client for Linux.
In This Chapter
Adding a New Connection ...................................................................................... 11
Configuring a RAS Connection ............................................................................... 13
Configuring an RDP Connection ............................................................................. 26
Configuring Global Options ..................................................................................... 38
Using a RAS Connection ........................................................................................ 40
Using an RDP Connection ...................................................................................... 41
Exporting and Importing Parallels Client Settings ..................................................... 41
Parallels Client Network Configuration File ............................................................... 42
Parallels Client Command Line Interface ................................................................. 44
Adding a New Connection
Parallels Client allows you to have more than one connection, so you could easily connect to
different servers or using different connection properties, etc.
To manually add a connection:
1 From the main menu, click File > New Connection.
2 Select the type of connection to create:
• Parallels Remote Application Server allows you to use published applications,
documents, or desktops.
Using Parallels Client for Linux
• Standard RDP allows you to connect to any remote computer that accepts standard
Remote Desktop connections.
3 On the next screen, enter the connection properties.
When creating a Parallels RAS connection, your system administrator should give you the
connection information that must be specified in this dialog. If you received an invitation email
from your administrator, you can find this information at the bottom of the message. The
information will look similar to the following:
To manually configure the Parallels RAS Connection, use the
following settings:
Server: 192.168.1.10
Port: 443
Connection Mode: Gateway Mode
When creating a Standard RDP connection, you need to know the IP address or hostname of
the remote computer you want to connect to.
12
Using Parallels Client for Linux
4 In the Server field, enter the Parallels RAS IP address or hostname (this should be the server
where the RAS Secure Client Gateway resides). If creating a Standard RDP connection, specify
the remote computer IP address or hostname.
5 The Connection Mode drop-down list is enabled only when creating a Parallels RAS
connection. Select one of the following options:
• Gateway Mode. Parallels Client connects to the RAS Secure Client Gateway and the
session connection is tunneled through the first available connection. This mode is ideal for
servers that are only reachable via the gateway and do not require a high level of security.
• Direct Mode. Parallels Client first connects to the RAS Secure Client Gateway for the best
available terminal server and then connects directly to that server. This is best used when
the Parallels Client and the terminal server reside on the same network.
• Gateway SSL Mode. Same as the gateway mode above, but uses encryption to secure the
data.
• Direct SSL Mode. Same as the direct mode above, but uses encryption to secure the data.
6 In the Friendly name field, choose and type a friendly name for this connection.
7 The Advanced settings button opens the Connection Properties dialog where you can
specify additional connection properties. For more information, please see Configuring a RAS
Connection (p. 13) or Configuring an RDP Connection (p. 26).
8 Click OK to create a connection.
Configuring a RAS Connection
To modify the properties of an existing Parallels RAS connection, right-click it in the main Parallels
Client window and then click Connection Properties in the context menu. This will open the
Connection Properties dialog. Properties are grouped in the dialog by functionality using tab
pages. The following subsections describe each tab page in detail.
13
Using Parallels Client for Linux
Connection
The Connection tab page allows you specify connection settings and logon information.
Configuring the Primary Connection
On the Connection tab page, you can define a primary connection and one or more secondary
connections.
14
Using Parallels Client for Linux
The primary connection is what Parallels Client will use first to connect to the specified server. This
should be the server where the primary RAS Secure Client Gateway is running.
To specify the primary connection information:
1 In the Primary Connection field, specify the server name or IP address.
2 In the Connection Mode drop-down list, select one of the following options:
• Gateway Mode. Parallels Client connects to the RAS Secure Client Gateway and the
session connection is tunneled through the first available connection. This mode is ideal for
servers which are only reachable via the gateway and do not require a high level of security.
• Gateway SSL Mode. Same as the gateway mode above, but uses encryption to secure the
data.
• Direct Mode. Parallels Client first connects to the RAS Secure Client Gateway for the best
available terminal server and then connects directly to that particular server. This is best
used when the Parallels Client and the terminal server are on the same network.
• Direct SSL Mode. Same as the direct mode above, but uses encryption to secure the data.
3 In the Port field, specify the port on which the gateway listens for incoming connections. If the
default value (80) has been modified on the server side, you have to replace the default value
here as well. Ask your system administrator about the port number if you are having a problem
connecting to the server.
4 In the Friendly Name field, choose and type a name of your choice, so you could easily identify
the server in Parallels Client later.
Configuring a Secondary Connection
If the Parallels RAS farm that you are connecting to has more than one RAS Secure Client
Gateway, you can define a secondary connection, which will be used as a backup connection in
case the primary gateway connection fails.
To add a secondary connection:
1 Click the Secondary Connections button.
2 In the Secondary Connections dialog, click the Add button and specify a server name or IP
address. This should be a server hosting a secondary RAS Secure Client Gateway (the primary
gateway is used by the primary connection).
3 Select the connection mode and modify the port number if necessary. Click OK and then click
OK again to return to the Connection Properties dialog.
Configuring the Logon Information
In the Logon section, specify the following properties:
1 Select the Auto Logon option to enable Parallels Client to connect automatically (using this
connection) on startup.
15
Loading...