Product Documentation

Migration examples

Nov 18, 2014

Example 1: Single large-scale XenDesktop 4 farm to a XenDesktop 7 Site

In this example, a XenDesktop 4 farm is in use. The XenDesktop 4 farm has 50 desktop groups, where each group contains an average 100 desktops. The XenDesktop 4 desktops are provided through Provisioning Services (PVS), and the machines are running on VMware ESX hypervisors. The VDA installed on all the VMs is the XenDesktop version 4.

Migration steps

  1. Upgrade all XenDesktop 4 VDAs to XenDesktop 5.6 Feature Pack 1 VDA software. This allows the VDAs to register with both the XenDesktop 4 controller and the XenDesktop 7 Delivery Controller.
  2. Make sure that all users log off the XenDesktop 4 farm.
  3. Make sure that all these machines are in maintenance mode.
  4. Run the export tool (XdExport) on the XenDesktop 4 farm.
  5. Install XenDesktop 7 components.
    1. Use Studio to create a full production mode Site.
    2. If Provisioning Services is part of the deployment, upgrade the Provisioning Services server and agents.
    3. Upgrade the License Server and associated licenses.
  6. Unzip the Import Tool (XdImport) to a local directory on the XenDesktop 7 Controller.
  7. Copy the XML file (XdSettings.xml) generated in Step 4 by the export tool to the local directory.
  8. From the PowerShell console of the Studio root node on the XenDesktop 7 Site, start a PowerShell session.
  9. Run the import tool (XdImport), passing the credentials of the associated hypervisors and the path of the XML file.
  10. Manually recreate administrator settings from the Administrator node in the Studio navigation pane; see Delegated Administration for details.
  11. Modify the imported desktops to use registry-based Controller discovery; and point them to the new XenDesktop 7 Controller.
  12. For VDAs running on Windows 7, Citrix recommends you upgrade those VDAs to use the XenDesktop 7 VDA for Windows Desktop OS, which provides access to all new features.

    After upgrading the VDAs to XenDesktop 7 for machines in a catalog or Delivery Group, upgrade the catalog (see Manage machine catalogs) and Delivery Groups (see Manage settings in Delivery Groups).

  13. Turn off maintenance mode for the Delivery Groups.
  14. Configure StoreFront to provide the desktops formerly provided through Web Interface. See the StoreFront documentation.

Example 2: XenDesktop 4 farm export with a partial import to XenDesktop 7.1 Site

In this example, the migration occurs in a number of steps, each step migrating a subset of the remaining desktops. A XenDesktop 4 farm is in use, and a XenDesktop 7.1 Site has already been created and is in use. The XenDesktop 4 farm has 50 desktop groups, and each group contains an average 100 desktops. The XenDesktop 4 desktops are provided through Provisioning Services, and the machines are running on Citrix XenServer hypervisors. The VDA installed on all the VMs is the XenDesktop version 4.

Migration steps
  1. Run the export tool on the XenDesktop 4 farm.
    1. Unzip the Export Tool (XdExport) on one of the Desktop Delivery Controllers in the farm.
    2. As a Citrix Administrator, run the export tool with no parameters.
  2. Copy and edit the resulting XML file so that it contains only the groups and desktops that you want to migrate.
  3. In the XenDesktop 4 farm, make sure that all users on desktops to be migrated have logged off and turn on maintenance mode for all desktops that are to be migrated.
  4. Unzip the Import Tool (XdImport) to a local directory on the XenDesktop 7.1 Delivery Controller.
  5. Copy the edited XML to the local directory.
  6. From the PowerShell console of the Studio root node on the XenDesktop 7.1 Site, start a PowerShell session.
  7. Run the Import Tool (XdImport), passing the credentials of the associated hypervisors and the path of the XML file.
  8. Manually recreate Administrator settingsf rom the Administrator node in the Studio navigation pane; see Delegated Administration for details.
  9. Modify the imported desktops to use registry-based Controller discovery; and point them to the new XenDesktop 7.1 Controller.
  10. Upgrade all VDAs to the appropriate VDA software:
  11. Turn off maintenance mode for the Delivery Groups.
  12. Configure StoreFront to provide the desktops formerly provided through Web Interface. See the StoreFront documentation.