Home | History | Annotate | Download | only in man1m
 te
 CDDL HEADER START

 The contents of this file are subject to the terms of the
 Common Development and Distribution License (the "License"). 
 You may not use this file except in compliance with the License.

 You can obtain a copy of the license at CDDL.txt
 or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions
 and limitations under the License.

 When distributing Covered Code, include this CDDL HEADER in each
 file and include the License file at CDDL.txt.
 If applicable, add the following below this CDDL HEADER, with the
 fields enclosed by brackets "[]" replaced with your own identifying
 information: Portions Copyright [yyyy] [name of copyright owner]

 CDDL HEADER END
 Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
 scconf_quorum_dev_scsi 1M "10 Apr 2006" "Sun Cluster 3.2" "System Administration Commands"
 NAME
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 - 


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 information about the object-oriented command set, see the Intro(1CL) man page.




A SCSI quorum device is considered to be any Sun 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. See scconf_quorum_dev_netapp_nas(1M) for options that are specific to NAS quorum devices.


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





.na
autoconfig
.ad


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 suboption does not assess whether an available device is qualified to be a quorum device.
If the cluster contains more than two nodes, the autoconfig suboption makes no changes to the quorum configuration. Do not use the autoconfig suboption if you intend to configure a NAS device as quorum. 





.na
[,noop]
.ad


Is valid with the autoconfig suboption. The command prints to standard output the list of quorum devices that the autoconfig suboption would add or change. The autoconfig,noop suboption 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 TYPEATTRIBUTE VALUE
AvailabilitySUNWsczu
Interface StabilityEvolving



 SEE ALSO

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