cfsmntadm (1M)

NAME

cfsmntadm - add, delete, modify, and set policy on cluster mounted file systems

SYNOPSIS

cfsmntadm add [ -D ] shared_disk_group shared_volume
mount_point [ service_group_name ] node_name=[ mount_options ] ...

cfsmntadm add shared_disk_group shared_volume mount_point

[ service_group_name ] all=[ mount_options ]
[ [ node_name ] ... ]

cfsmntadm add ckpt ckpt_name mount_point ckpt_mount_point

all=[ mount_options ]
[ [ node_name ] ... ]

cfsmntadm add snapshot shared_disk_group shared_volume

mount_point snapshot_mount_point
node_name=[ mount_options ]

cfsmntadm delete [ -f ] device_path

cfsmntadm delete [ -f ] mount_point

cfsmntadm display [ -v ] { node_name | mount_point }

cfsmntadm modify mount_point node_name=[ mount_options ...]

cfsmntadm modify mount_point node_name+=mount_options ...

cfsmntadm modify mount_point node_name-=mount_options ...

cfsmntadm modify mount_point all=[ mount_options ]

cfsmntadm modify mount_point all+=mount_options

cfsmntadm modify mount_point all-=mount_options

cfsmntadm modify mount_point add node_name=[ mount_options ...]

cfsmntadm modify mount_point delete node_name ...

cfsmntadm modify device_path vol new_volume_name

cfsmntadm modify mount_point vol new_volume_name

cfsmntadm setpolicy mount_point [ [ node_name ] ... ]

cfsmntadm vxtunefs args

AVAILABILITY

VRTScavf

DESCRIPTION

The cfsmntadm command is the cluster mount administrative interface for Veritas Cluster File Systems. Using cfsmntadm you can add, delete, display, modify, and set the primary election policy on cluster mounted file systems.

A shared disk group and shared volume must already be created, and a VxFS file system must exist on the volume, before using this command.

Only a privileged user can run this command.

KEYWORDS

add Adds a shared volume (cluster file system) to the cluster by associating it with the mount point on the specified nodes. cfsmntadm add adds this information (also referred to as the cluster mount instance) to the cluster configuration. The shared volume is automatically mounted when the nodes come up and join the cluster. To explicitly mount a shared volume on a node, use the cfsmount command.
A shared volume (cluster file system) can be associated with all the nodes in the cluster, or with a subset of nodes within the cluster. The shared volume must be associated with a node in order for cfsmount to mount the volume on that node. You can add or delete nodes from the list of nodes to which a shared volume is associated by using the cfsmntadm modify command.
cfsmntadm add returns 4 if the cluster mount point definition already exists, or returns another value greater than 0 if the cluster mount point cannot be added.
Note: After the cluster mount instance is set, the mount_point associated with it is used by other commands, such as cfsmount.
ckpt Adds a Storage Checkpoint mount instance to the cluster configuration and sets up a dependency between the Storage Checkpoint instance and the parent instance. The parent mount instance must exist at the time the Storage Checkpoint instance is created. cfsmntadm does not create the Storage Checkpoint. See the fsckptadm(1M) manual page for information on creating Storage Checkpoints. You can mount the Storage Checkpoint instance using the cfsmount command.
snapshot
  Adds a snapshot mount instance to the cluster configuration and sets up a dependency between the snapshot instance and the parent instance. The parent mount instance must exist at the time the snapshot instance is created. You can mount the snapshot instance using the cfsmount command. See the mount_vxfs(1M) manual page and the Veritas File System Administrator’s Guide for information on creating snapshots.
delete
  Deletes the cluster mount instance by dissociating the shared volume (cluster file system) from the mount point on various nodes. cfsmntadm delete also removes the definition of a cluster mount instance from the cluster configuration that was previously added by cfsmntadm add. After a cluster mount is deleted, the shared volume cannot be mounted by the cfsmount command. Deleting a mount instance can fail if it is mounted, or if it is the parent of a Storage Checkpoint or snapshot mount instance. NOTE: The cfsmntadm delete command offers two ways to delete: by specifying a mount point or by specifying a device path. Either method has the same result.
modify
  Changes the mount options for a cluster mount. If the shared volume is already mounted on a node for which the mount options have to be changed, the shared volume is remounted. Otherwise, changed mount options take effect at the next mount operation. Note: If the deleted node is the last node associated with a cluster mount, running the cfsmntadm modify delete command results in the cluster mount not being associated with any node in the cluster. The cluster mount instance definition is still saved. Nodes can be reattached to it using cfsmntadm modify. An instance of cluster-wide mount cannot be removed except with the cfsmntadm delete command. The cfsmntadm modify vol option must be used after renaming a volume with the vxedit command. The vol option updates the cfsadmin framework after renaming the affected volume.
