Job Management Partner 1/Performance Management User's Guide

[Contents][Glossary][Index][Back][Next]

13.2.1 Configuring the health check function

Organization of this subsection
(1) Setting up the health check function
(2) Setting the health check agent properties

(1) Setting up the health check function

The following prerequisites must be met prior to using the health check function. If these prerequisite conditions are not met, you will not be able to use the health check function.

Monitoring the operating status of the host running the monitoring agent:
  • Version 08-11 or later of PFM - Manager and Web Console
  • Any version of PFM - Agent or PFM - RM
To monitor the operating status of a host monitored by PFM - RM, you must enable the status management function on the PFM - RM host. If the status management function is not enabled, the status of the remote agent is not recognized correctly.

Monitoring the operating status of the monitoring agent service:
The health check function uses the status management function to monitor the operating status of PFM - Agent services. For this reason, the product being monitored by the health check function must support the status management function. The prerequisite conditions for using the function are as follows. Any version of PFM - RM can be used.
  • Version 08-11 or later of PFM - Manager and Web Console
  • The version of PFM - Agent used supports the status management function.
  • The status management function on the PFM - Agent or PFM - RM host is enabled.
Unless the second and third conditions are satisfied, the health check function will be unable to check the status of PFM - Agent or PFM - RM. For details on the versions of PFM - Agent that support the status management function, see 13.3 Using the status management function to check service status. The following table describes support for operating status monitoring of services by PFM - Agent version.

Table 13-1 Support for operating status monitoring of services by PFM - Agent version

Status management function on monitored agent host Version of monitored agent Operating status monitoring of services
Enabled 07-00-01 or later Can be used
Enabled 07-00 or earlier#1 Cannot be used#2
Disabled n/a Cannot be used#3

Legend:
n/a: Not applicable.

#1
When PFM - Agent 07-00 or earlier is installed on the same host as PFM - Agent 07-00-01 or later or PFM - Base 08-00 or later, and the status management function is enabled on the target PFM - Agent host

#2
The operating status monitoring of the agent service appears as Not Supported.

#3
The operating status monitoring of the agent service appears as Unconfirmed.

For details on how to configure the status management function, see 13.3.1 Configuring the status management function.

To monitor the status of a host monitored by PFM - RM, you must enable polling with an appropriate PFM - RM property. For details on settings for PFM - RM polling, see (d) Setting PFM - RM polling.

(a) Enabling the health check function

To enable the health check function on the PFM - Manager host:

  1. Stop Performance Management services.
    If Performance Management services are running on a physical host, stop the services by using the following command:
     
jpcspm stop -key jp1pc
    To stop Performance Management services on a logical host, use the cluster software.

  2. Execute the jpcconf hc enable command
    To enable the health check function, use the following command:
     
jpcconf hc enable

  3. Check the status of the health check function.
    To confirm that the status of the health check function is available, use the following command:
     
jpcconf hc display

  4. Start Performance Management services.
    To start all Performance Management services on a physical host, use the following command:
     
jpcspm start -key jp1pc
    To start all Performance Management services on a logical host, use the cluster software.
    The service ID is 0A1host-name or 0S1host-name.

Note:

When one of the services you are starting is PFM - Manager, and the health check function is enabled on the PFM - Manager host, the health check agent starts as one of the PFM - Manager services when you execute the jpcspm start command. When you execute the jpcspm stop command to stop the PFM - Manager services, the health check agent also stops.

You cannot specify agt0 as the service key when you execute the jpcspm start or jpcspm stop commands.

(b) Disabling the health check function

To disable the health check function on the PFM - Manager host:

  1. Stop Performance Management services.
    If Performance Management services are running on a physical host, stop the services by using the following command:
     
jpcspm stop -key jp1pc
    To stop Performance Management services on a logical host, use the cluster software.

  2. Execute the jpcconf hc disable command.
    To disable the health check function, use the following command:
     
jpcconf hc disable

  3. Check the status of the health check function.
    To confirm that the status of the status management function is unavailable, use the following command:
     
jpcconf hc display
    If PFM - Manager is running in a logical host environment, execute the jpcconf hc display command on the PFM - Manager host on the executing or standby node.

  4. Start Performance Management services.
    To start all Performance Management services on a physical host, use the following command:
     
