This article contains information regarding troubleshooting Citrix XenDesktop environments. It’s a collection of KB articles, HOWTO Video’s and Self Service Tools from Citrix.
Session information
A XenDesktop 5 Agent stores session information in the following registry location: [HKLM\Software\Citrix\ICA\Session]. Values like “ClientName” and “ClientAddress” are stored here. When a session is disconnected, the values of the last connect session will remain in the registry.
Unfortunately XenDesktop 4 Agent does not contains those settings. The Clientname and IP address are stored in environment variables: “clientipaddress” and “clientname”.
Related Citrix KB articles
CTX128075 XDDBDiag: Consistency check on data in XenDesktop 5 database
This command line support tool performs a consistency check on the data in a XenDesktop 5 database. It also outputs the following diagnostic data into comma-separated value (.csv) files located in a compressed file (.zip) namedcomputername_XDDBDiag_Output.zip to the same directory in which the program is located.
CTX127491 Session State Monitor Tool
The Session State Monitor Tool actively monitors remote connections and disconnections in the session for which it’s running. The tool provides the ability to specify custom commands for Disconnect, Reconnect, and Startup. The tool also has the ability to allow the endpoint (client) name to smooth roam in double-hop sessions to the second hop.
CTX123278 XDPing Tool
The XDPing tool is a command-line based application which automates the process of checking for the causes of common configuration issues in a XenDesktop environment. The tool can be used to verify configuration settings on both the XenDesktop Broker and VDA machines, both from the console and remotely.
CTX124379 Virtual Desktop Agent Troubleshooting Utility
When reproducing XenDesktop Virtual Desktop Agent issues in a lab environment it can be a time-consuming task to make frequent changes to Virtual Desktop Agent settings, such as changing its farm membership, checking Virtual Desktop Agent and ICA software versions, and viewing other pertinent information such as current farm, registered Desktop Delivery Controller (DDC), Desktop Group, hostname, IP address, log settings, and so on.
CTX117452 Enable Logging for XenDesktop
You can enable the logging process on the Desktop Delivery Controller (DDC) and the Virtual Desktop Agent (VDA) to collect log files for XenDesktop and enable OverwriteLogFile value in the configuration files. Enabling OverwriteLogFile value overwrites the log file each time the service is started. To enable the logging process on DDC and VDA, complete the following procedures: Enabling Logging on the VDA; Enabling Logging on the DDC
CTX128909 XenDesktop 5 Logon Process and Communication Flow
CTX117248 Troubleshooting Virtual Desktop Agent Registration with Controllers in XenDesktop
CTX127492 Enable Controller Service Logging in XenDesktop 5
CTX126990 Troubleshooting XenDesktop Service Startup Issues
CTX126704 Registry Entries Used by XenDesktop 5 Broker Service
CTX117446 Registry Entries Used by XenDesktop
Critical Tool Matrix for XenDesktop Environments
The Critical Tool Matrix is a PDF which contains a list of tools that are most commonly used by Citrix Support to troubleshoot critical issues in XenDesktop environments. Citrix Technical Support has prioritized these tools into high and medium categories. Download the tool here.


Recent Comments