Product Documentation

Install HDX RealTime Optimization Pack

Feb 23, 2017

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

The order of the Optimization Pack new installation (not an upgrade) 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 Citrix Receiver for Windows

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

If the HDX RealTime Media Engine is installed when you uninstall and then reinstall Citrix Receiver for Windows, ensure that you use the same mode that you used to install the HDX RealTime Media Engine. 

Important

RealTime Connector versions 2.x cannot be used with the RealTime Media Engine version 1.8. You can use any combination of versions 2.x RealTime Connector and RealTime Media Engine, as long as the RealTime Connector version is newer, or the same, than the RealTime Media Engine.  

 

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.

The download the RealTime Media Engine files from HDX RealTime Media Engine 2.2 for Microsoft Skype® for Business.

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.
    • 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.
  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 drive.

  1.   Log on to the terminal or computer.
  2.   Run HDX_RealTime_Media_Engine_2.2_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_Media_Engine_2.2_for_OSX.dmg. The disk image mounts.
  3. To start the installation, double-click HDX_RealTime_Media_Engine_2.2_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 all supported platforms.

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.

  • HDX RealTime Media Engine 64-bit requires Citrix Receiver for Linux 13.2 x64 or greater
  • HDX RealTime Media Engine 32-bit requires Citrix Receiver for Linux 13.0 x86 or greater

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

Components for the 32-bit package:

  • EULA.rtf
  • HDXRTME_install.sh
  • /i386 subdirectory containing the Debian and RPM packages:
    • citrix-hdx-realtime-media-engine-2.2.0-XXX_i386.deb
    • citrix-hdx-realtime-media-engine-2.2.0-XXX_i386.rpm

Components for the 64-bit package:

  • EULA.rtf
  • HDXRTME_install.sh
  • /x86_64 subdirectory containing the Debian and RPM packages:
    • citrix-hdx-realtime-media-engine-2.2.0-XXX_amd64.deb
    • citrix-hdx-realtime-media-engine-2.2.0-XXX_x86_64.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).

To Upgrade the exsisting HDX RealTime Media Engine installation

Use the same ./HDXRTME_install.sh script for upgrading the previous version of the HDX RealTime Media Engine package.

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 this version.

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.2_for_Skype_For_Business.msi or
    HDX_RealTime_Connector_2.2_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 this version.

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

Exclude lync.exe from anti-virus software scanning

Your anti-virus and anti-malware software might cause sound issues. To avoid issues like those in the following list, update your anti-virus and anti-malware software, including network-offloaded anti-virus scanners, to exclude scanning of Lync.exe. 

  • Call arrives and the ring tone plays incorrectly with interruptions at irregular intervals.
  • Dual Tone Multiple Frequencies (DTMF) playback is erratic making it difficult to tell which digit was entered.
  • Discontinuous ("stutter") ringing and Ringback tones.

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.

To temporarily disable and then reenable HDX RealTime Optimization Pack, do the following:

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

Configure client devices for use with Dell RemoteScan and HDX RealTime Optimization Pack

You can use Dell RemoteScan to initiate scans directly from your virtual desktop to any TWAIN or WIA compliant scanner. For more information, see http://www.dell.com/us/business/p/dell-software-remotescan-enterprise/pd. To run Dell RemoteScan on client devices in XenDesktop or XenApp environments using Microsoft Skype for Business with HDX RealTime Optimization Pack installed:

  1. Close RemoteScan if it is running on the client.
  2. Open RegEdit on client device and go to HKEY_LOCAL_MACHINE]/SOFTWARE/Citrix/ICA client/Engine/configuration/Advanced/Modules/ICA 3.0.
  3. Remove RSICAWorkStationProxy from the VirtualDriver key.
  4. Add RSICAWorkStationProxy to the VirtualDriverEx key. Place it following all other virtual driver entries.
  5. On the client device, edit c:\program files\remotescan server\server.ini and add the following entry in the [server] section: noicaregistry=1
  6. Start RemoteScan on the device.