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

  • RASClient-sso_x86_64.deb

  • RASClient-sso_x86_64.tar.bz2

  • 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 (e.g. Fedora), 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.

© 2024 Parallels International GmbH. All rights reserved.