Filename: XD560VDAWX86409.msp
For: XenDesktop 5.6 Virtual Desktop Agent (32-bit) with Hotfix Rollup XD560VDAWX86400 installed. For operating system requirements, see Citrix Product Documentation.
Replaces: XD560VDAWX86404, XD560VDAWX86405
Date: April, 2015
Language: English (US), Japanese (JA), Simplified Chinese (SC)
Readme version: 1.00

Readme Revision History

Important Note(s)

• This limited release is based on XenDesktop Virtual Desktop Agent 5.6 Hotfix Rollup XD560VDAWX86400. It patches only systems where the XdsAgent_X86.MSI file that shipped as Hotfix Rollup XD560VDAWX86400 is installed.
• 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.
• 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 Product Documentation.

Important Disclaimer - Limited Release Update

If the Download link is not available on this page and you wish to obtain this limited distribution release, visit our support site at http://www.citrix.com/support and open a support case using your Citrix account credentials, or contact your reseller at http://www.citrix.com/partners/locator.

Testing of this release was targeted only at the affected functionality, and regression and stress testing were minimal. Introduce this release to a test environment for evaluation before deploying it to a production environment.

TO THE EXTENT PERMITTED BY APPLICABLE LAW, CITRIX AND ITS SUPPLIERS MAKE AND YOU RECEIVE NO WARRANTIES OR CONDITIONS, EXPRESS, IMPLIED, STATUTORY, OR OTHERWISE, AND CITRIX AND ITS SUPPLIERS SPECIFICALLY DISCLAIM WITH RESPECT TO THE HOTFIX ANY CONDITIONS OF QUALITY, AVAILABILITY, RELIABILITY, SECURITY, LACK OF VIRUSES, BUGS OR ERRORS, OR SUPPORT AND ANY IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, ANY WARRANTY OF TITLE, QUIET ENJOYMENT, QUIET POSSESSION, MERCHANTABILITY, NONINFRINGEMENT, OR FITNESS FOR A PARTICULAR PURPOSE. TO THE EXTENT PERMITTED BY APPLICABLE LAW, NEITHER CITRIX, NOR ITS SUPPLIERS SHALL BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL, MULTIPLE, PUNITIVE OR OTHER DAMAGES (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF DATA, LOSS OF INCOME, LOSS OF OPPORTUNITY, LOST PROFITS, COSTS OF RECOVERY OR ANY OTHER DAMAGES), HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, AND WHETHER OR NOT FOR BREACH OF CONTRACT, NEGLIGENCE OR OTHERWISE, AND WHETHER OR NOT CITRIX, ITS SUPPLIERS, OR LICENSORS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

New Fixes in This Release

1. A "Connection Established, Negotiating Capabilities" pop-up window appears from the Receiver when the VDA becomes unresponsive. To start any other sessions successfully, restart the VDA.

   [From XD560VDAWX86409][#LC0909]

2. When users connect to a VDA with Remote Desktop (RDP) and then attempt to start a desktop from the Web Interface, Receiver for Linux starts and the ICA connection stops responding.

   [From XD560VDAWX86409][#LC1383]

3. If users log on to the Web Interface from within a VDA desktop session and attempt to start the same desktop, the session might disconnect and the VDA becomes unresponsive. As a result, users might not be able to start the desktop and the VDA must be restarted.

   [From XD560VDAWX86409][#LC2267]

Fixes from Replaced Hotfixes

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

   [From XD560VDAWX86404][#LA5065]

2. 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 XD560VDAWX86405][#LA5039]

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

   [From XD560VDAWX86405][#LA5781]

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

   [From XD560VDAWX86405][#LC0054]

5. 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\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 XD560VDAWX86405][#LC0243]

Installing and Uninstalling This Update

Notes:

• This release is packaged with Microsoft Windows Installer 3.0 as a .msp file. For more information about deploying .msp files, see Microsoft article 884016 or visit the Microsoft Web site and search on keyword msiexec.
• This installer program complies with Microsoft User Account Control (UAC). If UAC is enabled, you must run the installer program in elevated mode; that is, with administrative privileges enabled. For more information about UAC, see Microsoft TechNet or visit the Microsoft Web site and search on keyword UAC.
• To install this release successfully, computers must not have registry modification restrictions in place.
• Slipstreaming - installations of the VDA base product packaged with one or more individual hotfixes - is not supported and might leave computers in an unstable state.
• You must restart the computer after the installation of this hotfix completes. However, if you are installing multiple hotfixes at the same time, there is no need to restart the computer after the installation of each hotfix. It is sufficient to restart the computer after the installation of the final hotfix completes.
• If the need arises to restore the original settings and functionality provided by this release, you must uninstall the update before reinstalling it according to the installation instructions below.

To install this update:

1. Copy the hotfix package to an empty folder on the hard drive of the computer you want to update.
2. Close all applications.
3. Run the executable.
4. Restart the computer.

To uninstall this hotfix:

1. From the Start menu, select Control Panel > Programs and Features.
2. Highlight the hotfix you want to uninstall and click Uninstall.
3. Follow the directions on-screen.

Files Updated (All Dates/Times UTC)