fencevsd Command

Purpose

Prevents an application running on a node or group of nodes from accessing a virtual shared disk or group of virtual shared disks.

Syntax

fencevsd {-a | -v vsd_name_list} -n node_list

Description

Under some circumstances, the system may believe that a node has stopped functioning and begin recovery procedures, when the node is operational, but cut off from communication with other nodes running the same application. In this case, the problem node must not be allowed to serve requests for the virtual shared disks it normally serves until recovery is complete and the other nodes running the application recognize the problem node as operational. The fencevsd command prevents the problem node from filling requests for its virtual shared disks.

This command can be run from any node in the RSCT peer domain where the recoverable virtual shared disk subsystem is running.

Flags

-a: Specifies all virtual shared disks.
-v vsd_name_list: Specifies one or more virtual shared disk names, which are separated by commas.
-n node_list: Specifies one or more node numbers, which are separated by commas.

Parameters

logical_volume_name: Is the name of the logical volume that you want to specify as a virtual shared disk. This logical volume must reside on the global volume group indicated. The length of the name must be less than or equal to 15 characters.
global_group_name: Is the name of the globally-accessible volume group previously defined by the vsdvg command where you want to specify a virtual shared disk. The length of the name must be less than or equal to 31 characters.
vsd_name: Specifies a unique name for the new virtual shared disk. This name must be unique within the RSCT peer domain, and, in order to avoid possible future naming conflicts, should also be unique across the overall cluster. The suggested naming convention is vsdnngvg_name. The length of the name must be less than or equal to 31 characters.
Note: If you specify a vsd_name that is already the name of another device, the cfgvsd command is unsuccessful for that virtual shared disk. This error ensures that the special device files that are created for the name do not overlay and destroy files of the same name representing some other device type (such as a logical volume).

Security

You must have root authority to run this command.

Restrictions

You must issue this command from a node in the peer domain that has an active recoverable virtual shared disk subsystem.

Examples

To fence the virtual shared disks vsd1 and vsd2 from node 5, enter:

fencevsd -v vsd1,vsd2 -n 5

Location

/opt/rsct/vsd/bin/fencevsd