spd - set physical drive parameters on an HP SCSI disk array
spd [-a] [-c] [-d] [-f] [-r] [-x] [-M] drive device_file
spd changes the status of a drive on an HP SCSI disk array associated
with device file device_file.
-a Add drive. Adds a drive to the set of drives
known by the controller.
-c Clear the warning, or "failed disk" error status.
Parity checking via scn must be performed
immediately following this operation. See
-d Delete drive. Deletes a drive from the set of
drives known by the controller.
-f Fail drive. Marks the drive as failed, and may
place the LUN(s) residing on it in a dead or
degraded state, depending on RAID level, and the
presence of other failed drives in the LUN.
-r Replace drive. Marks the drive as replaced, which
instructs the controller to start reconstructing
the LUN(s) associated with this replaced drive.
-x Replace and format drive. Marks a drive as
replaced, and instructs the controller to
physically format the drive before starting LUN
-M Force the selected option. By altering the state
of individual disk mechanisms contained within a
disk array, the state of configured LUN devices
may also be altered. For example, if the disk
array has a LUN configured into a RAID 5
configuration, and one of the disk mechanisms used
to create the LUN is in a FAILED state, the disk
array will be operating in a DEGRADED mode. If
the user selected the FAIL DRIVE option on one of
the functioning disk mechanisms of the LUN, the
state of the LUN would be changed from DEGRADED to
DEAD. spd will warn the user of any significant
change in LUN state resulting from their selected
option. The -M option suppresses these warnings
and performs the selected operation.
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
drive Specified 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 disk drive.
spd 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
+ system calls
Error messages generated by spd:
usage: spd <<<<-a | -c | -d | -f | -r | -x>>>> <<<<-M>>>> <<<<cXiY>>>> <<<<special>>>>
An error in command syntax has occurred. Enter command again
with all required arguments, in the order shown.
spd: device busy
To ensure that spd does not modify a disk array that is being
used by another process, spd 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 array (see vgchange(1M)).
spd: 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.
spd: LUN does not exist
The addressed LUN is not configured, and thus is not known to the
spd: LUN # too big
The LUN number, which is derived from the device file name, is
out of range.
spd: Not a raw file
Utilities must be able to open the device file for raw access.
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000
spd: Not an HP SCSI disk array
The device being addressed is not an HP SCSI disk array.
SCSI (device level) communication errors:
Sense data associated with the failed operation is printed.
spd: Transfer length error
The amount of data actually sent to or received from the device
was not the expected amount.
Error messages generated by system calls:
spd uses the following system calls:
malloc(), free(), stat(), open(), close(), read(), write(), and
Documentation for these HP-UX system calls contains information about
the specific error conditions associated with each call. spd does not
alter the value of errno. The interpretation of errno for printing
purposes is performed by the system utility strerror().
The following command clears the FAILED state of the drive at ID 3 on
channel 2 on the HP SCSI disk array /dev/rdsk/c2t6d0 on a series 700.
The -M option must be selected to suppress warning messages. The scn
operation must be performed immediately to ensure accurate data parity
spd -c -M c2i3 /dev/rdsk/c2t6d0
To add the drive at ID 3 on channel 2 to the set of drives the array
controller knows about on the HP SCSI disk array /dev/rdsk/c2t6d0 on a
spd -a c2i3 /dev/rdsk/c2t6d0
To delete the drive at ID 3 on channel 2 from the set of drives the
array controller knows about on the HP SCSI disk array
/dev/rdsk/c2t6d0 on a series 800:
spd -d c2i3 /dev/rdsk/c2t6d0
To mark the drive at ID 3 on channel 2 as failed, thus rendering any
redundant RAID mode LUN (s) residing on it as dead or degraded, on the
HP SCSI disk array /dev/rdsk/c2t6d0 on a series 700:
spd -f -M c2i3 /dev/rdsk/c2t6d0
To mark the drive at ID 3 on channel 2 as replaced, thus initiating
the reconstruction of any redundant RAID mode LUN (s) residing on it,
Hewlett-Packard Company - 3 - HP-UX Release 11i: November 2000
on the HP SCSI disk array /dev/rdsk/c2t6d0 on a series 700:
spd -r b2a3 /dev/rdsk/c2t6d0
Failing a drive on a RAID_0 LUN will leave it with an "optimal" LUN
status, even though the controller will no longer access the failed
drive and its data.
Clearing a "failed" disk status might leave the array with
inconsistent parity. This can lead to corrupted data if the array LUN
ever operates in "degraded" state. Parity scan and repair must be
performed immediately after clearing the "failed" state of a disk
The HP C2425 and HP C2427 disk arrays are only supported on Series 700
systems running HP-UX version 9.0X.
The HP C2430 disk array is supported on Series 700 and 800 systems
running HP-UX versions 9.0X and 10.0X.
spd was developed by HP.
Hewlett-Packard Company - 4 - HP-UX Release 11i: November 2000