Page tree

CloudConnect Docs

Skip to end of metadata
Go to start of metadata

Upgrade RDS Server Configuration to the Latest CloudConnect Baseline

Last Updated:  

Background: CloudConnect periodically updates its Virtual Machine Template Images, including the preinstalled Citrix software components. Customers need these updates or upgrades to receive bug fixes and the latest features, which improve the remote computing experience. Except for Microsoft Software components, which are updated based on your configuration preferences, the Citrix software and other core software components distributed by CloudConnect do not have an automatic or upgrade mechanism.  Additionally, upgrades can be invasive to end users, so it is important that they be rolled out as part of a planned per-organization process.

CloudConnect distributes Remote Desktop Services configuration updates and Citrix Server-Side software upgrades through CloudConnect's Desktop Host Configuration Utility.  To install the latest CloudConnect-supported upgrades for RDS and Citrix features, run the latest release of the Desktop Host Configuration Utility on the Virtual Machine Console of the Desktop Host that you would like to upgrade.  The Desktop Host Configuration Utility is made available as an ISO Image file in the vCloud Director Public Catalog.  The following procedure below details the full update process.

Note: If Citrix XenApp 6.5 is installed in Programs and features, then prior to running DesktopConfig, you must first run UpgradePrep (available in the vCloud Catalog). DesktopConfig will alert you to this if you attempt to run it on a Desktop Host where XenApp 6.5 is installed.

Note: Do not run DesktopConfig on a virtual machine that is configured to perform windows server functions only. Do not run DesktopConfig on a Domain Controller. DesktopConfig should only be run on a Virtual Machine configured as a Remote Desktop Session Host or Citrix XenApp Desktop Server.


Prior to beginning this procedure, make sure all Citrix or RDS Desktop Users are logged out of their Cloud Desktops.

Applies To: Microsoft Windows Remote Desktop Services 2012R2-2019, Citrix XenApp & XenDesktop 7.X

Additional Notes: 

If the Upgrade fails, take the following action:

1) Collect Logfiles located at C:\CloudConnect\DesktopConfig\

2) Open a Low Priority Support Ticket case with CloudConnect Technical Support, and attach your log files.

3) Rollback the upgrade by choosing "Revert To Snapshot" from the Virtual Machine's context menu.

4) Power On the Virtual Machine.

5) If users still cannot logon within 15 minutes of Powering On the Virtual machine after Reverting the Snapshot, escalate your Technical Support Request's Severity to Service Outage.

The CloudConnect Desktop Configuration Utility upgrades Remote Desktop Services and Citrix software components to the latest Cloudconnect-supported Configuration.  Desktop Configuration Utility does not upgrade the Windows Operating System.  For guidance on upgrading the Microsoft Windows Operating System in place, see CloudConnect Upgrade Preparation Utility.