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

Search Scope:

- This Document
- Entire Library

### clquorumserver

### , clqs

- manage quorum servers

### Synopsis

    /usr/cluster/bin/clquorumserver -V

    /usr/cluster/bin/clquorumserver subcommand -?

    /usr/cluster/bin/clquorumserver subcommand [-v] [quorumserver]

    /usr/cluster/bin/clquorumserver clear -c clustername -I clusterID [-y] quorumserver

    /usr/cluster/bin/clquorumserver show [+ | quorumserver[…]]

    /usr/cluster/bin/clquorumserver start {+ | quorumserver[…]}

    /usr/cluster/bin/clquorumserver stop [-d] {+ | quorumserver[…]}

## Description

Use the `clquorumserver` command for the following tasks:

- Clean up stale configuration information of one or more quorum servers

- Display the configuration of one or more quorum servers

- Start one or more quorum servers

- Stop one or more quorum servers

The `clqs` command is the short form of the `clquorumserver` command. You can use either form of the command.

The general form of this command is as follows:

`clquorumserver` [subcommand] [options]

You can omit subcommand only if options specifies the `-?`, `-v`, or `-V` options.

The quorum server must be configured as a quorum device for the cluster. For information about configuring the quorum server, see `scqsd.conf`(4) and `scqsd`(1M). For information about adding a `quorum_server` type of quorum device to the cluster, see `clquorum`(1CL).

## SUBCOMMANDS

The following subcommands are supported:

`clear`

  Removes outdated cluster information from the quorum server. The quorum server keeps information about the cluster which it serves as a quorum device. This information can become invalid in the following circumstances:

  - When a cluster is decommissioned without first removing the cluster quorum device using the `clquorum remove` command

  - When a `quorum_server` type quorum device is removed from a cluster while the quorum server host is down

  | Caution - If a quorum server is not yet removed from the cluster, using this subcommand to clean up a valid quorum server could compromise the cluster quorum.

  You must specify the cluster name and cluster ID for a particular quorum server. See the `-c` and `-I` options for details.

  Users other than superuser require `solaris.cluster.admin` RBAC authorization to use this subcommand. See `rbac`(5) for more information.

`show`

  Displays the configuration information about the quorum server. For every cluster that configured the quorum server as a quorum device, this subcommand shows the corresponding cluster name, cluster ID, list of reservation keys, and list of registration keys.

  You can use the plus sign (`+`) to specify more than one quorum server.

  If no operand is given, or if the plus sign (`+`) is specified with the operand, the command prints the configuration of all running quorum servers.

  Users other than superuser require `solaris.cluster.read` RBAC authorization to use this subcommand. See `rbac`(5) for more information.

`start`

  Starts the quorum server

`stop`

  Stops the quorum server

## Options

The following options are supported:

`-?`
`--help`

  Prints help information.

  This option can be used alone or with a subcommand.

  - If you use this option alone, the list of available subcommands is printed.

  - If you use this option with a subcommand, the usage options for that subcommand are printed.

  When this option is used, no other processing is performed.

`-c` clustername
`--clustername` clustername

  Specifies the name of the cluster that uses the quorum server as a quorum device. You can get the cluster name by running some Oracle Solaris Cluster commands on the cluster nodes, such as `cluster show`.

  This option is required with the `clear` subcommand.

`-d`
`--disable`

  Disables the automatic restarting of the quorum server after a reboot.

`-I` clusterID
`--clusterID` clusterID

  Specifies the cluster ID. The cluster ID is an 8-digit hexadecimal number. You can get the cluster ID by running some Oracle Solaris Cluster commands on the cluster nodes, such as `cluster show`.

  This option is required with the `clear` subcommand.

`-V`
`--version`

  Prints the version of the command.

  Do not specify this option with subcommands, operands, or other options. The subcommand, operands, or other options are ignored. The `-V` option only prints the version of the command. No other operations are performed.

`-v`
-`--verbose`

  Prints verbose information to standard output, `stdout`.

  You can specify this option with any form of this command.

