Parallels Remote Application Server - 15.0 Client for Linux User's Guide
Parallels Remote
Application Server
Parallels Client for Linux User's Guide
v15
Copyright © 1999-2016 Parallels IP Holdings GmbH and its affiliates. All rights reserved.
Parallels IP Holdings GmbH
Vordergasse 59
8200 Schaffhausen
Switzerland
Tel: + 41 52 632 0411
Fax: + 41 52 672 2010
www.parallels.com
Copyright © 1999-2016 Parallels IP Holdings GmbH and its affiliates. 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/trademarks.
Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are registered trademarks of Microsoft
Corporation.
Apple, Mac, the Mac logo, Mac OS, iPad, iPhone, iPod touch, FaceTime HD camera and iSight 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 ......................................................................................5
Configuring Parallels Client for Linux.................................................................................. 8
Checking for Updates .....................................................................................................10
Using Parallels Client for Linux ............................................................................... 12
Adding a New Connection ..............................................................................................12
Configuring a RAS Connection........................................................................................ 14
Connection............................................................................................................................ 15
Display .................................................................................................................................. 18
Printing.................................................................................................................................. 19
Local Resources.................................................................................................................... 22
Experience ............................................................................................................................ 23
Network ................................................................................................................................ 24
Authentication ....................................................................................................................... 24
Advanced Settings ................................................................................................................ 25
Configuring an RDP Connection...................................................................................... 26
Connection............................................................................................................................ 27
Display .................................................................................................................................. 29
Local Resources.................................................................................................................... 30
Programs .............................................................................................................................. 31
Experience ............................................................................................................................ 32
Network ................................................................................................................................ 33
Authentication ....................................................................................................................... 33
Advanced Settings ................................................................................................................ 34
Configuring Global Options ............................................................................................. 36
Using a RAS Connection................................................................................................. 39
Using an RDP Connection............................................................................................... 39
Exporting and Importing Parallels Client Settings............................................................. 40
Parallels Client Command Line Interface.......................................................................... 40
General Options .................................................................................................................... 40
Contents
RDP Options ......................................................................................................................... 41
Device Options ...................................................................................................................... 42
Other Options........................................................................................................................ 43
Examples .............................................................................................................................. 44
Index ........................................................................................................................46
C HAPTER 1
Getting Started
In This Chapter
System Requirements .............................................................................................. 5
Installing Parallels Client for Linux ............................................................................. 5
Configuring Parallels Client for Linux ......................................................................... 8
Checking for Updates............................................................................................... 10
System Requirements
Parallels Client is approved for the following Linux distributions:
x86/x64
• Ubuntu 12.04 LTS
• Ubuntu 14.04 LTS
• Open Suse 12.3
• OpenSuse 13.2
• Fedora 20
• Xubuntu 15.10
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 Remote Application Server connection. 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 (links to Parallels Client for other platforms may also
be included if you are using other devices in addition to a Linux computer).
• A link to automatically configure Parallels Client on your computer, so you can connect to the
Parallels Remote Application Server.
Getting Started
• Parallels Remote Application Server connection properties. You can use this information to
manually create a Parallels Remote Application Server 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 for any reason.
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 2XClient.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
/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
6
Getting Started
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
SSO (Single Sign On) Installation Procedures
Depending on the package used to install Parallels Client, the SSO installation procedure may vary:
Already available with Parallels Client package:
• TAR package — Run script at location /opt/2X/Client/scripts/install.sh
• RPM package — Manual installation is required.
Separate package to Parallels Client:
• Debian package — Requires Parallels Client pre-installed. Install package using the default
package installer.
Manual installation procedure (RPM Required)
Install pam_2xclient.so module to have Single Sign On for Parallels Client.
This file is located under /opt/2X/Client/lib/security/pam_2xclient.so no matter the package used.
7
Getting Started
The module always returns true and will use an authentication token that will be provided by a
higher authentication module.
Note: When a higher authentication module has been configured to SUFFICIENT, it will return on
success immediately and pam_2Xclient.so won’t be called. Please change SUFFICIENT TO REQUIRED.
To install Parallels Client PAM module, add two lines to your session manage service (eg. /etc/pam
d/gdm):
auth optional pam_2xclient.so
password optional pam_2xclient.so
Module arguments:
Debug: Debug trace will be written to /tmp/pam_2xclient.log. If the file cannot be opened, then
syslog will be used.
You can use debug argument with all module types. EG. Session optional pam_2xclient.so debug
• The module will create an SSO cookie only for well known session services.
• You can change the list of services to allow: EG. auth optional pam_2xclient.so gdm kde kdm-
kde4
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 Remote Application Server.
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.
8
Getting Started
2 Once the Parallels Client is configured, it will open and ask you to log into Parallels Remote
Application Server.
3 Select the Authentication type from the following:
• Credentials. Select this option to connect to Parallels Remote Application Server by
supplying your credentials, such as your domain user name and password.
• Smart card. Select this option to connect to Parallels Remote Application Server 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.
9
Getting Started
5 Click Connect. If the login is successful, the main Parallels Client window will open and will
display 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. When the resource opens in a new window, you can begin using as if it was running on your
local computer.
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 the Options toolbar item.
10
2 In the Options dialog that opens, click the General tab.
Getting Started
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.
11
C HAPTER 2
Using Parallels Client for Linux
In This Chapter
Adding a New Connection........................................................................................ 12
Configuring a RAS Connection ................................................................................. 14
Configuring an RDP Connection ............................................................................... 26
Configuring Global Options....................................................................................... 36
Using a RAS Connection .......................................................................................... 39
Using an RDP Connection........................................................................................ 39
Exporting and Importing Parallels Client Settings ...................................................... 40
Parallels Client Command Line Interface................................................................... 40
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 > Add New Connection.
2 Select the type of connection to create:
• Click Remote Application Server to create a Parallels Remote Application Server
connection. This will allow you to use applications, documents, or desktops published in
Parallels Remote Application Server.
Using Parallels Client for Linux
• Click Standard RDP to create a standard Remote Desktop connection. This will allow 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 Remote Application Server 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 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.
13
Using Parallels Client for Linux
4 In the Server field, enter the Parallels Remote Application Server 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 Remote Application
Server 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.
• 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 server. This is best used when
the Parallels Client and the terminal server reside on the same network.
• 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. 14) or Configuring an RDP Con
nection (p. 26).
8 Click OK to create a connection.
Configuring a RAS Connection
To modify the properties of an existing Remote Application Server 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.
14
Loading...