- 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
Rerun a blueprint step during a deployment error
This feature allows you to rerun a section or tier of a blueprint during a deployment error based on the following conditions:
- The blueprint must be configured to pause on deployment error.
- You can resume the deployment from the current step. This functionality is supported for Script, Server, and Reboot steps.
You can resume the deployment from any previous step. This functionality is supported for Script and Reboot steps if the step is not configured to path a Server step or conditional evaluation.
- You can resume the deployment from the next step. This functionality is supported for Script , Server, and Reboot steps.
The following example demonstrates the rerun feature with a simple workflow.
Step 1: Create a blueprint
- From the menu bar, click Smart Build.
- Click New Blueprint.
- Enter the name of the blueprint.
- Click the Deploy tab.
- Under the Options tab, select Pause from the On failure box.
If the deployment fails due to any error in the blueprint, the deployment will pause and the Resume option will appear.
Step 2: Add and configure steps
Drag and drop the following steps in the specified order from the left pane of the Blueprint Designer (Cloud Steps and Utility Steps):
- Server step
- Wait step
- Manual step
- Wait step
- In each Wait Step instance, configure the Wait time setting to 30 seconds. The default is 180 seconds.
- Click Save to save the blueprint.
Step 3: Deploy the blueprint
- Click Deploy at the right side of the blueprint designer. Alternatively, you can deploy the blueprint from the Library page.
- Click Start Deployment setup and click Continue.
- Enter the deployment information and click Next.
- Review the number of VMs and click Next.
- Select the VM tier, configure the VM settings and click Next.
- Review the deployment configuration and click Next.
- Review the blueprint summary and click Deploy.
Step 4: View deployment information and rerun steps
In the Deployments page, click the deployment under the IN PROGRESS section.
- You can view the progress of the deployment under the Deployment Details tab.
The Server step, Wait step, and the Manual step run and the blueprint deployment pauses at the Manual step.
Select Resume > Select step to rerun and select one of the following options:
Option Description Retry paused step and resume Reruns the paused step and runs the subsequent steps Skip paused step and resume Skips the paused step and runs the subsequent steps Resume from previously executed step Lists the server and conditional steps you can rerun. Reruns the selected step and runs the subsequent steps
Based on the selected option, the deployment runs and finishes. In this example, we select the option Skip paused step and resume. The deployment is completed.
You can rerun a Server step on failure, if the Server step is configured in the blueprint to pause on failure.
- Select Resume > Select step to rerun after the deployment is paused.
- Select Retry paused step and resume. The Server step runs again and creates new VM instances. The number of VM instances created depends on the number of VM instances configured in the blueprint or during blueprint deployment. In case of a Server step failure, the blueprint deployment pauses and the Resume button appears.
Note: For each Server step rerun, new VM instances are created based on the blueprint configuration. Smart Tools does not tear down the VMs already created during Server step failure. You need to manually remove the VMs created during step failure on your resource location.