Product Documentation

Perform health checks for your XenApp and XenDesktop Site

Important: This topic has been deprecated and will be removed from the documentation. For the latest version of this topic, visit https://docs.citrix.com/en-us/smart-tools/checks/perform-health-update-checks-xenapp-xendesktop-sites.html.

Run initial checks on your Site

After you add your Site to Smart Check, you can start running health checks by clicking Get Started on the XenApp and XenDesktop Sites page.

Get Started button highlighted on Smart Check Site card

By default, Smart Tools runs the following checks:

  • Site Health Checks
  • Apps and Desktops Checks
  • Update Checks
  • LTSR Checks

Smart Tools creates a default schedule for running these checks on a daily basis, selecting a time at random between 12:00 AM and 5:00 AM. The time zone for this schedule is the time zone of the first Delivery Controller that Smart Tools discovers.

Results of initial checks

After a few minutes, Smart Tools discovers the components in your Site and runs the initial checks. When the analysis is finished, Smart Tools displays the Health Alerts page which shows the number of items found for each Site component. Smart Tools also sends you a daily email notification with the results of each check performed.

Health Alerts page with issues count highlighted

To view the alerts for the items found, click the Site component with the items you want to see. For more information about managing these alerts, see Manage Smart Check alerts and notifications.

To view your Site’s health report after the initial check run, click View.

Site cards on Smart Check Sites page

Run checks on demand

You can run checks on your Site at any time, on demand. You can also create a schedule for your Site to ensure checks are performed on days and at times you specify. The default time zone for determining when scheduled checks will run is the time zone of the first Delivery Controller that Smart Tools discovered when you initially added your Site to Smart Check.

To perform checks on demand

  1. Click Smart Check.
  2. On the XenApp and XenDesktop Sites page, select the Site you want to manage and click View. The Health Alerts summary for your Site appears.
  3. Click Perform Check and select the check you want to run. Select a check you added from the Checks catalog or select one of the following checks:

    • Site Health Checks: Evaluates the availability and health of your Site.
    • Apps and Desktops Health Checks: Evaluates the availability and health of your Site’s Delivery Groups.
    • Updates Checks: Checks for applicable hotfixes and product updates for your Site.
    • LTSR Compliance Checks: Checks to ensure the components in your Site are LTSR compliant.

    If you are running a check that targets specific machines such as VDA Health Checks or Delivery Controller Configuration Checks, ensure the machines meet the requirements described in System requirements for targeted machines.

  4. When prompted, click Perform Checks Now.

Running the checks will take a few minutes to complete. When finished, the Health Alerts page for your Site lists the status of all the checks performed and the number of errors, warnings, and notifications found. Smart Tools also sends you an email notification with this information.

To view the individual alerts that Smart Check finds, click a component on the Health Alerts page.

Schedule checks

  1. From the command bar, click Smart Check.
  2. On the XenApp and XenDesktop Sites page, select the Site you want to manage and click View. The Health Alerts summary for your Site appears.
  3. Click Configure. The Configuration page appears.
  4. Select a set of checks, such as Site Health or Update Checks, and then click Run on a schedule.
  5. If you selected a custom check or a Citrix-provided check that targets specific machines, click Select Machines and then select the machines you want to include each time the checks run.
  6. Select the interval (Every day or Every week), time, and day of the week, if applicable, to run the selected checks.
  7. When finished, click Return to Health Report.

When Smart Check runs the scheduled checks, Smart Tools sends you an email notification with the errors, warnings, and notifications found in your Site. Smart Check sends this email once per day, after the last scheduled health check finishes running. To view the individual alerts that Smart Check finds, click a component on the Health Alerts page.

Perform checks without the Site Agent

If you choose not to install the Smart Tools Agent on Delivery Controllers in your Site, you can still use Smart Check to perform manual checks at any time.

To do this, first use Call Home or Citrix Scout. Afterward, in Smart Check, run the checks again. Smart Check uses your Site data to analyze your Site and displays any issues or notifications it finds. You can then address the alerts using your own processes, outside of Smart Tools.

Troubleshooting failed checks

If Smart Check cannot run the selected checks, Smart Check displays the status “Could not run checks.” To view the error output for troubleshooting, click Get error output for the affected checks. After you correct the issue, you can rerun the checks or wait until the next scheduled run occurs.

In each set of checks, there are a certain number of critical checks that Smart Check runs. If Smart Check runs a critical check and it returns a failed response, Smart Check uses Call Home to perform a diagnostic check on your Site. If any errors are detected, Smart Check displays them on your Site’s health report. If you do not want to enable Call Home for your Site, use Citrix Scout to generate current diagnostics from your Site and then run the checks again.

Perform health checks for your XenApp and XenDesktop Site