Upgrade XenApp 6.0 to XenApp 6.5 by Human beings

Note: this post was created by Anton van Pelt. Antos was a guest blogger on citrix-guru.com



Last week one of my customers asked me to upgrade his XenApp 6.0 farm to XenApp 6.5. Unfortunately there is no in-place upgrade possible so we have to create a workaround. Citrix provide us with a upgrade utility http://support.citrix.com/article/CTX130614 but this utility can only run if there is already a new XenApp 6.5 farm created. This tool even don’t migrate the farm resources.

Well, this blog explains how to ‘upgrade’ the first server and create the XenApp 6.5 farm and migrate the actual XenApp 6.0 settings as well by using the Citrix Xenapp Migration Center. So what if we are using Citrix Provisioning Services and only have one vDisk where all XenApp 6.0 farm members gets booted from? It’s easy create a new target device and make a copy of the running vDisk.

My goal is to prove it is not needed to start a server installation from scratch. Nevertheless if you have the possibility to build a server or vDisk from scratch in an automated and easy manner this is definitely the way to go! But I realize lots of people don’t use SCCM or MDT to deploy a complete XenApp server. And use there latest couple of vDisks as fallback and backup.

This is how we perform the Human upgrade:

    • First remove the server from the XenApp 6.0 farm via the Citrix Delivery Services Console
    • People who are not using Citrix Provisioning Services can skip this step! First make a copy of the latest vDisk. Import the vDisk and make it available in private mode
    • Fire up the server (target device)
    • Remove all applicable software in the following order:
      • Citrix EdgeSight for XenApp 6 Agent
      • Citrix XenApp 6.0
      • Citrix HDX MediaStream for Flash – Server
      • Citrix Common Commands
      • Citrix XenApp Commands
      • Citrix Group Policy Client-Side Extension
      • Citrix XenApp Server Configuration Tool
      • Citrix XenApp Server Role Manager
      • Citrix XenApp Management
      • Citrix Single Sign-On Console
      • Citrix XenApp Group Policy Management Experience
      • Citrix Single Sign-On Plug-in
      • Citrix XenApp Power and Capacity Management Agent
      • Citrix offline plug-in
      • Citrix Online Plug-in
      • Smart Auditor Agent
    • In case of a Provisioning Services Target Device, don’t remove the target device software, otherwise you’re lost! 😉
    • Reboot the server
    • Now it’s time to install the XenApp 6.5 software
    • Install all the XenApp Server roles you needed


    • After the installation is completed you can specify the licensing server. Normally this is configured by a XenApp Group Policy and should be migrated later on. For now choose the option “Configure the license server later using a policy” skip the warning. At the licensing model option choose “Select the model at a later time” and skip the warning again


    • After this licensing wizard the Farm configuration option should be available
    • Create the new XenApp 6.5 farm via the configuration wizard and specify all applicable settings
    • Reboot the server


    • Install the available hotfixes for XenApp 6.5 (depends on your needs)
    • Now it’s time to migrate settings from the active XenApp 6.0 farm to the brand new XenApp 6.5 farm (make sure the server is removed from the XenApp 6.0 farm before starting to migrate
    • The Citrix XenApp Migration Center make use of PowerShell so we need to verify if the Execution Policy is set to unrestricted. To verify start the PowerShell console and press “Get-ExecutionPolicy”. If Restricted is reported press “Set-ExecutionPolicy unrestricted”


    • Start the Citrix XenApp Migration Center. This tool is available by default at a XenApp 6.5 installation
    • First need to specify the Source Farm. This can be any server in the active XenApp 6.0 farm because session-only mode servers are only available in XenApp 6.5


    • When you are connected to the source farm hit the analyze button to retrieve all settings from the XenApp 6.0 farm


    • I encountered this weird error. So have to investigate before proceeding with the migration. One of the published applications (the last one) has the following configuration:


    • I was not able to remove those dummy servers from the application so have removed the whole published application and run the “analyze farms” again. Now the issue is gone and I’m able to start to migrate


  • When the migration completed all my resources from the XenApp 6.0 farm are available in the XenApp 6.5 farm


Before migrating all of your servers to the new XenApp 6.5 farm please make sure all the resources and applications are still functional. When you are ready to migrate the other XenApp 6.0 servers to the new farm make use of the upgrade utility: http://support.citrix.com/article/CTX130614. Or if you are using Citrix Provisioning Services reboot all target devices with the new XenApp 6.5 vDisk 🙂 . Yup Citrix Provisioning Services is that handy!


Happy migrating, Cheers!


You may also like...