Product Documentation

Install the RealTime Optimization Pack

If you have not downloaded the installation files for the Optimization Pack, see How to download the 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 user 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 Optimization Pack and Skype for Business client to run without unnecessary performance degradation.

Bundled the RealTime Media Engine installation with the Citrix Receiver for Windows

As a convenience for new bring-your-own and at-home device users, the Citrix Receiver for Windows and the RealTime Media Engine are available as a single-download bundle with a single installer. When installing the latest version of Citrix Receiver for Windows, the RealTime Media Engine is included in the bundle. For more information, see the Citrix Receiver for Windows installation article.

Citrix might not create a new bundle for every Cumulative Update (CU) or Current Release of Citrix Receiver for Windows or the RealTime Media Engine. New users on unmanaged devices can download the single-download bundle and rely on auto-update to get the latest version of either component, subject to administration policies. Alternatively, the user can update either component manually.

If the RealTime Media Engine is installed when you uninstall and then reinstall Citrix Receiver for Windows, use the same mode that you used to install the 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 the RealTime Connector versions 2.3 or later and this version of the RealTime Media Engine.

Deploy the RealTime Media Engine to your users

You install 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 RealTime Media Engine to a user device depends on the operating system of the device.

Download the RealTime Media Engine files from HDX RealTime Media Engine 2.3 for Microsoft Skype® for Business.

Deploy the RealTime Media Engine to Windows devices

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

Prerequisites

Before deploying the 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 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 Ram disk Configuration dialog box, increase the size of the RAM disk to the maximum amount.
  5. Restart your device.

Deploy the RealTime Media Engine**

Ensure system requirements and prerequisites are met. You can then deploy the media engine to your users by making the installer available from a flash drive, webpage, or network drive.

  1. Log on to the terminal or computer.
  2. Run HDX_RealTime_Media_Engine_2.4_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 the RealTime Media Engine to Mac devices

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

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

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

  • Install HDXRealTimeMediaEngine.pkg
  • Uninstall the HDXRealTimeMediaEngine
  1. Log on to the Mac as an administrator.
  2. Double-click the downloaded file, HDX_RealTime_Media_Engine_2.4_for_OSX.dmg. The disk image mounts.
  3. To start the installation, double-click HDX_RealTime_Media_Engine_2.4_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, select 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 RealTime Media Engine to Linux terminal devices

The Optimization Pack requires the installation of the RealTime Media Engine on the terminal device. This section describes how to install the RealTime Media Engine for all supported platforms.

Important

For the Citrix Ready workspace hub (formerly known as HDX Ready Pi), follow the download and installation instructions provided by your device vendor, NComputing, or ViewSonic.

Prerequisites

Before deploying the 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.

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

To run the RealTime Media Engine installation script:

The installation package for the RealTime Media Engine includes the following components. Use this package for Ubuntu, and Red Hat. 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.4.0-XXX_i386.deb
    • citrix-hdx-realtime-media-engine-2.4.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.4.0-XXX_amd64.deb
    • citrix-hdx-realtime-media-engine-2.4.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, type ./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).

Upgrade the existing RealTime Media Engine installation:

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

Install the RealTime Connector on your servers and VDAs

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

Important

Before deploying RealTime Connector on your servers and VDAs, ensure that you have Skype for Business installed.

Install in to a XenDesktop environment

Install the 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 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 the RealTime Connector:

  1. Start a XenDesktop virtual desktop and log on as administrator.
  2. On the virtual desktop, run the installation file HDX_RealTime_Connector_2.4_for_Skype_For_Business.msi or HDX_RealTime_Connector_2.4_for_Skype_For_Business_32.msi and follow the instructions.

Install into a XenApp environment

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

Important

Uninstall older versions of the RealTime Connector before installing this version.

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

Exclude lync.exe from antivirus software scanning

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

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

Disable the Optimization Pack

Warning

Editing the registry incorrectly can cause serious problems that might 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 disable and then reenable the 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 Optimization Pack is disabled.

To reenable the 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