jpcspm start -key jp1pc
    To start all Performance Management services on a logical host, use the cluster software.

For details on each command, see the chapter describing the command in the manual Job Management Partner 1/Performance Management Reference.

(c) Checking the status of the health check agent

Use the jpctool service list command to check the status of the health check agent. You can also use the health check function to check the operating status of the health check agent. If the Agent Collector or Remote Monitor Collector service of the health check agent has terminated abnormally, the wrong health check results might be displayed.

(d) Setting PFM - RM polling

To monitor the status of a host monitored by PFM - RM, you must enable polling of the monitored host with an appropriate PFM - RM property. The following table describes the property to be set.

Table 13-2 Setting the polling property

Folder name Property name Description
Health Check Configurations Health Check for Target Hosts Specifies whether to perform polling to the monitored hosts. The default is No.
Yes: Performs polling.
No: Does not perform polling.

If polling is disabled, the operating status of the monitored host appears as Not Supported.

(2) Setting the health check agent properties

When the health check function is enabled, you can make settings related to the health check function, such as the collection interval for operation monitoring data and the monitoring level, by setting the properties of the health check agent from the Services tree of PFM - Web Console. The following table lists the health check agent properties you can set.

Table 13-3 Health check agent properties

Folder name Property name Description
Detail Records - HC Description Displays Health Check Detail as a description for the record.
Log Specifies whether to collect performance data. The default is No.
Yes: Collects performance data.
No: Does not collect performance data.
Collection Interval Specifies the collection interval in seconds, as a value in the range from 0 to 2,147,483,647. The default is 300. This value serves as the polling interval of the health check function.
Collection Offset Specifies the offset of the collection start time in seconds, as a value in the range from 0 to 32,767. The default is 0.
LOGIF Specifies the conditions for acquiring logs.
Health Check Configurations#1 Monitoring Level#2 Specifies the monitoring level. To monitor the operating status of the agent service, specify Service. To monitor the operating status of the agent host, specify Host. The default is Host.
Polling Interval Displays the polling interval. This value is taken from the Collection Interval in the PD_HC record.
Incl. Action Handler Specifies whether to include the Action Handler service when monitoring service operating statuses. The default is No.
Yes: The Action Handler service is monitored.
No: The Action Handler service is not monitored.
Busy as Inactive Specify whether agents whose service status remains Busy for extended periods should be considered inactive. The default is No. If you specify Yes, the Time to Busy as Inactive setting takes effect.
Yes: The agent is considered inactive#3.
No: The agent is not considered inactive.
You can check the service status of an agent in the Status column in the output of the jpctool service list command.
Time to Busy as Inactive Collector Specifies how long#3 busy statuses should persist for the Agent Collector and Remote Monitor Collector services before the services are considered inactive. Specify this item in seconds. The default is 300.
Time to Busy as Inactive Store Specifies how long#3 busy statuses should persist for the Agent Store and Remote Monitor Store services before the services are considered inactive. Specify this item in seconds. The default is 300.
Time to Busy as Inactive AH Specifies how long#3 a busy status should persist for the Agent Handler service before the service is considered inactive. Specify this item in seconds. The default is 300.

#1
When you change a setting in the Health Check Configurations folder, the new setting takes effect from the next polling interval.

#2
When you change the Monitoring Level setting, the health check results displayed in a realtime report of the health check agent differ according to whether polling under the new setting had taken place by the time the report was displayed.
Monitoring agent Displayed health check results
Monitoring agent for which polling under the new setting has completed The newest health check results recorded under the new setting
Monitoring agent for which polling under the new setting has not yet taken place The newest health check results recorded under the old setting
For this reason, the report may briefly display results from both the old and new settings.

#3
The length of time a service is in Busy status is calculated from the difference between the time when polling occurred (the time on the host running PFM - Manager) and the time when the status of the service changed to Busy (the time on the host running PFM - Agent or PFM - RM). Make sure that the clocks are synchronized on all hosts that run Performance Management services.

[Contents][Back][Next]

[Trademarks]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.