5.4 Setting Up Fault Resource Identification and Operator Intervention Request

The fault resource identification is a function that outputs a message to syslogd(1M) and Cluster Admin and a history of failed resources to Resource Fault History if a failure occurs in a resource or node that is registered to a cluster application.

After setting the initial configuration of the resource database, specify the settings for enabling fault resource identification and operator intervention request. An example of a message displayed by fault resource identification is shown below.

6750 A resource failure occurred.  SysNode:node1RMS userApplication:app0 Resource:apl1

The operator intervention request function displays a query-format message to the operator if a failed resource or a node in which RMS has not been started is found when a cluster application is started. The messages for operator intervention requests are displayed to syslogd(1M) and Cluster Admin.

1421 userApplication "app0" was not started automatically because all SysNodes that 
make up userApplication were not started within the prescribed time.
Forcibly start userApplication in SysNode "node1RMS"? (no/yes)

Message number: 1001
Warning: When userApplication is forcibly started, the safety check becomes disabled. 
If the operation is used incorrectly, data may be damaged and the consistency may be lost. 
Check that userApplication to be forcibly started is not online in the cluster before executing the forced startup.

See

For details on the messages displayed by the fault resource identification function and the messages displayed by the operator intervention request function, see "D.7.2 Failed Resource and Operator Intervention Messages (GUI)" and "D.5 Operator Intervention Messages".

This section describes procedures for operating fault resource identification and operator intervention request.

Note

After PRIMECLUSTER is installed, fault resource identification and operator intervention request are initially disabled. The following Cluster Admin functions are also disabled:
- Messages for fault resource identification and operator intervention request are not displayed to Cluster Admin.
- The list of resources that are currently affected by faults is not displayed in the Resource Fault History screen of Cluster Admin.
- The fault history of the resources is not displayed in the Resource Fault History screen of Cluster Admin.
To view the manual pages of each command, add "/etc/opt/FJSVcluster/man" to the MANPATH variable.

Enabling the operation of fault resource identification and operator intervention request

Execute the "clsetparam(1M)" command and specify the settings for enabling the fault resource identification and operator intervention request. Execute this procedure in any node that is part of the cluster system.
```
# /etc/opt/FJSVcluster/bin/clsetparam -p AppWatch ON
```
Execute the "clsetparam(1M)" command, and check that the parameters are set so that the operation of fault resource identification and operator intervention request is enabled. Execute this procedure on any node that is part of the cluster system.
```
# /etc/opt/FJSVcluster/bin/clsetparam -p AppWatch
```
```
ON
```
Restart all the operating nodes.
If a node is stopped, the fault resource identification and operator intervention request begin operating in that node from the next node reboot.

Disabling the operation of fault resource identification and operator intervention request

To cancel the setting previously made for "Enabling the operation of fault resource identification and operator intervention request," perform the following procedure:

Execute the "clsetparam(1M)" command and specify the settings for disenabling the fault resource identification and operator intervention request. Execute this procedure in any node that is part of the cluster system.
```
# /etc/opt/FJSVcluster/bin/clsetparam -p AppWatch OFF
```
Execute the "clsetparam(1M)" command, and check that the parameters are set so that the operation of fault resource identification and operator intervention request is disenabled. Execute this procedure on any node that is part of the cluster system.
```
# /etc/opt/FJSVcluster/bin/clsetparam -p AppWatch
```
```
OFF
```
Restart all the operating nodes.
If a node is stopped, the fault resource identification and operator intervention request stop operating in that node from the next node reboot.