- 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
Upload Site diagnostics to Citrix Technical Support
If you experience an issue with your Site, Citrix Technical Support might ask you to provide diagnostic data that they will use to help you resolve the issue. Smart Tools provides a simple way to securely upload your diagnostics data to Citrix Insight Services and share it with Citrix Support.
Before you can upload diagnostics, you need to create a diagnostics file. Typically, this is a ZIP file that you can generate with Citrix Scout.
For more information about creating a diagnostics file, see CTX135408.
- From the menu bar, click Smart Check.
- Click Diagnostics > Upload Diagnostics. The Upload Diagnostics dialog appears.
Enter the following information:
- In Diagnostic data file, click Select File to locate and select the diagnostic ZIP file you generated earlier.
- In Upload name, enter a friendly name for your upload, if applicable. By default, the filename of your diagnostic data file is used.
- In Case number, enter your 8-digit case number, if applicable.
- In Description, enter any additional information about your Support case, if applicable.
- To be notified when Smart Tools has completed processing your file, select Send me an email notification when file processing is complete.
- Click Upload. Smart Tools uploads the file.
- Click Done to close the dialog.
As Smart Check processes your file upload, the Diagnostic Uploads page displays its progress at the top of the page.
After processing is finished, Smart Tools adds your upload to the page and, if you selected the option, sends you an email notification. To view the details of your upload, click the upload entry displayed on the page. Each entry includes upload information such as upload date and time, name of the upload, Support case number (if included), the type of upload, and the user who initiated the upload.
If your Site is new to Smart Check, Smart Check uses your diagnostics upload to discover and display your Site on the Smart Check page. You can then install the Smart Tools Agent to run health checks. To view your Site’s health report, click Back to All Sites and then select your Site from the list.
Note: If you remove your Site from Smart Check, uploaded diagnostics files associated with the Site are not deleted.
After you upload your diagnostics file, Smart Tools creates a URL that you can share with Citrix Technical Support. Citrix Technical Support can then download your file for further analysis.
- From the menu bar, click Smart Check.
- Click Diagnostics > View Uploads. The Diagnostic Uploads page appears.
- Select the upload you want to share. The upload details page appears.
- Under Share report with Citrix Support, click Copy to copy the URL of your uploaded file. The report URL contains the upload ID for your diagnostics upload.
After you upload your file, Citrix Technical Support can locate it using your Smart Tools user name, organization name, case number (if included) or upload ID.
The Diagnostic Uploads page is where Smart Check displays a list of all your previous uploads, including the following information:
- Case: The case number associated with the upload.
- Source: The mechanism by which the upload was generated. Examples: Scout or Call Home in XenDesktop or XenApp, CDFControl, NetScaler.
- Upload Type: Whether the upload was manually generated, scheduled, or triggered as the result of a product error or other event.
- Recommendations: The number of notifications for issues that were detected in your diagnostic upload that you should address. Recommendations can include notifications for installing missing hotfixes, replacing obsolete hotfixes, or addressing issues that were detected.
If you have a large list of uploads, Smart Check makes it easier to navigate the list using the following features:
- Search as you type: To search in a column, simply click the magnifying glass and begin typing. Smart Check automatically displays uploads that contain your typed criteria.
- Filtering by Source or Upload Type: When you click the magnifying glass in the Source and Upload Type columns, you can select search criteria from a list of options. Smart Check automatically displays uploads that match your selections.
- Sorting: You can sort any column in the list in ascending or descending order; simply click the column heading. If you filtered the list, clicking on a column heading sorts the filtered list.
You can also hide or display columns so the page displays only the information you want to see.
Modify upload properties
When you click on an upload entry from the list, Smart Check displays a Summary page that includes the case number and description that was entered when the upload was created. If you need to change this information later, simply click the pencil icon next to these fields.
- From the Diagnostic Uploads page, select an upload from the list.
- From the Summary page, click Delete Upload.
- Click Delete.
When you upload a diagnostics file, the file is analyzed for potential issues such as missing hotfixes or known issues. If any issues are identified, Smart Check displays a list of recommendations for addressing them. These recommendations also include links to Citrix resources to help you learn more about the issue and how to troubleshoot and resolve it.
Note: Because recommendations are based on the contents of diagnostic uploads, they can provide more information about potential issues in your XenApp and XenDesktop Sites, in addition to the issues that might be detected with health checks. Citrix recommends using diagnostic uploads alongside running health checks to ensure you address all important issues in your Site.
To view recommendations
- From the Diagnostic Uploads page, select an upload from the list. The Summary page appears.
- Click the Recommendations tab. A list of recommendations appears.
- To view the recommendation details, click an entry in the list. Smart Check displays a description of the recommendation and links to resources to help you fix the issue.