Citrix Virtual Apps and Desktops

Citrix Virtual Apps and Desktops 7 2003

About this release

This Citrix Virtual Apps and Desktops release includes new versions of the Windows Virtual Delivery Agents (VDAs) and new versions of several core components. You can:

  • Install or upgrade a site

    Use the ISO for this release to install or upgrade core components and VDAs. Installing or upgrading to the latest version allows you to use the latest features.

  • Install or upgrade VDAs in an existing site

    If you already have a deployment, and aren’t ready to upgrade your core components, you can still use several of the latest HDX features by installing (or upgrading to) a new VDA. Upgrading only the VDAs can be helpful when you want to test enhancements in a non-production environment.

    Be sure to check Upgrading VDAs to 1912 or later.

    After upgrading your VDAs to this version (from version 7.9 or later), you do not need to update the machine catalog’s functional level. The 7.9 (or later) value remains the default functional level, and is valid for this release. For more information, see VDA versions and functional levels.

For installation and upgrade instructions:

Citrix Virtual Apps and Desktops 7 2003


If the Personal vDisk (PvD) component was ever installed on a VDA, that VDA cannot be upgraded to version 1912 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 installed PvD but never used it.

To learn how to determine if you’re affected, and what to do, see Upgrading VDAs to 1912 or later.

Changes in host support for Current Releases

As of Citrix Virtual Apps and Desktops 7 2003, current releases of that product do not support VDAs (machines that deliver apps and desktops) on the following hosts:

  • Amazon Web Services (includes VMware Cloud on AWS)
  • CloudPlatform (refers to the original Citrix software platform)
  • Microsoft Azure (includes Azure Resource Manager and Azure Classic)

What is supported:

  • For Current Release (CR) customers, Citrix Virtual Apps and Desktops 7 supports the host and virtualization resources listed in each release’s system requirements documentation.

    For example, the supported hosts for the latest (newest) CR are listed in that release’s system requirements.

  • For Long Term Service Release (LTSR) customers, Citrix continues to support the hosts listed for each of those releases. Some of those LTSRs support VDAs on one or more cloud hosts that are no longer supported on CRs.

    For example, Citrix Virtual Apps and Desktops 7 1912 LTSR (and its cumulative updates, when released) supports the hosts listed in that release’s system requirements.


Citrix recommends that you use the Virtual Apps and Desktops service on Citrix Cloud, instead of the on-premises product. To learn more, see Migrating Citrix Virtual Apps and Desktops from on-premises to Citrix Cloud.

If you want to continue using on-premises Citrix Virtual Apps and Desktops 7 CR releases:

  • Unsupported hosts might remain in task flows and displays in this release of Citrix Virtual Apps and Desktops 7. Although you might be able to select an unsupported host, we recommend that you do not.


    If you install or upgrade a site or VDAs on an unsupported host to version 2003 or later, your deployment becomes unsupported. VDAs in an unsupported deployment cannot register with a Delivery Controller. Unregistered VDAs cannot deliver apps and desktops to users.

  • Do not prepare master images, create (provision) machines, or create connections on the unsupported hosts. When provisioning machines, this applies whether you use Citrix or third-party tools.
  • Use (or create and then use) master images and connections to hosts that are supported in the release you’re upgrading to.
  • Create machine catalogs that use master images on a supported host. Machines (VDAs) in a catalog must reside on a supported host.
  • Ensure that your Delivery Groups (and Application Groups, if used) contain machines from a catalog for a supported host.

For more information, see CTX 270373.

Upgrade: Effects of changes in supported SQL Server versions

Changes in supported database versions can affect Citrix upgrades.

  • Site databases: SQL Server 2008 R2, 2012, and 2014 are no longer supported for the site database. (This includes the monitor and configuration logging databases.)
  • Local host cache database: SQL Server version 2014 is no longer supported for the local host cache database.

You might need to upgrade your SQL Server version before you can upgrade your Citrix components. For details, see SQL Server version check.

Install and upgrade: Personal vDisk install and upgrade no longer allowed

The Personal vDisk (PvD) component can no longer be installed or upgraded.

  • PvD no longer appears in the VDA installers’ graphical interface.
  • From the command line, including the /baseimage option causes the command to fail.
  • The installation media no longer contains the PvD software.

Citrix recommends using the user personalization layer feature.

Install and upgrade: Windows Server 2012 R2 no longer supported for Controllers, Studio, Director, VDAs, and Universal Print Server

You can no longer install or upgrade Delivery Controllers, Studio, Director, VDAs, or the Universal Print Server on Windows Server 2012 R2 machines. See System requirements for supported OS versions.

Install and upgrade: Changes in how to install and upgrade StoreFront

In earlier releases, when you clicked the Get Started tile in the full-product installer’s main page, the Core Components page included StoreFront. You could select StoreFront and other core components to install on the same machine.

As of this release, the Core Components page no longer contains a StoreFront check box. To install or upgrade StoreFront, click Citrix StoreFront in the Extend Deployment panel on the main page. This launches CitrixStoreFront-x64.exe from the installation media.

In the XenDesktopServerSetup.exe command, you can no longer specify /components storefront. If you do, the command fails. To install StoreFront from the command line, run CitrixStoreFront-x64.exe, which is available in the Citrix Virtual Apps and Desktops installation media’s x64 folder.

