Product Documentation

Install and set up

Apr 30, 2015

The following packages are available for Receiver for Linux:

  • Debian (.deb file):
    • x86 - 32-bit and 64-bit packages (containing 32-bit binaries)
    • ARM - 32-bit packages for armel and armhf platforms
  • RPM Package Manager (.rpm file):
    • x86 - 32-bit package
  • Tarball (.tar.gz file):
    • x86 and ARM - 32-bit binaries in a tarball package for x86, armel, and armhf platforms
    • x86 64-bit - 64-bit binaries in a tarball package for 64-bit systems

If your distribution allows, install Receiver from the RPM or Debian package. These files are generally easier to use because they automatically install any required packages. If you want to control the installation location, install Receiver from the tarball package.

You can access the packages from the Downloads section of the Citrix website (http://www.citrix.com/downloads/).

Tip: If you are installing Receiver from the Debian package on Ubuntu, you may find it convenient to open the packages in the Ubuntu Software Center.

To install Receiver for Linux from a Debian package

When installing the 64-bit Receiver Debian package on a Debian 7 (or earlier) 64-bit system, you must first enable i386 packages. To check whether the i386 packages are already enabled, At the command line, type the command dpkg --print-foreign-architectures. Then, note the following depending on the outcome:

  • If i386 appears on the output, you can proceed with the package installation.
  • If i386 does not appear on the output, type the following series of commands in order to enable the packages:
  1. sudo dpkg --add-architecture i386
  2. sudo apt-get update

In the following instructions, replace packagename with the name of the package that you are installing.

Tip: This procedure uses a command line. Instead, you can install the package by double-clicking the downloaded .deb package in a file browser. This typically starts a package manager that downloads any missing required software. If no package manager is available, Citrix recommends gdebi, a command-line tool that performs this function.
  1. Log on as a privileged (root) user.
  2. Open a terminal window.
  3. Run the installation by typing dpkg -i packagename.deb.
  4. Install any missing dependencies by typing sudo apt-get -f install.
  5. Install the USB support package using the same run command.

To install Receiver for Linux from an RPM package

In the following instructions, replace packagename with the name of the package that you are installing.

Tip: RPM Package Manager does not install any missing required software. To download and install the software, Citrix recommends using zypper install <file name> at a command line on OpenSUSE or yum on Fedora.
  1. Log on as a privileged (root) user.
  2. Open a terminal window.
  3. Run the installation by typing zypper install packagename.rpm. For example, zypper install ./ICAClient-suse11sp3-13.2.1.328635-0.x86_64.rpm.
  4. Install the USB support package using the same run command.

To install Receiver for Linux from a tarball package

  1. Open a terminal window.
  2. Uncompress the .tar.gz file and extract the contents into an empty directory. For example, for Linux platforms, type: tar xvfz packagename.tar.gz.
  3. Type ./setupwfc and then press Enter to run the setup program.
  4. Accept the default of 1 (to install the Receiver) and press Enter.
  5. Type the path and name of the required installation directory and then press Enter, or press Enter to install Receiver in the default location.

    The default directory for privileged (root) user installations is /opt/Citrix/ICAClient.

    The default directory for non-privileged-user installations is $HOME/ICAClient/platform. platform is a system-generated identifier for the installed operating system. For example, $HOME/ICAClient/linuxx86 for the Linux/x86 platform).

    Note: If you specify a non-default location, set it in $ICAROOT in $HOME/.profile or $HOME/.bash_profile.
  6. When prompted to proceed, type y and then press Enter.
  7. You can choose whether to integrate Receiver into your desktop environment. The installation creates a menu option from which users can start Receiver. Type y at the prompt to enable the integration.
    Note: To ensure the integration performs well when Receiver is installed in a non-default location, set the location in $ICAROOT in $HOME/.profile or $HOME/.bash_profile.
  8. If you have previously installed GStreamer, you can choose whether to integrate GStreamer with Receiver and so provide support for HDX Mediastream Multimedia Acceleration. To integrate Receiver with GStreamer, type y at the prompt.
  9. If you are logged on as a privileged user (root), then you can choose to install USB support for XenDesktop and XenApp published VDI applications. Type y at the prompt to install USB support.
    Note: If you are not logged on as a privileged user (root), the following warning appears: USB support cannot be installed by non-root users. Run the installer as root to access this install option.
  10. When the installation is complete, the main installation menu appears again. To exit from the setup program, type 3 and then press Enter.

To uninstall Citrix Receiver for Linux

This procedure has been tested with the tarball package. Remove the RPM and Debian packages using your operating system's standard tools.

  1. Run the setup program by typing $ICAROOT/setupwfc and press Enter.
  2. To remove the client, type 2 and press Enter.
    Note: To uninstall the Citrix Receiver for Linux you must be logged in as the same user who performed installation.