fsclustadm man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

fsclustadm(1M)							fsclustadm(1M)

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

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

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 CODES
       fsclustadm 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 ALSO
       fsadm_vxfs(1M), fsckptadm(1M), mkfs_vxfs(1M), mount_vxfs(1M)

VxFS 5.0			  7 Jan 2008			fsclustadm(1M)
[top]

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net