Product Documentation

Known issues

Dec 22, 2017

The following warning applies to any workaround that suggests changing a registry entry.


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.

XenApp and XenDesktop

The XenApp and XenDesktop 7.16 release contains the following issues:

Install and upgrade

  • An intermittent (observed when the Windows CEIP process runs nightly) StoreFront upgrade issue occurs during an upgrade from a 7.12 of later Delivery Controller. The following message is displayed:

"StoreFront cannot be upgraded because the following program is using some files. Close the program and try again.
Program name: CompatTelRunner"

To work around this issue, follow the instruction in the message.


  • If StoreFront was originally installed using the executable from the installation media, StoreFront does not appear as eligible for upgrade when you use the full-product installer for a later version. As a workaround, upgrade StoreFront using the executable from the installation media.


  • When upgrading a XenDesktop 5.6 deployment, group policy is missing. As a workaround, first upgrade from XenDesktop 5.6 to XenDesktop 7.13. Then upgrade to the current release.


  • When installing a Controller and you select I want to connect to Smart Tools and Call Home on the Smart Tools page of the installation wizard, Call Home might not be enabled. As a workaround, either use the schedule feature in Citrix Scout or enable Call Home using PowerShell.


  • When upgrading the Delivery Controller from a version earlier than 7.13, to version 7.13 and later, an error (exception) may be seen if the "Auto client reconnect timeout" setting is configured in any of the policies. This error happens if the "Auto client reconnect timeout" setting value is outside the permitted range 0 and 300, which was first introduced in version 7.13. To prevent this error, use the Citrix Group Policy PowerShell Provider to unconfigure the setting, or to set it to a value within the specified range. For an example, see CTX22947.

  • When upgrading a Delivery Controller from version 7.15 CU1 to version 7.16, a Citrix licensing error message might appear. You can safely click OK and ignore this message.



  • When you select machines and add them to existing Delivery Groups, Studio allows you to add machines from incompatible Machine Catalogs to the same Delivery Group. (If you first select a Delivery Group and add machines to it, Studio correctly prevents machines from incompatible Machine Catalogs being added.)

  • When you remove an App-V package from the Application Library, it is removed from the Studio display, but not from the VDA.


  • When App-V applications are disabled on the App-V management server, they are still listed in Studio in the App-V Publishing node, even though they cannot be used. To hide the disabled applications, restart Studio.


  • App-V shortcuts published as applications in XenApp do not launch, and raise an error, if their shortcut command line arguments contain Virtual File System replaceable tokens, such as [{Common Programs}] or [{ProgramFilesX64}]. To avoid this issue, sequence the package shortcuts without replaceable tokens.



  • If using HDX Adaptive Transport with Citrix Receiver for Windows in a LAN environment with NetScaler Gateway, we recommend that you upgrade to Citrix Receiver for Windows 4.10. Older Citrix Receivers might experience fragmentation issues with DTLS.

  • Stop error (blue screen) is intermittently observed during the installation of a 7.16 VDA on a Surface Pro 3 or 4. During installation, the Intel driver igdkmd64 stops responding. This is a third-party issue that impacts Intel GPUs: Intel 5000 HD, and Intel Iris 530.

    [# HDX-12662] 
  • The cursor in a session with GPU does not display as expected (black cursor or "ghosting") in Citrix Receiver for Linux or Citrix Receiver for HTML5. The issue will occur for users who have a GPU but do not have the "Optimize for 3d Workload" policy enabled. To work around this issue, enable the policy or set the DWORD registry key: HKLMSOFTWARE\Citrix\HDX3D\BitmapRemotingConfig\EnableDDAPICursor = 1

    [# HDX-12366] 
  • Windows Event Log Error: "Windows is unable to verify the image integrity of the file MfApHook64.dll". For more information, see CTX226397.

  • When you start an application from StoreFront, the application might not start in the foreground or the application is in the foreground but might not have focus. As a workaround, click the icon in the task bar to bring the application to the front or in the application screen to bring it to focus.

  • When you delete an Azure Resource Manager machine catalog, the associated machines and resource groups are deleted from Azure, even if you indicate that they should be retained. 


  • Multicast might fail to display video when using Citrix Receiver for Windows newer than version 4.6. Audio is still available. As a workaround, add this registry key on the endpoint:

Name: DisableVMRSupport
Value: 4


  • When LogonUISuppression is enabled, users have these issues:
    • Users attempting Smartcard authentication cannot log on to use their published applications. 
    • Users are unable to change their passwords using CTRL+F1 >> Change password, and they cannot unlock their machine after locking their session using CTRL+F1 >> Lock.

As a workaround, disable LogonUISuppression.

[# HDX-11413, #HDX-12465]

  • When a user starts a published application and immediately starts a desktop (or tries the reverse order), the second request might fail with the following error message: The task you are trying to do can't be completed because Remote Desktop Services is currently busy. Please try again in a few minutes. Other users should still be able to log on. As a workaround, retry after a few seconds.


Third-party issues

  • Citrix and Microsoft have identified an issue when starting seamless applications from a Server VDA running Windows Server 2016. When a user starts an application published from this VDA, Citrix Receiver displays a black screen covering the workspace of the monitor for several seconds before starting the application. For more information, see

    Warning: If you are using Azure Active Directory (AAD), do not make the registry change described in CTX225819. Making this change may cause session launch failures for AAD users.

    [#HDX-5000, HDX-11255] 

  • After starting a YouTube video using the YouTube HTML5 video player, full-screen mode might not work. You click the icon in the lower-right corner of the video, and the video doesn't resize leaving the black background in the full area of the page. As a workaround, click the full screen button, and then select theater mode.


Other components

Components and features that are documented separately have their own known issues articles.