Health Monitoring & Recovery Test Pack

  Download HMR Test Pack

Included Tests

These tests are included in the Health Monitoring & Recovery (HMR) Test Pack:

• Checkdns.exe
• CheckLHC.exe
• Checkxmlthreads.exe
• Cpsvctest.exe
• Spoolertest.exe
• ICAListener.exe

Description

This section describes what each test checks and how it accomplishes its testing.
It is recommended to use default threshold values when importing these tests in the Access Management Console except where explicitly noted below. Refer to the Citrix Presentation Server 4.5 Administrator's Guide for importing tests via the Access Management Console.

• Check DNS - Checkdns.exe

Check DNS ensures DNS health on the local server. The test consists of a forward DNS lookup that uses the local hostname to query the IP address from the local DNS in the computer's environment. The test passes successfully if the returned IP address matches the IP address that is registered locally with the NIC. By default, only a forward DNS lookup is performed. The flag /rl can be applied to run both forward and reverse DNS lookups.

• Check Local Host Cache - CheckLHC.exe

Check Local Host Cache performs an integrity and consistency test on the local Citrix Presentation Server's local host cache (LHC). The integrity check ensures that the data stored in the LHC is not corrupted while the consistency check ensures no duplicate LHC entries. These operations are similar to those in other Presentation Server utilities found in DSCheck and DSVerify. Because this test can be CPU intensive, it is recommended to use a longer test interval of 24 hours (86400 seconds) while keeping default values for the test threshold and timeout.

• Check XML Threads - Checkxmlthreads.exe

Check XML Threads performs a threshold check on the current number of worker threads running in the Citrix XML Service. Run this test with a single integer parameter to set the maximum allowable threshold value. The test checks the current value on the system and compares that to the input value. If the value found on the system is greater than the input value the test fails; otherwise, the test passes.

• Citrix Print Manager Service Test - Cpsvctest.exe

Citrix Print Manager Service Test determines the health of the Citrix Print Manager service by enumerating session printers. In cases where the test cannot enumerate session printers, such as service hangs or crashes, the test fails.

• MS Print Spooler Test - Spoolertest.exe

MS Print Spooler Test checks if the print spooler installed with Windows, is healthy, and ready for use. This test helps determine if there are system printer issues that you must address. The test attempts to enumerate printer drivers, printer processors, and printers.

• ICAListener - ICAListener.exe

ICA Listener detects if the server is able to accept ICA connections. The test detects the default ICA port, connects to the port, and sends it some data. If the test gets the appropriate data back, the test succeeds.

Setup

The setup utility LHCTestAclsUtil.exe is included in the HMR Test Pack. This utility enables the Check Local Host Cache test to run. The utility makes several registry, directory, and file permission changes to allow the LHC test access to the appropriate items.
Run the utility from the command line, with local administrator privileges. The utility asks whether or not the user is willing to allow the settings changes. Specify yes to complete the setup.