Home > Veritas Storage Foundation™ Cluster File System Manual Pages
CFSMNTADM (1M) |
Maintenance Commands |
[ 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 ] #if defined(SOLARIS) || defined(HPUX) || defined(AIX)
cfsmntadm add snapshot dev=local_block_device mount_point
snapshot_mount_point local_node=[mount_options ] #endif
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 ] ... ]
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.
- 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.
- 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:
- Name of the shared volume
- Name of the shared disk group to which the shared volume belongs
- List of nodes on which the shared volume can be mounted
- List of nodes on which shared volume is currently mounted
- Mount options for each node
- Primary node for the file system mounted at mount_point
- 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:
- Name of the shared volume
- 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.
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
VERITAS File System Administrator's Guide
Last updated: 1 Jun 2006
Copyright ©2009 Symantec Corporation
All rights reserved.