Using the Auto-Discovery Portlet

Topics marked with * relate to features available only in vFabric Hyperic.

Contents of the Auto-Discovery Portlet

The Auto-Discovery portlet on the Hyperic Dashboard lists recently added or modified platforms and servers, and allows an authorized user to view discovery details, and to import the new or changed resource data to the Hyperic database.

By default, the Auto-Discovery portlet lists the (up to) five most recently new or changed platforms. To set the maximum number of platforms that can appear in the list, see Configure the Number of Auto-Discoveries Displayed.

A platform appears in the the Auto-Discovery portlet if it, or a server running on it, is new or changed. The rules are these:

  • The platform is new — A platform appears as new in the portlet, if neither its IP address or FQDN match that of an existing platform in inventory. In this case, any new servers discovered on the platform appear below the platform in the portlet.

  • The platform has a new server — A new server has been discovered on the platform since the last scan. The new server is listed below the platform.

  • Platform or server properties have changed — One or more inventory properties for the platform, or for one or more of the servers running it, have changed since the last scan. Servers with changed properties are listed below the platform.

The image below shows the Auto-Discovery portlet after the agent was started for the first time on a platform.


The Auto-Discovery portlet presents the following information for each platform it contains:

  • Hostname — The hostname of the platform is a link to a page — the Auto-Discovery Results page - that contains detailed information about the scan results for the platform and servers running there. See Using the Auto-Discovery Results Page.

  • Platform type — The resource type for the platform.

  • Status — Indicates the type of change that was detected for a resource, either "new" or "modified".

  • Changes — If the Status for a resource is "modified", the Changes column contains a summary of what changed. For example:

    • "server set changed" — Applies to platforms; this value indicates that changes to one or more servers on the platform were detected. The changed server(s) are listed below the platform.

    • "name change" — Indicates that the name of the resource has changed; a resource name can change when a resource is upgraded from one version to another, if version number forms a portion of the resource name, as is often the case.

    • "install path changed" — Indicates that the installation path for a server has changed; the installation path for a resource can change when a resource is upgraded from one version to another, if version number forms a portion of the path, as is often the case.

    • "IP set changed" — Indicates that the IP address has changed. When the agent detects an IP address not associated with an existing platform in inventory, it checks for a platform with a matching FQDN - if found, Hyperic recognizes the platform as existing.

    • "FQDN changed"

  • For each newly discovered or changed server on the platform:

    • Installation path

    • Status — Indicates "new" or "modified"

    • Changes — If Status is "modified", the Changes column contains a summary of what changed.

About Discovery and Import of Services

The Auto-Discovery Portlet does not display new or changed services. Serviced are discovered during a run-time scan and are automatically added to Hyperic inventory. For more information, see Resource Auto-Discovery Processes.

Import or Skip Resources in Auto-Discovery Portlet

You can process the contents of the Auto-Discovery Portlet in these ways:

  • To import all resources---leave all resources selected, and click Add to Inventory.

  • To skip all resources---leave all resources selected, and click Skip Checked Resources.

  • To import selected resources---Either:

    • De-select the resources you do not want to add to inventory, and click Add to Inventory, or

    • De-select the resources you do want to add to inventory and Skip Checked Resources.

About Skipped Resources

If you do not import a resource displayed in the Auto-Discovery portlet, note:

  • If you skip a new platform, you skip its servers as well.

  • During the next platform scan, skipped resources will reappear in the portlet after the next scan that detects them. If you have resources that you do not want the agent to discover, see the relevant section in Options for Running and Controlling Resource Discovery.

If the Hyperic Agent discovered all of the resource properties required to monitor a resource, it starts monitoring that resource as soon as you add it to inventory. This is the case for most resource types. Note however, that some level of configuration is required to start managing some resources types - see the Configuration Properties section on a resource's Inventory tab for configuration requirements.

Configure the Number of Auto-Discoveries Displayed

To set the number of completed auto-discoveries displayed in the portlet, click the gear icon in the upper left corner of the portlet. On the Display Settings page, select "10" or "all", and click OK.