Home > Veritas Cluster Server Manual Pages

VXFENADM (1M)

Maintenance Commands

Table of contents


NAME

vxfenadm - Manage SCSI-3 disk registrations and reservations for I/O fencing and display information on I/O fencing operations.

SYNOPSIS

vxfenadm -G diskpath | -G all -f disk_filename

vxfenadm -R diskpath | -R all -f disk_filename

vxfenadm -m -k|K key -f disk_filename

vxfenadm -n -k|K key -f disk_filename

vxfenadm -x -k|K key -f disk_filename

vxfenadm -p -k|K key -f disk_filename -v victim_node_key

vxfenadm -g diskpath | -g all -f disk_filename

vxfenadm -r diskpath | -r all -f disk_filename

vxfenadm -t diskpath

vxfenadm -i diskpath

vxfenadm -d diskpath

vxfenadm -h


AVAILABILITY

VRTSvxfen

DESCRIPTION

The vxfenadm utility enables the vxfen driver to manage SCSI-3 registrations and reservations on disks for purposes of I/O fencing. In the event of a split-brain condition, I/O fencing allows only a system with a valid registration to write to a disk. Thus, I/O fencing prevents data corruption on the disks. System administrators can use the -m, -n, -x, -p, -g, and -r flags to validate the accessibility of the disks and to perform troubleshooting tasks; these options do not actually implement fencing. NOTE: While using -x and -p options, make sure I/O fencing is not configured; these options will overwrite valid keys used by VxVM. A disk_filename contains the list of all disks and each path (in the event of multiple paths) in a disk group. If administrators use the -p, -m, -n, or -x options, the key is 8-bytes whatever the user supplies. Administrators can use the utility to display state information, registration and reservation information, and key definitions. The vxfenadm utility supports both character and numeric key formats. Character Key Format -k key key is a character string. If key is less than 8 bytes in length, then vxfenadm will append it with - (hyphen). For keys shorter than 8 bytes, use -K KEY where KEY is in the numeric (ascii value) format. Numeric Key Format -K KEY KEY is in numeric (ascii value) format. For example, the equivalent numeric format for the key APGR000 is 65,80,71,82,48,48,48,0. Because the key is seven bytes long, 0 is used for the eighth byte.

OPTIONS

-k
The key consisting of eight bytes defined for this set of disks.
-K
Same as -k, but in numeric sequence.
-f
Option flag preceding the name of the file, disk_filename, that contains all of the fully qualified path(s) to each disk; a disk can be accessible by multiple paths.
-t
Issue SCSI TEST UNIT command and return 0 if successful.
-p
Removes the registrations and reservations made for disks in disk_filename made with key used by the victim node (-v victim_node_key).
-v
Key used by the victim node to register/reserve disks.
-m
Registers with the disks in disk_filename.
-n
Reserves with the disks in disk_filename.
-x
Unregisters with the disks in disk_filename.
-g
Reads the keys registered on a disk specified by diskpath or reads the keys which are registered on all disks listed in disk_filename. Keys are displayed in numeric and character format.
-G
Reads the keys on a disk and if possible prints node ID based on first byte of the key. Specify a diskpath or a disk_filename (a listing of paths), and print formatted results.
-r
Reads the reservations on a disk specified by diskpath or reads the reservations on all disks listed in disk_filename.
-R
Reads the reservations on a disk specified by diskpath or reads the reservations on all disks listed in disk_filename, and print the results in numeric format.
-i
Reads the SCSI inquiry information from the disk listed in diskpath.
-d
Displays cluster-wide system state.
-h
Displays the usage for vxfenadm command.

EXAMPLES

If you enter the following command to register a key AVCS:
# vxfenadm -m -k AVCS -f disk_filename
-k AVCS will convert the key to AVCS---- before the SCSI-3 command is issued to the device. AVCS will register as AVCS---- on the disk. The same holds for other SCSI-3 commands. If you try to unregister a key with character format that is less than 8 bytes, the unregistration fails. For example: Read the keys registered on a disk using the following command:
# vxfenadm -g all -f disk_filename
Device Name: <diskpath>
Total Number Of Keys: 2
key[0]: Key Value [Numeric Format]: 65,80,71,82,48,48,48,0 Key Value [Character Format]: APGR000
If you unregister the key using the following command, the unregistration fails:
# vxfenadm -x -k APGR000 -f disk_filename
VCS FEN vxfenadm ERROR V-11-2-1204 Command 0 FAILED for: diskpath
VCS FEN vxfenadm ERROR V-11-2-1120 Unregistration FAILED for: diskpath
VCS FEN vxfenadm ERROR V-11-2-1133 Error returned
In this case, the key registered on the disks is APGR000. But the vxfenadm command implicitly converted the key to APGR000-. Hence the unregistration failed. The unregistration will succeed with the numeric format. To successfully unregister the key, enter the following command:
# vxfenadm -x -K 65,80,71,82,48,48,48,0 -f disk_filename
VCS FEN vxfenadm NOTICE Deleted the key:[APGR000] from device diskpath

SEE ALSO

vxfenconfig(1M), vxfentsthdw(1M), vxfendebug(1M), vxfenmode(4M), vxfenclearpre(1M)

Last updated: Jan 2009
Copyright ©2009 Symantec Corporation
All rights reserved.