Product Documentation

Known issues

Nov 04, 2016

The following issues are known to exist in this release.

Cannot create anonymous store with PowerShell SDK in Windows Server 2016

Creating an anonymous store using the PowerShell SDK in Windows Server 2016 might fail. [#651103]

Workaround: Use the StoreFront management console to create an anonymous store in Windows Server 2016.

StoreFront installation enables the Management Service server role

When using the XenApp and XenDesktop full-product installer, StoreFront installation enables the Management Service server role, which allows the web server to be managed remotely from another computer using IIS Manager.  From a security perspective, if this server role is not required for any third-party components or you don’t need to manage IIS remotely, use the Server Manager or PowerShell to remove this role to minimize the network attack surface of the StoreFront server.  [#658056]

StoreFront management console cannot change Delivery Controller type from XenDesktop to XenApp 6.5

On Windows Server 2016, changing a XenDesktop Delivery Controller type to a XenApp 6.5 controller type fails, even if the Manage Delivery Controller screen displays the change. [#658595]

Workaround: Create a new Delivery Controller and set it to XenApp 6.5.

StoreFront management console displays Internal Only

When you enable remote access and register a Gateway with a store, the StoreFront management console indicates only internal access, but remote access is also available. [#654561]

Users cannot log on to Citrix Receiver for Web if a custom authentication form contains an element with ID=confirmBtn

Users are unable to log on to Citrix Receiver for Web if a StoreFront authentication extension generates a custom authentication form containing an element with ID confirmBtn. Workaround: The authentication extension should use a different ID value in the custom form.  [#603196]

Studio console crashes with an MMC error after clicking StoreFront node for the first time

After the XenDesktop installation completes and you open the Studio console (and do not close it) and click the StoreFront node in the left pane for the first time, the MMC snap-in might crash. [#655031]
Workaround: Reopen Studio.

Reconnection of applications fails when using the Edge brower

When using a Windows 10 client with the Edge browser, the following functions might not work:

  • Auto reconnect applications.
  • Manual reconnect to applications through the Connect menu option (visible if the administrator enables it in the configuration).

Workaround: Use a different browser. [#595065]

When using a Windows 10 client with the Edge browser, you cannot auto reconnect disconnected applications. Workaround: Use a different browser. [#595065]
When using a Windows 10 client with the Edge browser, you cannot auto reconnect disconnected applications. Workaround: Use a different browser. [#595065]

StoreFront management console might not automatically update 

The StoreFront management console might not automatically update when you enter changes. Workaround: Refresh the console UI.

Removal of .dll files 

These dlls were included in previous versions of StoreFront to configure Gateways but are not  provided in this release. Workaround: Update your old scripts to remove these dlls. [#592677]

  • Citrix.DeliveryServices.Admin.Roaming.CreateRoamingServiceExtension.dll
  • Citrix.DeliveryServices.Admin.Roaming.GatewaysScopeNode.dll
  • Citrix.DeliveryServices.Admin.Roaming.StoreExtensions.dll

Using Citrix Receiver for Web within an iframe

Citrix Receiver for Web does not support Internet Explorer 7 and using iframes on an intranet site causes Internet Explorer to switch to the Internet Explorer 7 document mode by default (no X-UA-Compatible meta tag defined and compatibility mode set to always on for intranet sites). [#570682]

Workaround: Use the X-UA-Compatible meta tag:

<meta http-equiv="X-UA-Compatible" content="IE=10; IE=9; IE=8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge" />

Reconnecting apps in the Chrome browser might fail

When using the Chrome browser and reconnecting to published applications from XenApp and XenDesktop servers, clicking Connect for the applications might only reconnect the first session when more than one session is being used. [575364]
Workaround: Click Connect again to reconnect each additional session being used.

Activate Citrix ICA Client link might not work in non-English versions of Firefox

Some non-English versions of Firefox install the Addons Manager by default. You might not receive a response when clicking Activate the Citrix Client on the Activate the Citrix plug-in screen. There are three workarounds (the first being the preferred method) [#494376]:

  • Click the block-like icon in the address bar and choose an option for Allow <server> to run Citrix ICA Client.
  • Remove or disable the Addons Manager.
    1. Click the menu button and choose Add-ons.
    2. The Addons Manager tab opens.
    3. In the Addons Manager tab, select Extensions and click Remove or Disable on the Addons Manager page.

Citrix Receiver for Web sites may be slow to respond on Internet Explorer 8

Users running Internet Explorer 8 may find that Citrix Receiver for Web sites containing a large number of desktops and applications are slow to respond when browsing the store or entering search terms. [#274126]

Citrix Receiver for Web with Windows 10 Edge 

Starting and appliction or desktop from Citrix Receiver for Web with the Windows 10 Edge browser might trigger a prompt to download and .ICA file. Workaround: Add Citrix Receiver for Web to the Trusted Sites list. For more information, see this Citrix Blog article.  [#594927].

Apps in AppController 

Apps published in AppController might not start. Workaround: Use the StoreFront PowerShell commands to manually create a store with an authentication service located at http://sfserver/Citrix/Authentication. [#599292].

Configuration of Optimal HDX routing with old PowerShell cmdlet fails

When attempting to configure Optimal HDX routing with the old PowerShell cmdlet using Set-DSOptimalGatewayForFarms, the command fails.[#624040]


  1. Configure a global gateway with the settings you want for Optimal HDX routing using the Add-DSGlobalV10Gateway command and provide default values for the authentication settings.
  2. Use the Add-DSStoreOptimalGateway command to add the optimal gateway configuration.

Add-DSGlobalV10Gateway -Id 2eba0524-af40-421e-9c5f-a1ccca80715f -Name LondonGateway -Address "http://example" -Logon Domain -SecureTicketAuthorityUrls @("http://staurl1", "http://staurl2")
Add-DSStoreOptimalGateway -SiteId 1 -VirtualPath /Citrix/Store1 -GatewayId 2eba0524-af40-421e-9c5f-a1ccca80715f -Farms @("Controller") -EnabledOnDirectAccess $true

Authentication Service problems after upgrade

Upgrades from StoreFront 2.x to 3.x followed by a propagation to the server group might result in an entry for the pnaAuthenticationStartupModule being added to the authentication configuration file. Because entries can be added only to authentication services that have been enabled for PNA authentication services and PNA password change, the authentication service cannot start, as it’s missing the named start-up module. [#640644]

Workaround: Remove the entry from the authentication configuration file. By default, the configuration file resides at C:\inetpub\wwwroot\Citrix\<Your_Auth_Service>\web.config.