cfsshare (1M)

NAME

cfsshare - Clustered NFS (CNFS) configuration command

SYNOPSIS

cfsshare config [ -n ] shared_disk_group shared_volume mount_point

cfsshare share mount_point [share_options ]

cfsshare unshare mount_point

cfsshare add shared_disk_group shared_volume mount_point [ share_options ] node_name=[ mount_options ] ...

cfsshare add shared_disk_group shared_volume mount_point [ share_options ] all=[ mount_options ]

cfsshare delete mount_point

cfsshare unconfig

cfsshare addvip network_interface address netmask

cfsshare deletevip address

cfsshare addvipv6 network_interface ipv6_address prefixlen

cfsshare deletevipv6 ipv6_address

cfsshare display

AVAILABILITY

VRTScavf

DESCRIPTION

The cfsshare command can be used to configure or unconfigure CNFS.

You can use the cfsshare command as follows:

o To share or unshare an existing CFSMount resource already in VCS configuration.
o To create and share a CFSMount resource corresponding to a cluster mounted filesystem. Or unshare and delete an existing CFSMount resource that has already been shared.
o To add and delete the Virtual IP addresses through which the NFS shares need to be accessed.

Cluster manager software must be up and cfscluster config should have been run before you run the cfsshare command.

Only a privileged user can run this command.

KEYWORDS

config Configures the CNFS components.
share NFS exports the file system mounted at the specified mount point using the share options specified.
unshare Unshares the file system mounted at the specified mount point.
add Adds the file system to VCS configuration, mounts the file system at the specified mount point and NFS exports the file system using the share options specified.
delete Unshares the file system mounted at the specified mount point, unmounts the filesystem and removes the file system from VCS configuration.
unconfig Unconfigures the NFS sharing components from VCS configuration.
addvip Creates a new non-parallel/failover service group which contains a NIC resource for the given network device and an IP resource for the Virtual IP address.
deletevip Deletes the non-parallel/failover service group corresponding to the Virtual IP address specified.
addvipv6 Creates a new non-parallel/failover service group which contains a NIC resource for the given network device and an IP resource for the IPv6 Virtual IP address.
NOTE: The OS does not support NFS Version 3 over IPv6.
deletevipv6
  Deletes the non-parallel/failover service group corresponding to the IPv6 Virtual IP address specified.
NOTE: The OS does not support NFS Version 3 over IPv6.
display Displays the filesystems that are currently being NFS-exported and that are in the VCS configuration.

OPTIONS

-n For Red Hat Enterprise Linux (RHEL):
Configures the cluster and does not make any changes to the /var/lib/nfs/statd/sm directory.
For SUSE Linux Enterprise Server (SLES):
Configures the cluster and does not make any changes to the /var/lib/nfs/sm directory.
See the Veritas Storage Foundation Cluster File System Administrator’s Guide for more information.

ARGUMENTS

address is the Virtual IP address.
ipv6_address
  is the IPv6 Virtual IP address.
network_interface
  is the network interface.
mount_options
  The mount options of the node.
mount_point
  The mount point representing the cluster mount with which a shared volume is associated. If no shared volume is associated with this mount point, the share, unshare, and delete subcommands (keywords) fail.
netmask is the netmask.
prefixlen is the size in bits of the prefix for the IPv6 address represented in the Classless Inter-Domain Routing (CIDR) notation.
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. shared_disk_group Name of the VxVM shared disk group.
shared_volume
  Name of the VxVM shared volume.

EXIT CODES

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

EXAMPLE

To configure the CNFS: # cfsshare config cfsdg vollocks /locks

To add a CFS file system to VCS config and share it with share options "rw": # cfsshare add cfsdg vol1 /mnt1 rw all=

To share a CFS file system, previously added to VCS config, with share options "rw": # cfsshare share /mt1 rw

To display currently shared CFS file systems: # cfsshare display

To unshare a CFS file system: # cfsshare unshare /mnt1

To add a Virtual IP "10.192.111.161" with the netmask "255.255.240.0" on network interface "eth0": # cfsshare addvip eth0 10.182.111.161 255.255.240.0

To remove a previously added Virtual IP "10.182.111.161": # cfsshare deletevip 10.182.111.161

To unconfigure CNFS: # cfsshare unconfig

SEE ALSO

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

Veritas Storage Foundation Cluster File System Administrator’s Guide


VxFS 5.1 cfsshare (1M)