Filename: XA_XD_760_Controller_X86_HFs_2.zip
For: XenApp 7.6 and XenDesktop 7.6 Delivery Controller (32-bit). For operating system requirements, see Citrix Product Documentation.
Replaces: BrokerSrvc760WX86001, HostSrvc760WX86001, MCSrvc760WX86001, MonitorSrvc760WX86001
Date: July, 2015
Languages supported: English (US), Japanese (JA), Simplified Chinese (SC)
Readme version: 1.00

Readme Revision History

Important Note(s)

• Caution: This section applies to all customers:
  By design, the Broker Service hotfix (BrokerSrvc760WX86002.msi) included in this update modifies the DbSchema of your Broker data store (the "data store"). These modifications are permanent and irreversible. Should you decide, for any reason, to uninstall the Broker Service hotfix at a later time, these modifications do not revert automatically. As a matter of precaution, Citrix recommends strongly that you back up your data store before installing the Broker Service hotfix. Doing so allows you to manually restore your data store to the backed up version. Even so, any changes you make to the data store between backing up and restoring it are lost. For information about backing up and restoring your data store, see Knowledge Center article CTX135207.
  The DbSchema update succeeds only if at least one site is created. If you have not yet created a site, create at least one site before installing this update. Otherwise, the install fails to update the existing DBSchema and you will need to rebuild your XenDesktop.
• Important: All hotfixes included in this release must be installed; otherwise, your Controller might be left in an unstable state. If you are upgrading from the base (RTM) version of the 7.6 Controller, install all hotfixes included in this package. If you are upgrading from an earlier release of Controller Hotfixes, install only the hotfixes that are new in this package compared to the earlier release you already installed. There is no need to install the individual hotfixes in a specific order.
• After the upgrade to this release, a prompt appears for the License Server compatibility check in Desktop Studio that makes sure that your License server is the required version. If you are using the License server released with XenDesktop 7.6 or from a more recent version, you do not need to upgrade the License server. Click Continue to proceed with the DBschema upgrade.
• For known issues with Citrix XenApp 7.6 and XenDesktop 7.6, see Citrix Product Documentation.

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.
• For information about XenApp and XenDesktop upgrade best practices, see Citrix Product Documentation.

Known Issues

1. If the hotfix package ConfMgrWOL760WX86002 is installed first, the error message "HCLPlugins\Managed Machine Folder not found" appears. To prevent the error, install the following packages first: Broker Services [BrokerSrvc760WX86002], Machine Creation Services [MCSrvc760WX86002] or Host Services [HostSrvc760WX86002]. Citrix strongly recommends that ConfMgrWOL760WX86002 is installed last.

   If you need to remove the hotfixes, uninstall ConfMgrWOL760WX86002 first and then uninstall the rest of the packages.

