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 raw or 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 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

/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 raw device. A minimum of three disks must be configured in normal cases (except in the case of the [-s] option). Multiple paths can also be listed. 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:

 
  For Solaris: /dev/rdsk/c1t1d0s2

/dev/rdsk/c2t1d0s2

/dev/rdsk/c3t1d0s2

  For Linux: /dev/sdc

/dev/sdd

/dev/sde

  For HP-UX: /dev/rdsk/c1t1d0

/dev/rdsk/c2t1d0

/dev/rdsk/c3t1d0

  For AIX: /dev/rhdisk20

/dev/rhdisk21

/dev/rhdisk22

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. Atleast three coordination points must be used which can either be coordination point servers or coordinator disks. Multiple paths to the coordinator disks may also be listed. 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:

  For Solaris: security=1

[mycps.company.com]:14250

/dev/rdsk/c2t1d0s2

/dev/rdsk/c3t1d0s2

  For Linux: security=1

[mycps.company.com]:14250

/dev/sdd

/dev/sde

  For HP-UX: security=1

[mycps.company.com]:14250

/dev/rdsk/c2t1d0

/dev/rdsk/c3t1d0

  For AIX: security=1

[mycps.company.com]:14250

/dev/rhdisk21

/dev/rhdisk22

/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)


5.1.100.0 vxfenconfig (1M)