30-04-2021

Citrix Workspace Replace Receiver



downloadWhy can't I download this file?

Applicable Products

  • Citrix Workspace App
  • Citrix Virtual Apps and Desktops
  • Receiver for Windows

Symptoms or Error

After installing or upgrading Citrix Workspace App or Receiver for Windows on an endpoint with the Real-time Media Engine (RTME) installed, resource launch fails for any application or desktop.
This might also happen on endpoints that have Cisco's VXME installed.
CWA or Receiver displays one of the following errors:
“You might be having an issue with a Citrix virtual driver (HDX RealTime Media Engine). Contact your system administrator for further assistance.”
“Unable to connect to the server. Contact your system administrator with the following error. SSL Error 4: The operation completed successfully.”

Solution

Update: The has been fixed in CWA version 1810

Workaround

Does Citrix Workspace Replace Receiver

Replace the values that are missing from the following Windows registry key on the endpoint with CWA or Receiver installed:
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesICA 3.0VirtualDriverEx
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesHDX RealTime Media Engine]
'DriverNameWin32'='RTMEPlugin.dll'
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesSOCKSProxyPlugin]
'DriverNameWin32'='SOCKSProxyPlugin.dll'
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesUDPGatewayPlugin]
'DriverNameWin32'='UDPGatewayPlugin.dll'
The VirtualDriversEx key should contain the following Value Data:
HDX RealTime Media Engine, SocksProxyPlugin, UDPGatewayPlugin

Note:- For 32 bit machines “ WOW6432Node” is not required

Problem Cause

Issue is caused by a corrupted XML file in CWA or Receiver installer that deletes the Windows registry Value data required by the

Citrix Storefront Receiver Workspace

VirtualDriverEx key.
Workspace
When launching any application or desktop, CWA or Receiver loads the virtual drivers listed in the following Windows registry location:
HKEY_LOCAL_MACHINESOFTWAREWow6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesICA 3.0VirtualDriverEx
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesHDX RealTime Media Engine]
'DriverNameWin32'='RTMEPlugin.dll'
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesSOCKSProxyPlugin]
'DriverNameWin32'='SOCKSProxyPlugin.dll'
[HKEY_LOCAL_MACHINESOFTWAREWOW6432NodeCitrixICA ClientEngineConfigurationAdvancedModulesUDPGatewayPlugin]
'DriverNameWin32'='UDPGatewayPlugin.dll'
After the CWA or Receiver upgrade, the Value data for VirtualDriverEx key is deleted:
During the launch request, CWA or Receiver fails to find the required registry values and the launch fails.

Additional Resources

In the past, it was required to uninstall the Lync Optimization Pack when installing or upgrading Receiver.
Upgrading Citrix Receiver when using Citrix Lync Optimization Pack:
https://support.citrix.com/article/CTX200340

Disclaimer

Caution! Using Registry Editor 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.

You may have noticed that Citrix is in the process of implementing changes announced at Synergy 2018 to unify its product portfolio. Some of these changes are cosmetic, affecting names only, but others contain functional changes. In particular, the new Citrix Workspace App will eventually replace the Receiver, ShareFile (now Citrix Content Management), and XenMobile (now Citrix Endpoint Management) clients, and will provide users with consolidated access to virtual apps and desktops, SaaS and mobile apps, shared content, and secure browsing within the Citrix Workspace ecosystem.

Citrix Workspace Replace Receiver

You may have also noticed Receiver has started to update itself to Workspace App on various devices. The user experience is similar to Receiver, should be familiar to users, and is compatible with all currently supported versions of Citrix Virtual Apps and Desktops (formerly XenApp and XenDesktop) and Citrix Gateway (formerly NetScaler Gateway), but most firms would like to control this behavior. There isn’t much you can do about mobile devices, or home PCs and Macs, but on firm-owned PCs, Receiver updates can be controlled via command line at installation, and via Group Policy after installation.

Most firms choose to disable Receiver updates, then push out an updated version after it is thoroughly tested. That’s the approach Kraft Kennedy recommends, but other options exist including the ability to limit updates to the Long Term Servicing Release (“LTSR”). Currently, that would limit update to Receiver 4.9.

Citrix Workspace App Replace Receiver

Helpful links: