vxfenclearpre (1M)

NAME

vxfenclearpre - Remove SCSI3 registrations and reservations from disks.

SYNOPSIS

vxfenclearpre [ -t all | -t vxfen | -t cluster -c clusterid ]

AVAILABILITY

VRTSvxfen

DESCRIPTION

The vxfenclearpre utility provides a user with a way to easily clear all SCSI3 registration and reservation keys from the set of coordinator disks as well as the set of shared data disks. This applies to CVM Disk Groups only, as Private Disk Groups have their keys cleared when the disk groups are imported.

WARNING: Please exercise caution and make sure that there are no other active nodes in the cluster when running this. If there are other nodes present and accessing shared storage, data corruption will result!

OPTIONS

-t Specify which keys need to be cleared. This option applies only for coordinator disks.
all clear all keys from the coordinator disks
vxfen clear all vxfen keys (which match the VF prefix) from the coordinator disks
cluster clear only vxfen keys which match clusterid from the coordinator disks clusterid should be a decimal number between 0 and 65535

EXAMPLES

Consider a setup with 3 coordinator disks and 2 data disks.

coordinator disks : disk1 disk2 disk3
data disks : disk4 disk5
coordinator disks are disks listed in the file /etc/vxfentab and the data disks are disks which are part of online shared disk groups.
Suppose the coordinator disks have keys as follows
 
  disk1: VFDEED01 VFBEAD01
disk2: VFDEED01 VFBEAD01
disk3: VFDEED01 ABCDEFGH
and the data disks have keys as follows
  disk4: APGR0001 BPGR0001
disk5: ZZZZZZZZ BPGR0001
1. vxfenclearpre -t cluster -c 56079 will clear the following keys
  disk1: VFDEED01 (Cluster ID: 57069 Node ID: 1)
disk2: VFDEED01 (Cluster ID: 57069 Node ID: 1)
disk3: VFDEED01 (Cluster ID: 57069 Node ID: 1)
2. vxfenclearpre -t vxfen will clear the following keys
  disk1: VFDEED01 VFBEAD01
disk2: VFDEED01 VFBEAD01
disk3: VFDEED01
3. vxfenclearpre -t all will clear the following keys
  disk1: VFDEED01 VFBEAD01
disk2: VFDEED01 VFBEAD01
disk3: VFDEED01 ABCDEFGH
4. vxfenclearpre will clear the following keys
  disk1: VFDEED01 VFBEAD01
disk2: VFDEED01 VFBEAD01
disk3: VFDEED01 ABCDEFGH
disk4: APGR0001 BPGR0001
disk5: ZZZZZZZZ BPGR0001

SEE ALSO

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


VCS 5.1 SP1 vxfenclearpre (1M)