unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (HP-UX-11.11)
Page:
Section:
Apropos / Subsearch:
optional field



 spd(1M)							     spd(1M)




 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.



 Hewlett-Packard Company	    - 1 -   HP-UX Release 11i: November 2000






 spd(1M)							     spd(1M)




	   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:

	   +  spd

	   +  SCSI (device level) communications

	   +  system calls

    Error messages generated by spd:
      usage: spd <&lt&lt&lt;-a | -c | -d | -f | -r | -x>&gt&gt&gt; <&lt&lt&lt;-M>&gt&gt&gt; <&lt&lt&lt;cXiY>&gt&gt&gt; <&lt&lt&lt;special>&gt&gt&gt;
	   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.




 Hewlett-Packard Company	    - 2 -   HP-UX Release 11i: November 2000






 spd(1M)							     spd(1M)




      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,



 Hewlett-Packard Company	    - 3 -   HP-UX Release 11i: November 2000






 spd(1M)							     spd(1M)




      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.





























 Hewlett-Packard Company	    - 4 -   HP-UX Release 11i: November 2000