vxfenclearpre - Remove SCSI3 registrations and reservations from disks and Coordination Point servers.

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

VRTSvxfen

You can use the vxfenclearpre utility to clear all SCSI3 registration and reservation keys from the set of coordinator disks, Coordination Point servers, as well as the set of shared data disks. The utility only clears the keys on the CVM disk groups. It does not clear keys for private disk groups as their keys are cleared when the disk groups are imported.

You can also use the vxfenclearpre utility to clear registrations from coordination point servers (CP servers) for the current cluster. The local node from where you run the utility must have the UUID of the current cluster at the /etc/vx/.uuids directory in the clusuuid file. If the UUID file for that cluster is not available on the local node, the utility does not clear registrations from the coordination point servers.

For any issues you encounter with the vxfenclearpre utility, you can refer to the log file at, /var/VRTSvcs/log/vxfen/vxfen.log file.

Note: You can use the utility to remove the registration keys and reservations from the set of coordinator disks for any cluster you specify in the command, but you can only clear registrations of the current cluster from the CP servers. Also, you may experience delays while clearing registrations on the coordination point servers because the utility tries to establish a network connection with IP addresses used by the coordination point servers. The delay may occur because of a network issue or if the IP address is not reachable or is incorrect. Warning: 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 gets corrupted.

-t

Specify which keys need to be cleared. This option applies only for coordinator disks. For CP servers, the utility always removes registrations of the current cluster from the CP server. However, to remove registrations of other clusters from the CP server, you need to run the cpsadm utility on the CP server node. 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.

Consider a setup with three coordinator disks, two data disks, and two coordination point servers (CP servers).

coordinator disks : disk1 disk2 disk3
data disks : disk4 disk5
CP servers: [10.209.80.184]:50001 [10.209.75.118]:443

Coordinator disks and coordination point servers are listed in the file /etc/vxfentab and data disks are disks that are part of online shared disk groups.

Suppose the coordinator disks have keys as follows:

disk1: VFDEED01 VFBEAD01
disk2: VFDEED01 VFBEAD01
disk3: VFDEED01 ABCDEFGH

The data disks have keys as follows:

disk4: APGR0001 BPGR0001
disk5: ZZZZZZZZ BPGR0001

The CP servers have nodes registered as follows:

CP server1: [10.209.80.194]:50001: node1 (1)  node2 (0) (Cluster ID:57069)
CP server2: [10.209.75.118]:443: node1 (1) (Cluster ID:57069)

1.	vxfenclearpre -t cluster -c 57069 clears 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) CP server1: node1, node2 (Cluster ID: 57069) CP server2: node1 (Cluster ID:57069)
2.	vxfenclearpre -t vxfen clears the following keys disk1: VFDEED01 VFBEAD01 disk2: VFDEED01 VFBEAD01 disk3: VFDEED01 CP server1: node1, node2 (Cluster ID: 57069) CP server2: node1 (Cluster ID: 57069)
3.	vxfenclearpre -t all clears the following keys disk1: VFDEED01 VFBEAD01 disk2: VFDEED01 VFBEAD01 disk3: VFDEED01 ABCDEFGH CP server1: node1, node2 (Cluster ID: 57069) CP server2: node1 (Cluster ID: 57069)
4.	vxfenclearpre clears the following keys disk1: VFDEED01 VFBEAD01 disk2: VFDEED01 VFBEAD01 disk3: VFDEED01 ABCDEFGH disk4: APGR0001 BPGR0001 disk5: ZZZZZZZZ BPGR0001 CP server1: node1, node2 (Cluster ID: 57069) CP server2: node1 (Cluster ID: 57069)

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

Copyright (c) 2016 Veritas.

All rights reserved.