DNS Check Test

To be able to successfully register with the Citrix Delivery Controller 5.x, the virtual desktop agent executing on the virtual desktops should be able to see the correct IP address of the Citrix Delivery Controller 5.x. If the DNS server is incorrectly configured, then it will not be able to resolve the IP address of the Citrix Delivery Controller 5.x to its domain name, thereby causing desktop registration to fail; as a result, DDC will not be able to deliver virtual desktops on-demand to users. 

This test brings DNS misconfigurations to light by reporting whether the DNS server is able to resolve the IP address of the Citrix Delivery Controller 5.x to its fully qualified domain name. If this test reports an error, then you can easily conclude that this is the reason why registration failed.

Target of the test : A Citrix Delivery Controller 5.x

Agent deploying the test : An internal agent

Outputs of the test : One set of results for the DNS server that the Citrix Delivery Controller 5.x users.

Configurable parameters for the test
Parameter Description

Test Period

How often should the test be executed.

Host

The IP address of the host for which this test is to be configured.

Port

Refers to the port at which the specified host listens to.

Detailed Diagnosis

To make diagnosis more efficient and accurate, the eG Enterprise embeds an optional detailed diagnostic capability. With this capability, the eG agents can be configured to run detailed, more elaborate tests as and when specific problems are detected. To enable the detailed diagnosis capability of this test for a particular server, choose the On option. To disable the capability, click on the Off option.

The option to selectively enable/disable the detailed diagnosis capability will be available only if the following conditions are fulfilled:

  • The eG manager license should allow the detailed diagnosis capability
  • Both the normal and abnormal frequencies configured for the detailed diagnosis measures should not be 0.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

DNS lookup status

Indicates whether the DNS server is able to resolve the IP address of the DDC to its fully qualified domain name.

 

This measure reports the value Ok if the DNS server is able to resolve the IP address of the DDC to its domain name. The value Error, on the other hand, is reported if the DNS server is not able to resolve the IP address of the DDC to its domain name. The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value
Ok 1
Error 0

Note:

By default, this measure reports the above-mentioned states to indicate whether the DNS is properly configured or not. However, the graph of this measure will represent the states using their corresponding numeric equivalents only – i.e., 0 and 1.

Note:

This test integrates with XDPing to report metrics. 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 Citrix Delivery Controller and VDA machines, both from the console and remotely.

To enable the eG agent to integrate with XDPing, you need to download the XDPing tool from the URL: http://support.citrix.com/article/CTX123278, and then, copy it to the <EG_INSTALL_DIR>\eGurkha\bin directory on the agent host.