2. If a Delegated Administrator account has User Access Control enabled, updates to Delivery Controller are installed to the default location in error. The default location is "systemroot%\Program Files\Citrix" and this might not be the same location where you originally installed Delivery Controller. To resolve this issue, perform one of the following steps:
   
   • Disable User Account Control and then run the msi file.
   • Install the packages as a "local administrator" on the Delivery Controller server when User Account Control is enabled.

   [#LC2252]

3. After applying the Broker Service and/or Monitor Service hotfix included in this update, Desktop Studio prompts for a database upgrade. If you click Start the automatic Site upgrade, the Upgrading Site dialog box appears. In that dialog box, if you click I am ready to upgrade, another dialog box, Studio, appears after the database upgrade completes. The interface of the Studio dialog box is misleading in that it displays a green check mark next to 0 Successful tasks - even though the database upgrade was successful.

New Fixes in This Release

1. When the user updates a catalog, the Configuration Logging reports that the "Update Machine Catalog" is successful but one of the tasks in the Task Details view shows the message "Release the provisioning scheme" failed.

   [From MCSrvc760WX86002][#LC0518]

2. If you create virtual machines (VM) with Desktop Studio that uses Machine Creation Services and the VMs are hosted on a VMware hypervisor, attempts to update VMs that are part of the machine catalog fail. When this occurs, an error appears in the Machine Creation log that the virtual disk does not exist, but the directory in the datastore does exist.

   [From BrokerSrvc760WX86002, ConfigMgrWOL760WX86002, HostSrvc760WX86002, MCSrvc760WX86002][#LC1201]

3. When provisioning VDAs by using the Machine Creation Service, the primary DNS suffix changes for the VDAs.

   [From MCSrvc760WX86002][#LC1300]

4. If a VDA in a shared delivery group is tagged and the tag is used as part of a policy filter, the policies are not applied to other VDAs in the delivery group.

   [From BrokerSrvc760WX86002][#LC1506]

5. Creating new catalogs fail after upgrading to XenDesktop 7.6 and if the master VM image contains a nested hardware virtualization property that is enabled on VMware vSphere 5.1.

   [From BrokerSrvc760WX86002, HostSrvc760WX86002, MCSrvc760WX86002][#LC1586]

6. In the Powershell snap-in, running the command Get-Help set-MonitorConfiguration -detailed returns the error message -"GroomApplicationInstanceRetentionDays <Int32> FIXME".

   [From MonitorPSSI760WX86002][#LC2176]

7. If a Delegated Administrator account has User Access Control enabled, updates to Delivery Controller are installed to the default location in error. The default location is "%systemroot%\Program Files\Citrix" and this might not be the same location where you originally installed Delivery Controller.

   [From BrokerSrvc760WX86002, HostSrvc760WX86002, MCSrvc760WX86002, MonitorSrvc760WX86002][#LC2252]

8. If a virtual graphics processing unit (VGPU) is enabled in the VM master image in VMware vSphere 6 with a GRID board, the machine creation process fails.

   [From BrokerSrvc760WX86002, HostSrvc760WX86002, MCSrvc760WX86002][#LC2326]

9. If applications are open when a session ends, the EndDate column shows the time the session ended.

   [From MCSrvc760WX86002, MonitorSrvc760WX86002][#LC2435]

10. The VDA provisioned by integrated Hyper-V appears unregistered after subscribing successfully.

    [From BrokerSrvc760WX86002, HostSrvc760WX86002, MCSrvc760WX86002][#LC2722]

11. This release adds support for the Linux Broker Agent.

    [From BrokerSrvc760WX86002][#LC3146]

Fixes from Replaced Hotfixes

1. If the XenServer parameter "TimeOffSet" exists on the master image virtual machine (VM), creating the Machine Creation Services (MCS) catalog fails. To check the existance of the parameter, in the XenServer console, run the command "xe vm-list uuid= params=other-config". To resolve this issue, apply this hotfix or manually remove the parameter by running the XenServer command "xe vdi-param-remove uuid= param-name=other-config param-key=timeoffset".

   [From BrokerSrvc760WX86001, HostSrvc760WX86001, MCSrvc760WX86001][#LC1071]

2. The Monitoring Service prematurely deletes the application instance history after seven days instead of the default 90 days. This occurs in XenDesktop and XenApp deployments with Platinum Edition licensing.

   [From MonitorSrvc760WX86001][#LC1129]

3. In Desktop Director, on the "Trends > Hosted Applications Usage" tab, the totals for each application do not equal the sum total for all applications. This occurs in environments running for seven days or longer.

   [From MonitorSrvc760WX86001][#LC1130]

4. In some Amazon Web Services environments, provisioning desktops with Machine Creation Services (MCS) might fail with the error "No facility for disk upload", even when the environment is configured correctly.

   [From BrokerSrvc760WX86001, HostSrvc760WX86001, MCSrvc760WX86001][#LC1295]

Component Versions

Installing This Release

Notes:

• This release is packaged as a .zip file containing the replacement .msi files for the various components of XenApp 7.6 and XenDesktop 7.6 Controller. For more information about deploying msi files, see Microsoft article 884016 or visit the Microsoft Web site and search on keyword msiexec.
• This section applies to all customers:
  By design, the Broker Service hotfix (BrokerSrvc760WX86002.msi) included in this update modifies the DbSchema of your Broker data store (the "data store"). These modifications are permanent and irreversible. Should you decide, for any reason, to uninstall the Broker Service hotfix at a later time, these modifications do not revert automatically. As a matter of precaution, Citrix recommends strongly that you back up your data store before installing the Broker Service hotfix. Doing so allows you to manually restore your data store to the backed up version. Even so, any changes you make to the data store between backing up and restoring it are lost. For information about backing up and restoring your data store, see Knowledge Center article CTX135207.
  The DbSchema update succeeds only if at least one site is created. If you have not yet created a site, create at least one site before installing this update. Otherwise, the install fails to update the existing DBSchema and you will need to rebuild your XenDesktop.
• Caution: Downgrades, also known as rollbacks, from individual component hotfixes in this release are not supported and might leave your systems in an unstable state. The component hotfixes in this release do not patch the existing installations of the components - each fully replaces the original component with a new installation. As a result, uninstalling a component hotfix removes the entire component from the Controller. If the need arises to revert to an earlier version of the product, you must uninstall each component hotfix of this release and then reinstall the earlier versions of each component. Reverting to an earlier version of a component might result in the loss of settings you configure while this upgrade is installed.
• Important: All hotfixes included in this release must be installed; otherwise, your Controller might be left in an unstable state. If you are upgrading from the base (RTM) version of the 7.6 Controller, install all hotfixes included in this package. If you are upgrading from an earlier release of Controller Hotfixes, install only the hotfixes that are new in this package compared to the earlier release you already installed. There is no need to install the individual hotfixes in a specific order.
• To install the component hotfixes in the release successfully, servers must not have registry modification restrictions in place.

To install the component hotfixes in this release:

1. Copy the compressed hotfix package to a shared folder on the network.
2. Extract the compressed hotfix package and save the component msi file(s) on the Delivery Controller you want to update.
3. Run the .msi file(s).
4. Restart the Delivery Controller even if not prompted to do so.
5. To upgrade to the latest DbSchema installed by this release, go to the Desktop Studio Dashboard and click Upgrade.

To uninstall this hotfix and revert to an earlier level of the component and the data store:

1. Uninstall the component from ARP/Programs and Features.
2. Restore the data store as described in Knowledge Center article CTX135207.
3. Install the desired level of the component (base or other hotfix).
4. Restart the Controller even if not prompted to do so.