This page last changed on Apr 20, 2010 by mmcgarry.

Resources > Browse

Topics marked with * relate to HQ Enterprise-only features.

Feedback is welcome. Click Add Comment at the bottom of the page.

About the Browse Page

Click Browse on the Resources tab in the masthead to display the Browse page.

The Browse page lists all or a subset of your managed resources of a selected inventory level. The default List View lists key property values and the current availability of each resource of the selected inventory level. Chart View charts the indicator metrics for each resource.

The controls on the Browse page allow you to navigate to resource of interest and manage you resource inventory.

Filter the Resource List

  1. Click an inventory type to display resources of that type:
    • Platforms
    • Servers
    • Services
    • Compatible Groups/Clusters
    • Mixed Groups
    • Applications
  2. Specify one or more filter criteria:
    • Name - Type part or all of the resource's name in Search. The search is case-insensitive.
    • Resource Type - Filter the list by resource type by selecting a type from the pull-down list.
    • Availability - Limit the list to unavailable resources by clicking Unavailable (not supported for Compatible Groups/Clusters or Mixed Groups).
    • Owner - Limit the list to resources owned by the user you are logged in as by checking Owned by.
    • match criteria - Click Any or All to list resources that meet all of the criteria, or those that meet any of the criteria, respectively.
  3. Click to run the search.

Navigation and View Options

Switch Between Chart and List View

To view indicator metric charts for each resource, click
in the upper right corner of the page.

To switch back to List View, click .

Navigate to a Resource

From either List View or Chart View, click the name of a resource to display its Monitor page.

From List View, click the M, I, or A icon next to the resource name to navigate to its Monitor, Inventory, or Alert page. If an icon does not appear for a resource, the associated page is not available for that resource type. For instance, there is no Monitor page for a Mixed Group.

Icon Action
"Monitor" page
Inventory page (for a platform, server, service, group, application)
"Alert" page
Indicates this feature is not available due to permissions.

About Breadcrumb Links

The breadcrumbs on resource pages in the HQ user interface ease the process of navigating among related resources and backtracking to previously viewed resources.

As of HQ 4.2, the breadcrumbs on a resource page reflect where the resource fits in a resource hierarchy. Breadcrumbs correspond to steps you took (resources you selected) to navigate down a resource hierarchy. For example, if you navigate to a service, starting at the top of the hosting hierarchy - by browsing to a platform and drilling down - the breadcrumbs are links to the platform and server you visited along the way:

Browse > PlatformName > ServerName > ServiceName

When you navigate to a resource that is outside the currently resource hierarchy, the breadcrumb trail is purged. For example, if you drill down to a service, as described above, and then navigate to an application that the service belongs to (from the service's  Inventory page) the breadcrumbs are purged and the application is your new starting point. Note that, when you jump outside the current hosting hierarchy, a link to the previously viewed resource appears - so you can get back to it easily, if you wish.  For example

Browse > ApplicationName
Return to ServiceName

Clicking Browse in the breadcrumb trail opens the Browse page for the inventory level (platform, server, or service) most recently browsed.  

Breadcrumbs Prior to HQ 4.2
Prior to HQ 4.2, the breadcrumbs on a resource page reflected the inventory level and resource type of the currently selected resource, in this form:
InventoryLevel > ResourceType > ResroureName 
For example, the breadcrumbs when you select a Linux platform with FQDN  "West10.demo.net" would be:
Platforms > Linux > West10.demo.net
The Platforms link opens the Browse page for all platforms; the Linux link opens the Browse page for platforms whose resource type is "Linux".

Create a Platform

Click New Platform in the Tools menu and proceed to the "New Platform" page.

Note: The only types of platforms you can create are non-discoverable platform, such as network devices or virtual hosts. Operating system platforms are auto-discovered by the HQ Agent, and can not be manually created.

Create an Application

Click New Application in the Tools Menu and proceed to the "New Application" page.

Create a New Group

To create a new group, click New Group in the Tools Menu and proceed to the "New Group" page.

Note: To create a group that contains one or more of the resources listed the Browse page, see the next section below.

Select and Add Platforms, Servers, or Services to a New or Existing Group

When the Browse page lists platforms, servers, or services, you can select one or more resource instances and add them to a new or an existing group.

  1. Click Platforms, Servers, or Services to list resources of that inventory type.
  2. Filter the list as desired.
  3. Checkmark desired resources and click .
    • The Group Manager popup lists any existing groups to which you can add the selected resources. The existing groups that appear take into account these facts about the resource instances you have selected:
      • Current membership in a group - Any group to which any of the currently selected resources is a member will not appear on the list.
        Any group to which one of the selected resources is already assigned is excluded from the
      • Types of the selected resources - If the selected resources are not all of the same type (for example, both "Linux" and "Win32" platforms are selected", only mixed groups appear in the list. If the currently selected resources are all the same type (for example "Linux") the list of groups will include any existing compatible groups for that type.
  4. You can add selected resources to existing group or create a new group:
    • To add the selected resources to an existing group, select the desired group and click Add to Existing Group.
    • To add the selected to new group, click Add to new Group, and follow the instructions in help for the New Group page.

Create a New Group of Groups

When the Browse page lists groups, you can select one or more resource instances and add them to a new group.

Note: You cannot add groups to an existing group from the Browse page. Instead, navigate the the group to which you wish to add a group, and click Add to List.

  1. Click Mixed Groups or Compatible Groups/Clusters.
  2. Filter the list as desired.
  3. Checkmark desired groups and click to display the New Group page.
  4. Follow the instructions in help for the New Group page.

Delete a Resource

To delete a resource from the HQ inventory, checkmark the resource and click .

The resource is permanently removed from the HQ inventory, and therefore cannot be monitored or controlled.

Note: In HQ 4.1 and later, resource deletion is asynchronous.

Resources you delete will disappear from the resource list immediately. Removal of the resources from the HQ database occurs asynchronously; there may be a slight delay before resources are removed from the database. If you restart agent prior to the resource is removed from the database, errors might occur if you re-add the resource to memory after the agent rediscovers it.

Do not try to re-import a platform immediately after deleting it - this may fail. Note also that until the delete process running in background completes, a deleted platform will still appear in the HQ Health's Agent tab. Similarly, the HQ license count displayed in the web user interface will not be decremented until the delete process is completed.

The delete process will timeout after 15 minutes. Incomplete delete processing can corrupt the HQ database. If wish to delete many resources at once, for example a platform with hundreds of servers or services, first increase the timeout period to ensure the processing has time to complete To increase the timeout period, increase the value of the TransactionTimeout attribute in HQ_SERVER_HOME/conf/templates/jboss-service.xml from 900 seconds to 9000 seconds or more, and restart the HQ Server.

Enable or Disable Alert Definitions

In HQ 4.1 and later, the Resource > Browse page allows you to enable or disable all alerts for one or more resources.

Checkmark desired resources, and click Enable All Alerts or Disable All Alerts.

Return to the Dashboard.

icon_hub_locked.png (image/png)
icon_hub_i.png (image/png)
icon_hub_c.png (image/png)
view_by_type.gif (image/gif)
icon_hub_m.png (image/png)
icon_hub_a.gif (image/gif)
dash-button_go-arrow.gif (image/gif)
tbb_group.gif (image/gif)
tbb_delete.gif (image/gif)
accept.png (image/png)
showlistview.png (image/png)
showchartview.png (image/png)
Document generated by Confluence on Apr 20, 2010 15:01