Prepare to migrate your XenApp 6.x deployment

 Contents

Overview

The Smart Migrate service helps you reduce the amount of work required to migrate your XenApp 6.x farm to a new XenApp 7.x Site. With Smart Migrate, Smart Tools exports your existing farm policies and settings and imports them into your new XenApp and XenDesktop 7.x Site. This topic describes the limitations and prerequisites for migration. 

You can migrate your XenApp 6.x farm using the following methods:

  • Automated migration: Connect your XenApp 6.x and 7.x controllers to Smart Tools and perform the migration.
  • Manual migration: Run migration scripts on your XenApp controllers and upload the farm policies and settings to Smart Tools for migration.

Preparation resources

Before starting the migration, refer to the PrepareBuild, and Integrate sections of the XenApp Migration and Upgrade guide on the Citrix web site. This guide provides additional resources to help you prepare your XenApp 6.x deployment for migration. 

Additionally, review the Migrate XenApp 6.x topic on the Citrix Product Documentation web site. This topic provides in-depth information about the application and policy settings that will and will not be migrated. See the "Limitations" section of the topic.

Migration limitations

  • Smart Migrate supports migrating to XenApp 7.x, up to Version 7.13. 
  • Not all policy settings are migrated. For example, unfiltered policy settings and obsolete policy settings from XenApp 6.x are not migrated. Settings that are no longer supported are ignored and recorded in the migration log file. For a list of settings that are not migrated, see the "Policy settings not imported" section of the Migrate XenApp 6.x topic.
  • Many application properties are not imported because of differences between the XenApp 6.x Independent Management Architecture (IMA) and the XenApp 7.6 FlexCast Management Architecture (FMA) technologies. For a list of supported properties, see the "Application property mapping" section of the Migrate XenApp 6.x topic.
  • Printer user assignments are not migrated.
  • Only server-installed applications are migrated to the XenApp 7.x Site. Published desktops, content, and most streamed applications are not supported.
  • Only Citrix policy settings created with the AppCenter management console are imported; Citrix policy settings created with Windows Group Policy Objects (GPOs) are not imported.
  • Nested folders greater than five levels deep are not supported by Studio and will not be imported. If your application folder structure includes folders more than five levels deep, consider reducing the number of nested folder levels before importing.
  • As part of a manual migration, you will create XML files containing your farm's application and policy settings and upload them to Smart Tools for analysis. Be aware that Smart Tools accepts uploaded files up to 100 MB only. 

Back to top

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

Back to top

Manual XenApp migrations

Prerequisites

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

XenApp 7.x deployment in a supported resource location

You can deploy XenApp and XenDesktop 7.x to your resource location using your own deployment process or you can use 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 have the XenApp 6.5 PowerShell SDK installed. The Citrix Common Commands snap-in in the SDK is required so you can 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, as it's not included in the XenApp installer. Previous XenApp versions include the SDK as part of the XenApp installation. 

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. Download and execute the PowerShell scripts on the XenApp 6.5 controller and upload the resulting configuration XML files to Smart Tools.
  2. Smart Tools analyzes the XenApp 6.x configuration XML files. Afterward, you select the application and policy settings you wish to migrate.
  3. Migrate the selected applications and policies. Download and execute the automatically-generated PowerShell scripts on the XenApp 7.x controller.

For instruction for performing a manual XenApp migration, see Migrate XenApp 6.x manually with Smart Tools

Back to top

0 Comments