Citrix Virtual Apps and Desktops Site upgrade fails when upgrading to 1808.1.0

Citrix Virtual Apps and Desktops Site upgrade fails when upgrading to 1808.1.0

book

Article ID: CTX237835

calendar_today

Updated On:

Description


When following the Site upgrade steps provided in the Upgrade a deployment section of the Citrix Product Documentation, the upgrade fails at the "Run Studio" step:
User-added image
This failure occurs only when:

  • Upgrading from a previous XenApp and XenDesktop version to Citrix Virtual Apps and Desktops 7 1808.1
  • The Site to upgrade contains two or more Delivery Controllers
  • Only some of the Site Delivery Controllers have been upgraded
The error encountered in Studio 1808.1 during the upgrade attempt is "This version of Studio cannot be used with your current Delivery Controller. Upgrade your Controller version to 1808.1.0." and shown here:
User-added image

Resolution


Scenario-based Solutions

Before you start: The download location for the Citrix Virtual Apps and Desktops 7 1808.2 Product ISO used in the following solutions is:
https://www.citrix.com/downloads/citrix-virtual-apps-and-desktops/product-software/citrix-virtual-apps-and-desktops-1808.html

Scenario 1: The Site upgrade to 1808.1 was not successful
If you already have downloaded the 1808.1 version, updated some of the Delivery Controllers in the Site, and have encountered the error described in the "Symptoms or Error" section, please perform the following steps:
  1. Download the 1808.2 build and then insert the media or mount the ISO drive for the new release.
  2. Upgrade the existing 1808.1 Delivery Controllers to 1808.2, using the 1808.2 graphical interface product installer (AutoSelect.exe).
    • During this process, Studio 1808.1 (if installed) on the Delivery Controller will be upgraded to Studio 1808.2
  3. Upgrade any installed instances of Studio 1808.1 on standalone machines to Studio 1808.2
  4. Perform the Site upgrade from Studio.
  5. After the Site has been upgraded, continue to upgrade remaining Controllers to 1808.2

Scenario 2: The Site upgrade to 1808.1 was successful
For customers who did not encounter the issue described in the "Symptoms or Error" section and have successfully upgraded their Site to 1808.1, they will still need to upgrade to 1808.2.
To upgrade in this scenario, please follow the following steps:
  1. Download the 1808.2 build and then insert the media or mount the ISO drive for the new release.
  2. Upgrade the Site to 1808.2 by following the Upgrade a deployment section of the Citrix Product Documentation.

Important Additional Information
  • Citrix Virtual Apps and Desktops 7 1808.1 is no longer available for download.
  • Do not use the Citrix Virtual Apps and Desktops 7 1808.1 Product ISO (Citrix_Virtual_Apps_and_Desktops_7_1808.iso) to upgrade your Site.
  • For customers who are planning to perform a Site upgrade to Citrix Virtual Apps and Desktops 7 1808, download Citrix Virtual Apps and Desktops 7 1808.2 Product ISO (Citrix_Virtual_Apps_and_Desktops_7_1808_2.iso) before performing the Site upgrade from a previous version.
  • Check that installed Citrix product & component versions have been updated to 1808.2. Use Programs and Features in Control Panel on machines where Citrix Core products have been installed. The following table lists the product Name and Version comparison for installed products/components:
User-added image

Problem Cause

Citrix Studio 1808.1.0 contained a bug that prevented it from communicating with Delivery Controller versions older than 1808.1