- 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
Deploy a blueprint to a Citrix XenServer resource location
This topic describes how to deploy a blueprint using an Citrix XenServer resource location that you have added to Smart Tools (as described in Add a Citrix XenServer resource location).
If you want to use XenServer as a resource location, but don’t want to supply the credentials needed to add it to Smart Tools, you can deploy blueprints using existing VMs that you provision. To do this, see Deploy a blueprint using existing machines.
Before you deploy blueprints to your XenServer resource location, you must first prepare a machine template. Smart Tools uses the template to create new VMs with the same configuration. For more information about preparing a template for use with Smart Tools blueprints, see Prepare Windows Server VM templates for deploying blueprints.
- On the Library page, point to the blueprint you want to deploy.
- Under Actions, click Actions > Deploy. The blueprint description page appears.
- Click Start deployment setup. The Enter Profile page appears.
- In Deployment Name, enter a friendly name for your deployment.
In Deployment profile, select an existing deployment profile with the deployment settings you want to use.
Note: Deployment profiles are settings that are saved from a previous blueprint deployment. The deployment profile you select must match the blueprint you are deploying and the resource location you want to use. You cannot use a deployment profile that was created using a different blueprint or a different resource location. For more information, see About deployment profiles.
- Click Next. The Resource Location page appears.
In Resource Location, select the Citrix XenServer resource location where you want to deploy the blueprint. If the resource location you want to use does not exist, click Add Resource Location and follow the steps described in Add a Citrix XenServer resource location.
Note: If you intend to deploy the blueprint using existing AWS instances, select All Existing Machines.
Click Next. The Pre-deployment Checklist appears.
The Pre-deployment Checklist displays recommendations for provisioned VMs, VM template requirements, and deployment parameters for your blueprint based on the resource location you previously selected. To save time configuring your deployment, you can download the deployment parameters, enter the appropriate values, and import the updated parameters later in the deployment process (see section Step 6: Enter deployment parameters in this topic).
- Review each section of the Pre-deployment Checklist to verify your VM templates and resource location meet the stated requirements.
- (Optional) Click Export parameter list to download the deployment parameters in CSV format. Enter the appropriate values using a text editor or spreadsheet application. You can import these parameters on the Configuration page of the deployment process.
- Click Continue. The Size page appears.
When you deploy the blueprint, Smart Tools can provision new VMs in your resource location or use existing machines that you specify for each machine tier in the blueprint. By default, the Create new VMs option is selected.
Important: If you want to use existing machines, the machines must have the Smart Tools Agent installed; otherwise, Smart Tools cannot locate them in your resource location. For more information about using existing machines to deploy blueprints, see Deploy a blueprint using existing machines.
To create new VMs during deployment
- Ensure Create new VMs is selected.
- Select the Citrix XenServer resource location from the list. The Configure VM dialog box appears.
On the Parameters page, configure the following settings and then click Next:
- Create Server Method: Choose a server creation method. To create a server using a prepared machine image, select Create from template. To create a server using an XVA file, select Import from XVA.
- VM Name: Enter a name for the provisioned machine. Example: MyVM
- Place VM in Host: If the XenServer resource location includes a resource pool, select the XenServer host where the provisioned machines will reside.
- Launch Template: Select the prepared machine image you want to use to provision the machine.
- Number of vCPU: Enter the appropriate number of vCPUs for the provisioned machine.
- Topology: Select the appropriate number of cores per socket for the provisioned machine.
- Memory Size: Enter the amount of memory in MB with which to provision the machine.
- On the Storage page, select a virtual disk for the provisioned machine and then click Next. To add a new virtual disk, click Add Disk.
On the Networking page, configure the following settings and then click Next:
- MAC Address: You can set a MAC address or auto-generate a MAC address for a selected network interface card (NIC). By default, Auto generate MAC address is selected for the primary NIC. To add multiple NICs, click Add NIC. To set the MAC address, point to the NIC you want to modify and then click Set MAC. Enter a MAC address in the field provided.
- Set Static IP: Select this option to configure the IP address, subnet mask, and gateway addresses for the provisioned machine. For more information, see Set static IP addresses for XenServer VM templates.
- On the Agent page, ensure the Install Citrix Smart Tools Agent on new VMs is selected and enter the local Administrator credentials for the VM template that will be used to provision the machine. Click Next.
- On the Summary page, review the configuration and click Finish. The Configure VM dialog box closes, returning you to the Size page.
- Click Next. The Configuration page appears.
To use existing machines
- Select Use existing machines.
- Select a machine from the list. After you select a machine, Smart Tools displays the IP address.
- Click Next. The Configuration page appears.
- For each section of the blueprint, enter the appropriate parameters that Smart Tools will use to deploy the blueprint.
- (Optional) If you downloaded the deployment parameters from the Pre-deployment Checklist in Step 4: Review the deployment requirements, under Import parameters, click Choose File to upload the updated parameters in CSV format.
- Click Next.
Deployment profiles enable you to reuse your current deployment settings in the event you want to deploy the blueprint again to the same resource location. Using a deployment profile, you skip several steps in the deployment process, saving time and minimizing input errors. Creating a deployment profile is optional.
- Enter a friendly name for the profile.
- (Optional) Enter a description.
- Click Save. If you do not want to create a profile, click Cancel.
- Review the deployment summary.
- Click Deploy.
After the deployment begins, Smart Tools displays the status of the deployment in the Deployment Details page. The Deployment Details page includes the real-time progress of each step in your blueprint. Depending on machine availability and the complexity of the blueprint, the deployment might take some time to complete, and some blueprint steps might take longer than others.