cfsshare - Clustered NFS (CNFS) and Common Internet File System (CIFS) configuration command

The cfsshare command takes NFS protocal by default where the -p option is not used.

cfsshare config [ -n ] shared_disk_group shared_volume mount_point

cfsshare config [ -n ] [ -p nfs ] shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p cifs -l samba_lockdir -c samba_config_file -t samba_topdir -m user shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p cifs -l samba_lockdir -c samba_config_file -t samba_topdir -m domain -d domain -s password_server -u domain_user shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p cifs -l samba_lockdir -c samba_config_file -t samba_topdir -m ads -d domain -r realm -s password_server -u domain_user shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p all -l samba_lockdir -c samba_config_file -t samba_topdir -m user shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p all -l samba_lockdir -c samba_config_file -t samba_topdir -m domain -d domain -s password_server -u domain_user shared_disk_group shared_volume mount_point

cfsshare config [ -n ] -p all -l samba_lockdir -c samba_config_file -t samba_topdir -m ads -d domain -r realm -s password_server -u domain_user shared_disk_group shared_volume mount_point

cfsshare share mount_point [ share_options ]

cfsshare share -p nfs mount_point [ share_options ]

cfsshare share -p nfs [ -N nfs_share_options ] mount_point

cfsshare share -p cifs -v address -n cifs_share_name [ -C cifs_share_options ] mount_point

cfsshare share -p cifs -v address -n cifs_share_name mount_point [ share_options ]

cfsshare unshare mount_point

cfsshare unshare -p nfs mount_point

cfsshare unshare -p cifs mount_point

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

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

cfsshare add -p nfs [ -D ] shared_disk_group shared_volume mount_point [ share_options ] node_name=[ mount_options ]

cfsshare add -p nfs [ -D ] shared_disk_group shared_volume mount_point [ share_options ] all=[ mount_options ]

cfsshare add -p nfs [ -D ] [ -N nfs_share_options ] shared_disk_group shared_volume mount_point node_name=[ mount_options ]

cfsshare add -p cifs [ -D ] -v address -n cifs_share_name shared_disk_group shared_volume mount_point [ share_options ] node_name=[ mount_options ]

cfsshare add -p cifs [ -D ] -v address -n cifs_share_name shared_disk_group shared_volume mount_point [ share_options ] all=[ mount_options ]

cfsshare add -p cifs [ -D ] -v address -n cifs_share_name [ -C cifs_share_options ] shared_disk_group shared_volume mount_point node_name=[ mount_options ]

cfsshare add -p cifs [ -D ] -v address -n cifs_share_name [ -C cifs_share_options ] shared_disk_group shared_volume mount_point all=[ mount_options ]

cfsshare delete mount_point

cfsshare delete -p nfs mount_point

cfsshare delete -p cifs mount_point

cfsshare unconfig

cfsshare unconfig -p all

cfsshare unconfig -p nfs

cfsshare unconfig -p cifs

cfsshare addnode node_name

cfsshare addvip [ -a node_name ] device address netmask [ network_hosts ]

cfsshare addvip [ -a node_name ] network_interface address netmask

cfsshare deletevip address

cfsshare addvipv6 [ -a nodename ] device address prefixlen

cfsshare addvipv6 [ -a nodename ] network_interface ipv6_address prefixlen

cfsshare deletevipv6 ipv6_address

cfsshare display

VRTScavf

The cfsshare command can be used to configure or unconfigure Clustered NFS (CNFS) and Common Internet File System (CIFS) sharing of CFS file systems.

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 or CIFS 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.

config	Configures the CNFS and CIFS components required for sharing of CFS file system. This requires a shared volume which will be used to create a metadata file system. This shared metadata file system should not be used for storing any user data. If the shared volume or file system is already present in VCS configuration, this command converts it into the shared metadata file system.
share	Exports the file system mounted at the specified mount point via NFS and CIFS 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 exports the file system via NFS and CIFS 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 and CIFS components from VCS configuration.
addnode	Updates cfsnfssg and vip service group with new node. Also creates proper symlinks required for CNFS. It should be run from one of the existing node in the CNFS cluster.
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 and CIFS exported and that are in the VCS configuration.

