scconf_quorum_dev_quorum_server(1M)			  System Administration Commands		       scconf_quorum_dev_quorum_server(1M)

NAME

       scconf_quorum_dev_quorum_server - add, remove, and configure a quorum server type of quorum device.

SYNOPSIS

       scconf  [-q quorum-options]

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.

       Sun Cluster provides the option of configuring a quorum server as a quorum device. This configuration information consists of a device name
       that must be unique across quorum devices, the address of the host machine on which the quorum server is running, and the  port	number	on
       which  the  quorum server is listening for requests. If your cluster requires multiple quorum devices, configure multiple quorum servers or
       use storage devices for the additional quorum devices. A quorum server can act as only one quorum device for a cluster.

       To configure the cluster to use a quorum server, the quorum server software must be installed, configured, and running on a machine that is
       accessible  to  all  cluster nodes. The quorum server itself must be configured and running when this command is run on a cluster node. See
       clquorumserver(1M) for information about configuring the quorum server.

OPTIONS

       The following parameters are required for configuring a quorum server type of quorum device. See  scconf(1M)  for  the  list  of  supported
       generic options.

       Use  the  add and remove forms of the command to add shared quorum devices to and remove shared quorum devices from the configuration file.
       Use the change form of the command to change various cluster quorum configuration properties or states.	The following quorum  server  spe-
       cific options can be used to change the cluster quorum configuration:

   Add a Quorum Server Type of Quorum Device
       Before adding a quorum device:

	   o	  The quorum server must be running on the quorum server host machine.

	   o	  You must enter the quorum server host name in the /etc/inet/hosts file.

	   o	  You must set the netmask for the quorum server host.

       For  information about the hosts file and netmask requirements, see the procedure on adding quorum server quorum devices in the Sun Cluster
       System Administration Guide. Once the quorum device is added, none of the parameters can be changed.

	 # scconf -q -a name=devicename,type=quorum_server,qshost=qhost,port=portnumber

       name=devicename

	   The name of a quorum server. This name must be unique among all quorum devices in the system.

       type=quorum_server

	   Indicates the type of disk device group to create. For a quorum server type of quorum device, the value of this parameter must be  quo-
	   rum_server.

       qhost=qhost

	   The hostname of the machine on the network that can be reached by all cluster nodes and that is running the quorum server. Depending on
	   the IPv4 or IPv6 configuration of the host, this hostname must have an entry in the /etc/hosts file,  the  /etc/inet/ipnodes  file,	or
	   both.

       port=portnumber

	   The port on which the quorum server listens for requests.

	   Note -

	     If  you  need to change the port number of a quorum server while maintaining the same host name, remove the quorum device first, make
	     your changes, then add the quorum device back.

   Change the Configuration Parameters of a Quorum Server Type Quorum Device
	 # scconf -c -q name=devicename,maintstate | reset

       If other parameters such as qshost or port must be changed, add a new quorum device with the new parameters and remove the existing  quorum
       device.

   Remove a Quorum Server Type of Quorum Device
	 # scconf -q name=devicename

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

EXAMPLES

       Example 1 Adding a Quorum Server Type of Quorum Device

       The following scconf command adds a quorum server quorum device with its port number configured as 9000.

	 # scconf -q -a name=qd1,type=quorum_server,qshost=scclient1,port=9000

       Example 2 Removing a Quorum Server Type of Quorum Device

       The following scconf command removes the quorum server quorum device named qd1.

	 # scconf -r -q name=qd1

ATTRIBUTES

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

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

SEE ALSO

       Intro(1CL), clquorum(1CL), clquorumserver(1CL), cluster(1CL), scconf(1M), gateways(4), hosts(4)

Sun Cluster 3.2 						    18 Jul 2006 			       scconf_quorum_dev_quorum_server(1M)