unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 sss(1M)							     sss(1M)




 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



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






 sss(1M)							     sss(1M)




			   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:

	   +  sss

	   +  SCSI (device level) communications

	   +  system calls

    Error messages generated by sss:
      usage: sss <&lt&lt&lt;-d | -on [-s] | -off>&gt&gt&gt; [cXiY,...] <&lt&lt&lt;special>&gt&gt&gt;
	   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.



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






 sss(1M)							     sss(1M)




      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:

	   sss -d /dev/rdsk/c22d0s2

      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.





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






 sss(1M)							     sss(1M)




 AUTHOR
      sss was developed by HP.




















































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