Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### scconf_quorum_dev_quorum_server

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

### Synopsis

    scconf  [-q quorum-options]

## Description

Note - Oracle Solaris Cluster software includes an object-oriented command set. Although Oracle Solaris Cluster software still supports the original command set, Oracle Solaris Cluster procedural documentation uses only the object-oriented command set. For more information about the object-oriented command set, see the `Intro`(1CL) man page.

Oracle Solaris 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`(1CL) 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 specific options can be used to change the cluster quorum configuration:

### Add a Quorum Server Type of Quorum Device

Before adding a quorum device:

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

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

- 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 Oracle Solaris 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 `quorum_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 | `ha-cluster/system/core`
Stability | Evolving

## See Also

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

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |