Product Documentation

Upgrade a machine catalog

Apr 22, 2014

Machines in a machine catalog from previous versions might contain machines running earlier VDA versions, or earlier Windows operating systems. These include:

  • VDA versions 5.0 Service Pack 1, 5.5, 5.6, or 5.6 Feature Pack 1
  • VDA Version 5.6 on a Microsoft Windows 7 operating system
  • Microsoft Windows XP or Microsoft Windows Vista operating systems
Note: Remote PC Access does not support Microsoft Windows Vista.

Perform the following upgrades on machines before you upgrade the machine catalog:

  • Upgrade the operating system to Microsoft Windows 7 or Microsoft Windows 8.x.
  • Upgrade the VDA version to version 7 as described in XenDesktop 5 upgrade components.

Once you upgrade these machines' operating systems or VDA versions, upgrade their machine catalogs to take advantage of the latest features in this release.

After upgrading the machine operating system and VDA version, and before you run Studio to upgrade the machine catalog, you must:

  • Make sure you upgrade the VDA version in the Provisioning Services console if you use Provisioning Services to create machine catalogs.
  • Start the machines and register them with the Delivery Controller. Otherwise, the Studio wizard cannot determine whether the machines in the machine catalog need upgrading.

To upgrade machine catalogs

When creating or editing a machine catalog, the wizard displays the following option if it detects older operating system versions:

Some virtual machines are running Windows XP or Windows Vista.

You should also select this option if the virtual machine is running Windows 7 with VDA 5.6

Select the checkbox for this option so that the wizard creates a machine catalog specifically for these types of systems.

You can create the machine catalog, but before upgrading the machine catalog, make sure that referenced machines have been upgraded to:

  • Windows 7 or Windows 8.x
  • For machines running Windows 7, they must also run VDA version 7.
  1. In Studio, select the Machine Catalogs node and then click View.
  2. Select the machine catalog to upgrade. Check the Details tab, which displays operating system and VDA version information and click Upgrade Catalog. The wizard checks to make sure that the machine catalog can be upgraded and indicates that the machine catalog is suitable for upgrade.
    • If the wizard indicates that the machine catalog is suitable for upgrade, an informational message appears. Click Upgrade and follow the prompts to complete the upgrade.
    • If one or more machines are not suitable, the wizard lists the reasons for the machine deficiencies.
      • Click View Details for detailed information. You can optionally export the information to a file by clicking Export Details in the Upgrade Warnings dialog box.
      • Click Cancel and update the machines that need upgrades.
    Citrix recommends that you resolve machine issues before upgrading the machine catalogs to ensure that all machine function properly.

To revert a machine catalog upgrade

You can revert the machines in a machine catalog to their prior states.

If you used Provisioning Services to create the machine catalog you want to revert, make sure you change the VDA version in the Provisioning Services console before reverting the machine catalog upgrade.

  1. In the Machine Catalogs node, click View.
  2. Select the machine catalog to revert. Check the Details tab, which displays operating system and VDA version information and click Undo. Follow the prompts to complete the process.