Home > Veritas Storage Foundation™ Cluster File System Manual Pages

CFSCLUSTER (1M)

Maintenance Commands

Table of contents


NAME

cfscluster - Cluster File System cluster configuration command

SYNOPSIS

cfscluster config [ -t timeout ] [ -s ] | unconfig

cfscluster start

cfscluster stop [ -f ] [[node_name]... ]

cfscluster stop [ -f ] all

cfscluster status


AVAILABILITY

VRTScavf

DESCRIPTION

The cfscluster command configures or unconfigures Veritas Volume Manager (VxVM) cluster functionality (CVM) and the VxFS file systems on the nodes where CVM was configured. cfscluster can also start and stop CVM on a node and obtain status.

Cluster manager software must be up and connecting the cluster before you run cfscluster.

Only a privileged user can run this command.


KEYWORDS

config
The cfscluster config command needs to be run only once, and from only one node in the cluster. Configures and starts CVM on the nodes in a cluster (when the -s option is used). (Nodes are connected to each other by private network and are directly connected to a shared storage device.) config enables direct access to shared disks by the cluster nodes.

The cluster configuration is initialized with the list of nodes forming the cluster. When a node is taken out of the cluster, CVM is stopped on the node by the cluster manager. This means no access to the shared disks from that node. Similarly, when a node rejoins the cluster, CVM is started automatically on the specified node.

unconfig
Unconfigures the cluster set up among the nodes by removing the cluster configuration.
start
Starts the cluster manager on the local node. This joins the node to the cluster. On the local node, cfscluster start starts the cluster manager. If there are any cluster mounts associated with the node, the associated shared volume is mounted.
stop
Stops the cluster manager on the specified nodes, removing the nodes from the cluster. If a node_name is not specified, the cluster manager on the local node is stopped. Use stop all to stop the cluster manager on all nodes.

If a shared volume is mounted on the node, the command fails unless the force option, -f, is specified. If the force option is used, the shared volume is unmounted, then the cluster manager is stopped on that node.

status
Reports the status of cluster manager, the CVM state, and mount resources on all nodes in the cluster.

OPTIONS

-f
The force option unmounts any mounted shared volumes from all the nodes in the cluster. Use this option to unmount shared volumes before stopping the cluster. Caution: Be careful when using the -f option. If the unmount fails in presence of Storage Checkpoints, snapshots, or secondary-only mounts, the resources can fault.
-s
Start CVM. This option is used with config.
-t timeout
The timeout value is specified in seconds for CVM cluster reconfiguration. The CVM timeout value is the time the cluster manager would wait for joins to happen in case of reconfiguration. If the cluster joins does not happen in the time interval, it marks the resource as faulted or offline.

ARGUMENTS

node_name
List of nodes (linked by a private network) to stop the cluster manager. A node name is a machine name obtained using the uname -n command (see the uname(1) manual page).

RETURN VALUES

cfscluster returns an exit value of 0 if the command completes successfully, and a value greater than 0 if the command fails.

FILES

/etc/VRTSvcs/conf/sysname
File used by the cluster manager to identify cluster system names. Do not use a full domain name when listing systems.

EXAMPLES

To configure and start CVM on all nodes of a cluster with a timeout value of 200 seconds, enter:

 # 
cfscluster config -t 200 -s

SEE ALSO

hostname(1), uname(1), cfsdgadm(1M), cfsmntadm(1M), cfsmount(1M)

Last updated: 1 Aug 2008
Copyright ©2009 Symantec Corporation
All rights reserved.