Options for Running and Controlling Resource Discovery

This section describes options for initiating and preventing Hyperic resource discovery processes.

For information about different types of auto-discovery scanning, see Resource Auto-Discovery Processes.

Scan a Platform On-Demand

To initiate a platform scan:

  1. Navigate to the platform you want to scan.

  2. Select New Auto-Discovery from the Tools menu.

    • The New Auto-Discovery page appears.

      Some Platforms Cannot Be Scanned

      You can only initiate an auto-discovery scan for a platform that runs an Hyperic Agent. Platforms that are remotely monitored, such as Cisco and other network device platforms that do not run an agent, cannot be scanned.

  3. You can run default scan only, or run a file scan in addition to the default scan. The different scan types are described in Resource Auto-Discovery Processes.

    • To run a default scan only, click OK at the top of the page.

    • To run a file scan in addition to the default scan:

      1. Check the the Server Types that Hyperic should look for on the platform.

      2. In ScanDirs, specify the directories that HQ should scan.

      3. In ExcludeDirs, specify the directories that Hyperic should not scan.

      4. In fsTypes, select the type of file system to scan: local disks, network-mounted disks, or both ("all").

      5. In depth, specify the depth in the directory structure to which HQ should scan.

      6. To have Hyperic follow symlinks when scanning, check Should symlinks be followed.

      7. Click OK at the bottom of the screen.

Configure Default and Runtime Scanning Frequency

Configure Frequency of Default Scan

By default, an HQ Agent runs a default scan upon startup and every 15 minutes thereafter. To change the frequency, uncomment the autoinventory.defaultScan.interval.millis line in the agent.properties file, and set the desired value in milliseconds.

  • autoinventory.defaultScan.interval.millis*

    Description

    Specifies how frequently the agent performs a default autoinventory scan.

    The default scan detects servers and platform services, typically using the process table or the Windows registry. Default scans are less resource-intensive than runtime scans.

    Default

    Commented out, set to 86,400,000 milliseconds, or 1 day.

    Note however, that by default, the agent performs the default scan at startup and every 15 minutes thereafter.

Disable Default Scan

To prevent the HQ Agent from running default scans on the platform, uncomment the autoinventory.defaultScan.interval.millis property in the agent.properties file, and set it to "-1". For example:

autoinventory.defaultScan.interval.millis=-1

Configure Frequency of Runtime Scan

By default, an HQ Agent runs a runtime scan once a day. To change the frequency, edit the{{autoinventory.runtime.Scan.interval.millis}} line in the agent.properties file, and set the desired value in milliseconds.

autoinventory.runtimeScan.interval.millis

Description

Specifies how frequently the agent performs a runtime scan.

A runtime scan may use more resource-intensive methods to detect services than a default scan. For instance, a runtime scan may involve issuing an SQL query or looking up an MBean.

Default

86,400,000 milliseconds, or 1 day.

Exclude a Plugin Resource Hierarchy

If you do not want the Hyperic Agent to discover a resource, you can prevent the agent from loading the plugin. Specify the plugin or plugins that you do not want the agent to load at startup with the agent.exclude property in the agent.properties file on the platform.

Disable Platform Service Discovery

To disable auto-discovery of platform services, update agent.properties with the following property settings.

sigar.mirror.procnet

Description

mirror /proc/net/tcp on linux

Default

true

netservices.netstat

Description

Add the netservices.netstat property to agent.properties and set it to "false" to prevent the agent from auto-discovering network services running on the platform.

Default

As installed, agent.properties does not contain this property, and by default, an HQ Agent discovers network services running on a platform.

Disable Service Discovery for a Server Instance

If you do not want to the agent to discover the services running in a server, you can disable the behavior in the Monitoring section of the Configuration Properties page for a server instance.