Filename: XD560VDAWX64500.zip
For: XenDesktop 5.6 Feature Pack 1 Virtual Desktop Agent (64-bit). For operating system requirements, see Citrix eDocs, the Citrix Product Documentation Library.
Replaced hotfixes: See table
Date: October, 2014
Languages supported: English (US), Japanese (JA), Simplified Chinese (SC)
Readme version: 1.01

Readme Revision History

Contents

This hotfix rollup replaces all earlier hotfix rollups and most individual hotfixes released for Version 5.6 of the Virtual Desktop Agent so far. It also introduces a number of new fixes and enhancements that have not been released previously.

• List of Replaced Hotfixes

• Known Issues in This Release

• New Fixes in This Release

• Fixes from Hotfixes Released and Replaced since Hotfix Rollup XD560VDAWX64400

• Installing This Release

Important Note(s)

• You can install or upgrade the Virtual Desktop Agent from a console session or from an RDP session. Upgrading from within an ICA session is not supported.
• If you intend to use the Universal Print Server feature, Citrix recommends that you install the Universal Print Server Client before installing this hotfix rollup pack. When installing this hotfix rollup pack on systems with the UpsClient installed or when installing the UpsClient on systems with this hotfix rollup pack installed, a Windows security warning might appear, stating that Windows cannot verify the publisher of the driver software. When this happens, click “Install this driver software anywayâ€� to complete the installation. [#0508898]
• This release introduces a number of fixes related to the HDX MediaStream Flash Redirection feature. For detailed information about specific versions of Internet Explorer and Adobe Flash supported by these fixes, websites we tested them against, as well as known issues and workarounds, see Knowledge Center article CTX136588.
• Caution! This release may require you to edit the registry. Using Registry Editor 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.

Where to Find Documentation

This document describes the issue(s) resolved by this release and includes installation instructions. For additional product information, including supported operating systems and system requirements, see Citrix eDocs, the Citrix Product Documentation Library.

Replaced Hotfixes

This hotfix rollup replaces the following hotfixes, that is - it offers a single installation package for all fixes previously available in those hotfixes:

XD560VDAWX64200, XD560VDAWX64300, XD560VDAWX64400, XD560VDAWX64305, XD560VDAWX64306, XD560VDAWX64307, XD560VDAWX64308, XD560VDAWX64309, XD560VDAWX64401, XD560VDAWX64402, XD560VDAWX64403, XD560VDAWX64404, XD560VDAWX64405

Known Issues in This Release

• After installing this release, VDAs can experience a fatal exception, displaying a blue screen when running two or more Microsoft Office 2013 applications at the same in the same session. The issue occurs with the RTM and early versions of Office 2013. To prevent this issue from happening, upgrade to Version 15.0.4535.1002 or later of Office 2013.
• Installing or upgrading an existing version of the ESXI Driver tool on a system where a VDA is already installed, any future sessions on that VDA are disconnected immediately upon launch. As a workaround, see Knowledge Center article CTX137417.

New Fixes in This Release

This rollup introduces the following fixes that have not been previously released:

Enhancement

1. This is an enhancement in support of a specific 5-in-1 COM port device. It ensured that the ID card reader function of the device works properly in VDA sessions.

   [From XD560VDAWX64500][#LC0325]

HDX 3D Pro

1. In HDX 3D Pro sessions, the screen can fail to be fully drawn; instead, parts of the session screen appear in black.

   [From XD560VDAWX64500][#LA5338]

2. Attempts to reconnect to an HDX 3D Pro enabled session can fail and a black screen appears.

   [From XD560VDAWX64500][#LC0213]

HDX MediaStream Flash Redirection

1. When using Microsoft Internet Explorer 8 or later, Flash redirection can fail for videos embedded in websites. A black rectangle appears in place of the video.

   [From XD560VDAWX64500][#LC0477]

2. When using Microsoft Internet Explorer 9 and later versions of the browser, if you click a link to a Flash redirected video while another Flash redirected video is already playing, the audio streams of the two videos overlap.

   This fix does not eliminate the issue, but setting the following registry key on the VDA allows you to shorten the amount of time during which it occurs:

   HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\HdxMediaStreamForFlash\Server\PseudoServer
   Name: UrlListForTerminationFlashInst
   Type: REG_MULTI_SZ
   Data: <URLs of affected websites; include both http:// and https://, each on a separate line; for example: http://www.youtube.com/; https://www.youtube.com/>

   [From XD560VDAWX64500][#LC0453]

3. Flash redirection fails for videos embedded on cnn.com and msn.com. A black rectangle appears in place of the video.

   In order to enable this fix, you must set the following registry keys:

   HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\HdxMediaStreamForFlash\Server\PseudoServer\ASJSCallbacks

   For cnn.com:

   Name: cnn.com
   Type: REG_MULTI_SZ

   Data:	javaScriptLoaded
   	setQueueAutoplay
   	setAdVisibility
   	setPlayerMode
   	setAdSection
   	setAdKeyValue
   	playContent
   	getContentEntry
   	switchTrackingContext

   For msn.com:

   Name: msn.com
   Type: REG_MULTI_SZ

   Data:	MsnVideoCallback
   	MsnVideoPropertyCallback
   	GetWidgetID

   Note: This fix works only for Internet Explorer 9 and later.

   [From XD560VDAWX64500][#LC0665]

4. After using YouTube's built-in Search field In Microsoft Internet Explorer 8 and later versions of the browser, HDX Flash Redirection reverts to server-side rendering.

   To enable this fix, you must set the following registry key on the VDA:

   HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\HdxMediaStreamForFlash\Server\PseudoServer
   Name: SupportedUrlHeads
   Type: REG_MULTI_SZ
   Data: <each value on a separate line, null separated>
   http://
   https://
   file://

   Note: SupportedUrlHeads was first introduced in Fix #LA4151. It is also used by this fix. If you add SupportedUrlHeads to the Registry, Flash Redirection ignores a Flash instantiation request unless the targeted URL starts with one of the headers specified in SupportedUrlHeads.

   [From XD560VDAWX64500][#LC0505]

5. While viewing YouTube.com using Microsoft Internet Explorer 8 and later versions of the browser, Flash videos can appear as black rectangles when you:

   • Open a Windows Explorer window to overlap the YouTube browser page
   • Hover the mouse pointer over YouTube's Search field, or any video preview or hyperlink on the page

   [From XD560VDAWX64500][#LC0506]

HDX Plug and Play

1. This enhancement allows NI USB-8473 devices to be redirected into virtual desktop sessions.

   [From XD560VDAWX64500][#LA4970]

2. This enhancement allows USB HID devices(device descriptor with device class: 0xFF, interface descriptor with device class: 0x03) to be redirected into virtual desktop sessions.

   [From XD560VDAWX64500][#LA5388]

Keyboard

1. When reconnecting to a session from a different user device that has a different keyboard layout, the new keyboard layout is not applied automatically to the existing session.

   [From XD560VDAWX64500][#LA5004]

Printing

1. Client printer redirection in a VDA session can fail after switching from an RDP session.

   [From XD560VDAWX64500][#LC0164]

2. When using the Citrix XPS Universal Printer driver to print a Microsoft Excel document, each Excel cell of the spreadsheet is printed as a single page, causing multiple pages to be printed. This happens when the "Fit Sheet on One Page" option is selected.

   To enable the fix, set the following registry keys:

   HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Print
   Name: dmFields
   Type: REG_DWORD
   Data: 0x00000010

   [From XD560VDAWX64500][#LA4288]

3. When using the Citrix XPS Universal Printer driver to print a Microsoft Excel document, each Excel cell of the spreadsheet is printed as a single page, causing multiple pages to be printed. The issue occurs when modifying the page layout ("Printer Properties" > "Layout") on the Citrix UPD screen.

   To enable the fix, set the following registry key:

   HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Print
   Name: dmFields
   Type: REG_DWORD
   Data: 0x00000010

   [From XD560VDAWX64500][#LA5228]

4. If using the XPS universal printer driver (UPD), the page orientation (portrait or landscape) cannot be changed on the Layout tab in Microsoft Outlook 2010.

   [From XD560VDAWX64500][#LA5211]

5. The Citrix Print Manager Service (CpSvc.exe) process might exit unexpectedly. As a result, printers fail to autocreate.

   [From XD560VDAWX64500][#LA5451]

6. Creating new session printers on a Windows XP computer might fail. This occurs when you delete a session printer manually.

   [From XD560VDAWX64500][#LC0193]

Server/Farm Administration

1. A high number of Event ID 4624 (Account successfully logged on) and Event ID 4634 (Account logged off) entries is recorded in the Windows Security Log.

   [From XD560VDAWX64500][#LC0147]

Session/Connection

1. When connecting a USB magnetic card reader device, the device is recognized in the virtual desktop but the correct drivers do not load.

   [From XD560VDAWX64500][#LC0360]

2. When you press the Windows+Left/Right arrow keys to move an application to the edge of the screen, then disconnect and reconnect to the session, the application is resized. The degree of the resizing varies by application and is greater on non-primary monitors.

   [From XD560VDAWX64500][#LC0386]

3. After reconnecting to a VDA session, the Windows Taskbar might disappear following certain user activities.

   [From XD560VDAWX64500][#LA5747]

4. In scenarios with two dual-monitor endpoints A and B with identical screen resolutions, when you disconnect from endpoint A and then reconnect from endpoint B, all top-level windows are repositioned to the primary monitor.

   [From XD560VDAWX64500][#LA5440]

5. If the CANcaseXL USB network adapter is redirected into a virtual desktop, it appears to malfunction in Windows Device Manager. This USB device does not support the Citrix USB redirection driver. The VDA requires installation of Fix #LA5022 in order to work properly.

   [From XD560VDAWX64500][#LA5022]

6. The PICA Display Manager (PicaDispMgr.exe) might exit unexpectedly and can cause the virtual desktop session to become unresponsive when using Camtasia Studio, which is a third party application on Version 5.6.300 of a VDA.

   [From XD560VDAWX64500][#LA5285]

7. When using Microsoft Lync's chat feature on a mobile device, the soft keyboard can disappear unexpectedly.

   [From XD560VDAWX64500][#LA5371]

8. Attempts to open a disconnected published application that is started in seamless mode from the Web Interface by using Receiver for Linux or Citrix Receiver for Windows fail.

   [From XD560VDAWX64500][#LA5817]

Smart Cards

1. After authenticating to a VDA using Citrix Receiver for Linux while a smart card is present in the reader attached to the endpoint, the VDA can become unresponsive.

   [From XD560VDAWX64500][#LC0982]

System Exceptions

1. The Citrix ICA Service (PicaSvc.exe) might exit unexpectedly due to a handle leak after several hours of working.

   [From XD560VDAWX64500][#LA4987]

2. The WorkstationAgent.exe process can exit unexpectedly.

   [From XD560VDAWX64500][#LA5553]

3. The WorkstationAgent.exe process can exit unexpectedly.

   [From XD560VDAWX64500][#LA5435]

4. Even on systems with Fix #LA2882 installed, VDAs might experience a fatal exception, displaying a blue screen, on vdtw30.dll with bugcheck code 0x7F.

   [From XD560VDAWX64500][#LA4934]

5. On a Windows 7 computer, an error on a blue screen appears due to PICAVC.SYS referencing a null pointer.

   [From XD560VDAWX64500][#LC0139]

Miscellaneous

1. VDAs do not attempt to reregister with the Delivery Controller after a network outage.

   [From XD560VDAWX64500][#LA5658]

Fixes from Hotfixes Released and Replaced since Hotfix Rollup XD560VDAWX64400

This rollup also contains all fixes included in Rollups XD560VDAWX64200, XD560VDAWX64300, and XD560VDAWX64400, plus the following fixes that shipped since the release of Hotfix Rollup XD560VDAWX64400:

1. The Rundll32.exe process might exit unexpectedly during VDA startup.

   [From XD560VDAWX64305][#LA5065]

2. This fix addresses a security vulnerability. For more information, see Knowledge Center article CTX139591.

   [From XD560VDAWX64306][#LA4447]

3. If you initiate a connection to a VDA with Hotfix XD560VDAWX64301 (or its replacement) installed but then disconnect before entering credentials, the VDA refuses to accept new connections until it is restarted.

   [From XD560VDAWX64306][#LA5781]

4. SmoothRoaming from unbrokered RDP to Receiver sessions fails for sessions running on VDAs with Hotfix XD560VDAWX64301 (or its replacement) installed.

   [From XD560VDAWX64306][#LC0054]

5. The PICA Display Manager (PicaDispMgr.exe) might exit unexpectedly and can cause the virtual desktop session to become unresponsive when using Camtasia Studio, which is a third party application on Version 5.6.300 of a VDA.

   [From XD560VDAWX64307][#LA5285]

6. After reconnecting to a VDA session, the Windows Taskbar might disappear following certain user activities.

   [From XD560VDAWX64308][#LA5747]

7. When using Microsoft Lync's chat feature on a mobile device, the soft keyboard can disappear unexpectedly.

   [From XD560VDAWX64309][#LA5371]

8. When attempting to RDP into a VDA where certain third-party applications are installed, the logon screen can lack the requisite text input fields for user names and passwords.

   The issue occurs because the Citrix credential provider does not provide the requisite fields to enter credentials for RDP connections.

   [From XD560VDAWX64401][#LA5393]

9. On systems with Fix #LA3065 (XD560VDAWX64400) installed, browsing web sites with Internet Explorer 8 or later can cause the browser to become unresponsive. The issue occurs regardless of whether or not the web site contains Flash content.

   [From XD560VDAWX64402][#LA5876]

10. When using a Receiver for Linux or Windows to reconnect to a session initiated using a Receiver for iOS, the screen saver fails to initialize.

    [From XD560VDAWX64403][#LA5133]

11. On VDAs running on a non-English language operating system, attempts to reconnect to a session that was disconnected from the Connection Center can fail.

    [From XD560VDAWX64403][#LA5739]

12. The Rundll32.exe process might exit unexpectedly during VDA startup.

    [From XD560VDAWX64404][#LA5065]

13. Users can establish a Remote Desktop (RDP) connection to a VDA, even if they are not members of the Direct Access Administrators Group or Administrator group.

    [From XD560VDAWX64405][#LA5039]

14. If you initiate a connection to a VDA with Hotfix XD560VDAWX64301 (or its replacement) installed but then disconnect before entering credentials, the VDA refuses to accept new connections until it is restarted.

    [From XD560VDAWX64405][#LA5781]

15. SmoothRoaming from unbrokered RDP to Receiver sessions fails for sessions running on VDAs with Hotfix XD560VDAWX64301 (or its replacement) installed.

    [From XD560VDAWX64405][#LC0054]

16. Attempts to launch a session to a VDA from the Web Interface might fail.

    This fix introduces support for the following registry value that attempts to modify the registry stack to start listening to the time-out setting and the Windows Communication Foundation (WCF) time-out value in the file WorkstationAgent.exe.config. If PrepareSession() does not change the stack state within five seconds, the session fails to start.

    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\PortICA\PicaSvc
    Name: StackStartListeningStateTimeout
    Type: REG_DWORD
    Value: <amount of time in milliseconds; recommended: 90000>

    To modify the WCF time-out value (recommended value is 120 seconds):

    1. Run Notepad as administrator.
    2. Open C:\Program Files\Citrix\Virtual Desktop Agent\WorkstationAgent.exe.config
    3. Change the "sendTimeout="00:00:20"" time value at line 10 (inside the XML tag starting with <binding name="NamedPipeBinding"…) to "00:02:00"
    4. Change the "sendTimeout="00:00:20"" time value at line 17 (inside the XML tag starting with <binding name="StackManagerNamedPipeBinding"…) to "00:02:00"
    5. Save and close the file.

    [From XD560VDAWX64405][#LC0243]

Installing This Release

Notes:

• For specific installation and upgrade information, see Installing and Upgrading to XenDesktop 5.6 and Knowledge Center article CTX127301.
• Before deploying HDX 3D Pro Graphics for the first time, see Installing and Configuring HDX 3D Pro for more information.
• Before upgrading an existing HDX 3D Pro Graphics deployment, see Install Procedures for HDX 3D Pro VDA for more information.
• This version is packaged as a .zip file containing the replacement XdsAgent_x64.msi file. For more information about deploying msi files, see Microsoft article 884016 or visit the Microsoft Web site and search on keyword msiexec.
• To install this version successfully, servers must not have registry modification restrictions in place.
• If you select "Close the applications and attempt to restart them" on the Files in Use page of the installation wizard of this hotfix, a message might appear, stating the following:
  "Some files that need to be updated are currently in use. The following applications are using files that need to be updated by this setup. You can let the Setup Wizard close them and attempt to restart them or reboot the machine later."
  If this happens, you can safely ignore the message and click OK to continue with the installation.

To install this version:

1. Copy the file to a shared folder on the network.
2. Extract the compressed file and save the XdsAgent_x64.msi file on the computer you want to update.
3. Run the .msi file.
4. Restart the computer if prompted to do so.

If it does not exist already, this will add a new entry, Citrix Virtual Desktop Agent Core Services, to the Add/Remove Programs list.