display
  When used with the mount_point argument, displays the cluster file system properties associated with a mount point. The following are displayed for a shared volume or a mount point:
 
o Name of the shared volume
o Name of the shared disk group to which the shared volume belongs
o List of nodes on which the shared volume can be mounted
o List of nodes on which shared volume is currently mounted
o Mount options for each node
o Primary node for the file system mounted at mount_point
o Displays the primary election policy, if any, for the file system
When used with the node_name argument, displays the list of shared volumes mounted on the specified node. The following are displayed for each mounted shared volume:
 
o Name of the shared volume
o Type of mount point
setpolicy
  Sets the primary election policy for a cluster file system. node_name is a list of nodes that can assume the primaryship for the file system mounted at mount_point. If no node is specified, the current policy for mount_point is nullified.
vxtunefs
  Issues the vxtunefs command with the specified arguments on all nodes in the cluster. See the vxtunefs(1M) manual page for the possible arguments.

OPTIONS

-f Forces deletion of cluster mount instance.
-v Specifies verbose mode.
-D Deep I/O monitor the volume used for the file system

ARGUMENTS

all=mount_options
  Some mount options can be specified for all nodes. See the mount_vxfs(1M) manual page for information on mount options applicable to cluster file systems.
all+=mount_options
  Appends the specified mount options to the existing mount options for all nodes.
all-=mount_options
  Removes the specified mount options from the existing mount options for all nodes.
device_path
  The VxVM block or raw device path corresponding to the specified mount point.
mount_point
  Path name of the directory on which the shared volume must be cluster mounted. All the nodes in the cluster mount the shared volume at this mount point.
node_name
  List of node names on which the shared volume can be mounted. These nodes must be part of the cluster or the request fails for that node. If no node names are specified, the cluster mount is attached with all the nodes in the cluster.
node_name=mount_options ...
  Specifies mount options for each node.
node_name+=mount_options ...
  Appends the specified mount options to the existing mount options of the specified node.
node_name-=mount_options ...
  Removes the specified mount options from the existing mount options of the specified node.
shared_disk_group
  Name of the Veritas Volume Manager (VxVM) shared disk group.
service_group
  The service group in which the mount instances are created. It is not necessary to specify a service group unless you want to control where the mount instances are created.
shared_volume
  Name of the VxVM shared volume.

EXAMPLES

You can use either of the following two commands to change a cluster configuration to add a cluster mount point /mnt1, associated with the shared disk group sharedg and the shared volume vol01, and attached to both nodes of a 2-node cluster.

cfsmntadm add sharedg vol01 /mnt1 all=cluster cfsmntadm add sharedg vol01 /mnt1 node1=cluster node2=cluster

To add a cluster mount point /mnt1, associated with the shared disk group sharedg and the shared volume vol01, and attached only to one node of a 2-node cluster, enter:


cfsmntadm add sharedg vol01 /mnt1 node1=cluster

To delete the cluster mount point /mnt1 from a cluster configuration, enter:


cfsmntadm delete /mnt1

If the shared volume is mounted at /mnt1, the above command will fail. To delete the cluster mount point /mnt1 from a cluster configuration, whether or not it has a shared volume mounted, enter:


cfsmntadm delete -f /mnt1

To change the mount options associated with all the nodes in the cluster for a cluster mount /mnt1, enter:


cfsmntadm modify /mnt1 all=cluster,convosync=direct

The following command adds a node to the list of nodes associated with a cluster mount. This new node must be part of the cluster. After the new node is added, the shared volume can be mounted on them using the cfsmount command.


cfsmntadm modify /mnt1 add node2=cluster

The following command deletes a node from the list of nodes associated with a cluster mount.


cfsmntadm modify -f delete node2

To set the primary election policy for the cluster mount /mnt1, enter:


cfsmntadm setpolicy /mnt1 node1 node3 node2

To change the primary election policy for a cluster mount /mnt1, enter:


cfsmntadm setpolicy /mnt1 node3 node2 node1

To set all Storage Checkpoints in the cluster to be removable by default, enter:


cfsmntadm vxtunefs -D ckpt_removable=1

EXIT CODES

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

SEE ALSO

cfscluster(1M), cfsdgadm(1M), cfsmount(1M), fsckptadm(1M), fsclustadm(1M), mount_vxfs(1M)

Veritas Storage Foundation Cluster File System High Availability Administrator’s Guide


VxFS 6.0 cfsmntadm (1M)