vxfenswap - Assist online replacement of coordination points.

vxfenswap -g diskgroup [ -n ] [ -a autoconfirm ] vxfenswap [ -n ] [ -a autoconfirm ] vxfenswap -a cancel [ -n ]

VRTSvxfen

The vxfenswap utility changes the coordination points that are used for arbitration in the event of a network partition. This change happens on a running cluster. For online coordination point migration to/within scsi3 mode, the utility uses diskgroup specified with -g option to create the new list of coordinator disks. For online coordination point migration to/within customized mode, the utility uses coordination points (servers or disks) specified in /etc/vxfenmode.test file to create new list of coordination points. If the new set of coordination points contain coordination points server(s), then prior to using this utility, the coordination point server(s) should be properly set up to serve as coordination points with the VCS cluster. Please see vxfenmode(4M) to understand how to specify the servers and diskgroup to be used as coordination points and section "Preparing CP servers manually for use by VCS cluster" of "Veritas Cluster Server Installation Guide" for details on how to set up coordination point servers to serve the VCS cluster. The online migration process will fail if any of the cluster nodes is not able to register with a majority of the coordination points. This utility uses /etc/vxfenmode.test file to get the new fencing mode and disk policy from the user (so as to pick raw paths or DMP (Dynamic Multipathing) paths for the coordinator disks). This utility uses vxfenconfig command to change the coordinator points and/or fencing mode in the vxfen driver. The utility picks up the nodes of the cluster by looking at the file /etc/llthosts and picking those nodes that have fencing configured. The nodes can also be specified in the file /etc/vxfen_nodelist. This utility makes use of ssh and scp to communicate with the nodes. Please make sure the communication is set up properly before using this utility. Instead of ssh and scp, rsh and rcp can be used for communication by specifying the -n option. WARNING: After this utility is executed, it is possible that the whole cluster will panic if any node leaves the cluster membership before this utility returns successfully.

-g diskgroup	Use diskgroup specified with -g option. Applicable only for online migration to/ within scsi3 mode.
-n	Use non-secure communication. By default, the vxfenswap utility makes use of ssh and scp to communicate with nodes. When this option is specified, this utility will use rsh and rcp for communication.
-a autoconfirm
	Automatically commit the replacement operation without prompting for confirmation. If this option is not specified, the vxfenswap utility prompts for confirmation before changing the coordination points in the vxfen driver.
-a cancel	Rollbacks any previously incomplete online coordination point replacement operation.

For online migration from customized to scsi3 mode with disk group vxfencoorddg:
	1. Copy sample vxfenmode file for scsi3 (e.g. /etc/vxfen.d/vxfenmode_scsi3_dmp) to /etc/vxfenmode.test on local node. 2. Run vxfenswap with the following options vxfenswap -g vxfencoordg
For online migration from scsi3 to customized mode:
	1. Use the sample vxfenmode file for cps (/etc/vxfen.d/vxfenmode_cps) to create /etc/vxfenmode.test on all cluster nodes. 2. Run vxfenswap with the following options vxfenswap
For swapping coordinator disks with disk group vxfencoorddg in scsi3 mode:
	1. Copy /etc/vxfenmode to /et/vxfenmode.test on local node. 2. Run vxfenswap with the following options vxfenswap -g vxfencoordg
For swapping coordination points in customized mode:
	1. Use the sample vxfenmode file for cps (/etc/vxfen.d/vxfenmode_cps) and edit it to contain the new set of coordination points. This has to be done on all the cluster nodes. 2. Run vxfenswap with the following options vxfenswap

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