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
Network COM+ Access is easily added from Add/Remove Programs in Server 2003 or through the Server Manager in Server 2008/2008 R2 under the Application Server role.The tool will work fine pulling XenApp data from servers that connect indirectly to the data store (such as Access and SQL Express). There is no need to specify the server hosting the database in such environments.
XenApp Migration ApplicationXenApp Migration Application is a .NET WPF application that gathers data from the user and users PowerShell to invoke XenApp Migration Commands for all migration operations. XenApp Migration CommandsXenApp Migration Commands is a set of cmdlets and scripts packaged as a PowerShell 2.0 module. XenApp PowerShell ImporterXenApp PowerShell Importer is part of XenApp Migration Commands. It handles importing a configuration using XenApp Commands. XenApp MFCOM ExporterXenApp MFCOM Exporter is part of XenApp Migration Commands. It handles exporting a remote configuration using MFCOM. This component is used when migrating configurations from XenApp 5.0. XenApp XACOM ExporterXenApp XACOM Exporter is part of XenApp Migration Commands. It handles exporting a remote configuration using XACOM. This component is used when migrating configurations from XenApp 6.0 and 6.5. XenApp CommandsXenApp Commands is a set of cmdlets packaged as a PowerShell snap-in. The snap-in is automatically installed as part of the main XenApp install. MFCOM ServerMFCOM Server is the server-side component of MFCOM. It runs on XenApp 5.0. XACOM ServerXACOM Server is the server-side component of XACOM. It runs on XenApp 6.0 and 6.5.
The Zone Preference and Failover Policy for XenApp 5 will convert to a Load Balancing Policy using Worker Group Preference in XenApp 6.5
For more information on zones and load evaluator migration details, refer to eDocs.
Order of the post-migration steps does not matter.
The initial launch of the Citrix AppCenter (formerly the Delivery Services Console) presents a dialog informing the user that no applications are available in the environment and a migration tool is available. Users will continue to see the message until one or more applications are published.Both 32-bit and 64-bit versions of the PowerShell snap-ins are provided. This is primarily for consistency reasons with the PowerShell platform. Cmdlets will be available in both versions. The recommendation is to stick with the 64-bit version.
Refer to the previous slide on the requirements/pre-reqs when installing the tool on OSes other than 2008 R2.
3. If the properties of a published application, policy, or other setting changes in the source farm, re-running the tool will allow the changes to update in the XenApp 6.5 farm. This may lead to undesirable changes being made. Administrators might want to manually specify specific settings to migrate on subsequent migrations instead of migrating all settings.
2. Use the /clean switch to fix any errors
The following slides outline a direct migration with the GUI tool.
Worker group mappings are only configured for XenApp 5 source farms.
Servers map to worker groups in a one-to-one fashion. The tool will prompt you if you try to use the same server or worker group twice.
A similar error message will be presented if using PowerShell to perform the migration.
Migrating from Presentation Server 4.5 to XenApp 5.0: http://support.citrix.com/servlet/KbServlet/download/17904-102-671543/Technical%20Guide%20for%20Upgrading%20or%20Migrating%20to%20XenApp%205%2010-23.pdf
At Citrix Services - we’re Citrix consultants, teachers and support engineers and we’re all about one thing: making sure you succeed.With our help, you’ll deploy high-performance, robust virtualization and networking projects, faster – with dramatically lower risk and higher return.The best Citrix architects and administrators are the ones who never stop learning – and Citrix Education is here to help you learn those skills.Citrix Consulting gives you direct access to our most experienced virtualization and networking experts.When it’s complex; when it’s mission-critical; when it’s big; That’s when Citrix consultants can really help.On your virtualization journey, you’ll want always-on support from people who really care about your success.There’s no better insurance for your Citrix investment than with Citrix Support.
Agenda• Overview• Requirements and Architecture• Tool Specifics• Installation and Pre-migration Tasks• Performing Migrations• Best Practices and Troubleshooting• Resources/Q+A Citrix Confidential - Do Not Distribute
XA 4.5 Migration Steps• Step 1 – Upgrade/Migrate to 5.0 • Follow this whitepaper for detailed steps • Technical Guide for Upgrading or Migrating to 5.0• Step 2 – Upgrade/Migrate to 6.5 • Then follow the steps in this whitepaper • Technical Guide for Upgrading or Migrating to 6.5 Citrix Confidential - Do Not Distribute
Problem statement• No direct upgrade to XenApp 6.5 from previous versions • All servers must be installed in a new farm with Windows Server 2008 R2 and the XenApp install media • Mixed farms are not supported• No way to efficiently migrate settings between farms of the same version Citrix Confidential - Do Not Distribute
Tool highlights• Allows admins to migrate settings from one farm to another • An updated version to the original tool for XenApp 6 that now includes a GUI (It is still based on PowerShell)• Provides two options for migrating settings • Direct (default/recommended): Exports settings in one step from the source farm to the XenApp 6.5 farm provided there is an available network connection and the same administrator account is valid in both environments. • Indirect: Settings are exported to XML files from the source farm and later imported into the XenApp 6.5 farm• Enables supported settings to be migrated or allows administrators to select which specific settings to migrate Citrix Confidential - Do Not Distribute
Tool requirements• A source farm containing the desired settings • XenApp 5 on Windows Server 2003 w/HRP05 • XenApp 5 on Windows Server 2008 • XenApp 6 on Windows Server 2008 R2 • XenApp 6.5 on Windows Server 2008 R2• A XenApp 6.5 destination farm• A Citrix Administrator Account • Full admin permissions in the destination farm and a minimum of view- only in the source farm (An account that is full admin in both farms is recommended) Citrix Confidential - Do Not Distribute
Required OS permissions• A domain admin account is recommended • Local admins and power users will work though• DCOM group access is needed in the source farm• Write access needed to working directory • C:Users<username>AppDataLocalCitrixCitrix.XenApp.Migration (The folder on the XenApp 6.5 server where data and logs reside) Citrix Confidential - Do Not Distribute
Microsoft pre-reqs for source servers• Network COM+ is needed if performing a direct migration• The following pre-reqs are required if doing an indirect migration (e.g. running the tool on the source server to export the data) • .NET Framework 3.5 SP1 • MSI 3.0 • PowerShell Citrix Confidential - Do Not Distribute
What can we migrate with all XA versions?• The following items may be migrated with any supported version of XenApp used for the source farm • Applications • Application and server folders • Load evaluators attached to apps (only attached to servers when source farm is XenApp 6.x) • Policies (IMA/Farm policies only and not GPO policies in Active Directory) • Server settings • Farm settings • Farm administrators • HMR tests (Any custom test executables will need to be copied over) • Session printers (Printer paths will not be validated, see zones) Citrix Confidential - Do Not Distribute
Settings and data that will not migrate• Printer drivers and related settings • Drivers, driver replication settings, and driver mappings• Configuration Logging • This is a historical log of administrative changes performed in the legacy farm so there is no reason to migrate this information• Server registry settings • Seamless flags and other registry settings will not come over• Zones • This is related to the structure of a farm which is not practical to migrate Citrix Confidential - Do Not Distribute
Post-migration steps• Attaching load evaluators to servers• Associating application folders with published applications• Associating servers or OUs with worker groups• Assigning server objects to folders• Assigning zones• Configuring printer settings• Setup Configuration Logging within the new farm• Copying Health Monitoring and Recovery test executables to new farm Citrix Confidential - Do Not Distribute
Working directory• C:Users<username>AppDataLocalCitrixCitrix.XenApp.Migration • Data – XML files containing the data for each object type • Logs – XML and text log files of the migration processes • UILogs – Logs from the Migration Center • MigrationOptions.xml – Configuration settings (Delete to start fresh) Citrix Confidential - Do Not Distribute
Installation on XenApp 6.5• The Migration Center is installed with the product Citrix Confidential - Do Not Distribute
Installation with earlier XenApp versions• For indirect migrations (exporting settings to be later imported into the new farm)• The tool needs to be installed from the media • AdministrationDelivery Services ConsolesetupCitrix.XenApp.Migration.Install_x64.msi • AdministrationDelivery Services ConsolesetupCitrix.XenApp.Migration.Install_x86.msi• Note that the Migration Center GUI application can only be used from the target XenApp 6.5 server • The PowerShell cmdlets must be used on the source server when performing an indirect migration Citrix Confidential - Do Not Distribute
Things to keep in mind• Direct modifications to the data store • The tool should ideally be run during a maintenance window with no users connected to the XenApp 6.5 farm. As always, data store backups are essential!• Published application paths • Application paths will be transferred over exactly as specified in the source farm. If the path specified in the source farm does not exist for the installed applications in the XenApp 6.5 farm, the applications will not launch. This is especially true for 32-bit XenApp 5 servers and their applications being migrated to 64-bit XenApp 6.5. • The -X86ApplicationList PowerShell switch may be used to force a x86 path• Tool may be run multiple times as needed • Changes to previously migrated settings will be reflected Citrix Confidential - Do Not Distribute
Before starting the migration• Update any configured FTAs • If the source farm uses file type associations for published applications, ensure they are updated by running the “Update file types from registry” option in the Delivery Services Console (AppCenter for XenApp 6.5)• Run DSCheck on the source farm with appropriate switches to ensure consistency • DSCheck /full apps • DSCheck /full groups • DSCheck /full servers • DSCheck /full folders • DSCheck /full printers Citrix Confidential - Do Not Distribute
Best practices• Migrate after hours and/or in phases • Reading and writing large amounts of farm data (and generating potentially excessive network traffic) is best done with no users connected to either farm• Migrate in a 1:1 fashion • A one-to-one mapping with the farms is the only supported use of the tool. That is, while you can technically do it, it is not supported or recommended to migrate settings from multiple source farms into a single destination XenApp 6.5 farm Citrix Confidential - Do Not Distribute
Troubleshooting the migration• Once the migration process is started, it will typically only fail on one or more objects/sections (it’s not a boolean process where it either all works or all fails)• Running DSCheck after the migration (especially when troubleshooting) is a good idea Citrix Confidential - Do Not Distribute
Common issues• XenApp is not installed or the installation is corrupt, MFCOM is not running, a DCOM permissions issue is present, a firewall misconfiguration, etc. Citrix Confidential - Do Not Distribute
Resources• Migration Center Feature Spec • http://support.citrix.com/proddocs/topic/xenapp65-w2k8/ps-migrate-xa6- wrapper.html• Migration Center Demo Video on Citrix TV • http://www.citrix.com/tv/#videos/4475• Tech Guide for Migrating/Upgrading to XenApp 6.5 • http://support.citrix.com/servlet/KbServlet/download/28732-102- 671615/TechGuide%20Upgrading%20Migrating%20to%20XA6.5%201.0_126 6.pdf Citrix Confidential - Do Not Distribute
How long will a migration take?• On a test system with 10 published MS Office applications and basic settings 9 – 10 minutes• On a more complex, more mature XenApp Server timelines will vary depending on size and complexity, number of published apps etc.. Citrix Confidential - Do Not Distribute
About Educate | Guide | Support | SucceedCitrix ServicesCitrix Services make How we can helpsureyou succeed with your Citrix Education – The fastest, most efficient way tovirtualization get your team the virtualization skills they need.programs. Online, on-site or in class. citrix.com/training Citrix Consulting – Intensive engagements for complex, critical or just plain massive projects. citrix.com/consulting Citrix Support – Always-on support services that leverage everything we know about best-practice deployment and -maintenance. Citrix Confidential Do Not Distribute
ConsultingLet our experts help you speed up your migration processApplication readiness testing using AppDNAMigrate your most critical apps Fast track to 6.5 at a compelling price!
Education: 10% off Citrix Training PassesGet your people up to speed on XenApp 6.5 With 10% discount on Citrix Training PassesApplies to all XenApp 6.5 courses Basic and Advanced (self-paced or instructor-led) CCA and CCAA certifications Request your Training Pass discount here
Premier Support Calculator• 24x7x365 support• Unlimited number of cases and admin contacts• Remote support using GoToAssist Calculate the cost! Citrix Confidential - Do Not Distribute
Documentation• Whitepapers • Technical Guide for Upgrading/Migrating to XenApp 6.5 • Technical Guide for Upgrading/Migrating to XenApp 6 • Other Whitepapers KC Articles Nearly 300 technical articles on• Tools XenApp 6.5 • XenApp 6 Migration Tool eDocs • Citrix Auto Support Product Documentation • List of tools for XenApp 6.5 Citrix Confidential - Do Not Distribute