Citrix DaaS

Troubleshoot VDA registration and session launch issues

August 27, 2024

Contributed by:

C R

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 using Studio.

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 Studio.

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

In Studio, go to the Search node.
Select one or more machines and then select Run Health Check from the action bar.

Run health check option Studio

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.

The official version of this content is in English. Some of the Cloud Software Group documentation content is machine translated for your convenience only. Cloud Software Group has no control over machine-translated content, which may contain errors, inaccuracies or unsuitable language. No warranty of any kind, either expressed or implied, is made as to the accuracy, reliability, suitability, or correctness of any translations made from the English original into any other language, or that your Cloud Software Group product or service conforms to any machine translated content, and any warranty provided under the applicable end user license agreement or terms of service, or any other agreement with Cloud Software Group, that the product or service conforms with any documentation shall not apply to the extent that such documentation has been machine translated. Cloud Software Group will not be held responsible for any damage or issues that may arise from using machine-translated content.

Was this helpful

Troubleshoot VDA registration and session launch issues

August 27, 2024

Contributed by:

C R

August 27, 2024

Contributed by:

C R

Troubleshoot VDA registration and session launch issues

Prerequisites

Run health checks for VDAs

In this article