The vxfenadm Utility
Administrators can use the vxfenadm command to troubleshoot and test fencing configurations. The command's options for use by administrators are:
-g - read and display keys
-i - read SCSI inquiry information from device
-m - register with disks
-n - make a reservation with disks
-p - remove registrations made by other systems
-r - read reservations
-x - remove registrations
Registration Key Formatting
The key defined by VxVM associated with a disk group consists of seven bytes maximum. This key becomes unique among the systems when the VxVM prefixes it with the ID of the system. The key used for I/O fencing, therefore, consists of eight bytes.
Click the thumbnail above to view full-sized image.
The keys currently assigned to disks can be displayed by using the vxfenadm command. For example, from the system with node ID 1, display the key for the disk /dev/rdsk/c2t1d0s2 by entering:
# vxfenadm -g /dev/rdsk/c2t1d0s2
Reading SCSI Registration Keys...
Device Name: /dev/rdsk/c2t1d0s2
Total Number of Keys: 1
key[0]:
Key Value [Numeric Format]: 65,80,71,82,48,48,48,48
Key Value [Character Format]: APGR0000
The -g option of vxfenadm displays all eight bytes of a key value in two formats. In the numeric format, the first byte, representing the Node ID, contains the system ID plus 65. The remaining bytes contain the ASCII values of the letters of the key, in this case, "PGR0000." In the next line, the node ID 0 is expressed as "A;" node ID 1 would be "B."
|