-c	The -c option is used to specify the Samba configuration file and path.
-d	The -d option is used to specify the domain or workgroup name that the SFCFS cluster will be part of, which can be an NT Domain ("domain" mode) or ADS domain ("ads" mode).
-l	The -l option is used to specify the directory where Samba daemons create locking files.
-m	The -m option is used to specify the mode in which Samba needs to be configured. It can be a user, domain or ads.
-n	For NFS: 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.
	For CIFS: Configures the cluster and does not make changes to smb.conf, smbpasswd, or secrets.tdb files.
	See the Storage Foundation Cluster File System High Availability Administrator’s Guide for more information.
-p	The -p option is used to specify the protocol to be used for sharing the file system.
-p all	You can use the -p all option only with the cfsshare config command. The -p all option is used to enable sharing via NFS and CIFS.
-r	The -r option is used to specify the Kerberos realm ("ads" mode only).
-s	The -s option is used to specify the password server name. This is name of the domain controller or Active Directory Server.
-t	The -t option is used to specify the directory where all Samba binaries are present.
-u	The -u option is used to specify the Domain or Active Directory user with Adminstrator privileges, who can add a system to the domain or Active Directory.
-C	The -C option is used to specify the CIFS share options assoicated with the specified mount point. The various CIFS share options are separated by semi-colons.
-N	The -N option is used to specify the NFS share options assoicated with the s pecified mount point. The various NFS share options are separated by commas.
-D	The -D option is used to deep I/O monitor the volume used by the file system.
-a	The -a option adds the specified node as the first node in the autostartlist for vip group corresponding to vip address.

address	Specifies the virtual IP address.
cifs_share_name
	Specifies the CIFS share name.
cifs_share_options
	Specifies the CIFS share options.
domain	Specifies the domain name.
domain_user
	Specifies the domain username.
ipv6_address
	Specifies the IPv6 virtual IP address.
mount_options
	Mount options of the file system on 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	Specifies the netmask.
network_hosts
	Hosts on the network that receive pings to determine the state of the NIC. The specified hosts must be pingable.
network_interface
	Specifies the network interface.
nfs_share_options
	Specifies the NFS share options.
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.
password_server
	Specifies the password server (domain controller or Active Directory Server).
prefixlen	Specifies the size in bits of the prefix for the IPv6 address represented in the Classless Inter-Domain Routing (CIDR) notation. samba_config_file Specifies the Samba configuration file. samba_lockdir Specifies the Samba lock directory. samba_topdir Specifies the Samba’s top of the directory. shared_disk_group Name of the VxVM shared disk group.
shared_volume
	Name of the VxVM shared volume.

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

To configure the CNFS, enter: # 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", enter: # cfsshare share /mnt1 rw

To display currently shared CFS file systems, enter: # cfsshare display

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

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

To remove a previously added virtual IP "10.182.111.161", enter: # cfsshare deletevip 10.182.111.161

To unconfigure CNFS, enter: # cfsshare unconfig

To configure CIFS in user mode, enter: # cfsshare config -p cifs -m user -l /var/run -c /etc/samba/smb.conf -t /usr lockdg vollocks /locks

To configure CIFS in domain mode, enter: # cfsshare config -p cifs -m domain -l /var/run -c /etc/samba/smb.conf -t /usr -s sfstest-ad -d SFSTEST-AD2 -u Administrator lockdg vollocks /locks

To configure CIFS in ads mode, enter: # cfsshare config -p cifs -m mode -l /var/run -c /etc/samba/smb.conf -t /usr -s sfstest-ad -d SFSTEST-AD2 -r SFSTEST-AD2.LOCAL -u Administrator lockdg lockvol /locks

To unconfigure CIFS, enter: # cfsshare unconfig -p cifs

To add a virtual IP, enter: # cfsshare addvip en0 10.182.79.216 255.255.240.0 10.182.79.215

To add and share a file system via CIFS, enter: # cfsshare add -p cifs -v 10.182.79.216 -n sh1 -C "readonly=no; dosfiletimes=yes" sharedg vol1 /mnt1 all=

To delete a previous shared file system, enter: # cfsshare delete /mnt1

To delete the virtual IP added previously, enter: # cfsshare deletevip 10.182.79.216

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

Storage Foundation Cluster File System High Availability Administrator’s Guide