@@ -27,21 +27,39 @@ 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.
-The action to perform. This value can be "on" or "off". 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. The
-"off" action will attempt to remove a key from the device(s). This
-option is required.
+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
+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.
The key to use for the current action. The key must be a hexadecimal
@@ -54,7 +72,9 @@ removed from the device(s).
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).
+the full path (eg. /dev/sdc). For all actions, if no devices are
+specified, fence_scsi_test will automatically use all devices found in
@@ -65,4 +85,4 @@ Print out a help message describing available options, then exit.
.SH SEE ALSO
-fence_scsi(8), fence(8), fence_node(8), sg_persist(8), lvs(8), lvm.conf(5)
+fence_scsi(8), fence(8), fence_node(8), sg_persist(8), vgs(8), lvm.conf(5)