Install and upgrade: 32-bit Studio installer no longer available on installation media

The Citrix Virtual Apps and Desktops installation media no longer contains the 32-bit Studio installer. See System requirements for supported OSs.

Install and upgrade: Change in required .NET version

For components with a Microsoft .NET Framework prerequisite, .NET version 4.8 is now installed automatically if it (or a later version) is not already installed. This is a newer .NET version than in previous releases. System requirements indicates which components have this prerequisite.

Install and upgrade: Self-Service Password Reset deprecated

The Self-Service Password Reset component is deprecated.

Citrix Scout data masking

The Citrix Scout data masking feature allows you to mask sensitive data in diagnostics files before uploading them to Citrix. For more information, see Data masking.

Virtual Delivery Agents (VDAs) 2003

Version 2003 of the Windows VDA for Multi-session OS and the VDA for Single-session OS includes the following enhancements (in addition to the VDA installation and upgrade items listed previously in this article).


Editing the registry incorrectly can cause serious problems that might require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.

MTU Discovery

The Citrix protocol Enlightened Data Transport (EDT) now has MTU Discovery capabilities. MTU Discovery allows EDT to automatically determine and set the payload size for the session. This feature enables the ICA session to adjust to networks with non-standard Maximum Transmission Unit (MTU) or Maximum Segment Size (MSS) requirements. The ability to adjust avoids packet fragmentation that might result in degraded performance or failure to establish an ICA session. This update requires a minimum of Citrix Workspace app 1911 for Windows. If using Citrix Gateway, the minimum Citrix ADC firmware version required is or For more information, see EDT MTU Discovery.

Enhanced browser content redirection routing using new proxy configuration options

We have added other configuration options for the proxy settings on the VDA. You can choose from these options:

  • Direct or transparent – Routes browser content redirection traffic through the VDA and forwards it directly to the web server hosting the content.
  • Explicit proxy (was previously included) – Routes browser content redirection traffic through the VDA and forwards it to the specified web proxy.
  • PAC files – Routes browser content redirection traffic through the VDA and forwards it to the web proxy determined by evaluating the specified PAC file.

For more information, see Browser content redirection proxy setting.

Enhanced Build to lossless

Build to lossless is enhanced with automatic image detection. Previously, Build to lossless assumed a lossy-first approach. In that approach, all moving imagery is encoded using H.264 (or H.265) and then is progressively sharpened to lossless when movement ceases. Sometimes staying lossless is preferable. The new automatic image detection feature performs some light image analysis on each frame. This feature determines whether to send the frame lossless; thus, skipping the lossy-first step.

To revert to lossy-first, set this registry key on the VDA:


Name: BTLLossyThreshold


Data: 0

Multi-Stream virtual channel stream assignment

In previous releases, you used a registry setting to change the virtual channel assignment when using multi-stream ICA. This release includes policy settings for assigning virtual channels. For more information see, Multi-Stream virtual channel assignment settings.

Enhanced support for electron-based apps in multi-session OS VDA

We now support electron-based apps. Electron is an open-source framework for developing desktop GUI applications. For example, Microsoft Teams and Slack.

Wait for printers to be created before an application starts

The wait for printers to be created feature is now available for Citrix Virtual Apps. Using a PowerShell cmdlet running on a Delivery Controller, you can specify that all printers be created before the app is started. For more information, see Wait for printers to be created.

Drag and then drop files between a Citrix session and a local endpoint (for evaluation only)

Dragging and then dropping files between a Citrix session and a local endpoint is available for evaluation. You can drag and then drop files, groups of files, directories, groups of directories, or a combination of files and directories to and from the same client on the session. This ability applies to a desktop session or a seamless app. This includes the desktop, Explorer window, and some applications. This feature does not support all apps. For example, you can drag a file out of a compressed (zipped) folder, but not into one.


The feature requires a minimum of Citrix Workspace app 2002 for Windows. This feature is included for customer evaluation only and is disabled by default.

Some known limitations:

  • You cannot drag a file from a client desktop into a Firefox or Internet Explorer browser window inside a desktop session.
  • You cannot drag and then drop into a zipped folder, into an application shortcut, a message from a seamless application to a client desktop, or into a seamless Outlook message if dragged quickly from a client.

To enable drag-and-drop, make the following registry setting on the host:


Name: Enabled


Value: non-zero

After you enable the registry value, and if using the required Citrix Workspace app version, drag-and-drop is enabled after the next session logon.

Loss tolerant mode


The feature requires a minimum of Citrix Workspace app 2002 for Windows. This version of the VDA will support it when it becomes available.

Loss tolerant mode uses a new transport protocol to enhance the user experience in challenging network conditions. For more information, see Loss tolerant mode

Citrix Licensing 11.16.3

Citrix Licensing 11.16.3 contains new features and fixed and known issues.

Citrix Federated Authentication Service 2003

Citrix Federated Authentication Service (FAS) 2003 contains new features.

For documentation about related components, see:

More information

  • Be sure to check Deprecation for any changes to announcement and removal versions.
  • For information about product name and version number changes that were introduced in the year 2018, see New names and numbers.
Citrix Virtual Apps and Desktops 7 2003