test veritas logo


VXFENCONFIG(1M)

NAME

vxfenconfig - Configure the vxfen driver used in I/O fencing.

SYNOPSIS

vxfenconfig -c [-s]

vxfenconfig -v

vxfenconfig -U

vxfenconfig -l

vxfenconfig -W

vxfenconfig -R

vxfenconfig -a

AVAILABILITY

VRTSvxfen

DESCRIPTION

The vxfenconfig command configures the vxfen driver using parameters found in /etc/vxfenmode file. For a list of possible parameters and usage information please see the manpage for /etc/vxfenmode file. If this file is omitted I/O Fencing defaults to SCSI3 functionality.

vxfenconfig command configures the vxfen driver using the coordination points listed in the /etc/vxfentab file. Disks must be listed by the full file name of the DMP device. A minimum of three coordination points must be used (unless the -s option is specified to configure the driver in scsi3 mode); in total, an odd number of coordination points must be used.

OPTIONS

-c Configure the vxfen driver.
[-s] Configure the vxfen driver for use with only a single coordinator disk. The default (and Veritas recommendation) is three coordinator disks.

This option is applicable only in scsi3 mode.

Warning: When I/O fencing is configured to use only one coordinator disk, the loss of the single coordinator disk results in the loss of the availability of all applications in the cluster.
-U Unconfigure the vxfen driver.
-v|V Print out the version information.
-l List the coordination points used by vxfen driver.
-W List current and supported protocol versions.
-R Roll upgrade vxfen to start operating at the highest possible protocol version that can be used by all nodes in the cluster.
-a List the node weights currently set in the vxfen driver.

FILES

o

/etc/vxfentab

Note: This file is automatically created by VxFEN rc scripts, and should not be edited by the user. In scsi3 mode, the file contains the list of coordinator disks, each of which is identified by the full file name of the device. A minimum of three disks must be configured in normal cases (except in the case of the [-s] option). The /etc/vxfentab file is created by the rc script based on the contents of the /etc/vxfendg file. An example /etc/vxfentab file may contain the following lines:

/dev/vx/rdmp/disk_0
/dev/vx/rdmp/disk_1
/dev/vx/rdmp/disk_2

In customized mode with cps mechanism, the file contains the security mode for communication with the coordination point servers together with the coordinator disks. Coordination points can be a combination of coordination points servers and coordinator disks. At least three coordination points must be used which can either be coordination point servers or coordinator disks. In customized mode, the /etc/vxfentab file is created by the rc script based on the contents of the /etc/vxfenmode file.

An example /etc/vxfentab file in customized mode with cps mechanism may contain the following lines:

security=1
[mycps.company.com]:14250
/dev/vx/rdmp/disk_0
/dev/vx/rdmp/disk_1

o

/etc/vxfendg

Contains the name of the disk group containing the coordinator disks. Typically, this disk group is vxfencoorddg. /etc/vxfendg must exist on each system in the cluster. The file is applicable only when the mode of fencing is SCSI3.

EXAMPLES

1. To configure vxfen :

# vxfenconfig -c

2. To unconfigure vxfen :

# vxfenconfig -U

3. To list coordination points used by vxfen :

# vxfenconfig -l

4. To list current and supported protocol versions :

# vxfenconfig -W

5. To roll upgrade vxfen to the highest clusterwide protocol version :

# vxfenconfig -R

6. To list node weights :

# vxfenconfig -a

7. To run I/O Fencing in disabled mode, add the following line to /etc/vxfenmode

vxfen_mode=disabled

Warning: Veritas does not support SFRAC clusters using I/O fencing in the disabled mode (vxfen_mode=disabled).
8. To run I/O Fencing in customized mode using a combination of one coordination point server & coordinator disks, add the following to /etc/vxfenmode

vxfen_mode=customized
vxfen_mechanism=cps
scsi3_disk_policy=dmp
cps1=[192.168.0.23]:14250
vxfendg=vxfencoorddg

SEE ALSO

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


VCS 7.4.3 VXFENCONFIG(1M)