• Share
  • Email
  • Embed
  • Like
  • Save
  • Private Content
Spoxamigrate
 

Spoxamigrate

on

  • 446 views

 

Statistics

Views

Total Views
446
Views on SlideShare
446
Embed Views
0

Actions

Likes
0
Downloads
27
Comments
0

0 Embeds 0

No embeds

Accessibility

Categories

Upload Details

Uploaded via as Adobe PDF

Usage Rights

© All Rights Reserved

Report content

Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
  • Full Name Full Name Comment goes here.
    Are you sure you want to
    Your message goes here
    Processing…
Post Comment
Edit your comment

    Spoxamigrate Spoxamigrate Document Transcript

    • Citrix Virtual ClassroomCitrix XenApp 6.5 migration made easySelf-paced exercise guide
    • Page 2Citrix Virtual ClassroomTable of ContentsTable of Contents.............................................................................................................................................. 2Overview............................................................................................................................................................. 3Exercise 1: Prepare the Environment ............................................................................................................ 6Exercise 2: Direct Migration with the Migration Center...........................................................................12Exercise 3: Direct Migration with the PowerShell Interface ....................................................................21Exercise 4: Indirect Migration with the PowerShell Interface..................................................................28
    • Page 3Citrix Virtual ClassroomOverviewCitrix XenApp is an on-demand application delivery solution that enables any Windows® application tobe virtualized, centralized, and managed in the datacenter and instantly delivered as a service to usersanywhere on any device. In use by over 100 million users worldwide, XenApp delivers on the promise ofproven application compatibility. Once you’ve decided that the latest XenApp 6.5 version is the right fitfor your organization, it’s possible to migrate from a previous version of the product to maintain existingdata while providing a seamless transition for your users.In this lab, we will step through performing multiple migrations from a XenApp 5 environment to aXenApp 6.5 environment using the included migration components as well as the features of WebInterface. Various options (both GUI and PowerShell) are available depending on the organizationalrequirements. We’ll also see how it’s possible to segment users into distinct groups (Eg. Production andpilot) to help facilitate the migration strategy.Hands-on Training ModuleThis training module has the following details:Objective  Provide hands-on experience with migrating to XenApp 6.5 fromearlier versionsAudience  Primary: XenApp administrators and support staff
    • Page 4Citrix Virtual ClassroomLab Environment DetailsThis section is used to describe the lab environment and the virtual machines that are used.Machine DetailsAD.training.lab Windows Server 2008 R2SQLServer Windows Server 2008 R2 and SQL ServerXA1 XenApp 6.5 on Windows Server 2008 R2XA2 XenApp 6.5 on Windows Server 2008 R2XA51 XenApp 5 on Windows Server 2003XA52 XenApp 5 on Windows Server 2003Win7Client Windows 7 endpoint deviceNOTE: This is a shared lab environment image and not all virtual machines will be used.NOTE: If prompted with a dialog to restart on any virtual machine, always select Restart Later.Required Lab CredentialsBelow are the login credentials required to connect to the workshop system and complete the labexercises.Domain/Machine Username PasswordTraining Administrator Citrix123All local machines Administrator citrix
    • Page 5Citrix Virtual ClassroomHow to log into the lab environmentThe self-paced lab environment is hosted on a cloud-based Citrix XenServer. Connecting to your serverfrom the portal page is as easy as 1-2-3.Step-by-step login instructionsStep Action1. Once logged in to the self-paced portal, click the Start lab button to launch a connection topublished XenCenter.2. When XenCenter loads, right-click the XenCenter node and select Add…3. On the Add New Server screen enter the XenServer IP address provided on the portaland in the Password field enter the password provided on the portal. The user name willalways be root.
    • Exercise 1: Prepare the Environment Page 6Citrix Virtual ClassroomExercise 1: Prepare the EnvironmentOverviewIn this exercise we will prepare the infrastructure to allow users to connect to the new XenApp 6.5environment after the migration. We will create a group of pilot users, who will test this new server farm,while the other users will continue to connect to the existing production farm based on XenApp 5.Step-by-step guidanceFollow the steps below to complete the task.Estimated time to complete this lab: 20 minutes.Step Action1. Start by powering off the XD, VDA and SQLServer2 virtual machines and power on theXA51 and XA52 virtual machines. This is done by right-clicking the VMs in XenCenter.2. Log on to the AD.training.lab virtual machine with user trainingAdministrator andpassword Citrix123. (Click the VM in XenCenter and then click the Console tab.)3. Open Active Directory Users & Computers from the Desktop.4. Right-click the Users node and select New > Group5. Name the group Production and click OK
    • Exercise 1: Prepare the Environment Page 7Citrix Virtual ClassroomStep Action6. Double-click the new group and under the Members tab add in user User1 throughUser10. Then click OK.7. Refer to steps 4-6 and create another global security group called Pilot with user User11through User 15.8. Right-click the training.lab node and select New > Organizational Unit9. Name this OU Main and click OK10. Create a second OU also under training.lab called Backup11. Drag the computer account for XA1 under the Computers container to Main and XA2 toBackup. Click Yes on the dialog message.12. Minimize the console and open the Citrix Web Interface Management console from theDesktop.13. Select the XenApp Web Sites node on the left and then click Server Farms in the Actionspane on the right.
    • Exercise 1: Prepare the Environment Page 8Citrix Virtual ClassroomStep Action14. Click the Add button to add a new server farm to the existing site. Use the followingsettings and then click OK.Farm name: XenApp65Servers: XA1XML Service port: 8080
    • Exercise 1: Prepare the Environment Page 9Citrix Virtual ClassroomStep Action15. Move the XenApp65 farm name up in the list to ensure it’s the top entry. Then click OKon the Manage Server Farms dialog box.16. Browse to C:inetpubwwwrootCitrixXenAppconf in Windows Explorer17. Open the file WebInterface.conf with Notepad. Scroll all the way down until you see a linethat starts with Farm2. Select the whole line and cut it (CTRL-X). Scroll up until you seethe line that starts with Farm1. Create a new line underneath and paste the contents(CTRL-V).18. Remove the # in front of Farm1Groups. Replace domaingroup with trainingpilot. Createan empty line underneath and type:Farm2Groups=trainingproduction19. Your file should now contain a section like the following (more text will be after 443,):Save the file and close Notepad.20. Switch to the Win7Client virtual machine and log on as trainingadministrator withpassword Citrix123.21. Open Internet Explorer and browse to http://ad.training.lab. Wait a moment for theWeb Interface Site to load.
    • Exercise 1: Prepare the Environment Page 10Citrix Virtual ClassroomStep Action22. Log on with username User1 and password Citrix123. You should see the followingpublished resources for this user.NOTE: This user is in the Production Active Directory Group and connects to thecurrent XenApp 5 production farm per our Web Interface configuration.23. Log off from the Web Interface.24. Log back on to the Web Interface with username User11 and password Citrix123. Thisuser is a member of the Pilot Active Directory Group and logs on to the new XenApp 6.5farm. You should see Paint as the only published application.25. Log off from the Web Interface.END OF EXERCISESummaryKeyTakeawaysThe key takeaways for this exercise are: Users can be separated into distinct Active Directory groups for themigration process Web Interface allows user groups to target specific farms within the samesite
    • Exercise 1: Prepare the Environment Page 11Citrix Virtual ClassroomNOTES Troubleshooting points to consider for your own environment:o Farm1 needs to be XenApp 6.0 or latero If you use Farm#Group for one farm, you have to use it for every farmo Make sure the XML port specified is correct
    • Exercise 2: Direct Migration with the Migration Center Page 12Citrix Virtual ClassroomExercise 2: Direct Migration with the MigrationCenterOverviewIn this exercise we will perform a direct migration from XenApp 5 to XenApp 6.5 using the MigrationCenter GUI.Step-by-step guidanceFollow the steps below to complete the task.Estimated time to complete this lab: 15 minutes.Step Action1. Start by going to the XA51 virtual machine (XenApp 5) and logging in astrainingadministrator with password Citrix123.2. Go to Add or Remove Programs from the Control Panel3. Click Add/Remove Windows Components4. Double-click Application Server5. Ensure the “Enable network COM+ access” is checked. This is required in order for themigration components on XenApp 6.5 to remotely query the farm data.6. Close all open dialogs and windows on XA51
    • Exercise 2: Direct Migration with the Migration Center Page 13Citrix Virtual ClassroomStep Action7. Switch to the XA1 virtual machine (XenApp 6.5) and logon as trainingAdministratorwith password Citrix1238. We need to ensure that the PowerShell Execution Policy is set correctly on this server thatwe’ll be performing the migration from. Start by launching a new PowerShell instance fromthe Windows taskbar or through the Start Menu.9. Type Set-ExecutionPolicy AllSigned and press Enter. Type “Y” and pressEnter to accept the change.10. Close the PowerShell window11. Run the Citrix XenApp Migration Center from Start -> Administrative Tools -> Citrix-> XenApp Migration. The following dialog will be briefly displayed as the componentsinitialize.12. Enter XA51 as the server for the source farm and click Check
    • Exercise 2: Direct Migration with the Migration Center Page 14Citrix Virtual ClassroomStep Action13. The server farm information should be resolved. Click on OKNOTE: The version of our source server will show as XenApp 4.5 since XenApp 5 forWindows Server 2003 is essentially the same product as Presentation Server or XenApp 4.5for Windows Server 2003.14. Once in the main Migration Center interface, click on Worker group mappings…15. Click the Add button and enter XA51 for the Representative server name and Main for theWorker group name. Then click OK. Click Yes on the confirmation since the workergroup does not currently exist.16. Click the Add button again and enter XA52 for the Representative server name andBackup for the Worker group name. Then click on OK and Yes on the confirmation.
    • Exercise 2: Direct Migration with the Migration Center Page 15Citrix Virtual ClassroomStep Action17. Confirm that your mappings dialog looks like the following:NOTE: It is not required for all servers in a XenApp 5 source farm to be mapped to aworker group in the destination farm. A minimum of one mapping, however, does need tobe created.18. Click OK on the mappings dialog19. Click Analyze Farms and wait a moment for the process to complete
    • Exercise 2: Direct Migration with the Migration Center Page 16Citrix Virtual ClassroomStep Action20. When the Migration Center finishes analyzing the data in the source farm, click on Viewlog to see the information it contains. Close the log file when done viewing.21. Let’s begin the migration. Click on Migrate to Target Farm and wait for the process tocomplete.22. Click on View log to see the results of the migration. Close the log file when done viewing.23. Close the Migration Center24. Launch the Citrix AppCenter from the Desktop25. Expand all of the sub-nodes under XA65 and take a moment to browse the objects. Noticethe administrators, applications, load evaluators, policies, and worker groups.26. Right-click the Internet Explorer published application and select Application properties
    • Exercise 2: Direct Migration with the Migration Center Page 17Citrix Virtual ClassroomStep Action27. Click Location on the left and note that the standard “Program Files” path was importedfrom the source farm. Since this environment is 64-bit, let’s change the command line pathto “C:Program Files (x86)Internet Exploreriexplore.exe” and the working directory to“C:Program Files (x86)Internet Explorer” to run the 32-bit version of Internet Explorer.Then click OK.NOTE: At this point the administrator would need to perform the post-migration taskswhich include assigning load evaluators and placing objects into folders. The MigrationCenter itself can be run multiple times to bring in new settings or ones which may havechanged in the source environment.28. Switch to the XA51 server and launch the Delivery Services Console from the Desktop29. Expand the XA5PROD node and right-click on Administrators and select New > Addadministrator30. Click the Add button and then Add List of Names…31. Enter traininguser8 and click OK twice32. Click the Next button twice33. Select Full Administration and click Finish34. Launch the XenApp Advanced Configuration Console from the Desktop35. Click the Policies node and then double-click the Remote Users Policy36. Expand HDX Plug-n-Play > Client Resources > Audio and click on Turn off speakers37. Select the Enabled button and then click OK
    • Exercise 2: Direct Migration with the Migration Center Page 18Citrix Virtual ClassroomStep Action38. Switch back to the XA1 server and launch the Citrix XenApp Migration Centerapplication from the Start menu39. The application retains the previous settings so simply click Analyze Farms40. When the analysis completes, verify that the following results are shown. The administratorobject and policy configuration change was performed in the XenApp 5 source farm andthe application change for Internet Explorer was performed in the destination farm.41. Click Migrate to Target Farm to bring over the new data42. After the migration, switch to Citrix AppCenter or re-launch it from the Desktop43. Click the XenApp node and select Run discovery from the Actions pane on the right.Click OK if the confirmation dialog is displayed.44. Verify under the Administrators node that TRAININGuser8 is shown45. Right-click Internet Explorer and go to Application properties46. Click Location on the left and note that the path has reverted back to “Program Files”from “Program Files (x86)” that we had previously changed it to. This is because thesource farm settings will override the destination ones. Click OK.47. Click the Policies node and then the User tab
    • Exercise 2: Direct Migration with the Migration Center Page 19Citrix Virtual ClassroomStep Action48. Under the Remote Users policy, note that Client audio redirection is set to Prohibitedper the setting we configured in the source XenApp 5 farmEND OF EXERCISE
    • Exercise 2: Direct Migration with the Migration Center Page 20Citrix Virtual ClassroomSummaryKeyTakeawaysThe key takeaways for this exercise are: The Citrix XenApp Migration Center is an easy way to migrate farm settingsfrom XenApp 6.x or 5.0 to XenApp 6.5 The XenApp 6.5 farm needs to be able to communicate with the sourcefarm and a common administrative account must be used to perform a directmigration Migrations may be performed multiple times as needed and the source farmsettings will override conflicting ones in the destination farm
    • Exercise 3: Direct Migration with the PowerShell Interface Page 21Citrix Virtual ClassroomExercise 3: Direct Migration with thePowerShell InterfaceOverviewIn this exercise we will perform a direct migration from an earlier version of XenApp to XenApp 6.5 usingthe PowerShell interface. The PowerShell interface allows us to be selective with the settings we want tobring over and provides additional control over the migration process.Step-by-step guidanceFollow the steps below to complete the task. Note that PowerShell cmdlets are not case-sensitive but areshown capitalized for readability purposes. PowerShell accepts standard command prompt input andsupports autocomplete with the tab key as well.Estimated time to complete this lab: 15 minutes.Step Action1. Before we begin the steps for this next migration, we’ll need to start by deleting the currentdata in the XenApp 6.5 farm. A PowerShell script has been created to assist us with theprocess. From XA1, launch a new PowerShell session from the blue icon on the taskbar.2. Unlike the XenApp Migration components, this script is unsigned so the PowerShellExecution Policy needs to be set to the most permissive unrestricted level. TypeSet-ExecutionPolicy Unrestricted and press Enter. Type “Y” and pressEnter to confirm.3. Type CD and press Enter to go to the drive root
    • Exercise 3: Direct Migration with the PowerShell Interface Page 22Citrix Virtual ClassroomStep Action4. Type .ResetFarm.ps1 and press Enter. Wait a moment for the script to finishrunning.NOTE: It is normal for some red errors to show here as certain built-in objects cannot bedeleted. Feel free to inspect the contents of the script file at C:resetfarm.ps1 in Notepad.As an alternative to running this script file, we could have also manually deleted theseobjects from Citrix AppCenter or recreated the farm; however, use of this script is muchquicker and easier.5. Next we’ll want to delete the migration user profile data from the previous migration.These files contain the migration settings and options. On XA1, browse toC:Usersadministrator.trainingappdatalocalCitrixCitrix.XenApp.Migration viathe Windows Explorer address bar and delete the contents there.NOTE: The “appdata” folder is hidden by default so you’ll need to enter the path in theaddress bar or enable showing hidden folders.
    • Exercise 3: Direct Migration with the PowerShell Interface Page 23Citrix Virtual ClassroomStep Action6. Launch Windows PowerShell with Citrix XenApp Migration Module from Start ->Administrative Tools -> Citrix -> XenApp Migration. (Alternatively you can bring up astandard PowerShell prompt and run Import-ModuleCitrix.XenApp.Migration)7. As stated in the window, running Get-XAMigrationCommand will list all the cmdletsfor the migration component8. Type the following and press Enter:Set-XAMigrationOption –RemoteServerName XA51 –PassThruThis will configure the migration to pull all possible settings from the XA51 server and thefarm it belongs to. The –PassThru switch is a PowerShell option which outputs thechanges that have been made to the objects.NOTE: Network COM+ Access was previously enabled and verified on the XA51 server.This is a requirement when performing direct migrations (whether through the MigrationCenter or by using the PowerShell cmdlets).9. Let’s associate the XenApp 5 server to the worker group named “Main” by runningAdd-XAServerMapping XA51 main and confirming the output. (If the workergroup doesn’t exist, which is the case in our environment, it will be created for us.)10. Associate XA52 by running Add-XAServerMapping XA52 backup11. Let’s take a look at the examples of the cmdletSet-XAMigrationOption by running:Get-Help Set-XAMigrationOption –examples
    • Exercise 3: Direct Migration with the PowerShell Interface Page 24Citrix Virtual ClassroomStep Action12. We’ll start by explicitly disabling all objects for the migration since we only want to bringover specific ones this time. The following statement will accomplish this:Set-XAMigrationOption -ObjectType * -Enabled $false13. Next run Set-XAMigrationOption -ObjectType application-Enabled $true to enable the migration of published applications (it is possible to geteven more granular and selectively include or exclude specific applications).14. Run Set-XAMigrationOption -ObjectType policy -Enabled $trueto enable the migration of policies.15. Now let’s ensure that the Internet Explorer published application transfers over with thecorrect “Program Files (x86)” path this time. To do this, run:Set-XAMigrationOption –x86ApplicationList “InternetExplorer”16. Before we begin the migration, let’s run Start-XAMigration–PendingReportOnly to see the changes we are about to make before we commit.(The–pendingreportonly switch is preferred to PowerShell’s–WhatIf switch as it provides more details).
    • Exercise 3: Direct Migration with the PowerShell Interface Page 25Citrix Virtual ClassroomStep Action17. Type Start-XAMigration and press Enter to begin the migration process.18. When the process completes, switch to Citrix AppCenter or re-launch it from theDesktop.19. Click the XenApp node and select Run discovery from the Actions pane on the right.Click OK if the confirmation dialog is displayed.20. Click the Administrators node and notice that the only administrator shown isTRAININGadministrator since we did not import any administrators from the sourcefarm (only policies and applications were imported).21. Right click the Internet Explorer published application and select Application properties
    • Exercise 3: Direct Migration with the PowerShell Interface Page 26Citrix Virtual ClassroomStep Action22. Click Location on the left and notice the command line and working directory reflect“Program Files (x86)” since we used the –x86Application list option for this applicationduring the migration process. Click OK when done viewing.END OF EXERCISE
    • Exercise 3: Direct Migration with the PowerShell Interface Page 27Citrix Virtual ClassroomSummaryKeyTakeawaysThe key takeaways for this exercise are: The PowerShell interface provides more control over performing migrations There are specific required cmdlets that must be run and several otherswhich are optional when performing migrations
    • Page 28Citrix Virtual ClassroomExercise 4: Indirect Migration with thePowerShell InterfaceOverviewIn this exercise we will perform an indirect migration from XenApp 5 to XenApp 6.5 using the PowerShellinterface. This is required when there is no direct network path from the XenApp 6.5 farm to the sourcefarm and/or differences in administrative accounts.Step-by-step guidanceFollow the steps below to complete the taskEstimated time to complete this lab: 15 minutes.Step Action1. Start by navigating to C: on XA1, right-click on ResetFarm.ps1 and select Run withPowerShell2. Switch to the XA51 virtual machine and go to adsoftware in Windows Explorer.3. Run Citrix.XenApp.Migration.Install_x86.msi. The pre-requisite of PowerShell 2.0 hasalready been installed.
    • Page 29Citrix Virtual ClassroomStep Action4. Proceed through the setup and when it completes choose to Set the PowerShell executionpolicy to AllSigned before clicking Finish.5. Launch the Windows PowerShell with Citrix XenApp Migration Module from Start ->All Programs -> Citrix -> XenApp Migration6. Type “a” to Always run and press Enter7. Run Set-XAMigrationOption –RemoteServername XA51 –PassThru8. Run Set-XAMigrationOption –DataFolderPath c:migration to setthe local path for the export files9. Run Function Update-XAFileType {} which is required when performingindirect migrations since this function needs a definition on the XenApp 5 platform.
    • Page 30Citrix Virtual ClassroomStep Action10. Run Start-XAMigration –ExportOnly to export the farm data to XML files.11. In Windows Explorer, take a moment to browse and open the XML files at c:migrationto observe the contents.12. Switch to the XA1 virtual machine13. Copy the XML files from XA51C$migration toC:Usersadministrator.trainingAppDataLocalCitrixCitrix.XenApp.MigrationData(remember that the AppData path is hidden by default) and override any existing files ifthey exist14. Delete the MigrationOptions.XML file located atC:Usersadministrator.trainingAppDataLocalCitrixCitrix.XenApp.Migrationsince we want to start from scratch with default options. This is the safest way to ensure noprevious settings from earlier migrations will be transferred since this file contains themigration options such as which server to use, settings to include or exclude, etc. (but notthe settings themselves which are in the data directory)
    • Page 31Citrix Virtual ClassroomStep Action15. Switch to the open instance of Windows PowerShell with Citrix XenApp MigrationModule or re-launch one from Start -> Administrative Tools -> Citrix -> XenAppMigration. (Alternatively you can bring up a standard PowerShell prompt and runImport-Module Citrix.XenApp.Migration)16. Run Get-XAMigrationOption to confirm that all settings are enabled for themigration. (They should be by default as we deleted the MigrationOptions.XML file.Running this command recreates the file and sets the default options.)17. Run Add-XAServerMapping XA51 main18. Run Add-XAServerMapping XA52 backup19. Run Start-XAMigration –ImportOnly to begin the data import process. Wait abrief moment for it to complete.20. Switch to Citrix AppCenter or re-launch it from the Desktop.21. Click the XenApp node and select Run discovery from the Actions pane on the right.Click OK if the confirmation dialog is displayed.22. Observe that the farm data objects (applications, policies, etc.) have imported with thedefault options just as we saw before with the Citrix Migration Center (though this timethe migration was performed indirectly).23. IMPORTANT! This is the last exercise for this lab. Please go back to the Self-pacedLearning Lab site and do the following before you go: Provide us feedback by selecting the “Take web survey…” link. After completing the survey, click the “Logout” link towards the bottom right toclose out your lab session.END OF EXERCISE
    • Page 32Citrix Virtual ClassroomStep ActionKeyTakeawaysThe key takeaways for this exercise are: Indirect migrations may be performed when there is no direct connectionfrom the XenApp 6.5 farm to the source XenApp farm and/or administratoraccounts differ An indirect migration is a two-step process where the data is first exportedto XML files and then these files are copied to a XenApp 6.5 server to beimportedPlease complete this surveyWe value your feedback! Please take a moment to let us know about your self-pacedlab experience by completing a brief survey on the web portal before you logout.
    • Page 33Citrix Virtual ClassroomRevision HistoryRevision Change Description Updated By Date1.0 Original Version WW Technical Readiness October 2012About CitrixCitrix Systems, Inc. designs, develops and markets technology solutions that enable information technology (IT)services. The Enterprise division and the Online Services division constitute its two segments. Its revenues arederived from sales of Enterprise division products, which include its Desktop Solutions, Datacenter and CloudSolutions, Cloud-based Data Solutions and related technical services and from its Online Services divisions Webcollaboration, remote access and support services. It markets and licenses its products directly to enterprisecustomers, over the Web, and through systems integrators (Sis) in addition to indirectly through value-addedresellers (VARs), value-added distributors (VADs) and original equipment manufacturers (OEMs). In July 2012, theCompany acquired Bytemobile, provider of data and video optimization solutions for mobile network operators.http://www.citrix.com© 2012 Citrix Systems, Inc. All rights reserved.