NAME

ssaadm − Administration program for the SPARCstorage Array

SYNOPSIS

ssaadm [ −v ] subcommand [ option ... ] pathname ...

AVAILABILITY

SUNWssaop

DESCRIPTION

The ssaadm program is an administrative command that manages the SPARCstorage Array.  ssaadm performs a variety of control and query tasks depending on the command line arguments and options used. 

The command line must contain a subcommand and at least one pathname.  It may also contain options and other parameters depending on the subcommand.  The subcommand is applied to each of the pathnames on the command line. 

pathname specifies the SPARCstorage Array controller or a disk in the SPARCstorage Array.  The controller name is specified by its physical name, e.g.,

/devices/.../.../SUNW,soc@3,0/SUNW,pln@axxxxxxx,xxxxxxxx:ctlr,

or by a name of the form

cN,

where N is the logical controller number.  ssaadm uses the cN name to find an entry in the /dev/rdsk directory of a disk that is attached to the SPARCstorage Array controller.  The /dev/rdsk entry is then used to determine the physical name of the SPARCstorage Array controller.  A disk in the SPARCstorage Array is specified by its logical or physical device name, e.g.,

/dev/rdsk/c1t0d0s2

or

/devices/.../.../SUNW,soc@3,0/SUNW,pln@axxxxxxx,xxxxxxxx/ssd@0,0:c,raw. 

See disks(1M) for more information on logical names for disks and controllers. 

OPTIONS

−v verbose mode. 

Other options specific to each subcommand are described below. 

USAGE

Subcommands

display [−p] pathname...
Display configuration information for the specified unit(s) or display performance information for the specified SPARCstorage Array controller. If pathname specifies the controller, the configuration information is displayed for all disks in the SPARCstorage Array. 

−p Display performance information for the specified SPARCstorage Array controller.  The accumulation of the performance statistics must be enabled using the perf_statistics subcommand before displaying the performance information.  If it is not, all of the I/O’s per second will be displayed as zeros.  The performance display reports the following information:

BUSY how busy the controller in the SPARCstorage Array is, expressed as a percentage. 

IOPS the total I/O’s per second for the SPARCstorage Array. 

entries for each disk
the total number of I/O’s per second.

download −f filename pathname
Download the prom image specified by filename to the SPARCstorage Array controller FEPROMs.  When the download is complete the SPARCstorage Array must be reset in order to use the downloaded code.  NOTE: The download modifies the FEPROM on the SPARCstorage Array and should be used with CAUTION. 

fast_write [−s] −c pathname

fast_write [−s] −d pathname

fast_write [−s] −e pathname
Enable or disable the use of the NVRAM to enhance the performance of writes in the SPARCstorage Array. pathname may refer to the SPARCstorage Array controller or to an individual disk. 

−s This option causes the SPARCstorage Array to save the change so it will persist across power-cycles. 

−c Enable fast writes for synchronous writes only. 

−e Enable fast writes. 

−d Disable fast writes. 

perf_statistics −e pathname

perf_statistics −d pathname
Enable or disable the accumulation of performance statistics for the specified SPARCstorage Array controller. The accumulation of performance statistics must be enabled before using the display −p subcommand.  This subcommand can be issued only to the SPARCstorage Array controller. 

−e Enable the accumulation of performance statistics. 

−d Disable the accumulation of performance statistics. 

purge pathname
Purge any fast write data from NVRAM for one disk, or all disks if the controller is specified. This option should be used with caution, usually only when a drive has failed.

reserve pathname
Reserve the specified controller(s) or disk(s) for exclusive use by the issuing host.

release pathname
Release a reservation held on the specified controller(s) or disk(s).

start [−t tray-number] pathname
Spin up the specified disk(s). If pathname specifies the controller, this action applies to all disks in the SPARCstorage Array. 

−t Spin up all disks in the tray specified by tray-number. pathname must be of the controller. 

stop [−t tray-number] pathname
Spin down the specified disk(s). If pathname specifies the controller, this action applies to all disks in the SPARCstorage Array. 

−t Spin down all disks in the tray specified by tray-number. pathname must be of the controller. 

sync_cache pathname
Flush all outstanding writes for the specified disk(s) from NVRAM to the media. If pathname specifies the controller, this action applies to all disks in the SPARCstorage Array. 

EXIT STATUS

The following exit values are returned:

0 Successful completion. 

-1 An error occurred. 

SEE ALSO

disks(1M)

NOTES

For more information, see the SPARCstorage Array Users Guide.

SunOS 5.5  —  Last change: 6 Apr 1995