- 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 Site onboarding issues
This topic provides troubleshooting tips for issues that might be encountered when adding a XenApp and XenDesktop Site to Smart Check or Smart Scale.
When adding a Site to Smart Check or Smart Scale, Smart Tools prompts you for account credentials for installing the Smart Tools Site Agent and onboarding the Site. The account credentials you specify must meet the following requirements:
- The account credentials are entered in domain\username format.
The account credentials have the appropriate permissions. The following table lists the minimum required permissions:
Smart Check Smart Scale Citrix administrator role Full Administrator Delivery Group Administrator Active Directory group Domain Users Domain Users
To view the Citrix administrator role delegated to the account, launch Studio, click Configuration > Administrators from the navigation pane, and then click the Administrators tab in the upper middle pane.
For more information:
- For Smart Check, see the “Required permissions” section in About Smart Check.
- For Smart Scale, see the “Add a Site and install Site Agents” section of Add a Site to Smart Scale.
To add a Site, the Citrix Cloud account that you use to access Smart Tools must have the Administrator role assigned to it in Smart Tools. By default, all Citrix Cloud users with Smart Tools access are assigned the Administrator role.
To view the Smart Tools role for your user account, click Resources & Settings > Users.
For Smart Check to communicate with your Site, the Delivery Controller must meet the following requirements:
- The Delivery Controller is powered on.
- The Delivery Controller is configured to allow outbound communication on port 443 (HTTPS).
- The Smart Tools Site Agent is installed and running on the Delivery Controller.
- The Studio console is accessible on the Delivery Controller.
To verify the Smart Tools Site Agent is running, launch the Services console (services.msc) and locate the Smart Tools Agent Service. Verify the Status is Started and the Startup Type is Automatic.
To verify the Studio console is accessible on the Delivery Controller, launch Studio and check that it displays all the Machine Catalogs and Delivery Groups in your Site. Studio should launch smoothly and display no errors.
- On the Delivery Controller hosting the Smart Tools Site Agent, open a web browser and enter https://smart.cloud.com in the address bar.
- When prompted, enter your Citrix Cloud username and password and click Sign In.
- If applicable, select a customer account. The Smart Tools home page displays.
To use Smart Check or Smart Scale, Delivery Controllers in the Site must have PowerShell 3.0 installed, at a minimum, and be capable of running PowerShell scripts.
To verify the current version of PowerShell installed:
- On the Delivery Controller, open a PowerShell command window.
- At the command prompt, type Get-Host and press ENTER.
- In Version, confirm the output is 3.0 or later.
To verify the Delivery Controller is capable of running PowerShell scripts:
- Log on to the Delivery Controller using the same credentials you used to add the Site to Smart Check.
- Launch an instance of Windows PowerShell (powershell.exe).
- Enter the following PowerShell commands:
Add-PSSnapin -Name Citrix.* -ErrorAction Stop Get-ConfigSite
The commands load all Citrix PowerShell modules and return the Site instance. Confirm these commands complete successfully with the expected results.
If you’ve tried these troubleshooting tips and your Site continues to experience an issue, contact Citrix Support for assistance.
Troubleshoot Site onboarding issues
In this article
- Verify credentials are correct
- Verify your Smart Tools account has the correct permissions
- Verify the Delivery Controller can be reached
- Verify the Delivery Controller can reach Smart Tools
- Verify the Delivery Controller has the correct PowerShell version installed and can run scripts
- Additional assistance