fsclustadm (1M)


fsclustadm - VxFS cluster mounted file system administration utility


fsclustadm [ -v ] listmount mount_point

fsclustadm [ -v ] showprimary mount_point

fsclustadm mounttype fImount_point

fsclustadm setprimary mount_point

fsclustadm [ -v ] getpolicy mount_point

fsclustadm setpolicy [ hostname1 hostname2 ... ] mount_point

fsclustadm cfsdeinit

fsclustadm idtoname nodeid

fsclustadm nametoid hostname

fsclustadm [ -v ] protoversion




fsclustadm 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.


-v Verbose. In verbose mode, fsclustadm reports nodes by host name. Otherwise, nodes are reported by their cluster file system (CFS) node ID number.


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 persistent 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 system 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.
  Prints the protocol versions supported by the VxFS driver, as well as the current protocol version. If you specify the -v option, fsclustadm also prints a table of the entire cluster’s protocol support.
The possible values for the FLAGS column in the output are as follows:
UPGRADING The protocol is in the process of upgrading.
BUSY The protocol is processing operations that would block attempts to upgrade.
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 without 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 fsclustadm 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. setprimary 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.
  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.


fsclustadm exits with a zero status if successful, a non-zero status if the attempted operation fails.


"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 migration 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 information with the VxFS driver.


/etc/llthosts Used to translate node IDs to host names.


The following command prints the protocol versions supported by the VxFS driver, as well as the current protocol version:

# fsclustadm protoversion Cluster Protocol Versions: Node #PROTOCOLS CUR PREF FLAGS local: 10,11 10 -

The following command prints the entire cluster’s protocol support:

# fsclustadm -v protoversion Cluster Protocol Version Table: Node #PROTOCOLS CUR PREF FLAGS 0: 10,11 10 - 1: 10,11 10 -


fsadm_vxfs(1M), fsckptadm(1M), mkfs_vxfs(1M), mount_vxfs(1M)

VxFS 5.1 SP1 fsclustadm (1M)