Citrix DaaS

Troubleshoot VDA registration and session launch issues

We offer a health check feature that lets you gauge the health of VDAs. The feature lets you identify possible causes for common VDA registration and session launch issues through the Full Configuration management interface.

Unlike Cloud Health Check, a standalone tool for gauging the health and availability of the site and its other components, the feature is available as the Run Health Check action in the Full Configuration management interface.

The Run Health Check action can run the same checks as Cloud Health Check except the following ones:

  • For VDA registration:
    • VDA communication port availability
  • For session launches on VDAs:
    • Session launch communication port availability
    • VDA application launch path

Prerequisites

Before you use the feature, verify that you meet the following prerequisites:

  • Windows VDAs
  • VDA version 2109 or later
  • VDAs are registered

Run health checks for VDAs

  1. In the Full Configuration management interface, go to the Search node.

  2. Select one or more machines and then select Run Health Check from the action bar.

Run health check option in Full Configuration

Note:

Currently, you can run health checks only for registered VDAs. The Run Health Check action is unavailable for unregistered VDAs.

After you select Run Health Check, a window appears, displaying the progress of the health checks. Wait until the heath checks complete or click Cancel to cancel the checks. If necessary, you can move the window.

Health check in progress

Note:

In scenarios where a “health checks in progress” window already exists, you cannot run additional health checks until the existing health checks complete.

After the health checks complete, the following two buttons appear: View report and Close. To view the results of the health checks, click View report.

Health check complete

The health check report opens in a new browser tab. The report contains the following elements:

  • Time and date when the results report was generated
  • The person who ran the health checks
  • Checks run on the target machines
  • Issues found, along with fix recommendations

Health check report

You can run health checks individually and in batches.

Note:

When running health checks in batches, select no more than 10 machines. Otherwise, the Run Health Check action is unavailable.

Troubleshoot VDA registration and session launch issues