About the vxfenadm utility

Administrators can use the vxfenadm command to troubleshoot and test fencing configurations.

The command's options for use by administrators are as follows:


read and display keys 


read SCSI inquiry information from device 


register with disks 


make a reservation with disks 


remove registrations made by other systems 


read reservations 


remove registrations 

About the registration key format

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.

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/sdy by entering:

# vxfenadm -g /dev/sdy

Reading SCSI Registration Keys...

Device Name: /dev/sdy

SCSI ID => Host: 3 Channel: 0 Id: 9 Lun: 0

PRGeneration: -84

Total Number of Keys: 1


Key Value [Numeric Format]: 65,45,45,45,45,45,45,45

Key Value [Character Format]: A-------

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, "-------." In the next line, the node ID 0 is expressed as "A;" node ID 1 would be "B."

Verifying the nodes see the same disk

To confirm whether a disk (or LUN) supports SCSI-3 persistent reservations, two nodes must simultaneously have access to the same disks. Because a shared disk is likely to have a different name on each node, check the serial number to verify the identity of the disk. Use the vxfenadm command with the -i option to verify that the same serial number for the LUN is returned on all paths to the LUN.

For example, an EMC disk is accessible by the /dev/sdr path on node A and the /dev/sdt path on node B.

To verify that the nodes see the same disks

  1. Verify the connection of the shared storage for data to two of the nodes on which you installed Veritas Cluster Server.
  2. From node A, enter the following command:

    # vxfenadm -i /dev/sdr

    SCSI ID=>Host: 2 Channel: 0 Id: 0 Lun: E

    Vendor id : EMC

    Product id : SYMMETRIX

    Revision : 5567

    Serial Number : 42031000a

    The same serial number information should appear when you enter the equivalent command on node B using the /dev/sdt path.

    On a disk from another manufacturer, Hitachi Data Systems, the output is different and may resemble:

    SCSI ID=>Host: 2 Channel: 0 Id: 0 Lun: E

    Vendor id : HITACHI

    Product id : OPEN-3

    Revision : 0117

    Serial Number : 0401EB6F0002

    Refer to the vxfenadm(1M) manual page.