NAME
sss — set spindle sync state of drives in an HP SCSI disk array
SYNOPSIS
sss -d
[drive_list]
device_file
sss -on
[-s]
[drive_list]
device_file
sss -off
[drive_list]
device_file
DESCRIPTION
sss
displays or changes the spindle synchronization
state of the disk drives in the HP SCSI disk array associated with device file
device_file.
Though
device_file
is the name of a device file corresponding to a LUN,
sss
operates (by default) on all disk drives physically connected
to the array controller, without regard to the drives' LUN ownership. Even if multiple LUNs (or sub-LUNs) are present,
sss
should be directed to only one of them (that is, specify the name
of the device file for only one of the LUNs in the
sss
command line). To affect a subset of the physical drives in the
array, specify which drives to affect in
drive_list.
Options
- -d
Display only. Displays the current spindle synchronization status.
This has two components: the drive's master or slave status and its
state of spindle synchronization (on or off).
- -on
Sync on. Enables spindle synchronization; one drive is designated master and
the rest are designated slaves, unless the
-s
"slave only" tag is present, in which case all designated drives will be
slaves. If only one drive is designated, it will be a master.
- -off
Sync off. Disables spindle synchronization.
- -s
Slave only. Only used with the
-on
option. Make all designated drives slaves. This is useful when
replacing a drive in a set of drives which already have spindle
synchronization enabled. If you have replaced the master drive,
use the
-on
option without
-s,
and specify the new drive only.
- drive_list
A list of drives used to specify which drives in the array will
be affected by the synchronization operation.
drive_list
is in the form
cXiY
, where
X
(a decimal number) represents the SCSI channel number, and
Y
(a decimal number) represents the SCSI-ID number of the desired drive. Drives names in
drive_list
are separated by commas. If no
drive_list
is present,
sss
defaults to all physical drives attached to the array controller,
regardless of which LUNs they belong to.
RETURN VALUE
sss
returns the following values:
- 0
Successful completion.
- -1
Command failed (an error occurred).
DIAGNOSTICS AND ERRORS
Errors can originate from problems with:
SCSI (device level) communications
Error messages generated by sss:
- usage: sss <-d | -on [-s] | -off> [cXiY,...] <special>
sss
encountered an error in command syntax.
Enter the command again with the required arguments, in the order shown.
- sss: Arg out of range
One of the arguments has exceeded its maximum or minimum size, or
is incorrect in form. Check the size and form of each argument.
- sss: device busy
To ensure that
sss
does not modify a disk array
that is being used by another process,
sss
attempts to obtain exclusive access to the disk array.
If the disk array is already opened by another process
(for example, LVM — the Logical Volume Manager),
a
``device busy''
error message is returned by the driver. To eliminate the
``device busy''
condition, determine what process has the device open.
In the case of LVM, it is necessary to deactivate the volume group containing the array before configuring the spindle sync state of the drives in the array (see
vgchange(1M)).
- sss: LUN # too big
The LUN number, which is derived from the device file name, is out of range.
- sss: Not a raw file
sss
must be able to open the device file for raw access.
- sss: Not an HP SCSI disk array
The device being addressed is not an HP SCSI disk array.
- sss: Transfer length error
The amount of data actually sent to or received from the device was not the expected amount.
SCSI (device level) communication errors:
Sense data associated with the failed operation is printed.
Error messages generated by system calls:
sss
uses the following system calls:
malloc(),
free(),
stat(),
open(),
close(),
read(),
write(),
and
ioctl().
Documentation for these HP-UX system calls contains information about the specific error conditions associated with each call.
sss
does not alter the value of
errno.
The interpretation of
errno
for printing purposes is performed by the system utility
strerror().
EXAMPLES
To display the spindle synchronization status of drives on HP SCSI disk array
/dev/rdsk/c22d0s2
on a Series 800:
To enable spindle synchronization on all drives of the HP SCSI disk array
/dev/rdsk/c410d3l3s0
on a Series 700:
sss -on /dev/rdsk/c410d3l3s0
The drive on SCSI channel 3 at SCSI ID
0
of the HP SCSI disk array
/dev/rdsk/c410d3l3s0
has just been replaced. The other drives in
the array are synchronized, and the replaced one was a slave.
To enable spindle synchronization on the new drive on a Series 700:
sss -on -s c3i0 /dev/rdsk/c410d3l3s0
If, in the replacement scenario above, the replaced drive was
the master, to enable spindle synchronization and make the new
drive a master:
sss -on c3i0 /dev/rdsk/c410d3l3s0
or, alternatively, enable the whole set again:
sss -on /dev/rdsk/c410d3l3s0
DEPENDENCIES
This utility is currently supported only on HP C2425, HP C2427, and HP C2430 disk arrays.
AUTHOR
sss
was developed by HP.