Product Documentation

Deploy HDX RealTime Media Engine to Linux terminal devices

Nov 06, 2014

HDX RealTime Connector requires the installation of the Citrix HDX RealTime Media Engine on the terminal device. This section describes how to install the Media Engine for these Linux distributions:

  • Fedora 16 (Verne) x86, RPM-based
  • Ubuntu 11.10 (Oneiric Ocelot) x86-64, Debian-based

Prerequisites

Before deploying HDX RealTime Media Engine to a Linux terminal device running Ubuntu:

  • If the Ubuntu system is newly installed, install all available updates from the Update Manager before proceeding.
  • If the Ubuntu system does not have a directory called /usr/lib32, create it with this command: sudo mkkdir /usr/lib32

To prepare terminals running Ubuntu for installation of HDX RealTime Media Engine

When performing the following steps, place all installation files in a directory, such as /downloads, and run commands in that directory.

  1. Download the 64-bit Debian Citrix Receiver package from the Receiver for Linux 12.1 download page. The download is under the heading For 64-bit Systems and is named icaclient_12.0.0_amd64.deb.
  2. Download the RPM Open Motif version 2.3.3 package from http://motif.ics.com/open-motif/download/openmotif-233-1el53i386rpm. The file name is openmotif-2.3.3-1.el5.3.i386.rpm. The RPM package is necessary because there is no Debian package for version 2.3.3 of Open Motif.
  3. Convert the Open Motif RPM package to a Debian package. For information, refer to steps 2b-2d in http://support.citrix.com/article/CTX125285.
  4. Install these libraries required by Citrix Receiver:
    sudo apt-get download libmotif4:i386 libxmu6:i386 
    sudo dpkg -x libmotif4* /tmp 
    sudo dpkg -x libxmu6* /tmp 
    sudo cp -r /tmp/usr/lib/* /usr/lib32/

    The two sudo dpkg commands cause Linux to remove write privileges from both "group" and "user" for the /tmp directory. Be sure to reset privileges of /tmp back to 777 using this command: sudo chmod 777/tmp

  5. Install the converted Open Motif package: sudo dpkg -i openmotif_2.3.3-2_i386.deb
  6. Install the Citrix Receiver Debian package: sudo dpkg -i icaclient_12.0.0_amd64.deb
  7. To fix any unresolved dependencies, run this command: sudo apt-get install –f
  8. Verify that Citrix Receiver can connect through XenDesktop or to XenApp.
  9. Go to “To run the HDX RealTime Media Engine installation script,” later in this topic.

To prepare terminals running Fedora for installation of HDX RealTime Media Engine

When performing the following steps, place all installation files in a directory, such as /downloads, and run commands in that directory.

  1. Download the 64-bit RPM Citrix Receiver package from the Receiver for Linux 12.1 download page. The download is under the heading For 64-bit Systems and is named ICAClient-12.0.0-0.x86_64.rpm.
  2. Download the RPM Open Motif version 2.3.3 package from http://motif.ics.com/open-motif/download/openmotif-233-1el53i386rpm. The file name is openmotif-2.3.3-1.el5.3.i386.rpm.
  3. Install Open Motif: sudo yum install -y openmotif-2.3.3-1.el5.3.i386
  4. Install the Citrix Receiver package: sudo yum install -y ICAClient-12.0.0-0.x86_64.rpm
  5. Remove the files from the /tmp directory using these commands:
    sudo rm -rf .X11-unix/ 
    sudo rm -rf .ICE-unix/ 
    sudo rm -rf .X0-unix/
  6. Verify that Citrix Receiver can connect through XenDesktop or to XenApp.
  7. Continue with “To run the HDX RealTime Media Engine installation script,” next.

To run the HDX RealTime Media Engine installation script

The installation package for Citrix HDX RealTime Media Engine includes the following components. Use this package for both Ubuntu and Fedora. The software detects the type of Linux and installs the appropriate package.

  • EULA.docx
  • HDXRTME_insdll.sh
  • /i386 subdirectory containing the Debian and RPM packages:
    • citrix-hdx-realtime-media-engine-1.0.1.i386.deb
    • citrix-hdx-realtime-media-engine-1.0.1.i386.rpm
  1. Place the entire installation package in the directory from which you are running commands.
  2. At the prompt of the directory in which the software resides, enter ./HDXRTME_insdll.sh and then follow the instructions provided by the script.
  3. If you have Microsoft Lync running as a published application, restart it (Microsoft Lync).