3.3 Discovery_ReportAgent

Use this Knowledge Script to discover the NetIQ AppManager report agent and associated data sources.

There are some circumstances under which you must run the Discovery_ReportAgent Knowledge Script again:

  • If you add a new data source (for example, Active Directory)

  • If you install new applications for which AppManager provides application-specific reports (for example, if you install Oracle)

If you add a new data source, re-running Discovery_ReportAgent adds the data source as a child of the report agent, and displays the corresponding Report Knowledge Scripts in the Operator Console and Control Center.

If you install a new application (and discover it), re-running Discovery_ReportAgent adds the discovered application to the appropriate AppManager repository under the report agent, and displays the corresponding application-specific reports.

When you run Discovery_ReportAgent again, be sure to set the Knowledge Script to discover existing data sources. For example, if you previously discovered Active Directories, be sure to enable the Discover Active Directories? parameter. Failure to rediscover existing data sources will remove them from the report agent.

If you delete or add a resource object, or if you make any other kind of change that might affect the monitoring of your resources, run the Discovery_ReportAgent Knowledge Script again to update your list of resource objects. In addition, if you are running this module on AppManager 8 or higher, you can use the delta discovery feature in Control Center to run discovery on a schedule to more quickly detect changes to your environment.

3.3.1 Restrictions

This Knowledge Script is not supported in the Web Console.

You cannot use the Action_RunKS Knowledge Script to run Discovery_ReportAgent.

3.3.2 Resource Objects

Any computer with the AppManager report-enabled agent installed

3.3.3 Default Schedule

By default, this script is only run once for each computer.

3.3.4 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

Discovery Type

Discover AppManager repository?

Set to y to discover the AppManager repository resource object. Successful discovery of this object allows you to render reports based on data in the AppManager repository. The default is y.

Discover Active Directories?

Set to y to discover Active Directory resource objects. Successful discovery of Active Directories allows you to render reports based on the data contained therein. The default is n.

Event Notification

Raise event if discovery succeeds?

This Knowledge Script always raises an event when the job fails for any reason. In addition, you can set this parameter to y to raise an event when the job succeeds. The default is n.

Event severity when discovery succeeds

Set the event severity level, from 1 to 40, to reflect the importance for a successful discovery. The default is 25.

Event severity when discovery fails

Set the event severity level, from 1 to 40, to reflect the importance when the discovery fails. The default is 5.

Event severity when discovery is partially done

Set the event severity level, from 1 to 40, to reflect the importance when a discovery returns some data but also generates warning messages. The default is 10.

Event severity when discovery is not applicable

Set the event severity level, from 1 to 40, to reflect the importance when the discovery is not applicable. This type of failure usually occurs when the target computer does not have the AppManager report agent installed. The default is 15.