Home Man
Today's Posts

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for sunw.hastorageplus (opensolaris section 5)

SUNW.HAStoragePlus(5)		    Sun Cluster Miscellaneous		    SUNW.HAStoragePlus(5)

       SUNW.HAStoragePlus  -  resource type that enforces dependencies between Sun Cluster device
       services, file systems, and data services

       SUNW.HAStoragePlus describes a resource type that  enables  you	to  specify  dependencies
       between	data  service  resources  and device groups, cluster file systems, and local file

       Note -

	 Local file systems include the UNIX File System (UFS), Quick File System (QFS),  Veritas
	 File System (VxFS), and Solaris ZFS (Zettabyte File System).

       This  resource  type  enables you to bring data services online only after their dependent
       device groups and file systems are guaranteed  to  be  available.  The  SUNW.HAStoragePlus
       resource type also provides support for mounting, unmounting, and checking file systems.

       Resource  groups  by themselves do not provide for direct synchronization with disk device
       groups, cluster file systems, or local file systems. As a result, during a cluster  reboot
       or  failover,  an  attempt  to  start  a data service can occur while its dependent global
       devices and file systems are still unavailable. Consequently,  the  data  service's  START
       method might time out, and your data service might fail.

       The SUNW.HAStoragePlus resource type represents the device groups, cluster, and local file
       systems that are to be used by one or more data service resources. You add a  resource  of
       type  SUNW.HAStoragePlus  to  a	resource  group  and  set  up  dependencies between other
       resources and the SUNW.HAStoragePlus resource. These dependencies  ensure  that	the  data
       service resources are brought online after the following situations occur:

	   1.	  All specified device services are available (and collocated, if necessary).

	   2.	  All specified file systems are checked and mounted.

       You can also use the SUNW.HAStoragePlus resource type to access a local file system from a
       non-global zone.

       The following extension properties are associated  with	the  SUNW.HAStoragePlus  resource


	   Specifies   whether	a  SUNW.HAStoragePlus  resource  needs	to  perform  an  affinity
	   switchover for all global devices  that  are  defined  in  the  GlobalDevicePaths  and
	   FilesystemMountPoints  extension  properties.  You can specify TRUE or FALSE. Affinity
	   switchover is set by default, that is, AffinityOn is set to TRUE.

	   The Zpools extension property ignores the AffinityOn extension property.  The  Affini-
	   tyOn extension property is intended for use with the GlobalDevicePaths and Filesystem-
	   MountPoints extension properties only.

	   When you set the  AffinityOn  extension  property  to  FALSE,  the  SUNW.HAStoragePlus
	   resource  passively	waits  for  the specified global services to become available. In
	   this case, the primary node or zone of each online global device service might not  be
	   the same node or zone that is the primary node for the resource group.

	   The	purpose of an affinity switchover is to enhance performance by ensuring the colo-
	   cation of the device groups and the resource groups on a specific node or  zone.  Data
	   reads  and  writes  always  occur  over the device primary paths. Affinity switchovers
	   require the potential primary node list for the resource group and the node	list  for
	   the	device group to be equivalent. The SUNW.HAStoragePlus resource performs an affin-
	   ity switchover for each device service only once, that is, when the SUNW.HAStoragePlus
	   resource is brought online.

	   The	setting  of  the  AffinityOn  flag  is	ignored  for  scalable services. Affinity
	   switchovers are not possible with scalable resource groups.


	   Overrides the check that SUNW.HAStoragePlus conducts on  each  unmounted  file  system
	   before  attempting  to  mount  it. You can specify an alternate command string or exe-
	   cutable, which is invoked on all unmounted file systems.

	   When a SUNW.HAStoragePlus resource is configured in a  scalable  resource  group,  the
	   file-system check on each unmounted cluster file system is omitted.

	   The	default value for the FilesystemCheckCommand extension property is NULL. When you
	   set this extension property to NULL, Sun Cluster checks UFS or  VxFS  by  issuing  the
	   /usr/sbin/fsck  -o  p  command.  Sun  Cluster checks other file systems by issuing the
	   /usr/sbin/fsck command. When you set the FilesystemCheckCommand extension property  to
	   another  command  string, SUNW.HAStoragePlus invokes this command string with the file
	   system mount point as an argument.  You can specify any arbitrary executable  in  this
	   manner.  A  nonzero	return value is treated as an error that occurred during the file
	   system check operation. This error causes the START method to fail. When  you  do  not
	   require  a file system check operation, set the FilesystemCheckCommand extension prop-
	   erty to /bin/true.


	   Specifies a list of valid file system mount points. You can specify	global	or  local
	   file systems. Global file systems are accessible from all nodes or zones in a cluster.
	   Local file systems are accessible from a single cluster node or zone. Local file  sys-
	   tems that are managed by a SUNW.HAStoragePlus resource are mounted on a single cluster
	   node or zone. These local file systems require the underlying devices to be Sun  Clus-
	   ter global devices.

	   These  file system mount points are defined in the format paths[,...]. You can specify
	   both the path in a non-global zone and the path in a global zone, in this format:


	   The global zone path is optional. If you do not specify a global zone path, Sun  Clus-
	   ter	assumes that the path in the non-global zone and in the global zone are the same.
	   If you specify the path as Non-GlobalZonePath:GlobalZonePath, you must specify Global-
	   ZonePath in the global zone's /etc/vfstab.

	   The default setting for this property is an empty list.

	   You	can use the SUNW.HAStoragePlus resource type to make a file system available to a
	   non-global zone. To enable the SUNW.HAStoragePlus resource type to do this,	you  must
	   create  a  mount point in the global zone and in the non-global zone. The SUNW.HAStor-
	   agePlus resource type makes the file system available to the non-global zone by mount-
	   ing	the  file  system  in the global zone. The resource type then performs a loopback
	   mount in the non-global zone.

	   Each file system mount point should have an equivalent entry  in  /etc/vfstab  on  all
	   cluster  nodes  and in all global zones. The SUNW.HAStoragePlus resource type does not
	   check /etc/vfstab in non-global zones.

	   SUNW.HAStoragePlus resources that specify local file systems  can  only  belong  in	a
	   failover  resource  group  with affinity switchovers enabled. These local file systems
	   can therefore be termed failover file systems. You can specify both local  and  global
	   file system mount points at the same time.

	   Any	file  system  whose mount point is present in the FilesystemMountPoints extension
	   property is assumed to be local if its /etc/vfstab entry satisfies both of the follow-
	   ing conditions:

	       1.     The non-global mount option is specified.

	       2.     The "mount at boot" field for the entry is set to "no."
	   A  Solaris  ZFS is always a local file system. Do not list a ZFS in /etc/vfstab. Also,
	   do not include ZFS mount points in the FilesystemMountPoints property.


	   Specifies a list of valid global device group names or global device paths. The  paths
	   are	defined  in  the  format paths[,...]. The default setting for this property is an
	   empty list.


	   Specifies a list of valid ZFS storage pools, each of which contains at least one  ZFS.
	   These ZFS storage pools are defined in the format paths[,...]. The default setting for
	   this property is an empty list. All file systems in a ZFS storage pool are mounted and
	   unmounted together.

	   The	Zpools	extension  property enables you to specify ZFS storage pools. The devices
	   that make up a ZFS storage pool must be accessible from all the nodes  or  zones  that
	   are	configured  in	the node list of the resource group to which a SUNW.HAStoragePlus
	   resource belongs. A SUNW.HAStoragePlus resource that manages a ZFS  storage	pool  can
	   only belong to a failover resource group. When a SUNW.HAStoragePlus resource that man-
	   ages a ZFS storage pool is brought online, the ZFS storage pool is imported, and every
	   file  system that the ZFS storage pool contains is mounted. When the resource is taken
	   offline on a node, for each managed ZFS storage pool, all file systems  are	unmounted
	   and the ZFS storage pool is exported.

	   Note -

	      SUNW.HAStoragePlus does not support file systems created on ZFS volumes.


	   Specifies  the location to search for the devices of Zpools. The default value for the
	   ZpoolsSearchDir extension property is /dev/dsk. The ZpoolsSearchDir extension property
	   is similar to the -d option of the zpool command.

       See attributes(5) for descriptions of the following attributes:

       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       |Availability		     |SUNWscu			   |

       rt_reg(4), attributes(5)

       Make  data  service resources within a given resource group dependent on a SUNW.HAStorage-
       Plus resource. Otherwise, no synchronization is possible between the data services and the
       global  devices or file systems. Strong resource dependencies ensure that the SUNW.HAStor-
       agePlus resource is brought online before other resources. Local  file  systems	that  are
       managed	by  a  SUNW.HAStoragePlus  resource are mounted only when the resource is brought

       Enable logging on UFS systems.

       Avoid configuring multiple SUNW.HAStoragePlus resources in different resource groups  that
       refer  to  the  same  device group and with AffinityOn flags set to TRUE. Redundant device
       switchovers can occur. As a result, resource and device groups might be dislocated.

       Avoid configuring a ZFS storage pool under multiple SUNW.HAStoragePlus resources  in  dif-
       ferent resource groups.

       The  SUNW.HAStoragePlus	resource  is  capable of mounting any cluster file system that is
       found in an unmounted state.

       All file systems are mounted in the overlay mode.

       Local file systems are forcibly unmounted.

       The waiting time for all device services and file systems to become available is specified
       by the Prenet_Start_Timeout property in SUNW.HAStoragePlus. This is a tunable property.

SunOS 5.9				   25 Sep 2007			    SUNW.HAStoragePlus(5)

All times are GMT -4. The time now is 04:01 AM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
Show Password