migration xendesktop 7. © 2013 citrix | confidential – do not distribute migration prerequisites...

MigrationXenDesktop 7

© 2013 Citrix | Confidential – Do Not Distribute

Migration prerequisites

• Set up a XenDesktop 7 Site, including the site database

• Understanding of which data can be exported and imported


Migrate XenDesktop 4 to XenDesktop 7

• Migration tool consists of two componentsᵒ XdExport

• XdSettings.xmlᵒ XdImport

• Both deployments must have the same:ᵒ Hypervisor version (for example, XenServer 6.1)ᵒ Active Directory environment


Migration parametersImport

Parameter Description

-FilePath <path> Location of XML file to which data is imported.

-AdminAddress The name of a controller in the XenDesktop site.Default = localhost

-HypervisorConnectionCredentials A PowerShell hash table that maps hypervisor addresses

-MergeDesktops Desktops in XML file are added to desktop groups in the new XenDesktop site – must have same name


Migration parameters(cont…)Import


-Verbose Provides messages with detailed progress info

-Overwrite Overwrites existing files in the location specified

-? or -help Outputs text describing parameters and exits without exporting any data

-SkipMachinePolicy Script does not create a machine policy to hold site level settings


Migration parameters (cont…)Import


-WhatIf A trial run is carried out to find what would be changed in or added to the new XenDesktop site.

-LogFilePath <path> The full path of the log file


Known limitations

• Configuration data excluded from migration

ᵒ VM Hosted Appsᵒ PVS server configurationᵒ License server configurationᵒ Netscaler & Access Gateway configurationᵒ Web interface configurationᵒ DDC Listᵒ Configuration Logging dataᵒ Desktop Foldersᵒ Active Directory OU setup


Additional limitations

• Configuration items not migrated (are exported but not imported)ᵒ Administratorsᵒ Delegated Administration settingsᵒ Desktop Group foldersᵒ Licensing configurationᵒ Registry keys


Migration process

• Make sure that all users log off the existing XenDesktop 4 Farm

• Make sure that all these machines are in maintenance mode

• Run the export tool (XdExport) on the existing XenDesktop 4 Farm

• Launch PoSH from XD 7 Controller

• Run XDImport tool (using path to xml file)

• Remove Delivery Groups from maintenance mode


Post Migration tasks

• Upgrade XD 4 VDAsᵒ Not required…but recommendedᵒ Windows Vista and Windows XP

• upgrade to XenDesktop 5. 6 Feature Pack 1 ᵒ Windows 7

• upgrade to XenDesktop 7

• Manually recreate Administrator settings

• Update user devices


Post Migration tasks (cont…)

• Modify imported desktops to use registry-based controller discoveryᵒ AD default for XenDesktop 4ᵒ Remove OU GUID registry entryᵒ Add a ListOfDDCs registry entryᵒ Set machine policy for list of Controllers

• Use GPMC

• See CTX133384

http://support.citrix.com/article/CTX133384


Migrate – XenApp customers

• Migration will not be available for existing XenApp customers until the Merlin release of Avalon

UpgradeXenDesktop 7


Required upgrade components

• VDAs for Desktop OS Machines (Windows desktop) that upgrade to XenDesktop 7 Virtual Delivery Agents

• Delivery Controllers

• License Server and licenses

• Existing Database

*Note: Make sure you back up your database before performing any upgrade procedures


Upgrade sequence

• Citrix recommends that you upgrade components in the following sequence1. License server and license files2. Provisioning services (PVS) servers and

PVS clients3. VDA software for your desktops and

images4. One half of the existing Controllers5. Desktop Studio if installed separately from

the Controller6. Database7. Remaining Controllers


Upgrading componentsVDAs

• Supported VDA versions to XenDesktop 7 ᵒ 5.0 Service Pack 1ᵒ 5.5ᵒ 5.6ᵒ 5.6 Feature Pack 1 (including remote PC access VDAs)

• Installer upgrades all agents and existing MSIs (Windows installer packages) on existing VDAᵒ Previous VDA releases only upgraded VDAs through installerᵒ You cannot upgrade to XenDesktop 7 using MSIs


Upgrading componentsDirector and Site database

• You can upgrade the following Director versionsᵒ 1.0ᵒ 1.1ᵒ 2.0ᵒ 2.1

• Upgrade Site database from a XenDesktop 7 Controller using Studioᵒ Updates the schema and migrates data ᵒ Studio performs additional data migration steps for the services


Upgrading componentsPersonal vDisk and Receiver

• The installer also upgradesᵒ Personal vDisk (PVD)ᵒ Receiver

• Receiver for Windows (Receiver.exe) is upgraded to Receiver for Windows 4.0.

• Receiver for Windows Enterprise (CitrixReceiverEnterprise.exe) is upgraded to Receiver for Windows Enterprise 3.4.


Components requiring separate upgrade

• Provisioning Services (PVS)ᵒ Upgrade the PVS server using the PVS server rolling upgradeᵒ Upgrade the PVS client using PVS vDisk versioning


Run Desktop Studio

Upgrade DB

Manually?

Upgrade site now?

IncompleteNo Yes

No

Display Errors

ErrorComplete

Site Upgrades…

AdminUpgrades ½

of DDCs

DisplayNext Steps

AdminUpgrades remaining

DDCs

FinishManualUpgrade

Success

DB Script GenerationQuestions

Yes

DBA runs DB scripts…

Generate Script and Mark Site as Pending Upgrade

Later… Later…

Done

Start High-Level Studio Upgrade Flowchart

Upgrading via StudioUseCase


Site DB Upgrade (Studio)Prior to upgrade…

DDC-A DDC-B DDC-C

SQL Server

XD_DB1

DDC-D


Site DB Upgrade (Studio)Upgrade ½ Delivery Controllers

DDC-A DDC-B

SQL Server

XD_DB1

DDC-C(down)

DDC-D(down)


Site DB Upgrade (Studio)Studio verifies License Server

DDC-A DDC-B DDC-C(down)

SQL Server

XD_DB1

DDC-D(down)

Excalibur Studio

License Server


Site DB Upgrade (Studio)Studio backs up old database


SQL Server

XD_DB1

DDC-D(down)

ExcaliburStudio

Backup


Site DB Upgrade (Studio)Studio restores database


SQL Server

XD_DB1

DDC-D(down)

ExcaliburStudio

Backup XD_DB2


Site DB Upgrade (Studio)Studio queries upgrade data from remote DB


SQL Server

XD_DB1

DDC-D(down)

ExcaliburStudio

Backup XD_DB2


Site DB Upgrade (Studio)Studio updates the second database


SQL Server

XD_DB1

DDC-D(down)

Excalibur Studio

Backup XD_DB2


Site DB Upgrade (Studio)Studio tests the schema is correct before moving site


SQL Server

XD_DB1

DDC-D(down)

ExcaliburStudio

Backup XD_DB2


Site DB Upgrade (Studio)Studio sets all DB connection strings to new DB

DDC-A(down)

DDC-B(down)

DDC-C(up)

SQL Server

XD_DB1

DDC-D(up)

ExcaliburDesktop Studio

Backup XD_DB2


Site DB Upgrade (Studio)Studio runs upgrade success verification tests

DDC-A(down)

DDC-B(down)

DDC-C(up)

SQL Server

XD_DB1

DDC-D(up)

ExcaliburStudio

Backup XD_DB2


Site DB Upgrade (Studio)Is the site working properly?

Failure

Success

Work better. Live better.

migration xendesktop 7. © 2013 citrix | confidential – do not distribute migration prerequisites...

Documents