sautil(1M)																sautil(1M)

NAME

       sautil - support utility for the HP SmartArray RAID controller family

SYNOPSIS

       device_file [-N]

       device_file [-s]

       device_file fw_image

       device_file fw_image physical_drive_id

       device_file fw_image encl_physical_drive_id

       device_file

       device_file

       device_file

       device_file logical_drive_number

       device_file rate

       device_file

       device_file

       device_file

       device_file [-raw]

       device_file

       device_file physical_drive_id [-raw]

       device_file

       device_file

       device_file

DESCRIPTION

       The  command is a support tool for the HP SmartArray RAID Controller Family.  This command allows the system administrator to perform tasks
       such as:

	      1) Retrieving RAID configuration and status information for the controller, logical drive, physical disk, cache, etc.;

	      2) Retrieving RAID driver information (driver state, trace log, statistics, etc.);

	      3) Downloading new revisions of controller or disk firmware;

	      4) Sending instructions to the firmware (reset controller, scan SCSI bus, etc.); and

	      5) Recreating the controller device file(s).

   Prerequisites
       Some of the options are intended for use by HP support personnel and require detailed knowledge of the RAID SA driver or firmware to inter-
       pret the output.

   Security Restrictions
       requires  either the superuser privilege or and privileges.  See privileges(5) for more information about privileged access on systems that
       support fine-grained privileges.

   Options
       recognizes the following options and parameters as indicated in the section above.  Keyword options are order-dependent, but are not  case-
       sensitive.

       device_file    Most options require a device file parameter, e.g., The device file for a specific RAID SA controller can be determined from
		      the output.

		      When the device file parameter is specified without any options, will display information such as the RAID SA driver  state,
		      controller  hardware  path,  firmware revision, capacity expansion and rebuild priority settings, cache status and settings,
		      logical drive configuration and physical drive properties.

		      When the optional argument is specified, persistent device files (see intro(7)) are displayed for logical drives.

		      When the optional argument is specified, a subset of the information is displayed.

       This option downloads the specified firmware image file
		      (fw_image) to the controller.  The image file name is case-sensitive.   The  firmware  download  process	usually  completes
		      within  one minute, but could theoretically take up to eight minutes.  All I/O to the controller are temporarily halted dur-
		      ing this time.

       This option downloads the specified firmware image file
		      (fw_image) to physical disk specified by the (physical_drive_id).  The image file name is case-sensitive.

       physical_drive_id
		      To specify the SCSI physical disk.  It can be represented as such as: 4:12.  Valid channel numbers  are  between	1  and	4.
		      Valid target numbers are between 0 and 15.

		      To  specify  the	SAS/SATA  physical  disk.  It  can  be	represented  as  either  such  as:  2I:1:10  or  (wwid),  such as:
		      0x500000e010f16432.

       This option downloads the specified firmware image file
		      (fw_image) to the storage enclosure processor.  This option is supported on SAS Smart Array HBAs only.  The image file  name
		      is  case-sensitive.   The firmware download process takes ten to fifteen minutes.  All I/O to the controller are temporarily
		      halted during this time.

       encl_physical_drive_id
		      To specify the storage enclosure processor.  It  can  be	represented  as  either  such  as:  1E:1:0  or	(wwid),  such  as:
		      0x500000e010f16432.

       This option resets the controller.
		      Some situations that may require a controller reset are:

		      1) OLR was performed and the logical drives on the replacement controller are not detected;

		      2) a  disk  enclosure  with  an  existing  RAID configuration was hot-added and the logical drives on that enclosure are not
			 detected.

       This option tells the controller to rescan all SCSI buses.
		      A situation that may require a scan is when a physical disk is hot-inserted into the system's internal drive bay.

       This option tells the controller to start rebuilding any logical drives that
		      are in state.  All logical drives in this state will eventually transition to Heavy I/O to the  controller  may  delay  this
		      transition.  There is no adverse impact if this option is invoked when no logical drives are in state.

       This option grants permission to the controller to set the state of the
		      specified  failed  logical drive (logical_drive_number) to "OK" and to set the states of all failed physical disks that have
		      been replaced via hot-plug exchanges to "OK".

		      WARNING: While this option preserves the RAID configuration (logical drive configurations, controller settings, etc.),  data
		      on  the  failed logical drive may have already been compromised.	If more disks have failed than the RAID level can accommo-
		      date, you will need to restore your data from backup media.

       This option tells the controller to set the SCSI transfer rate to a lower
		      speed than it would normally allow.  Valid arguments for the rate field are (and	ultra-160  for	controllers  that  support
		      Ultra-320).

       This option displays statistics counters maintained by the RAID SA "ciss"
		      driver.

       This option clears the statistics counters maintained by the RAID SA "ciss"
		      driver.

       This option displays the trace buffer of the RAID SA "ciss" driver.

       This option displays the firmware error log of the RAID SA controller.
		      When the optional argument is specified, the raw data (in bytes) are displayed.

       This option clears the firmware error log of the RAID160 SA controller.
		      It is not available for SmartArray 640x controllers.

       This option displays the error log for the physical disk specified by the
		      (physical_drive_id).  When the optional argument is specified, the raw data (in bytes) are displayed.

       This option displays the RAID SA controller's PCI configuration header.

       This option allows interactive reading of the RAID SA controller's
		      registers.

		      WARNING: Reading an invalid register may cause a system crash.

       This option is only available for SAS/SATA.
		      Vital  Product  Data contains Product Description, Part Number, Engineering Date Code, Serial Number, Miscellaneous Informa-
		      tion, Manufacturing Date Code, EFI Version, Asset Tag, HBA Firmware Version, and WWN.

       This option runs the RAID SA startup script to recreate the device files
		      (/dev/cissX).

   Logical Drive State Definitions
       All physical disks in the logical drive are operational.

       Some possible causes:

		      1) Multiple physical disks in a fault-tolerant (RAID 1, 1+0, 5, ADG) logical drive have failed.

		      2) One or more disks in a RAID 0 logical drive have failed.

		      3) Cache data loss has occurred.

		      4) Array expansion was aborted.

		      5) The logical drive is temporarily disabled because another logical drive on the controller had a missing disk at power-up.

       Also known as "degraded" state. A physical disk in a fault tolerant logical
		      drive has failed. For RAID 1, 1+0 or 5, data loss may result if a second disk should fail.  For  RAID  ADG,  data  loss  may
		      result if two additional disks should fail.

       A replacement disk is present, but rebuild hasn't started yet (another logical
		      drive  may be currently rebuilding). The logical drive will also return to this state if the rebuild had been aborted due to
		      unrecoverable read errors from another disk.

       One or more physical disks in this logical drive are being rebuilt.

       While the logical drive was in a degraded state, the system was powered off
		      and a disk other than the failed disk was replaced. Shut off the system and replace the correct (failed) disk.

       While the system was off, one or more disks were removed. Note: the other
		      logical drives are held in a temporary "failed" state when this occurs.

       The data in the logical drive is being reorganized because:

		      1) Physical disks have been added to the array (capacity expansion).

		      2) The stripe size is being changed (stripe-size migration).

		      3) The RAID level is being changed (RAID-level migration).

       A capacity expansion operation is in progress (or is queued up) that will make
		      room on the disks for this new logical drive.  Until room has been made on the physical disks, this newly configured logical
		      drive cannot be read or written.

       The logical drive is waiting to undergo data reorganization (see
		      above).  Possible causes for the delay are a rebuild or expansion operation may already be in progress.

   Physical Disk State Definitions
       The physical disk is configured in one or more logical drives and is
		      operational.

       The physical disk is configured as a spare disk.

       The physical disk has not been configured in any logical drives.

       The configured physical disk has failed.

RETURN VALUE

       returns the following values:

	      Successful completion.
	      Command line syntax error.
	      Incompatible CISS driver API.
	      Failure opening a file.
	      Other error.

EXAMPLES

       Display RAID subsystem information for the controller

       Update the firmware on the controller using the firmware image file

       Update the firmware on the physical disk (SCSI ID "13") connected to channel "2" of controller using the firmware image file located in the
       current directory:

       Recreate the device files for all RAID SA controllers in the system:

AUTHOR

       was developed by HP.

FILES

       Executable file.

       Device files.

SEE ALSO

       saconfig(1M), privileges(5), intro(7).

																	sautil(1M)