Product Documentation

Automated XenApp migrations

Prerequisites

Before you perform an automated XenApp migration, ensure you have met all the requirements in this section.

XenApp 7.x deployment

You must have a working XenApp 7.x deployment available to receive the migrated settings from your XenApp 6.x farm. If you don’t already have a XenApp 7.x deployment, you can create one using the XenApp and XenDesktop blueprints available in Smart Tools. For more information about using these blueprints, see the following topics:

XenApp 6.5 PowerShell SDK

All XenApp 7.x Controllers must have the XenApp 6.5 PowerShell SDK installed. Smart Tools requires the Citrix Common Commands snap-in in the SDK to run the scripts that will migrate your farm’s application and policy settings to your XenApp 7.x Site. If you intend to migrate to XenApp 7.13, you will need to install the SDK manually; the XenApp 7.13 installer does not include it. Previous XenApp versions include the SDK as part of the XenApp installation.

Smart Tools Agent

All XenApp 6.x and 7.x controllers have the Smart Tools Agent installed. The Smart Tools Agent collects the farm data needed to migrate and import your farm policy data to XenApp 7.x. Without the agent installed, Smart Tools cannot locate these servers in your network environment. If you deployed XenApp 7.x using a Smart Tools blueprint, the Smart Tools Agent is already installed on each machine in the deployment. For instructions on installing the agent, see Install or remove the Smart Tools Agent.

When you install the agent, you will need to supply administrator credentials so Smart Tools can access your farm and Site. The credentials you provide must meet the following requirements:

  • The account belongs to the Domain Admins group in Active Directory.
  • The account has the Full Administrator role in Studio.
  • Credentials are entered in domain\username format.

PowerShell execution policy

All XenApp 6.x and 7.x controllers have the PowerShell execution policy set to RemoteSigned. The migration process involves running PowerShell scripts and all XenApp servers must have permission to run them. Before migrating, verify the execution policy on each server by running Get-ExecutionPolicy in the PowerShell console.

Migration task overview

  1. Connect your XenApp 6.x and 7.x controllers to Smart Tools.
  2. Smart Tools analyzes the XenApp 6.x configuration XML files. Afterward, you select the application and policy settings that you wish to migrate.
  3. Migrate the selected applications and policies.

For instructions for performing an automated XenApp migration, see Migrate XenApp 6.x by connecting with Smart Tools.

Automated XenApp migrations