sautil - Support Utility for the HP SmartArray RAID Controller Family
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
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,
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
5) Recreating the controller device file(s).
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.
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
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
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
Hewlett-Packard Company - 2 - Formatted: August 2, 2006
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
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
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
get_pci_header This option displays the RAID SA controller's PCI
read_regs This option allows interactive reading of the RAID
SA controller's registers.
WARNING: Reading an invalid register may cause a
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
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
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
WRONG PHYSICAL DISK WAS REPLACED
While the logical drive was in a degraded state, the
Hewlett-Packard Company - 4 - Formatted: August 2, 2006
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
1) Physical disks have been added to the array (capacity
2) The stripe size is being changed (stripe-size
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
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
FAILED The configured physical disk has failed.
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
Display RAID subsystem information for the controller "/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 was developed by HP.
/opt/raidsa/bin/sautil Executable file.
/dev/ciss<<<<X>>>> Device files.
HP A7143A RAID160 SA Controller Support Guide
HP Smart Array 6400 Series Controller Support Guide
Hewlett-Packard Company - 6 - Formatted: August 2, 2006