Symantec logo

cfsdgadm

NAME

cfsdgadm - add or delete shared disk groups to/from a cluster configuration

SYNOPSIS

cfsdgadm add shared_disk_group node_name=activation_mode ...

cfsdgadm add shared_disk_group all=activation_mode [ [ node_name ] ... ]

cfsdgadm delete [ -f ] shared_disk_group

cfsdgadm display [ -v ] shared_disk_group

cfsdgadm modify shared_disk_group node_name=activation_mode ...

cfsdgadm modify shared_disk_group all=activation_mode

cfsdgadm modify shared_disk_group dg new_shared_disk_group

cfsdgadm move source_shared_disk_group target_shared_disk_group

AVAILABILITY

VRTScavf

DESCRIPTION

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.

Any specified shared disk group must already exist before using this command.

Only a privileged user can run this command.

KEYWORDS

add

Adds a shared disk group to a cluster by associating it with the specified nodes. The respective modes are applied when a disk group is activated.

This command adds shared disk group information (such as the shared disk group's name) and the list of specified nodes to the cluster configuration. After the shared disk group is associated with a node in the cluster, it will be activated (in the mode as was specified in the command) whenever the node joins the cluster. You can change the activation mode associated with a shared disk group for a node using the cfsdgadm modify command.

delete

Removes the shared disk group from the cluster by disassociating it from the nodes in the cluster. This option deletes the information related to this shared disk group from the cluster configuration. After the shared disk group is disassociated from the nodes in the cluster, the shared disk group is not automatically activated when the node joins the cluster.


  Note    The delete will fail if any shared volume belonging to this disk group is currently mounted. If the -f option is specified, the volumes are unmounted and the delete process continues.


display

Displays the information related to the shared disk group's cluster configuration:

OPTIONS

-f

The force option unmounts the shared volume from all the nodes in the cluster and removes the corresponding cluster mount instance.

-v

Specifies verbose mode.

ARGUMENTS

shared_disk_group

Name of the VxVM shared disk group.

node_name

List of node names on which the specified shared volume can be mounted. The node must be a member 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.

all= | node_name= activation_mode

For a shared disk group, the activation mode is on a per-node basis. all sets the same activation mode for all the nodes in the cluster. The following are the valid activation modes and corresponding read/write capability for shared disk groups:

ew

Specifies exclusive write. The node has exclusive write access to volumes in the disk group. No other node in the cluster can activate the disk group for write access.

off

Disables all read/write access.

ro

Specifies read only. The node has read access to volumes in the disk group. The node has no write access and denies write access to all other nodes in the cluster.

sr

Specifies shared read. The node has read access to volumes in the disk group, but no write access. Other nodes can activate the disk group for write access.

sw

Specifies shared write. The node has write access to volumes in the disk group. Other nodes can activate the disk group for shared write access.

EXIT CODES

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

EXAMPLES

To add shared disk group named sharedg to the cluster configuration, enter:

# cfsdgadm add sharedg all=sw

SEE ALSO

cfscluster(1M), cfsmntadm(1M), cfsmount(1M), vxdg(1M)