Product Documentation

Installing HDX RealTime Optimization Pack

May 02, 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.

Important

Configure any anti-virus/security software on XenApp or XenDesktop to allow the HDX RealTime Optimization Pack and Skype for Business client to run without unnecessary performance degradation.

Bundled RTME installation with the latest Citrix Receiver for Windows

A single installer now combines the latest Citrix Receiver for Windows with the HDX RTME installer. When installing the latest version of Citrix Receiver for Windows, the HDX RTME is included in the executable file (.exe).  Refer to the Citrix Receiver for Windows installation article for more information.

Important

The HDX RealTime Connector on your XenApp/XenDesktop servers must be at least version 2.0.0.417 (GA release) for compatability with the new RTME package; that is, RTME 2.0 cannot be used with the 1.8 RTME Connector.

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 Skype for Business.

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.
Deploy 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_2.0_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 or later 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_2.0_for_OSX.dmg. The disk image mounts.
  3. To start the installation, double-click HDX_RealTime_MediaEngine_2.0_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 Skype for Business running as a published application, restart it (Microsoft Skype for Business). 

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-2.0.0-417_i386.deb
    • citrix-hdx-realtime-media-engine-2.0.0-417_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 Skype for Business running as a published application, restart it (Microsoft Skype for Business).

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.

Important

Before deploying HDX RealTime Connector on your servers and VDAs, make sure you have Skype for Business installed. 

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 Skype for Business is not running on the XenDesktop virtual desktop.

Important

Uninstall older versions of the HDX RealTime Connector  before installing version 2.0.

Depending on your VDA/Server operating system, use the 32-bit or 64-bit version of the RealTime Connector.

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_2.0_for_Skype_For_Business.msi or
    HDX_RealTime_Connector_2.0_for_Skype_For_Business_32.msi  and follow the instructions.

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 Skype for Business is not running in any sessions on the servers.

Important

Uninstall older versions of the HDX RealTime Connector  before installing version 2.0.

  1. Log on to a XenApp server as Administrator.
  2. Run the installation wizard HDX_RealTime_Connector_2.0_for_Skype_For_Business.msi or
    HDX_RealTime_Connector_2.0_for_Skype_For_Business_32.msi and follow the instructions.

Disable HDX RealTime Optimization Pack

Warning

Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

Back up and remove or rename the following registry keys (for example, VdiMediaProviderDisabled). When you restart Skype for Business, the HDX RealTime Optimization Pack is disabled. 

To reenable the HDX RealTime Optimization Pack, restore or rename the key back to VdiMediaProvider.

For 64-bit Skype for Business or 32-bit Skype for Business on 32-bit Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\Lync\VdiMediaProvider

For 32-bit Skype for Business on 64-bit Windows: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office\Lync\VdiMediaProvider