NAME
spd — set physical drive parameters on an HP SCSI disk array
SYNOPSIS
spd
[-a]
[-c]
[-d]
[-f]
[-r]
[-x]
[-M]
drive device_file
DESCRIPTION
spd
changes the status of a drive on an
HP SCSI
disk array associated with device file
device_file.
Options
- -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
WARNING.
- -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
reconstruction.
- -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.
- 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.
RETURN VALUE
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
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 array controller.
- 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.
- 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
ioctl().
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().
EXAMPLES
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 information.
spd -c -M c2i3 /dev/rdsk/c2t6d0
scn /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 series 700:
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, on
the
HP SCSI
disk array
/dev/rdsk/c2t6d0
on a series 700:
spd -r b2a3 /dev/rdsk/c2t6d0
NOTE
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.
WARNING
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 array.
DEPENDENCIES
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.
AUTHOR
spd
was developed by
HP.