Local Host Cache Status Test

Each XenApp server stores a subset of the data store in the Local Host Cache (LHC). The LHC performs two primary functions:

  • Permits a server to function in the absence of a connection to the data store.
  • Improves performance by caching information used by ICA Clients for enumeration and application resolution.

The following information is contained in the local host cache:

  • All servers in the farm, and their basic information.
  • All applications published within the farm and their properties.
  • All Windows network domain trust relationships within the farm.
  • All information specific to itself. (product code, SNMP settings, licensing information)

This test checks for data consistency (duplicate values) and integrity (corrupt entries) of the XenApp server’s local host cache.

Target of the test : Any Citrix server

Agent deploying the test : An internal agent

Outputs of the test : One set of results for every server being monitored

Configurable parameters for the test
  1. TEST PERIOD – How often should the test be executed
  2. Host – The host for which the test is to be configured
  3. Port Refers to the port used by the Citrix server
  4. health monitor test path - Citrix XenApp is bundled with a Health Monitoring and Recovery (HMR) test pack, which provides a standard set of tests that can be configured to monitor the health of many XenApp components and report failures. Since the eG agent runs one of the HMR tests to determine the health of the local host cache (LHC), you need to configure the eG agent with the full path to the folder containing the HMR test pack. By default, the health monitor test path is set to default. This implies that the eG agent runs the HMR test from its default location, which is: C:\Progra~1\Citrix\HealthMon\Tests\Citrix. However, if the HMR test pack is available in a different location in your Citrix environment, then indicate that location in the health monitor test path text box. For instance, your specification can be: C:\LocalDir\Citrix\HealthMon\Tests\Citrix.
Measurements made by the test
Measurement Description Measurement Unit Interpretation

LHC initialized status:

Indicates whether the local host cache is initialized or not.

 

This measure reports a value Success if the local host cache is initialized successfully and reports a value Failure if the local host cache initialization is not successful.

The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value

Success

0

Failure

1

Note:

By default, this measure reports the above-mentioned states while indicating whether the local host cache initialization is successful or not. However, the graph of this measure will represent success and failure using the numeric equivalents- i.e., 0 and 1 - only.

LHC entry's integrity status:

Indicates whether the LHC entry is integrated successfully or not.

 

This measure reports the value Success if the LHC entry is integrated successfully and reports the value Failure if the LHC entry integration is not successful. Typically, this measure will report the value Failure if one/more corrupt entries are found in the local host cache. The only way you can fix a corruption in the local host cache is by deleting and recreating the local host
cache file (which is an MS Access file).

The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value

Success

0

Failure

1

Note:

By default, this measure reports the above-mentioned states while indicating whether the LHC entry is integrated successfully or not. However, the graph of this measure will represent success and failure using the numeric equivalents- i.e., 0 and 1 - only.

LHC context nodes status:

Indicates the health of the context nodes.

 

This measure reports the value Success if the health of the context nodes is good and reports the value Failure if the health of the context nodes is not good.

The numeric values that correspond to the above-mentioned states are as follows:

State Numeric Value

Success

0

Failure

1

Note:

By default, this measure reports the above-mentioned states while indicating whether the context nodes are healthy or not. However, the graph of this measure will represent success and failure using the numeric equivalents- i.e., 0 and 1 - only.