ssaadm(1M)
NAME
ssaadm - administration program for SPARCstorage Array and
SPARCstorage RSM disk systems
SYNOPSIS
ssaadm [-v] [-e] subcommand [subcommand_option...] | path-
name...
DESCRIPTION
The ssaadm program is an administrative command that
manages the SPARCstorage Array and SPARCstorage RSM disk
systems (henceforth called SPARCstorage systems). ssaadm
performs a variety of control and query tasks depending on
the command line arguments and options used. The luxadm(1M)
utility replaces ssaadm and should be used instead.
The command line must contain a subcommand (listed under
USAGE) and at least one pathname. Commands specific to
either a SPARCstorage Array or a SPARCstorage RSM state
that fact. 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 system controller or a
disk in the SPARCstorage system. The controller name is
specified by its physical name, for example,
/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 system controller. The
/dev/rdsk entry is then used to determine the physical name
of the SPARCstorage system controller. A disk in the
SPARCstorage system is specified by its logical or physical
device name, for example,
/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.
The SPARCstorage Array is obsolete. Support for this device
will be removed in a future version of Solaris.
OPTIONS
The following options are supported:
-e Expert mode. This is required for the expert mode sub-
commands listed below.
-v Verbose mode.
Subcommands and their options are described below. Expert
mode subcommands are listed separately.
OPERANDS
The following operands are supported:
pathname
The SPARCstorage system controller or a disk in the
SPARCstorage system.
USAGE
Subcommands
display [-p] pathname...
Display configuration information for the specified
units or display performance information for the
specified SPARCstorage Array controller. If pathname
specifies the controller, the configuration informa-
tion is displayed for all disks in the SPARCstorage
Array. For each drive that has fast write enabled,
(FW) are displayed after the drive identification.
-p Display performance information for the speci-
fied SPARCstorage Array controller. The accumu-
lation of the performance statistics must be
enabled using the perf_statistics subcommand
before displaying the performance information.
If not enabled, all of the I/Os per second are
displayed as zeros.
The performance display reports the following
information:
BUSY How busy the controller in the
SPARCstorage Array is, expressed as a per-
centage.
IOPS The total I/Os per second for the
SPARCstorage Array.
entries for each disk
The total number of I/Os per second.
download -f filename pathname
download -w wwn pathname
Download an image to the SPARCstorage Array con-
troller.
-f 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 that the download subcommand modi-
fies the FEPROM on the SPARCstorage Array and
should be used with caution.
-w Change the SPARCstorage Array controller's World
Wide Name. wwn is a 12 digit hex number, leading
zeros required. The new SPARCstorage Array
controller's image have the least significant 6
bytes of the 8-byte World Wide Name modified to
wwn.
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. path-
name may refer to the SPARCstorage Array controller or
to an individual disk.
-c Enable fast writes for synchronous writes only.
-d Disable fast writes.
-e Enable fast writes.
-s Save the state that is currently being requested
so it persists across power-cycles.
fc_s_download [-f fcode-file]
Download the fcode contained in the file fcode-file
into all the FC/S Sbus Cards. This subcommand is
interactive and expects user confirmation before
downloading the fcode. When invoked without the [-f
fcode-file] option, the current version of the fcode
in each FC/S Sbus card is printed. Note that the
fc_s_download subcommand should be used only in
single-user mode; otherwise the FC/S card could be
reset.
insert_device pathname
Guide user through hot insertion of a disk device.
This subcommand only applies to the RSM. See NOTES for
hot plugging limitations.
perf_statistics -d pathname
perf_statistics -e pathname
Enable or disable the accumulation of performance
statistics for the specified SPARCstorage Array con-
troller. The accumulation of performance statistics
must be enabled before using the display -p subcom-
mand. This subcommand can be issued only to the
SPARCstorage Array controller.
-d Disable the accumulation of performance statis-
tics.
-e Enable the accumulation of performance statis-
tics.
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.
release pathname
Release a reservation held on the specified controll-
ers or disks. When HA (High_Availability) Software is
running on a system, do not use this subcommand to
release a disk on an SSA. Doing so could cause prob-
lems for the HA software.
remove_device pathname
Guide user through hot removal of a disk device.
This subcommand only applies to the RSM. See NOTES for
hot plugging limitations.
replace_device pathname
Guide user through hot replacement of a disk device.
This subcommand only applies to the RSM. See NOTES for
hot plugging limitations.
reserve pathname
Reserve the specified controllers or disks for
exclusive use by the issuing host. When HA
(High_Availability) Software is running on a system,
do not use this subcommand to reserve a disk on an
SSA. Doing so could cause problems for the HA
software.
set_boot_dev [-y] pathname
Set the boot-device variable in the PROM to the physi-
cal device name specified by pathname which can be a
block special device or the pathname of the directory
on which the boot file system is mounted. This subcom-
mand normally runs interactively and requests confir-
mation for setting the default boot device in the
PROM. The -y option can be used to run it in non-
interactive mode, in which case no confirmation is
requested or required.
start [-t tray-number] pathname
Spin up the specified disks. 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 specify the con-
troller.
stop [-t tray-number] pathname
Spin down the specified disks. 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 specify the con-
troller.
sync_cache pathname
Flush all outstanding writes for the specified disk
from NVRAM to the media. If pathname specifies the
controller, this action applies to all disks in the
SPARCstorage Array.
SCSI Enclosure Services (SES) Subcommands
The SPARCstorage RSM tray is addressed by the using the
logical or physical path of the SES device or specifying
the controller followed by the tray number if that con-
troller has multiple trays. The controller is addressed by
cN or the physical path to the SPARCstorage Array's con-
troller.
See ses(7D) for more information about environmental sensor
cards and associated devices.
These subcommands also work with RSM trays directly
attached to wide differential SCSI controllers.
alarm pathname | controller tray-number
Display the current state of the audible alarm.
alarm_on pathname | controller tray-number
alarm_off pathname | controller tray-number
Enable or disable the audible alarm for this enclo-
sure.
alarm_set pathname | controller tray-number [seconds]
Set the audible alarm setting to seconds.
env_display pathname | controller tray-number
Display the environmental information for the speci-
fied unit.
led pathname
Display the current state of the led for the specified
disk.
led_on pathname
led_off pathname
Turn on or off the led for this disk.
power_off pathname | controller tray-number
Power down this RSM. The RSM will need to be powered
back on manually.
This subcommand does not work with RSMs directly
attached to wide differential SCSI controllers.
Expert Mode Subcommands
See NOTES for limitations of these subcommands. Only users
that are knowledgeable about the systems they are managing
should use the expert mode subcommands.
For the following subcommands that work on a bus if a disk
is specified then the bus that disk attached to is used.
bus_getstate pathname
Get and display the state of the specified bus.
bus_quiesce pathname
Quiesce the specified bus.
bus_reset pathname
Reset the specified bus.
bus_resetall pathname
Reset the specified bus and all devices on that bus.
bus_unquiesce pathname
Unquiesce the specified bus.
dev_getstate pathname
Get the state (online or offline) of the specified
device.
dev_reset pathname
Reset the specified device.
offline pathname
Turn the specified disk offline.
online pathname
Turn the specified disk online.
EXAMPLES
Example 1: Usingssaadm to remove a disk on an SSA
An example of using the expert mode hot plugging subcommands
to hot remove a disk on a SSA follows. See NOTES for hot
plugging limitations.
The first step reserves the SCSI device so that it can't be
accessed via its second SCSI bus:
example# ssaadm reserve /dev/dsk/c1t8d0s2
The next two steps take the disk to be removed offline then
quiesce the bus:
example# ssaadm -e offline /dev/dsk/c1t8d0s2
example# ssaadm -e bus_quiesce /dev/dsk/c1t8d0s2
The user then removes the disk and continues by unquiescing
the bus, putting the disk back online, then releasing it:
example# ssaadm -e bus_unquiesce /dev/dsk/c1t8d0s2
example# ssaadm -e online /dev/dsk/c1t8d0s2
example# ssaadm release /dev/dsk/c1t8d0s2
EXIT STATUS
The following exit values are returned:
0 Successful completion.
non-zero
An error occurred.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWssaop |
|_____________________________|_____________________________|
SEE ALSO
disks(1M), luxadm(1M), attributes(5), ses(7D)
SPARCstorage Array User's Guide
NOTES
Currently, only some device drivers support hot plugging. If
hot plugging is attempted on a disk or bus where it is not
supported, an error message of the form:
ssaadm: can't acquire "PATHNAME": No such file or directory
is displayed.
Do not quiesce any bus containing a disk with the root, usr,
or swap partitions to avoid possible system deadlock.
Man(1) output converted with
man2html