Displaying the I/O fencing registration keys

You can display the keys that are currently assigned to the disks using the vxfenadm command.

The variables such as disk_7, disk_8, and disk_9 in the following procedure represent the disk names in your setup.

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 Veritas 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