scconf_quorum_dev_scsi (1M)

Name

Synopsis

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

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

Description

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

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

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

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

-r –q globaldev=qd1

Attributes

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

See also

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