Successfully Migrating Your

XenApp 6.5 Farm to XenApp 7.6

Kevin Rowell - XenApp and XenDesktop Escalation Engineer

Citrix Synergy 2015 Orlando, Florida

2015 Citrix

Benefits of attending this session

Best Practices for a successful migration

PowerShell and migration scripts
Upgrading XenApp 6.5 Hosts

2015 Citrix | Confidential

Best Practices, Planning and Preparation

A Healthy DataStore
Migration Scripts
What is Migrated?

2015 Citrix

A Healthy Datastore
IMAHelper Tool

Invalid Server
Entries
Empty Zones

2015 Citrix

Invalid Server Entries

2014-09-18 08:34:18:093 Exporting application Outlook 2013"

2014-09-18 08:34:18:125 Cannot find server with id 596b-000c-000064b3
(0x80000007 Entry not found.)
2014-09-18 08:34:18:140 Exporting applications aborted

2015 Citrix

Invalid Zones
2014-09-18 09:07:24:326 Exporting worker group AREA_NONPROD_REL"
2014-09-18 09:07:24:357 48 worker groups exported
2014-09-18 09:07:24:357 Exporting zones
2014-09-18 09:07:41:002 Error getting data collector for zone AAZONE
(0x802D0006)
2014-09-18 09:07:41:002 Exporting zones aborted, you may consider to use the
-IgnoreZones switch to work around this problem

2015 Citrix

2014 Citrix. Confidential.

Migration Script Concepts and Steps

Policies
Export XenApp 6.x (IMA)
XenApp
Import Farm
XenApp
(XAFarm)
7.6 (FMA)

2015 Citrix

The Export Script Modules

2015 Citrix

Important Files Created by the Export

2015 Citrix

The XenApp Import Script Modules

2015 Citrix

Powershell Essentials

2015 Citrix | Confidential

PowerShell Prerequisites
The Export Scripts MUST be run on a XenApp 6.5
controller
The Import Scripts MUST be run a XA7.6 controller
Run As Administrator when launching PowerShell

2015 Citrix

(DDC)

Setting Up Your PowerShell Environment

Do NOT load the XenApp SDK Snap-in:

Asnp Citrix.*

Set-ExecutionPolicy Unrestricted

2015 Citrix

Execution Mode Warning

The default action is to NOT run. Be Aware

2015 Citrix

Exporting Data
Getting the Data Out of XenApp 6.x

2015 Citrix | Confidential

Setting Up PowerShell

Set-ExecutionPolicy
Unrestricted, AllSigned & RemoteSigned

2015 Citrix

Using the Import-Module Command

Import-Module PowerShell Command

2015 Citrix

Basic Export Policy Command

Export-Policy -XmlOutputFile policy.xml -LogFile exportpol.log

Get-Help Export-Policy -Full

2015 Citrix

Policy Export Help

2015 Citrix

Basic XAFarm Command Syntax

Export-XAFarm -XmlOutputFile xafarm.xml -LogFile exportxaf.log

2015 Citrix

XAFarm Export Help

Get-Help Export-XAFarm -Full

2015 Citrix

Export Commands XAFarm Filters

2015 Citrix

Export Examples
From the XenApp 6.x Datastore

2015 Citrix | Confidential

Basic Policy Export

Export-Policy XmlOutputFile policy.xml Logfile exportpol.log

2015 Citrix

Basic Export of Farm Data

Export-XAFarm XmlOutputFile xafarm.xml LogFile xafarm.log

2015 Citrix

Working Around Export Errors

Export-XAFarm XmlOutputFile xafarm.xml

LogFile exportxaf.log IgnoreZones

2015 Citrix

Importing Data
To the Newly created XA 7.6 Site

2015 Citrix | Confidential

Replaced Technologies
Published Desktops
Published Content
Streamed Apps
Application Servers
Pre-Launch Apps
2015 Citrix

Administrators

Planning Your Computer Policy Import

Health Monitoring

Memory Optimization

Load Evaluators

Prompt for Password

For a Comprehensive
list Reboot
visit
Citrix
eDocs
License
Information policies
Schedules
UNFILTERED
are
Never
imported.
Limit Sessions

2015 Citrix

Virtual IP

Planning Your User Policy Export

Auto connect ports

Linger timers

Only
policies
created
in
AppCenter
are
COM and LPT ports
Shadowing
imported.
For a printer
Comprehensive
list Pre-launch
visit Citrix eDocs
Client
names
Concurrent logon limit

2015 Citrix

Single Sign-On

Policy Filter Special Considerations

Access Control

Client IP Address

Worker
Citrix CloudBridge
Group

Client Name
Organizational unit

2015 Citrix

Getting Ready to Import

Step 1: Install XenApp 7.6 DDC

Step 2: Configure a basic site
2015 Citrix

The Important Files

Step 3: Copy Exported

2015 Citrix

Copy Files to XA7.6 DDC

Step 4: Run Import Script

2015 Citrix

Setting Up the PowerShell Environment

Import-Module .\ImportXAFarm.psd1
The default action.\ImportPolicy.psd1
is to NOT run. Be Aware
Import-Module

2015 Citrix

Policy Import Example

Import-Policy XmlInputFile .\policy.xml LogFile importpol.log

2015 Citrix

Planning The Import

Dont overcomplicate the import.

