Upgrade a XenApp 6.5 worker to a new VDA for Windows Server OS

May 28, 2016

When you run the LTSR installer on a XenApp 6.5 worker server, it:

  • Removes the server from the XenApp 6.5 farm (this task automatically invokes the XenApp 6.5 installer’s command-line interface)
  • Removes the XenApp 6.5 software
  • Installs a new (XenApp 7.6 or later supported release) VDA for Windows Server OS

When you use the installer’s graphical interface, you are guided through the same wizard that you used when installing VDAs for Windows Server OS in your new XenApp Site. Similarly, the command-line interface uses the same commands and parameters you use to install other VDAs.

You are probably already familiar with using the installer from installing your XenApp 7.6 core components and other VDAs. To review preparatory information, see VDA installation preparation. Then, launch the installer (Install using the graphical interface) or issue the command (Install a VDA using the command line) on the XenApp 6.5 worker server.

Good to know:

  • This upgrade is valid on XenApp 6.5 servers that are configured in session-host only mode (also called session-only or worker servers).
  • Uninstalling XenApp 6.5 requires several server restarts. When using the command-line interface, you can use the /NOREBOOT option to inhibit that automatic action; however, you must restart the server for the uninstallation and subsequent installation to proceed.
  • If an error occurs during the XenApp uninstallation process, check the uninstall error log referenced in the error message. Uninstall log files reside in the folder “%TEMP%\Citrix\XenDesktop Installation\XenApp 6.5 Uninstall Log Files\.”
  • After you upgrade the XenApp 6.5 worker servers, from Studio in the new XenApp Site, create Machine Catalogs (or edit existing catalogs) for the upgraded workers.
  • If you migrated policy and application settings from a XenApp 6.5 controller server (see Migrate XenApp 6.x), assign the Delivery Groups containing the migrated published applications to the machine catalog that hosted those applications in XenApp 6.5.


Symptoms: Removal of the XenApp 6.5 software fails. The uninstall log contains the message: “Error 25703. An error occurred while plugging XML into Internet Information Server. Setup cannot copy files to your IIS Scripts directory. Please make sure that your IIS installation is correct.”

  • Cause: The issue occurs on systems where (1) during the initial XenApp 6.5 installation, you indicated that the Citrix XML Service (CtxHttp.exe) should not share a port with IIS, and (2) .NET Framework 3.5.1 is installed.
  • Resolution:
    1. Remove the Web Server (IIS) role using the Windows Remove Server Roles wizard. (You can reinstall the Web Server (IIS) role later.)
    2. Restart the server.
    3. Using Add/Remove Programs, uninstall the following:
      1. Citrix XenApp 6.5
      2. Microsoft Visual C++ 2005 Redistributable (x64), version 8.0.56336
    4. Restart the server.
    5. Run the XenApp 7.6 installer to install the VDA for Windows Server OS.

Upgrade a XenApp 6.5 worker to a new VDA for Windows Server OS