Product Documentation

Migrate

Apr 03, 2015

The XenApp Migration Center pulls data from a server in a source XenApp server farm and imports (adds) it to a new XenApp server farm. The data is grouped as object types.

The following table lists the supported XenApp versions for the source farm and the new farm.
Source farm New Farm
XenApp 5 for Windows Server 2003 (with minimum HRP5) or XenApp 5 for Windows Server 2008 XenApp 6.5
XenApp 6.0 XenApp 6.5
XenApp 6.5 deployed in a test/pilot farm XenApp 6.5 deployed in a production farm

In all migrations, Citrix recommends you first use the XenApp 6.5 media to perform a clean install of the XenApp server role on one or more Microsoft Windows Server 2008 R2 or Microsoft Windows Server 2008 R2 SP1 servers. Then, use the XenApp Server Configuration Tool to create a new farm or join servers to that new farm. (Clean install means that there is no previous version of the XenApp server role installed on the server.)

If you cannot coordinate that recommended process, Citrix provides a XenApp 6.0 to 6.5 Upgrade Utility that you can customize for your servers; see CTX130614.

After you configure and restart the new XenApp server, use the Migration Center installed on that server to import objects from the source farm.

  • If you are migrating a XenApp 5 source farm, servers in that source farm are migrated to worker groups in the new farm according to server-to-worker-group mappings you specify before starting the migration. Servers in the mapping are representative servers chosen from each server silo in the XenApp 5 farm.
  • If you are migrating a XenApp 6.0 source farm or a XenApp 6.5 test/pilot source farm, worker groups already exist, so you do not need to set up server mappings before the migration.

You can preview (analyze) a migration; that is, the Migration Center indicates which objects will be imported during a migration, without actually performing the migration.

You can repeat the migration as additional servers in the source farm become ready for reimaging in the new farm. During subsequent migration previews, the Migration Center compares source farm objects with objects in the new farm, and lists differences. If you then migrate those objects, the current value in the new farm is overwritten with the current value in the source farm.

As the migration of more source farm servers continues, use the Web Interface user roaming feature to help ensure that users can access applications and resources.

Citrix recommends performing the entire migration from a server in the new XenApp farm; this is a direct migration. However, if your deployment does not allow this, you can perform an indirect migration. In this case, you split the migration process by installing and using the Migration Center on a server in the source farm to export settings. Then, using the Migration Center installed on a server in the new XenApp farm, you import the settings into the new farm.

Requirements and Installation

You can migrate a single XenApp farm.

Requirements for a XenApp 5 Source Farm

  • The servers in the XenApp 5 farm must be running XenApp 5 for Windows Server 2003 with at least Hotfix Rollup Pack 5 (HRP5), or XenApp 5 for Windows Server 2008.
  • The source server must have network COM+ access enabled, and the MFCOM service must be available.
  • To access the source server using a remote connection, you must be a member of the DCOM users group, and a Citrix administrator with at least view-only privileges.
  • When migrating from a 32-bit XenApp 5 farm, network printers used by policies (session printers) must have a 64-bit driver installed in the print server; otherwise, those printers will not be migrated.

Requirements for a XenApp 6.0 Source Farm or a XenApp 6.5 Test/Pilot Source Farm

  • The servers in the farm must be running XenApp 6.0 (in the XenApp 6.0 farm) or XenApp 6.5 (in the XenApp 6.5 test/pilot farm).
  • You must be a Citrix administrator with at least view-only privileges.
  • The XACOM service must be available.

Requirements for the New XenApp 6.5 Farm

  • The XenApp 6.5 server role must be installed and configured on the Microsoft Windows Server 2008 R2 or Microsoft Windows Server 2008 R2 SP1 server where you will use the Migration Center. The XenApp server must be configured with the XenApp controller server mode. (You cannot use the Migration Center on a XenApp 6.5 server configured with the XenApp session-only server mode.) Restart the server after configuration.
  • The IMA and XACOM services must be running.
  • You must be a Citrix administrator with full privileges.
  • You must have write access to the folder where the exported data from the source farm is placed before being imported into the new farm. This folder also contains the migrationoptions.xml file containing any migration options and property overrides you set through the Migration Center command-line interface, plus server mappings (when migrating a XenApp 5 farm). By default, this is a folder named Data, located under the XenApp Migration Center installation files in C:\Users\user\appdata\local\citrix\citrix.xenapp.migration). You can specify a different folder in the command-line interface with the Set-XAMigrationOption cmdlet.
  • By default, execution of PowerShell scripts is disabled. Set the PowerShell execution policy to AllSigned (Set-ExecutionPolicy AllSigned) or above.
  • The following software is required to run the Migration Center. This software is required for XenApp server installation and configuration, so it is likely to already be installed.
    • .NET Framework 3.5 SP1
    • MSI 3.0
    • PowerShell 2.0
  • If the source farm uses file type association for published applications, update the new farm with file type associations (using the Update file types from registry task in the Citrix AppCenter) before you migrate applications. This allows the migration process to create the associations in the new farm.
  • If you are migrating from a XenApp 5 farm, create worker groups in the new farm for server and application silos. (However, if a worker group you specify in a server mapping does not exist, the Migration Center creates it.)

Installing the Migration Center

The XenApp Migration Center is installed automatically when you install and configure the XenApp 6.5 server role.

If you need to re-install the Migration Center at a later date, use the installation file on the XenApp 6.5 media. In the Administration\Delivery Services Console\setup folder, double-click Citrix.XenApp.Migration.Install_x64.msi.

Note: Citrix recommends performing direct migrations, entirely from a server in the new farm. If your deployment does not allow this, see Indirect Migrations and Advanced Cmdlets for additional installation information about indirect migrations.