JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle Solaris Cluster Reference Manual
search filter icon
search icon

Document Information

Preface

Introduction

OSC33 1

OSC33 1cl

OSC33 1ha

OSC33 1m

cconsole(1M)

ccp(1M)

chosts(1M)

cl_eventd(1M)

cl_pnmd(1M)

cports(1M)

crlogin(1M)

cssh(1M)

ctelnet(1M)

halockrun(1M)

hatimerun(1M)

pmfadm(1M)

pmfd(1M)

rpc.pmfd(1M)

scconf(1M)

scconf_dg_rawdisk(1M)

scconf_dg_svm(1M)

scconf_dg_vxvm(1M)

scconf_quorum_dev_netapp_nas(1M)

scconf_quorum_dev_quorum_server(1M)

scconf_quorum_dev_scsi(1M)

scconf_transp_adap_bge(1M)

scconf_transp_adap_ce(1M)

scconf_transp_adap_e1000g(1M)

scconf_transp_adap_eri(1M)

scconf_transp_adap_ge(1M)

scconf_transp_adap_hme(1M)

scconf_transp_adap_ibd(1M)

scconf_transp_adap_qfe(1M)

scconf_transp_jct_etherswitch(1M)

scconf_transp_jct_ibswitch(1M)

scdidadm(1M)

scdpm(1M)

sceventmib(1M)

scgdevs(1M)

scinstall(1M)

scnas(1M)

scnasdir(1M)

scprivipadm(1M)

scprivipd(1M)

scrgadm(1M)

scsetup(1M)

scshutdown(1M)

scsnapshot(1M)

scstat(1M)

scswitch(1M)

sctelemetry(1M)

scversions(1M)

scvxinstall(1M)

sc_zonesd(1M)

OSC33 3ha

OSC33 4

OSC33 5

OSC33 5cl

OSC33 7

OSC33 7p

Index

scnasdir

- manage the exported directories on a network-attached storage (NAS) device in an Oracle Solaris Cluster configuration.

Synopsis

scnasdir [-H]
scnasdir [-a] [-H] [-n] -h device-name [-d directory [-d directory…]] [-f input-file]
scnasdir -p [-H] [-h device-name] [-t device-type]
scnasdir -r [-H ] [-n ] -h device-name [-d all | -d directory [-d directory…]] 

[-f input-file]

Description


Note - Beginning with the Sun Cluster 3.2 release, 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.


The scnasdir command manages the exported directories on NAS devices in an Oracle Solaris Cluster configuration. The device must already have been configured in the cluster by using the scnas command.

The scnasdir command can be used to add directories to a device's cluster configuration, to remove directories from a device's cluster configuration, and to print the directories of a particular device or particular device types.

The options in this command are processed in the order in which they are typed on the command line. The scnasdir command can only be run from an active cluster node. The results of running the command are always the same, regardless of the node that is used.

All forms of the scnasdir command accept the -H option. Specifying -H displays help information, and all other options are ignored and not executed. Help information is also printed when scnasdir is run without options.

You can use this command only in the global zone.

Options

Basic Options

The following options are common to all forms of the scnasdir command:

-H

If this option is specified on the command line at any position, the command prints help information. All other options are ignored and are not executed. Help information is also printed if scnasdir is run with no options.

You can use this option only in the global zone.

-n

If this option is specified on the command line at any position, the scnasdir command only checks the usage and does not write the configuration data. If the -n option is specified with the -f option, the scnasdir command displays the data that will be processed for the user to review.

The following options modify the basic form and function of the scnasdir command. None of these options can be combined on the same command line.

-a

Specifies the add form of the scnasdir command. The -a option can be used to add directories into the device's Oracle Solaris Cluster configuration.

You can use this option only in the global zone.

-p

Specifies the print form of the scnasdir command. When no other option is given, this -p option prints a listing of all the directories of all the NAS devices configured in Oracle Solaris Cluster. This option can be used with additional options to query a particular device or particular types of NAS devices.

You can use this option only in the global zone.

-r

Specifies the remove form of the scnasdir command. The -r option is used to remove all the directories, or the specified directories of a NAS device from its Oracle Solaris Cluster configuration.

You can use this option only in the global zone.

Additional Options

The following additional options can be combined with one or more of the previously described basic options to manage the directories of a device.

The additional options are as follows:

-h device-name

Use this option to specify the name of the NAS device in the Oracle Solaris Cluster configuration. The -h option identifies the device and can be used to remotely access the device by using rhs or telnet.

This device name must be specified for the add, change, and remove forms of the scnasdir command.

-d all | directory

Use this option to list the directories (or volumes) exported on the NAS device to be configured into the Oracle Solaris Cluster. These directories must be created and exported on the device before using the scnasdir command. See the documentation for the NAS device type for procedures for exporting directories.

The -d all option can only be accepted by the remove option, -r.

The directories must be specified by using either the -d option, or the -f option, for the add and remove forms of the scnasdir command.

-f input-file

Directories can be placed into a plain text file, one directory per line, and used with the -f option. Leading white spaces and tabs are ignored. Comments begin with an unquoted pound (#) sign, and continue to the next new line. The parser ignores all comments.

Examples

Example 1 Adding Two NAS Storage Device Directories to a Cluster

The following scnasdir command adds two directories of a NAS device to the Oracle Solaris Cluster configuration.

# scnasdir -a -h sunnas1 -d /vol/DB1 -d /vol/DB2

Example 2 Removing All of a NAS Storage Device's Directories From a Cluster

The following scnasdir command removes all the directories that are configured for a NAS device.

# scnasdir -r -h sunnas1 -d all

Exit Status

The following exit values are returned:

0

The command executed successfully.

nonzero

An error has occurred.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Availability
SUNWsczu
Interface Stability
Evolving

See Also

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