Product Documentation

Installing HDX RealTime Optimization Pack

Feb 04, 2016

If you have not already downloaded the installation files for HDX RealTime Optimization Pack, see How to download HDX RealTime Optimization Pack.

Important: If you have the Microsoft VDI Plug-in installed, ensure you uninstall it before installing the Optimization Pack.

The order of the Optimization Pack installation is important:

  1. If Receiver is running, close it.
  2. Install RealTime Media Engine on your users' devices.
  3. Start XenDesktop.
  4. Install RealTime Connector on your XenDesktop virtual desktops and XenApp servers.

Deploy HDX RealTime Media Engine to your users

You install HDX RealTime Media Engine on client devices. The media engine provides local media processing of audio/video calls and peer-to-peer communication with other callers using Microsoft Lync.

Your method for deploying HDX RealTime Media Engine to a user device depends on the operating system of the device.

Deploy HDX RealTime Media Engine to Windows devices

Citrix HDX RealTime Connector requires the installation of HDX RealTime Media Engine on the host terminal device. This topic describes the steps for deploying HDX RealTime Media Engine to thin client terminals running Windows operating systems.

Prerequisites

Before deploying HDX RealTime Media Engine to a Windows client device:

  • Ensure that Citrix Receiver is installed on the user device and is able to connect through XenDesktop or to XenApp.
  • If the device is using RAM disk, increase it to its maximum size.

To maximize RAM disk space

  1. Log on to the device as a local administrator.
    • If there is a red ball (labeled FBWF) in the Windows notification area, skip to the next step. The write filter is disabled.
    • If there is a the green ball in the Windows notification area, click the green ball and choose DISABLE so that the ball turns red.
  2. Restart your device and log on as a local administrator.
  3. Open Control Panel > Ramdisk.
  4. In the Ramdisk Configuration dialog box, increase the size of the RAM disk to the maximum amount.
  5. Restart your device.
Important: When upgrading Citrix Receiver for Windows, the Lync Optimization Pack must be uninstalled first and then reinstalled after upgrading Citrix Receiver. Refer to CTX200340 for additional details.
Deploying HDX RealTime Media Engine

After ensuring system requirements and prerequisites are met, you can deploy the media engine to your users by making the installer available from a flash drive, web page, or network driv

  1.   Log on to the terminal or computer as a local administrator.
  2.   Run HDX_RealTime_MediaEngine_1.8_for_Windows.msi. After accepting the terms of use, the installer runs silently.
  3.   Install a web camera on the device, using the built-in Windows drivers. 

Deploy HDX RealTime Media Engine to Mac devices 

HDX RealTime Connector requires the installation of Citrix HDX RealTime Media Engine on the client device. This section describes how to install the Media Engine on supported Mac OS devices.

Before running Citrix HDX RealTime Media Engine installation script, ensure you have Receiver for Mac 12.0 installed on the device.

The installation package for Citrix HDX RealTime Media Engine includes the following components:

  • Install HDXRealTimeMediaEngine.pkg
  • Uninstall HDXRealTimeMediaEngine
  1. Log on to the Mac as an Administrator.
  2. Double-click the downloaded file, HDX_RealTime_MediaEngine_1.8_for_OSX.dmg. The disk image mounts.
  3. To start the installation, double-click HDX_RealTime_MediaEngine_1.8_for_OSX.dmg.
  4. Follow the instructions provided by the script.
  5. After the installation completes, confirm the installation: In the Mac System Preferences under Other, click Citrix HDX RealTime Media Engine to view the installed version.
  6. If you have Microsoft Lync running as a published application, restart it (Microsoft Lync). 

Deploy HDX RealTime Media Engine to Linux terminal devices

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

  • RedHat 6.2 x86, RPM-based
  • Ubuntu 14.04 x86-64, Debian-based

Prerequisites

Before deploying HDX RealTime Media Engine to a Linux terminal device, you must install the Citrix Receiver for Linux. Go to the download page for Citrix Receiver for Linux and follow the instructions on that page for the system you are installing on.

To run 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 RedHat. The software detects the type of Linux and installs the appropriate package.

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

Install HDX RealTime Connector on your servers and VDAs

HDX RealTime Connector enables optimized audio and video conferences. To make HDX RealTime Connector available to your users in XenApp and XenDesktop environments, you install HDX RealTime Connector on your XenApp servers and XenDesktop virtual desktops.

Install into a XenDesktop environment

Install HDX RealTime Connector onto a XenDesktop virtual desktop you want to make available to your users. Before installation, ensure that Microsoft Lync is not running on the XenDesktop virtual desktop.

To install HDX RealTime Connector:

  1. Start a XenDesktop virtual desktop and log on as Administrator.
  2. On the virtual desktop, run the installation wizard HDX RealTime Connector LC 2013.msi and follow the instructions.
  3. Restart the virtual desktop.

Install into XenApp environment

Install HDX RealTime Connector on each server in a XenApp farm where you want to make HDX RealTime available. Before installation, ensure the Microsoft Lync is not running in any sessions on the servers.

  1. Log on to a XenApp server as Administrator.
  2. Run the installation wizard HDX RealTime Connector LC 2013.msi and follow the instructions.
  3. Restart the XenApp server.