scconf_quorum_dev_scsi(1M)				  System Administration Commands				scconf_quorum_dev_scsi(1M)

NAME

       scconf_quorum_dev_scsi  -  Add  and  remove  shared  SCSI quorum devices and change various SCSI cluster quorum configuration properties or
       states.

SYNOPSIS

       scconf {-a|-c|-r} -q globaldev=devicename otheroptions

       scconf {-a|-c|-r} -q name=devicename otheroptions

DESCRIPTION

       Note -

	 Beginning with the Sun Cluster 3.2 release, Sun Cluster software includes an object-oriented command set. Although Sun  Cluster  software
	 still	supports the original command set, Sun Cluster procedural documentation uses only the object-oriented command set. For more infor-
	 mation about the object-oriented command set, see the Intro(1CL) man page.

       A SCSI quorum device is considered to be any Sun Cluster supported, attached storage that is connected to two or more nodes of the cluster.
       The device must be managed by DID, and the device name that is provided must be a DID device name.

       The SCSI quorum device has no other properties that can be specified.

OPTIONS

       The following options are specific to shared disk quorum devices. See scconf(1M) for the list of supported generic options. See scconf_quo-
       rum_dev_netapp_nas(1M) for options that are specific to NAS quorum devices.

       The add and remove forms of the command are used to add and remove shared quorum devices to or from the configuration. The change  form	of
       the  command is used for changing various properties of cluster quorum configuration. The -q quorum-options available for each of the three
       forms of the command can be used to change the cluster quorum configuration are as follows:

       Add a shared quorum device:

	 -q -a globaldev=devicename[, node=node,node=node[, ...]]

       or

	 -q -a name= devicename,type=scsi

       or

	  -q -a autoconfig[,noop]

       Change a property or state of quorum configuration:

	 -q -c globaldev=devicename,{maintstate | reset}

       or

	 -q -c autoconfig[,noop]

       Remove a shared quorum device:

	 -q -r globaldev=devicename

       or

	 -q -r name=devicename

       autoconfig

	   When used with the add form of the command, automatically chooses and assigns one quorum device in the  two-node  cluster.  The  quorum
	   device is chosen from the available devices. If a quorum device is already configured, the command aborts.

	   When  used  with the change form of the command, automatically chooses and assigns one device that replaces all existing quorum devices
	   in the two-node cluster. The quorum device is chosen from the available devices.

	   All available devices in the cluster must be qualified to be a quorum device. The autoconfig  suboption  does  not  assess  whether	an
	   available device is qualified to be a quorum device.

	   If  the  cluster  contains  more  than two nodes, the autoconfig suboption makes no changes to the quorum configuration. Do not use the
	   autoconfig suboption if you intend to configure a NAS device as quorum.

       [,noop]

	   Is valid with the autoconfig suboption. The command prints to standard output the list of quorum devices that the autoconfig  suboption
	   would add or change. The autoconfig,noop suboption makes no changes to the quorum configuration.

       When scconf is interrupted or fails while performing quorum-related operations, quorum configuration information can become inconsistent in
       the cluster configuration database. If an inconsistency occurs, either run the same scconf command again or run it with the reset option to
       reset the quorum information.

       With the add form of the command, if a name is specified without a node list, the quorum device is added with a port defined for every node
       to which the device is attached. But, if a node list is given, at least two nodes must be provided, and each  node  in  the  list  must	be
       ported to the device.

EXAMPLES

       Example 1 Adding SCSI Quorum Devices

	The following scconf commands adds a SCSI quorum device.

	 -a -q globaldev=/dev/did/rdsk/d4s2
	 or
	 -a -q name=/dev/did/rdsk/d4s2,type=scsi

       Example 2 Changing SCSI Quorum Devices

	The following scconf command changes a SCSI quorum device configuration.

	 -c -q globaldev=/dev/did/rdsk/d4s2,reset
	 or
	 -c -q name=/dev/did/rdsk/d4s2,reset

       Example 3 Removing SCSI Quorum Devices

	The following scconf command removes the SCSI quorum device. qd1.

	 -r -q globaldev=qd1

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsczu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       Intro(1CL), clquorum(1CL), cluster(1CL), scconf(1M), scconf_quorum_dev_netapp_nas(1M)

Sun Cluster 3.2 						    10 Apr 2006 					scconf_quorum_dev_scsi(1M)