VXFENCTL(1M)

NAME

vxfenctl - VCS I/O Fencing (vxfen) Control Utility

SYNOPSIS

vxfenctl -a action -p parameter [-v value | -f filename] [-n]

AVAILABILITY

VRTSvxfen

DESCRIPTION

vxfenctlis provided to facilitate VxFEN configuration and parameter control.

This utility is used for various configuration related actions on a running cluster. It takes an action specified by the -a option and performs it on one or more nodes of the cluster.

set_param: with this action, vxfenctl takes a parameter specified by the -p option. If the parameter is expected to take the same value clusterwide, then the value should be specified using the -v option. Otherwise if the parameter is expected to take a different value on each cluster node then a list of values for the parameter for each node should be mentioned in the file specified by the -f option. The utility uses the vxfenconfig(1M) command to change this given parameter in the vxfen driver for the entire cluster. To make these modifications persistent, vxfenctl updates the VxFEN configuration file /etc/vxfenmode on each node in the cluster.

SSH/SCP are used for communication between nodes by default. Please ensure they are configured properly before using vxfenctl. Non-secure RSH/RCP can be used by specifying the -n option.

OPTIONS

-a action
  This option is used to specify an action (Currently the only supported action is: set_param)
-p parameter
  This option is used to specify a parameter (The supported paramaters are: race_policy, node_weight)
-v value
  This option is used to specify a clusterwide value for the given parameter. This option cannot be used with parameters such as node_weight which are specific to a particular node. Use the -f option instead.
-f filename
  This option is used to specify the configuration parameter file with each line containing a single tab separated node id and parameter value pair. This option cannot be used with parameters such as race_policy which need to have the same value clusterwide. Use the -v option instead. For example, when parameter is node_weight, specify the node id and node weights in weight_file with each line containing a single tab separated node id and node weight pair.
-n This option is used to enable non-secure communication using RSH/RCP.

EXAMPLES

1. To set node weights as specified in the file /tmp/weighttab using rsh for communication:

# cat > /tmp/weighttab
0 20
1 100

# vxfenctl -a set_param -p node_weight -f /tmp/weighttab -n

Note: vxfenctl makes this change persistent by automatically editing /etc/vxfenmode on all nodes and saving the node weight
2. To set race policy to weight using ssh (by default) for communication:

# vxfenctl -a set_param -p race_policy -v weight

Note: vxfenctl makes this change persistent by automatically editing /etc/vxfenmode on all nodes and saving the race policy.

SEE ALSO

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

COPYRIGHTS

Copyright (c) 2016 Veritas.

All rights reserved.


VCS 7.1 VXFENCTL(1M)