Linux Virtual Delivery Agent 2109

XDPing

Description

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

Note:

Running ctxsetup.sh does not install XDPing. You can run sudo /opt/Citrix/VDA/bin/xdping to install XDPing. This command also creates a Python3 virtual environment that is required for XDPing. If this command fails to create a Python3 virtual environment, create it manually following the instructions at Create a Python3 virtual environment.

To address SSL connection errors that you might encounter when using the pip tool, consider adding the following trusted hosts to the /etc/pip.conf file:
[global]
trusted-host =
pypi.org
files.pythonhosted.org

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/bin/xdping --help
<!--NeedCopy-->

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

sudo /opt/Citrix/VDA/bin/xdping
<!--NeedCopy-->

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

sudo /opt/Citrix/VDA/bin/xdping --preflight
<!--NeedCopy-->

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

sudo /opt/Citrix/VDA/bin/xdping -T time,kerberos
<!--NeedCopy-->

To probe a particular XenDesktop Controller:

sudo /opt/Citrix/VDA/bin/xdping -d myddc.domain.net
<!--NeedCopy-->

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

XDPing