Upgrade

Important notice about upgrading VDAs

If the Personal vDisk (PvD) component was ever installed on a VDA, that VDA cannot be upgraded to version 1912 LTSR or later. To use the new VDA, you must uninstall the current VDA and then install the new VDA.

This instruction applies even if you never used PvD.

Learn if you’re affected

How PvD might have been installed in earlier versions:

  • In the VDA installer’s graphical interface, PvD was an option on the Additional Components page. The 7.15 LTSR and earlier 7.x releases enabled this option by default. So, if you accepted the defaults (or explicitly enabled the option in any release), PvD was installed.
  • On the command line, the /baseimage option installed PvD. If you specified this option, or used a script that contained this option, PvD was installed.

If you don’t know whether your VDA has PvD installed, run the installer for the new VDA (1912 LTSR or later) on the machine or image.

  • If PvD is installed, a message appears, indicating there is an incompatible component.
    • For the graphical interface, click Cancel on the page containing the message, and then confirm that you want to close the installer.
    • From the CLI, the command simply fails with the displayed message.
  • If PvD is not installed, the upgrade proceeds.

What to do

If the VDA does not have PvD installed, follow the usual upgrade procedure.

If the VDA has PvD installed:

  1. Uninstall the current VDA. For details, see Remove components.
  2. Install the new VDA.

If you want to continue using PvD on your Windows 7 or Windows 10 (1607 and earlier, without updates) machines, VDA 7.15 LTSR is the latest supported version.

Introduction

Citrix maintains all of the core Citrix Virtual Apps and Desktops service components in your deployment, except VDAs.

To upgrade a VDA, download the installer (as you did when you originally installed it) and run it on the machine or image. You can use the installer’s graphical or command-line interface.

If you originally installed the VDA using VDAWorkstationCoreSetup.exe, you will retain that configuration if you upgrade it with the latest version of the same installer. If you run VDAWorkstationSetup.exe on that machine, you can enable the features that are not supported in the VDAWorkstationCoreSetup.exe installer. (Keep in mind that some of those features might be enabled by default in the VDAWorkstationSetup.exe installer.) Additionally, you will have the option to install Citrix Workspace app.

When upgrading a VDA to version 7.17 or a later supported version, a machine restart occurs during the upgrade process. This cannot be avoided. The upgrade resumes automatically after the restart (unless you specify /noresume on the command line).

After you upgrade VDAs, update the master images and catalogs that use that VDA.

Learn about product name changes.

Earlier operating systems

For machines with OSs that are no longer supported for installation of the latest VDA (such as Windows 7 and Windows Server 2008 R2), you have several options.

  • Reimage the machine to a supported Windows version, and then install the new VDA.
  • If reimaging the machine is not an option but you want to upgrade the OS, uninstall the VDA before upgrading the OS. Otherwise, the VDA will be in an unsupported state. Then, install the new VDA.
  • If you want to continue to use machines with an OS that is no longer supported for VDA 7.16 or later, XenApp and XenDesktop 7.15 LTSR is the most current supported VDA version for Windows 7 and Windows Server 2008 R2.
    • If the machine has version 7.15 LTSR installed (and you attempt to install a newer version), a message informs you that you’re using the latest supported version.
    • If the machine has a version earlier than 7.15 LTSR installed, a message guides you to CTX139030 for information. You can download 7.15 LTSR VDAs from the Citrix web site.

More information