fsclustadm(1M)fsclustadm(1M)NAMEfsclustadm - VxFS cluster mounted file system administration utility
SYNOPSIS
/opt/VRTS/bin/fsclustadm [-v] listmount mount_point
/opt/VRTS/bin/fsclustadm [-v] showprimary mount_point
/opt/VRTS/bin/fsclustadm mounttype fImount_point
/opt/VRTS/bin/fsclustadm setprimary mount_point
/opt/VRTS/bin/fsclustadm [ -v ] getpolicy mount_point
/opt/VRTS/bin/fsclustadm setpolicy [ hostname1 hostname2 ... ]
mount_point
/opt/VRTS/bin/fsclustadm cfsdeinit
/opt/VRTS/bin/fsclustadm idtoname nodeid
/opt/VRTS/bin/fsclustadm nametoid hostname
AVAILABILITY
VRTSvxfs
DESCRIPTIONfsclustadm reports various attributes of a cluster mounted VxFS file
system. fsclustadm can also set the local node to act as the primary
node for the file system.
mount_point is a cluster mounted file system.
Cluster File System Issues
The fsclustadm command operates from any node in a cluster.
OPTIONS-v Verbose. In verbose mode, fsclustadm reports nodes by host
name. Otherwise, nodes are reported by their cluster file
system (CFS) node ID number.
KEYWORDS
cfsdeinit Unregisters VxFS from GAB (group atomic broadcast) port f
membership. For this operation to complete successfully, a
CVM device cannot be mounted on the current node, and the
file system check daemon, vxfsckd, cannot be running on the
node.
getpolicy Reports the current primaryship migration policy for the
specified mount point. The migration policy is not persis‐
tent across cluster-wide unmounts and reboots. As long as
there is one functioning node in the cluster which has
mounted the file system, the migration policy remains active
and is propagated to other nodes as they join the cluster.
The cluster file system primaryship migrates if the file sys‐
tem is mounted on another node and is specified in the policy
list before current primary.
idtoname Translates a CFS node ID into a host name.
listmount Lists all nodes that currently have a cluster mount of the
specified file system mount_point. listmount operates on a
fileset basis, so when listmount is issued for a Storage
Checkpoint mount, the information returned pertains to the
Storage Checkpoint fileset.
mounttype Reports the mount type, local, secondary, or primary, of the
specified mount point.
nametoid Translates a host name into a CFS node ID.
setpolicy Sets the primaryship migration policy for the mount point.
setpolicy sets up the order in which hosts assume the cluster
file system primaryship if the primary fails. If no host
specified in the list is active when the primary fails, a
node is chosen at random to be the new primary. When the
policy is set, if the first host name specified in the list
is not the current primary, a primary migration is triggered
to the first host in the list. If setpolicy is invoked with‐
out a node list, the policy is cleared. The policy is not
persistent; it applies only to the current mount session.
setprimary
Designates the local node (that is, the node on which fsclus‐
tadm is issued) as the primary node for the file system
mounted at mount_point. Operates on a file system basis, so
all filesets in the file system have the same primary. set‐
primary must be issued on the Storage Checkpoint primary
fileset. Note: Each cluster mounted file system can have a
different node acting as primary. You may want to designate
a different primary node to optimize performance.
showprimary
Indicates which node is primary for the file system mounted
at mount_point. Operates on a file system basis, so all
filesets in the file system have the same primary.
EXIT CODESfsclustadm exits with a zero status if successful, a non-zero status if
the attempted operation fails.
DIAGNOSTICS
"UX:vxfs fsclustadm: ERROR: mount_point is not a cluster mount"
The mount point specified with the listmount, showprimary, or
setprimary keywords does not refer to a cluster mount.
"UX:vxfs fsclustadm: ERROR: invalid hostid number"
The host ID number supplied to idtoname is not a valid host
ID.
"UX:vxfs fsclustadm: ERROR: invalid host name"
The host name specified to nametoid is not a valid host name.
"UX:vxfs fsclustadm: ERROR: Duplicate node host name in policy"
A host name is specified more than once in the primary migra‐
tion policy list.
"...cannot open /dev/vxportal, Permission denied, error errno"
If you do not have write permission, the fsclustadm command
cannot open /dev/vxportal.
"...ioctl failed, error_message, errno"
The fsclustadm command could not successfully exchange infor‐
mation with the VxFS driver.
FILES
/etc/llthosts Used to translate node IDs to host names.
SEE ALSOfsadm_vxfs(1M), fsckptadm(1M), mkfs_vxfs(1M), mount_vxfs(1M)VxFS 5.0 7 Jan 2008 fsclustadm(1M)