- 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
Troubleshoot agent download and installation issues
This topic provides troubleshooting tips for agent download and installation issues.
When attempting to download the Smart Tools Agent, the following error message appears:
File not exists
To resolve this issue, contact Citrix Technical Support.
When attempting to install the Smart Tools Agent on VMs in Citrix XenServer or VMware vSphere resource locations, the installation fails.
This issue can occur if firewalls are blocking access to the machine, either betweenn Smart Tools and the machine or on the machine itself.
When the agent is installed on machines as part of a blueprint deployment, Smart Tools uses the following inbound ports to install the agent:
- Linux: Port 22 (SSH)
- Windows: TCP port 3389 (RDP)
Ensure that these ports are open on the machine for successful agent installation. After the agent is installed, you can shut down these ports as all further communication between the machine and Smart Tools occurs over outbound HTTPS (port 443).
The Smart Tools Agent fails to install on a Windows machine.
To resolve this issue, perform the following actions:
- Ensure that the Citrix Smart Tools Agent Service is stopped. Select Start > Control Panel > System and Security > Administrative Tools > Services. From the services list, verify if the Citrix Smart Tools Agent Service is stopped. If the agent service is running, right-click Citrix Smart Tools Agent Service and select Stop.
- Uninstall the agent.
- Delete the installation directory.
The agent is installed and registered successfully on a machine. However, machine details are not available.
This issue occurs if you have multiple Smart Tools accounts and you install the Smart Tools Agent from one account on machines in your other accounts. The machine details appear only on the account from which the agent is downloaded.
To resolve this issue, perform the following tasks:
- Uninstall the agent from the machine
- Delete the installation directory
- Download the correct agent for your environment.
- Install the agent on the machine. The machine details appear on the Smart Tools account from where you downloaded the agent package.
When installing the Smart Tools Agent on a VM, the agent installation halts and times out.
This issue occurs if the VM template (in XenServer or vSphere) is not created according to the instructions in Prepare Windows Server VM templates for deploying blueprints.
To resolve this issue, review the applicable section of Prepare Windows Server VM templates for deploying blueprints, recreate the VM template, and use the new template when creating new VMs in the resource location.
During blueprint deployment, agent installation fails for non-admin users having administrator privileges on a Windows machine. The following error message appears in the blueprint deployment step output:
Failed to install agent
Before you create a Windows VM template, ensure that you have disabled User Access Control on Windows. Deploy your blueprint using the Windows VM template.