`-y`
`--yes`

  This option is only used with the `clear` subcommand. It pre-answers the confirmation question that is prompted by `clear` subcommand. Without this option, the `clear` subcommand asks a question to confirm whether you want to clean up the cluster information, and you need to answer `yes` or `no`. The subcommand only continues processing if you answer `yes`. When use this option, the `clear` subcommand will not ask any confirmation question, and instead directly removes the cluster information for the specified quorum server.

## Operands

The following operand is supported:

quorumserver

  Specifies an identifier for the quorum server or servers. A quorum server can be identified by either a port number or an instance name. The port number is used by the cluster nodes to communicate with the quorum server. The instance name can be specified in the quorum server configuration file, `/etc/scqsd/scqsd.conf`. See `scqsd.conf`(4).

## Exit Status

If the command is successful for all specified operands, it returns zero (`CL_NOERR`). If an error occurs for an operand, the command processes the next operand in the operand list. The returned exit code always reflects the error that occurred first.

The following exit values are returned:

`0` `CL_NOERR`

  No error

  The command that you issued completed successfully.

`1` `CL_ENOMEM`

  Not enough swap space

  A cluster node ran out of swap memory or ran out of other operating system resources.

`3` `CL_EINVAL`

  Invalid argument

  You typed the command incorrectly, or the syntax of the cluster configuration information that you supplied with the `-i` option was incorrect.

`6` `CL_EACCESS`

  Permission denied

  The object that you specified is inaccessible. You might need superuser or RBAC access to issue the command. See the `su`(1M) and `rbac`(5) man pages for more information.

`18` `CL_EINTERNAL`

  Internal error was encountered

  An internal error indicates a software defect or other defect.

`35` `CL_EIO`

  I/O error

  A physical input/output error has occurred.

`36` `CL_ENOENT`

  No such object

  The object that you specified cannot be found for one of the following reasons:

  - The object does not exist.

  - A directory in the path to the configuration file that you attempted to create with the `-o` option does not exist.

  - The configuration file that you attempted to access with the `-i` option contains errors.

## Examples

Example 1 Displaying the Configuration of One Quorum Server

The following command displays the configuration information for the quorum server that uses port 9000.

    # clquorumserver show 9000

Example 2 Displaying the Configuration of Several Quorum Servers

The following command displays the configuration information for the quorum servers listed by their instance names.

    # clquorumserver show qs1 qs2 qs3

Example 3 Displaying the Configuration of All Running Quorum Servers

The following command displays the configuration information of all running quorum servers.

    # clquorumserver show +

Example 4 Starting Quorum Servers

The following command starts all the configured quorum servers.

    # clquorumserver start +

The following command starts a quorum server that is listening on port 9000.

    # clquorumserver start 9000

The following command starts the quorum server instance `qs1`.

    # clquorumserver start qs1

Example 5 Stopping a Quorum Server By Port Number

The following command stops a quorum server that is listening on port 9000.

    # clquorumserver stop 9000

Example 6 Cleaning Up Outdated Cluster Information From the Quorum Server

This example removes information about the cluster named `sc-cluster` from the quorum server.

Use caution when unconfiguring a quorum server in this way. Generally, you should use `clquorum remove` to remove the quorum server device from cluster configuration and clean up the configuration information on the quorum server in a single set. You should only need to use this command if communications were lost between the cluster and the quorum server host during the `clquorum remove` operation.

    # clquorumserver clear -c sc-cluster -I 0x4308D2CF 9000
    The quorum server to be unconfigured must have been removed from
    the cluster. Unconfiguring a valid quorum server could compromise
    the cluster quorum. Do you want to continue? (yes or no)

## Attributes

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

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | ha-cluster/service/quorum-server
Interface Stability | Evolving

## See Also

`Intro`(1CL), `clquorum`(1CL), `cluster`(1CL), `scqsd`(1M), `scqsd.conf`(4).

## Notes

The superuser can run all forms of this command.

Any user can run this command with the following options:

- `-?` (help) option

- `-V` (version) option

To run this command with other subcommands, users other than superuser require RBAC authorizations. See the following table.

Subcommand | RBAC Authorization
--- | ---
`clear` | `solaris.cluster.admin`
`show` | `solaris.cluster.read`
`start` | `solaris.cluster.admin`
`stop` | `solaris.cluster.admin`

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