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_netapp_nas 1M "10 Apr 2006" "Sun Cluster 3.2" "System Administration Commands"
 NAME
scconf_quorum_dev_netapp_nas - add and remove shared Network Appliance network-attached storage (NAS) quorum devices and change various NAS cluster quorum configuration properties or states.

 SYNOPSIS


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 Network Appliance NAS device can be configured as a quorum device for Sun Cluster. The NAS configuration information consists of: 




a device name, which must be unique across quorum devices 






 a filer name, which defaults to the device name if not specified






a LUN ID, which defaults to 0 if not specified




To provide support for NAS devices as quorum devices, the administrator must install the quorum device support module provided by Network Appliance. If this module is not available, scconfprevents the addition of the quorum device. See Sun Cluster With Network-Attached
Storage Devices Manual for Solaris OS for instructions about obtaining the support module.


Additionally, the iSCSI license must be valid for the Network Appliance device. 

 OPTIONS

The following options can be used for NAS 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 shared disk quorum devices.


The add and remove forms of the command are used to add and remove NAS quorum devices to or from the configuration. The change form of the command is used for changing various properties of cluster quorum configuration. 


Before you add a quorum device, you must set up and configure the device and the logical unit number (LUN) on the device to be configured as a quorum device. For detailed procedures, see your Network Appliance documentation. For Sun Cluster requirements of device setup, see Sun
Cluster With Network-Attached Storage Devices Manual for Solaris OS. After the quorum device is added, you cannot change the type.


Add a NAS quorum device:

-q -a name=devicename,type=netapp_nas[,filer=filer-name][,lun_id=0]





Change a NAS quorum device's configuration: 

-q -c name=devicename,{maintstate | reset}





Remove a NAS quorum device: 

-q -r name=devicename





The -q option supports the following Network Appliance NAS-specific suboptions:


.na
filer=filer-name
.ad


Specifies the name of the device on the network that you can use to access the NAS device when you are using rsh or telnet.





.na
lun_id=0
.ad


Specifies the LUN ID on the NAS device that will be a NAS quorum device. The LUN ID defaults to 0.





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.

 EXAMPLES

Example 1 Adding Network Appliance NAS Quorum Devices


 The following scconf command adds the Network Appliance NAS quorum device qd1. 


-a -q name=qd1,type=netapp_nas,filer=nas1.sun.com,lun_id=0





Example 2 Removing Network Appliance NAS Quorum Devices


 The following scconf command removes the Network Appliance NAS quorum device qd1. 


-r -q name=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-scsi(1M)