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 The userApplication "userApplication" did not start automatically because not all of the nodes
where it can run are online.
Forcing the userApplication online on the SysNode "SysNode" is possible.
Warning: When performing a forced online, confirm that RMS is started on all nodes in the cluster, manually shutdown any nodes where it is not started and then perform it. For a forced online, there is a risk of data corruption due to simultaneous access from several nodes. In order to reduce the risk, nodes where RMS is not started maybe forcibly stopped.
Are you sure wish to force online? (no/yes) Message No: 1001

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.