sautil(1M)sautil(1M)NAMEsautil - 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 privi‐
leges(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 revi‐
sion, 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 during this time.
This option downloads the specified firmware image file
(fw_image) to physical disk specified by the (physi‐
cal_drive_id). The image file name is case-sensitive.
physical_drive_id
To specify the SCSI physical disk. It can be repre‐
sented 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 repre‐
sented 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 down‐
load 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 enclo‐
sure 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 configura‐
tion (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.
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, Miscella‐
neous Information, 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 migra‐
tion).
3) The RAID level is being changed (RAID-level migra‐
tion).
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 ALSOsaconfig(1M), privileges(5), intro(7).
sautil(1M)