Symantec logo

Storage Foundation Cluster File System resource management commands

As many as five VCS agents are required to manage cluster file system functionality. Each of these resources has several attributes and dependencies between them. To make resources easier to manage, five SFCFS administrative commands are provided. It is advisable to use only these commands to manage cluster file systems.

SFCFS consists of the following commands:

Commands
Description
cfscluster
Cluster configuration command
cfsmntadm
Adds, deletes, modifies, and sets policy on cluster mounted file systems
cfsdgadm
adds or deletes shared disk groups to and from a cluster configuration
cfsmount
mounts a cluster file system on a shared volume
cfsumount
unmounts a cluster file system on a shared volume

The cfscluster command

The cfscluster command is used primarily to configure and unconfigure CVM and SFCFS, and can be run from any node in the cluster. VCS must be started before you can run the cfscluster config command. The cfscluster config command adds all the resource type definitions and adds resource instances, one each of type CVMCluster and CFSfsckd. The cfscluster config command also brings the resources online, and cfscluster status can be used to query the status of VCS.

See Resources and service groups for File System cluster functionality.

The cfscluster unconfig command takes resources offline (except CFSMount resources) and removes all the resources and service groups that were used to manage the cluster file system.

See the cfscluster(1M) manual page.

You must manually take CFSMount resources offline (using the cfsumount command) before executing the cfscluster unconfig command.

The cfsmntadm command

One CVMVolDg and one CFSMount resource is required to control each cluster mount. You can use the cfsmntadm add to add these resources. The cfsmntadm command takes mount points, shared volumes, and shared disk groups as arguments. You can optionally specify a service group name. If a service group name is specified, the cfsmntadm command creates a new service group (if the service group is not already present) and makes it dependent on the cvm service group. If no service group name is specified, cfsmntadm add creates a default service group, cfs. The command next adds CVMVolDg to the specified service group and associates it with the specified disk group (if that kind of resource is not already present in the same service group). Subsequently, cfsmntadm add adds a CFSMount resource and links it with the CVMVolDg resource, then sets the appropriate values to the resource attributes. It is advisable to add all the mount points (that have their device in the same shared disk group) to the same service group.

See Resources and service groups for File System cluster functionality.

Using cfsmntadm, you can also add file system snapshots and Storage Checkpoints; delete, display, and modify resources; and set the primary election policy on a cluster mounted file system.

See the cfsmntadm(1M) manual page.

The cfsdgadm command

The cfsdgadm command is the administrative interface for shared disk groups. Using cfsdgadm, you can add a shared disk group to a cluster configuration, delete a shared disk group, modify the activation mode, or display the shared disk group's configuration information. A shared disk group must already exist before being specified with cfsdgadm command.

See the cfsdgadm(1M) manual page.

The cfsmount and cfsumount command

The cfsmount command mounts a cluster file system on a shared volume on one or more nodes. If no nodes are specified, the cluster file system is mounted on all associated nodes in the cluster. The cluster mount instance for the shared volume must be previously defined by the cfsmntadm add command before running cfsmount. The cfsumount command unmounts one or more shared volumes

See the cfsmount(1M) manual page.

SFCFS service groups and resource dependencies describes the SFCFS service groups and resource dependencies.

SFCFS service groups and resource dependencies

SFCFS service groups and resource dependencies

Click the thumbnail above to view full-sized image.