3.20 GlobalCatalogHealth

Use this Knowledge Script to monitor access to the global catalog (GC) servers defined in the forest. This script retrieves a list of all GC servers within the site or forest specified in the Site list parameter, and tries to connect to them using ADSI (Active Directory Service Interfaces). In addition, this script raises an event if the connection fails for any domain controller hosting a GC.

3.20.1 Resource Objects

Active Directory domain controller

3.20.2 Default Schedule

The default interval for this script is Every 10 minutes.

3.20.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

General Settings

Raise event if job fails

Event severity when job fails

Set the severity level, from 1 to 40, to indicate the importance of an event in which the GlobalCatalogHealth job fails. The default is 35.

Monitor connectivity to global catalog servers

Scope of global catalog monitoring

Select site(s) or forest to indicate the scope within which you want to monitor your global catalog servers.

Site list (comma-separated, no spaces)

Specify a list of sites to monitor. Separate names by commas and no spaces. The list can contain no more than 4096 characters.

Full path to file with list of sites

You can use a text file that contains a list of sites, rather than using the previous parameter. Specify the path to that file here.

The path can be to a file on the computer where the AppManager agent is installed (for example, C:\AMAgent\sitelist), or a UNC path if the file exists on a different computer (for example, \\Server1\SiteLists\sitelist).

The file should contain one site per line. The AppManager agent must have read permission for the file.

Enable job delegation?

Select Yes to enable the delegation of the job to another server where appropriate. If enabled, runs the job on the selected computer that holds the Inter-Site Topology Generator (ISTG) server role. The default is unselected. For more information, see Section 3.1, AD Knowledge Script Job Delegation.

Delegate site-wide monitoring to the

Indicates the server role to which the job should be delegated, the ISTG.

Raise event when DC assumes this role?

If you enabled job delegation, set to Yes to raise events if the domain controller (DC) assumes the ISTG server role. The event indicates that the monitored computer has assumed that role. The default is Yes.

Event severity when DC assumes this role

Set the severity level, from 1 to 40, to indicate the importance of an event in which the DC assumes the ISTG server role. The default is 30.

Raise event when DC relinquishes this role?

If you enabled job delegation, set to Yes to raise events if the DC gives up the ISTG server role. The event indicates that the monitored computer has relinquished that role. The default is Yes.

Event severity when DC relinquishes this role

Set the severity level, from 1 to 40, to indicate the importance of an event in which the DC relinquishes the ISTG server role. The default is 30.

Event Notification

Raise event if connection to global catalog fails?

Select Yes to raise an event if the connection to the GC fails. The default is Yes.

Event severity when connection fails

Set the severity level, from 1 to 40, to indicate the importance of an event in which the connection to the GC fails. The default is 10.

Data Collection

Collect data for global catalog status?

Select Yes to collect data for charts and reports. If enabled, data collection returns:

  • Percentage of Global Catalog Servers Up %

  • Number of Global Catalog Servers Up GCs

  • Number of Global Catalog Servers Down GCs