Citrix Virtual Apps and Desktops

Upgrade a XenApp 6.5 worker to a new VDA

August 29, 2022

Contributed by:

C L

After you migrate a XenApp 6.5 farm, you can use your XenApp 6.5 servers that were configured in session-host only mode (also called session-only or worker servers) by removing the earlier software, upgrading the OS, and then installing a new VDA for Server OS.

Although you can upgrade a XenApp 6.5 worker server, installing the current VDA software on a clean machine provides better security.

To upgrade a XenApp 6.5 worker to a new VDA:

Remove Hotfix Rollup Pack 7 for XenApp 6.5, using the instructions in the hotfix readme. See CTX202095.
Uninstall XenApp 6.5. This process requires several restarts. If an error occurs during the uninstallation, check the uninstall error log referenced in the error message. That log file resides in the folder “%TEMP%\Citrix\XenDesktop Installation\XenApp 6.5 Uninstall Log Files\.”
Upgrade the server’s operating system to a supported version. See the VDA for Server OS section in System requirements. for a list of supported platforms.
Install a VDA for Server OS, using an installer provided with this release. See Install VDAs or Install using the command line.

After you install the new VDA, from Studio in the new XenApp Site, create machine catalogs (or edit existing catalogs) for the upgraded workers.

Troubleshoot

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:

Remove the Web Server (IIS) role using the Windows Remove Server Roles wizard. (You can reinstall the Web Server (IIS) role later.)
Restart the server.
Using Add/Remove Programs, uninstall Citrix XenApp 6.5 and Microsoft Visual C++ 2005 Redistributable (x64), version 8.0.56336.
Restart the server.
Install the VDA for Server OS.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Upgrade a XenApp 6.5 worker to a new VDA

August 29, 2022

Contributed by:

C L

August 29, 2022

Contributed by:

C L

Upgrade a XenApp 6.5 worker to a new VDA

Troubleshoot

In this article