fence_scsi_test(8) - Linux man page

Name

fence_scsi_test - Test for SCSI persistent reservation fencing

Synopsis

fence_scsi_test -o <action> [options] [OPTIONS]

Description

fence_scsi_test is a script used to verify that specific hardware configurations are capable of being used with the fence_scsi agent. All storage devices that are to be used with the fence_scsi agent must be capable of SCSI persistent reservations. This script assists in determining that the requirements are met by performing appropriate SCSI-PR actions and verifying the results.

This script is capable of creating reservations and registrations, as well as removing them. The "on" action is used to create reservations, just as you would do when a node comes online. The "off" action is used to remove registrations, which is equivalent to fencing. It is important to test both the "on" and "off" actions when testing for fence_scsi compatibility. Note that at least two nodes will be required to test both the "on" and "off" actions.

Because this script is capable of creating, modifying, and removing existing reservations and registrations, it should not be used on any systems that are actively using SCSI persistent reservations.

Actions

-o, --action=[on|off|clear]
The action to perform. This value can be "on", "off" or "clear".

For "on", the script will attempt to register a key (see -k option) with the device(s) (see -d option) and create a reservation if none exists. This action requires a key to be specified with the -k option. Since registrations are created via the "register-and-ignore" subcommand, any existing registrations for the local node will be overwritten.

The "off" action will attempt to remove a key from the device(s). This action requires a key to be specified with the -k option. Since the registration key is removed via the "preempt-and-abort" subcommand, this action should not be used to remove a node's own key. The "off" action is intended to remove another node's key. Note that the node attempting to revoke a registration key from the device(s) must also be registered with the device(s).

The "clear" action will remove all registrations and reservations from the device(s). The key (-k option) is ignored for this action, but the node attempting to clear the device(s) must be registered with the device(s). Do not use this action on a operational cluster.

Options

-k, --key=VALUE
The key to use for the current action. The key must be a hexadecimal value and should be unique to a node. For the "on" action, the key specifies the key value use to register the local node with the device(s). For the "off" action, the key specifies the key value to be removed from the device(s).
-d, --devices=LIST
List of devices to use for current action. This can be a single device or a comma-separated list of devices. Each device should be given as the full path (eg. /dev/sdc). For all actions, if no devices are specified, fence_scsi_test will automatically use all devices found in cluster volumes.
-h, --help
Print out a help message describing available options, then exit.
-v, --verbose
Verbose output.

See Also

fence_scsi(8), fence(8), fence_node(8), sg_persist(8), vgs(8), lvm.conf(5)