2015 Citrix

Import Examples

Import-XAFarm -XmlInputFile .\xafarm.xml

-LogFile importxaf.log
-MatchWorkerGroup "Adobe"
-DeliveryGroupName "Adobe"
2015 Citrix

Match Worker Group to Delivery Group

2015 Citrix

Match Worker Group to Delivery Group

2015 Citrix

Using the MatchAccount Switch

Import-XAFarm -XmlInputFile xafarm.xml

-LogFile importxaf_hr.log -DeliveryGroupName HR"
-MatchAccount HR
2015 Citrix

One to One Account Match

2015 Citrix

One to One Account Match

2015 Citrix

Many to One Account Match

Import-XAFarm -XmlInputFile xafarm.xml

-LogFile importxaf_Sales-Marketing.log
-MatchAccount "(Sales|Marketing)
-DeliveryGroupName "Sales-Marketing"
2015 Citrix

Many to One Account Match

2015 Citrix

Many to One Account Match

2015 Citrix

Many to One Account Match

2015 Citrix

One to One Folder Match

Import-XAFarm -XmlInputFile xafarm.xml

-LogFile importxaf_folder.log
-DeliveryGroupName "TestFolder"
-MatchFolder "Test,Folder
2015 Citrix

One to One Folder Match

2015 Citrix

One to One Folder Match

2015 Citrix

Many to One Folder Match

Import-XAFarm -XmlInputFile xafarm.xml

-LogFile importxaf_MultiFolder.log
-DeliveryGroupName "Admins"
-MatchFolder "Applications/(Admins/Citrix|Admins/MS Tools)"

2015 Citrix

Many to OneFolder Match

2015 Citrix

Many to One Folder Match

2015 Citrix

Using the -MatchServer Switch

Import-XAFarm -XmlInputFile xafarm.xml -LogFile importxaf_server.log
-DeliveryGroupName ServerXA4" -MatchServer FTL-MIG-XA4"

Import-XAFarm -XmlInputFile xafarm.xml -LogFile importxaf_multiserver.log

-DeliveryGroupName ServerGroupB" -MatchServer (FTL-MIG-XA2|FTL-MIG-XA4)"

2015 Citrix

Upgrading XenApp 6.5 Hosts

2015 Citrix | Confidential

In-Place Upgrade Recommendations and Prerequisites

Backup your XenApp 6.5 server host before upgrade!!!!!

To upgrade XenApp 6.0 server, first

Session-mode only XA 6.5 servers
update to XA6.5 Session-mode only
are valid for in-place upgrades
host.

2015 Citrix

Session-Host Only!!

2015 Citrix

In-Place Upgrade Known Issue

Log files can be found in the following folder:
"%TEMP%\Citrix\XenDesktop Installation\XenApp 6.5 Uninstall Log Files\"
"Error 25703. An error occurred while plugging XML into Internet Information
Server. Setup cannot copy files to your IIS Scripts directory. Please make sure that
your IIS installation is correct."
Cause: The issue occurs on systems where (1) during the initial XenApp 6.5
installation, you indicated that the Citrix XML Service (CtxHttp.exe) should not
share a port with IIS, and (2) .NET Framework 3.5.1 is installed.

2015 Citrix

Resolution
Remove the Web Server (IIS) role using the Windows Remove Server
Roles wizard. (You can reinstall the Web Server (IIS) role later.)
Restart the server.
Using Add/Remove Programs, uninstall the following:
Citrix XenApp 6.5
Microsoft Visual C++ 2005 Redistributable (x64), version 8.0.56336
Restart the server.
Run the XenApp 7.6 installer to install the VDA for Windows Server OS.

2015 Citrix

Automate the process with Project Serenity

2015 Citrix | Confidential

 2015 Citrix

 2015 Citrix

Find Out More

Citrix Life Cycle Management Agent
www.citrix.com/xenapp/upgrade
Demo
and Questions? Visit the Workspace
Experience Booth in the Expo Hall

2015 Citrix

Summary

2015 Citrix | Confidential

Common PowerShell Mistakes

NOT setting the execution policy for PoSH
NOT importing the Migration scripts (Import-Module)
NOT copying the generated XML files and icon folder to the target
DDC
NOT specifying a Delivery Group on import
this will dump all farm settings into a single Delivery Group.

2015 Citrix

In-Place Upgrade Hurdles

NOT taking snapshots or backups
Session-mode Only XenApp Hosts
Possible In-Place Upgrade Failures
2015 Citrix

3 Key Takeaways
Understand PowerShell Basics
Understand the Scripts
Plan and Test

2015 Citrix

Resources
Links and Documents

2015 Citrix | Confidential

Resources
My Blog: Migrating Made Easy

Product Documentation (eDocs)

Project Serenity

Session-Only Hosts

IMA Helper Tool

DSCHECK

2015 Citrix

?
?
2015 Citrix

?
?

?
?

Questions?

?
?

Before you leave

Conference Surveys are available online at www.citrixsynergy.com starting
Thursday, May 14 at 9:00 a.m.
Those who provide feedback by 6pm, Friday, May 15th will receive:
$20 Amazon e-gift card
Name entered in a drawing for a free Trip to Synergy 2016 (5 chances)

Download presentations starting Monday May, 18th from the My Event Planning tool

2015 Citrix

Work better. Live better.

2015 Citrix