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_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 - 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.

A SCSI quorum device is considered to be any Oracle Solaris 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.

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` sub-option does not assess whether an available device is qualified to be a quorum device.

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

[,`noop`]

  Is valid with the `autoconfig` sub-option. The command prints to standard output the list of quorum devices that the `autoconfig` sub-option would add or change. The `autoconfig,noop` sub-option 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 | ha-cluster/system/core
Interface Stability | Evolving

## See Also

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

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