unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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



 sautil(1M)							  sautil(1M)




 NAME
      sautil - Support Utility for the HP SmartArray RAID Controller Family

 SYNOPSIS
      sautil <device_file> [-s]

      sautil <device_file> download_ctlr_fw <fw_image>

      sautil <device_file> download_dev_fw <fw_image> <channel>:<target>

      sautil <device_file> reset_ctlr

      sautil <device_file> scan

      sautil <device_file> start_recovery

      sautil <device_file> accept_media_xchg <logical_drive_number>

      sautil <device_file> set_transfer_rate <rate>

      sautil <device_file> stat

      sautil <device_file> clear_stat

      sautil <device_file> get_trace_buf

      sautil <device_file> get_fw_err_log [-raw]

      sautil <device_file> clear_fw_err_log

      sautil <device_file> get_disk_err_log <channel>:<target> [-raw]

      sautil <device_file> get_pci_header

      sautil <device_file> read_regs

      sautil run_startup_script


 DESCRIPTION
      The sautil 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




 Hewlett-Packard Company	    - 1 -	  Formatted:  August 2, 2006






 sautil(1M)							  sautil(1M)




      5) Recreating the controller device file(s).

    Prerequisites
      An effective user ID of 0 (superuser) is required in order to run the
      sautil command. In addition, some of the sautil options are intended
      for use by HP support personnel and require detailed knowledge of the
      RAID SA driver or firmware to interpret the output.

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

      <device_file>	 Most sautil options require a device file
			 parameter, e.g., "/dev/ciss6". The device file for
			 a specific RAID SA controller can be determined
			 from the "ioscan -kfn" output.

			 When the device file parameter is specified without
			 any options, sautil 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 -s argument is specified, a
			 subset of the information is displayed.

      download_ctlr_fw	 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 during
			 this time.

      download_dev_fw	 This option downloads the specified firmware image
			 file (fw_image) to physical disk specified by the
			 channel and SCSI ID (channel:target).	The image
			 file name is case-sensitive.

      reset_ctlr	 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.





 Hewlett-Packard Company	    - 2 -	  Formatted:  August 2, 2006






 sautil(1M)							  sautil(1M)




      scan		 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.

      start_recovery	 This option tells the controller to start
			 rebuilding any logical drives that are in READY FOR
			 RECOVERY OPERATION state. All logical drives in
			 this state will eventually transition to
			 RECOVERING.  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
			 READY FOR RECOVERY OPERATION state.

      accept_media_xchg	 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
			 accommodate, you will need to restore your data
			 from backup media.

      set_transfer_rate	 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 auto, async, sync, ultra, ultra-2 (and ultra-
			 160 for controllers that support Ultra-320).

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

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

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

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

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



 Hewlett-Packard Company	    - 3 -	  Formatted:  August 2, 2006






 sautil(1M)							  sautil(1M)




      get_disk_err_log	 This option displays the error log for the physical
			 disk specified by the channel and SCSI ID
			 (channel:target).  When the optional -raw argument
			 is specified, the raw data (in bytes) are
			 displayed.

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

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

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

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

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

      FAILED	  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.

      USING INTERIM RECOVERY MODE
		  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.

      READY FOR RECOVERY OPERATION
		  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.

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

      WRONG PHYSICAL DISK WAS REPLACED
		  While the logical drive was in a degraded state, the



 Hewlett-Packard Company	    - 4 -	  Formatted:  August 2, 2006






 sautil(1M)							  sautil(1M)




		  system was powered off and a disk other than the failed
		  disk was replaced. Shut off the system and replace the
		  correct (failed) disk.

      PHYSICAL DISK(S) NOT PROPERLY CONNECTED
		  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.

      EXPANDING	  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).

      NOT YET AVAILABLE
		  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.

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

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

      SPARE	  The physical disk is configured as a spare disk.

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

      FAILED	  The configured physical disk has failed.

 RETURN VALUE
      sautil returns the following values:

	   0	Successful completion.
	   1	Command line syntax error.
	   2	Incompatible CISS driver API.
	   3	Failure opening a file.
	   4	Other error.





 Hewlett-Packard Company	    - 5 -	  Formatted:  August 2, 2006






 sautil(1M)							  sautil(1M)




 EXAMPLES
      Display RAID subsystem information for the controller "/dev/ciss5":

	   sautil /dev/ciss5

      Update the firmware on the controller "/dev/ciss5" using the firmware
      image file "/opt/raidsa/bin/MAXWELL332.BIN":

	   sautil /dev/ciss5 download_ctlr_fw /opt/raidsa/bin/MAXWELL332.BIN

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

	   sautil /dev/ciss5 download_dev_fw HPB4d849.lod 2:13

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

	   sautil run_startup_script

 AUTHOR
      sautil was developed by HP.

 FILES
      /opt/raidsa/bin/sautil   Executable file.

      /dev/ciss<&lt&lt&lt;X>&gt&gt&gt;	       Device files.

 SEE ALSO
      saconfig(1M).

      HP A7143A RAID160 SA Controller Support Guide
      HP Smart Array 6400 Series Controller Support Guide





















 Hewlett-Packard Company	    - 6 -	  Formatted:  August 2, 2006