Health check definition file

Format

To Page Top

File name

jbshc.conf

To Page Top

Storage destination directory

In Windows:

installation-folder\conf\jbshc\

shared-folder\jp1base\conf\jbshc\ (in a cluster system)

In UNIX:

/etc/opt/jp1base/conf/jbshc/

shared-directory/jp1base/conf/jbshc/ (in a cluster system)

To Page Top

Description

Specifies the host to be monitored and the process-monitoring interval as the behavior of the health check function.

To Page Top

Application of settings

Restart JP1/Base or execute the jbs_spmd_reload command to apply the settings.

To Page Top

Definition details

The following conventions apply to entries in the health check definition file (jbshc.conf).

• A hash mark (#) (code 0x23) at the start of a line indicates a comment.

• Do not enter a space or tab before or after an equal sign (=) or comma (,) or at the beginning or end of a line. If you enter either of these, the line will be ignored.

• Lines containing only a linefeed character are ignored.

[JP1_EVENT]

This section is about issuing JP1 events.

OUTPUT={YES | NO}

Specify whether to issue a JP1 event when a process is in an abnormal state. Specify YES or NO. The default is YES.

RECOVER={YES | NO}

Specify whether to issue a JP1 event when a process has recovered. Specify YES or NO. The default is YES.

RECOVER=YES is invalid if you have specified OUTPUT=NO.

[SYSLOG]

This section is about message output to the syslog or event log.

OUTPUT={YES | NO}

Specify whether to output a message to the syslog or event log when a process is in an abnormal state. Specify YES or NO. The default is YES.

RECOVER={YES | NO}

Specify whether to output a message to the syslog or event log when a process has recovered. Specify YES or NO. The default is YES.

RECOVER=YES is invalid if you have specified OUTPUT=NO.

[OTHER_HOSTS]

This section is about remote host monitoring.

INTERVAL=remote-host-monitoring-interval (seconds)

Specify the interval over which to monitor a remote host. The specifiable range is 60 to 7200 (seconds).

Estimate the monitoring interval as follows:

(number-of hosts-specified-in- the-HOST-parameter) x 3 (seconds)

Allow 3 seconds per host as the time required to monitor processes. The time might vary depending on the state of the network and the status of the monitored hosts.

If you set a monitoring interval that is shorter than this guideline, errors will be detected more quickly, but the health check function might not finish monitoring a remote host within the specified interval. In this case, the function waits until the previous monitoring round ends.

If you set a monitoring interval that is longer than this guideline, you can save network and OS resources, but error detection might be delayed.

The default is 300 (seconds).

If the message KAVA7219-W is output to the integrated trace log during a health check

The specified monitoring interval might be too short. Estimate the required monitoring interval using the following equation:

(current-interval) + ((KAVA7227-I-output-time - KAVA7219-W output-time) x 1.1)

STOP_CHECK={YES | NO}

Specify whether to monitor starting and stopping of monitored hosts. Specify YES or NO. If you omit this parameter, YES is assumed. If you do not specify a value, NO is assumed.

HOST=host-name1,host-name2,...

Specify the target remote hosts to be monitored. There is no need to specify this keyword if you want to monitor the local host only.

Delimit the host names with commas. You can specify multiple values for the HOST parameter. A maximum of 1,024 remote hosts can be specified. Hosts in excess of this maximum are not monitored.

To Page Top