Storage Foundation Cluster File System High Availability 7.2 Administrator's Guide - Solaris

To display the I/O fencing registration keys

1. To display the key for the disks, run the following command:

   # vxfenadm -s disk_name

   For example:

   • To display the key for the coordinator disk /dev/rdsk/c1t1d0s2 from the system with node ID 1, enter the following command:

     # vxfenadm -s /dev/rdsk/c1t1d0s2
     key[1]:
      	[Numeric Format]:  86,70,68,69,69,68,48,48
     	 [Character Format]: VFDEED00
     *	[Node Format]: Cluster ID: 57069 Node ID: 0 Node Name: sys1

     The -s option of vxfenadm displays all eight bytes of a key value in three formats. In the numeric format,

     • The first two bytes, represent the identifier VF, contains the ASCII value 86, 70.

     • The next four bytes contain the ASCII value of the cluster ID 57069 encoded in hex (0xDEED) which are 68, 69, 69, 68.

     • The remaining bytes contain the ASCII value of the node ID 0 (0x00) which are 48, 48. Node ID 1 would be 01 and node ID 10 would be 0A.

     An asterisk before the Node Format indicates that the vxfenadm command is run from the node of a cluster where LLT is configured and is running.

   • To display the keys on a CVM parallel disk group:

     # vxfenadm -s /dev/vx/rdmp/disk_7
     
     Reading SCSI Registration Keys...
     
     Device Name: /dev/vx/rdmp/disk_7
     Total Number Of Keys: 1
     key[0]:
      	[Numeric Format]:  66,80,71,82,48,48,48,49
     	 [Character Format]: BPGR0001 
     	 [Node Format]: Cluster ID: unknown  Node ID: 1 Node Name: sys2

   • To display the keys on a Cluster Server (VCS) failover disk group:

     # vxfenadm -s /dev/vx/rdmp/disk_8
     
     Reading SCSI Registration Keys...
     
     Device Name: /dev/vx/rdmp/disk_8
     Total Number Of Keys: 1
     key[0]:
     	 [Numeric Format]:  65,86,67,83,0,0,0,0
     	 [Character Format]: AVCS
     	 [Node Format]: Cluster ID: unknown  Node ID: 0 Node Name: sys1

2. To display the keys that are registered in all the disks specified in a disk file:

   # vxfenadm -s all -f disk_filename

   For example:

   To display all the keys on coordinator disks:

   # vxfenadm -s all -f /etc/vxfentab
   
   Device Name: /dev/vx/rdmp/disk_9
   Total Number Of Keys: 2
   key[0]:
   [Numeric Format]:  86,70,70,68,57,52,48,49
   [Character Format]: VFFD9401
   * [Node Format]: Cluster ID: 64916 Node ID: 1   Node Name: sys2
   key[1]:
   [Numeric Format]:  86,70,70,68,57,52,48,48
   [Character Format]: VFFD9400
   * [Node Format]: Cluster ID: 64916 Node ID: 0   Node Name: sys1

   You can verify the cluster ID using the lltstat -C command, and the node ID using the lltstat -N command. For example:

   # lltstat -C
   57069

   If the disk has keys that do not belong to a specific cluster, then the vxfenadm command cannot look up the node name for the node ID, and hence prints the node name as unknown. For example:

   Device Name: /dev/vx/rdmp/disk_7
   Total Number Of Keys: 1
   key[0]:
     [Numeric Format]:  86,70,45,45,45,45,48,49
     [Character Format]: VF----01
     [Node Format]: Cluster ID: unknown  Node ID: 1  Node Name: sys2

   For disks with arbitrary format of keys, the vxfenadm command prints all the fields as unknown. For example:

     [Numeric Format]:  65,66,67,68,49,50,51,45
     [Character Format]: ABCD123-
     [Node Format]: Cluster ID: unknown Node ID: unknown 
            Node Name: unknown