Linux Virtual Delivery Agent

Configure LDAPS


The Linux XDPing tool is a command-line based application that automates the process of checking for common configuration issues with a Linux VDA environment.

The Linux XDPing tool performs over 150 individual tests on the system, which are broadly categorized as follows:

  • Check whether Linux VDA system requirements are met
  • Identify and display machine information including the Linux distributions
  • Check the Linux kernel compatibility
  • Check for any known Linux distribution issues that can impact the Linux VDA operation
  • Check the Security-Enhanced Linux (SELinux) mode and compatibility
  • Identify network interfaces and check network settings
  • Check storage partitioning and available disk space
  • Check machine host and domain name configuration
  • Check DNS configuration and perform lookup tests
  • Identify underlying hypervisors and check virtual machine configuration. Support for:
    • Citrix Hypervisor
    • Microsoft HyperV
    • VMware vSphere
  • Check time settings and check whether network time synchronization is operational
  • Check whether PostgreSQL service is properly configured and operational
  • Check whether the firewall is enabled and required ports are open
  • Check Kerberos configuration and perform authentication tests
  • Check the LDAP search environment for the group policy service engine
  • Check whether Active Directory integration is set up properly and the current machine is joined to the domain. Support for:
    • Samba Winbind
    • Dell Quest Authentication Services
    • Centrify DirectControl
    • SSSD
  • Check the integrity of the Linux computer object in Active Directory
  • Check Pluggable Authentication Module (PAM) configuration
  • Check the core dump pattern
  • Check whether packages required by the Linux VDA are installed
  • Identify the Linux VDA package and check the integrity of the installation
  • Check the integrity of the PostgreSQL registry database
  • Check whether the Linux VDA services are properly configured and operational
  • Check the integrity of the VDA and HDX configuration
  • Probe each configured Delivery Controller to test that the Broker Service is reachable, operational, and responsive
  • Check whether the machine is registered with the Delivery Controller farm
  • Check the state of each active or disconnected HDX session
  • Scan log files for the Linux VDA related errors and warnings
  • Check whether the version of Xorg is suitable

Use the Linux XDPing tool

XDPing comes with the single executable named xdping that is run from the command shell.

To display the command-line options, use the --help option:

sudo /opt/Citrix/VDA/sbin/ctxpython3/bin/python3 -m xdping --help

To run the full suite of tests, run xdping without any command-line options:

sudo /opt/Citrix/VDA/sbin/ctxpython3/bin/python3 -m xdping

To check the environment before installing the Linux VDA package, run the pre-flight tests:

sudo /opt/Citrix/VDA/sbin/ctxpython3/bin/python3 -m xdping --preflight

To run specific test categories only, for example, the time and Kerberos tests, use the -T option:

sudo /opt/Citrix/VDA/sbin/ctxpython3/bin/python3 -m xdping -T time,kerberos

To probe a particular XenDesktop Controller:

sudo /opt/Citrix/VDA/sbin/ctxpython3/bin/python3 -m xdping -d

Sample Output

The following is a sample output from running the Kerberos test:

First part of the Kerberos test sample output Second part of the Kerberos test sample output Third part of the Kerberos test sample output

Configure LDAPS