- What's new in Smart Tools
- Known issues
- About Citrix Cloud and Citrix Smart Tools
- Technical Security Overview for Citrix Smart Tools
- Open source attribution
- System Requirements
- Get Started
- Smart Tools Agent
- About blueprints and the Blueprint Designer
- About blueprint steps
- About scripts
- Add a new script
- Use named parameters in scripts
- Reference attachments in scripts
- Create a blueprint
- Provision VMs for your blueprint with the Server step
- Use Amazon EC2 APIs in your blueprint with the EC2 Generic Step
- Add conditional actions to your blueprint with the Conditional step
- Add server volumes to your blueprint with the Mount Volume step
- Register or unregister DNS subdomains
- Chain blueprint step outputs and inputs
- Create references to scripts and blueprints
- View and modify blueprints and scripts
- Publish a blueprint
- Clone a blueprint
- Share a blueprint or script
- About Smart Check
- About health checks
- Add a Site to Smart Check
- Discover a Site in Smart Check
- Perform health checks for your XenApp and XenDesktop Site
- Use custom checks and alerts with Smart Check
- View reports from health checks
- Manage Smart Check alerts and notifications
- Upload Site diagnostics to Citrix Technical Support
- View or modify a Site in Smart Check
- JSON format objects reference
- Smart Scale
- Smart Migrate
- Resource Locations
- Prepare Windows Server VM templates for deploying blueprints
- About the Checks and Blueprints catalog and Library
- About deployment profiles
- About the Pre-deployment Checklist
- Deploy a blueprint using existing machines
- Deploy a blueprint to a Citrix XenServer resource location
- Set static IP addresses for XenServer VM templates
- Deploy a blueprint to a Citrix CloudPlatform resource location
- Deploy a blueprint to a VMware vSphere resource location
- Set a static IP address for OVA files using VMware vSphere
- Deploy a blueprint to a Microsoft Hyper-V Server resource location
- Hyper-V VM prerequisite configurations
- Deploy a blueprint to Microsoft Azure Classic resource location
- Deploy a blueprint to an Amazon Web Services resource location
- Preparing Windows-based custom AMIs for Smart Tools
- Rerun a blueprint step during a deployment error
- Pause or cancel a deployment
- Deploy a script
Deploy Citrix Solutions Blueprints
- Deploy Citrix Solutions blueprints using existing machines
- Create a XenApp and XenDesktop production deployment on Microsoft Azure Classic
- Create a XenApp and XenDesktop production deployment on AWS
- Create a XenApp and XenDesktop production deployment with Provisioning Services on Citrix XenServer and VMware vSphere
- Deploy the Simple XenApp and XenDesktop Proof of Concept blueprint on Microsoft Azure Classic
- Deploy the Simple XenApp and XenDesktop Proof of Concept blueprint to AWS
- Deploy the XenApp and XenDesktop Proof of Concept blueprint on Citrix XenServer
- Deploy the XenApp and XenDesktop Proof of Concept blueprint on Microsoft Azure Classic
- Deploy the XenApp and XenDesktop Proof of Concept blueprint with NetScaler to AWS
- Deploy XenApp with the Secure Browser Service
- Deploy the XenMobile Enterprise or Advanced Edition blueprint
- Deploy the XenMobile MDM Edition blueprint
Deploy Resource Locations for Citrix Cloud
- Deploy the XenApp and XenDesktop Resource Location Setup blueprint on Citrix XenServer
- Deploy the XenApp and XenDesktop Resource Location Setup blueprint on Microsoft Azure Classic
- Deploy the XenApp and XenDesktop Resource Location Setup blueprint on AWS
- Deploy the XenApp and XenDesktop Resource Location Setup blueprint with an existing domain on AWS
- Manage Deployments
- Accounts and users
- REST API
- Troubleshoot agent connectivity issues
- Troubleshoot agent download and installation issues
- Troubleshoot blueprint creation issues
- Troubleshoot blueprint deployment issues
- Troubleshoot Site onboarding issues
- Troubleshoot removing Sites from Smart Tools
- Troubleshoot Smart Scale events
- Troubleshoot XenApp 6.x farm migration issues
Migrate XenApp 6.x by connecting with Smart Tools
This topic describes migrating a XenApp 6.x deployment to an existing XenApp 7.x deployment that you specify. To do this, Smart Tools connects to your XenApp 6.x farm, collects farm data, allows you to select the applications and policies, and migrate them to your XenApp 7.x Site.
Important: Before performing a migration, review the migration prerequisites described in Automated XenApp migrations and and the migration limitations described in Prepare to migrate your XenApp 6.x deployment. Additionally, review the Migrate XenApp 6.x topic on the Citrix Product Documentation web site for in-depth information about the application and policy settings that will and will not be migrated. See the “Limitations” section of the topic.
- Log on to the Citrix Smart Tools web site. The home page appears.
- From the menu bar, click Smart Migrate and then click Add Migration Project. The Add Migration Project wizard appears.
- Enter a friendly name and, optionally, a description for your project.
- In Migration Type, select XenApp 6.0 to XenApp 7.x or XenApp 6.5 to XenApp 7.x, depending on the XenApp version you want to migrate.
- Click Add. The project page for your migration appears.
- On the migration project page, the Fully Automated option is selected by default. Scroll down and click Next.
In the XenApp 7.x deployment details section, choose one of the following options:
- Skip this for now. You can define XenApp 7.x deployment details while selecting applications and policies for migration.
- Connect to an existing deployment created outside of Smart Tools. You can select an existing XenApp 7.x deployment that you created with your own processes.
- Choose an existing deployment created with Smart Tools. If there are no XenApp 7.x deployments available, you can create a new deployment using a XenApp and XenDesktop blueprint in Smart Tools. Click How do I create a new deployment for an overview. For instructions, see Create a XenApp and XenDesktop production environment with Provisioning Services on Citrix XenServer and VMware vSphere topic.
If Connect an existing deployment created outside of Smart Tools is selected, perform the following actions:
- In Add XenApp 7.x environment, click Select environment and then select All Existing Machines.
- In Select XenApp 7.x controller, click Select XenApp Controller and then select a Delivery Controller in your XenApp 7.x Site. If there is no Delivery Controller in the drop-down list, select Cannot see Controller Server.
- Click Download to download the Smart Tools Agent.
- Install Citrix Smart Tools Agent.
- Click Refresh to refresh the drop-down list. The XenApp 7.x Controller appears in the drop-down list.
- Select the Controller.
- Supply the domain administrator credentials for the Delivery Controller and then click Save. Proceed to Step 5 (Add your XenApp 6.x farm and analyze settings).
If Choose an existing deployment created with Smart Tools is selected, perform the following actions:
- Choose the XenApp 7.x deployment from the drop-down list.
- Click on Select the XenApp 7.x Controller. The XenApp Controller details page appears.
- Select the XenApp Controller from the drop-down list and provide the user name and password credentials. Click Save.
Add your XenApp 6.x farm and analyze settings:
- In Add XenApp 6.x environment, click Select environment and then select All Existing Machines.
- In Select XenApp 6.x Controller, click Select XenApp Controller and then select a controller from your XenApp 6.x deployment.
- Supply the domain administrator credentials for the controller and then click Save.
- Click Analyze XenApp farm. Smart Tools collects application and policy data from the farm and adds the data to an XML file. After the analysis is finished, Smart Tools displays the number of applications, policies, and servers in the farm.
- Click Next. Smart Tools displays the analyzed applications and policies.
If you chose Option 1 (Skip this for now) in the previous section, then you have to provide the XenApp 7.x deployment details before proceeding with the following steps.
- Under Migration Details, click the Analyzed Applications category and select the applications you want to migrate.
- Click the Analyzed Policies category and select the policies you want to migrate.
- Click Proceed to Migration. Smart Tools prompts you to create a batch for the items you selected and choose a Delivery Group.
- Enter a name for the batch. By default, the batch name is automatically generated; however, you can change this to a different name.
The Delivery Group displays the following options in the drop-down list:
- Use default Delivery Group: The applications and policies are migrated to the default Delivery Group.
- List of Delivery Group available: Choose from the listed Delivery Group.
- Cannot see an existing Delivery Group? Refresh list: This refreshes the list and fetches the latest list of the Delivery Group from the 7.x controller.
- Create new Delivery Group: Use this option to create a new Delivery Group.
- Review the list of selected items. If you want to remove any items, point to the item and click Remove.
- When you are ready to migrate your selected applications and policies, click Migrate.
During the migration process, Smart Tools creates a Delivery Group in the XenApp 7.x site and imports the selected application and policy settings from XenApp 6.x.
To verify migration was successful, launch Citrix Studio and connect to the site. In the left pane, click Delivery Groups. In the top middle pane, the Delivery Groups tab displays the new Delivery Group. In the lower middle pane, the Applications tab displays the migrated applications in the new Delivery Group.