355 lines
8.3 KiB
HTML
355 lines
8.3 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of HPSA</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>HPSA</H1>
|
|
Section: Linux Programmer's Manual (4)<BR>Updated: 2017-09-15<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
hpsa - HP Smart Array SCSI driver
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<PRE>
|
|
modprobe hpsa [ hpsa_allow_any=1 ]
|
|
</PRE>
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>hpsa</B>
|
|
|
|
is a SCSI driver for HP Smart Array RAID controllers.
|
|
<A NAME="lbAE"> </A>
|
|
<H3>Options</H3>
|
|
|
|
<I>hpsa_allow_any=1</I>:
|
|
|
|
This option allows the driver to attempt to operate on
|
|
any HP Smart Array hardware RAID controller,
|
|
even if it is not explicitly known to the driver.
|
|
This allows newer hardware to work with older drivers.
|
|
Typically this is used to allow installation of
|
|
operating systems from media that predates the
|
|
RAID controller, though it may also be used to enable
|
|
<B>hpsa</B>
|
|
|
|
to drive older controllers that would normally be handled by the
|
|
<B><A HREF="/cgi-bin/man/man2html?4+cciss">cciss</A></B>(4)
|
|
|
|
driver.
|
|
These older boards have not been tested and are
|
|
not supported with
|
|
<B>hpsa</B>,
|
|
|
|
and
|
|
<B><A HREF="/cgi-bin/man/man2html?4+cciss">cciss</A></B>(4)
|
|
|
|
should still be used for these.
|
|
<A NAME="lbAF"> </A>
|
|
<H3>Supported hardware</H3>
|
|
|
|
The
|
|
<B>hpsa</B>
|
|
|
|
driver supports the following Smart Array boards:
|
|
<P>
|
|
|
|
<PRE>
|
|
Smart Array P700M
|
|
Smart Array P212
|
|
Smart Array P410
|
|
Smart Array P410i
|
|
Smart Array P411
|
|
Smart Array P812
|
|
Smart Array P712m
|
|
Smart Array P711m
|
|
StorageWorks P1210m
|
|
</PRE>
|
|
|
|
<P>
|
|
|
|
|
|
Since Linux 4.14, the following Smart Array boards are also supported:
|
|
<P>
|
|
|
|
<PRE>
|
|
Smart Array 5300
|
|
Smart Array 5312
|
|
Smart Array 532
|
|
Smart Array 5i
|
|
Smart Array 6400
|
|
Smart Array 6400 EM
|
|
Smart Array 641
|
|
Smart Array 642
|
|
Smart Array 6i
|
|
Smart Array E200
|
|
Smart Array E200i
|
|
Smart Array E200i
|
|
Smart Array E200i
|
|
Smart Array E200i
|
|
Smart Array E500
|
|
Smart Array P400
|
|
Smart Array P400i
|
|
Smart Array P600
|
|
Smart Array P700m
|
|
Smart Array P800
|
|
</PRE>
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H3>Configuration details</H3>
|
|
|
|
To configure HP Smart Array controllers,
|
|
use the HP Array Configuration Utility (either
|
|
<B><A HREF="/cgi-bin/man/man2html?8+hpacuxe">hpacuxe</A></B>(8)
|
|
|
|
or
|
|
<B><A HREF="/cgi-bin/man/man2html?8+hpacucli">hpacucli</A></B>(8))
|
|
|
|
or the Offline ROM-based Configuration Utility (ORCA)
|
|
run from the Smart Array's option ROM at boot time.
|
|
<A NAME="lbAH"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<A NAME="lbAI"> </A>
|
|
<H3>Device nodes</H3>
|
|
|
|
Logical drives are accessed via the SCSI disk driver
|
|
(<B><A HREF="/cgi-bin/man/man2html?4+sd">sd</A></B>(4)),
|
|
|
|
tape drives via the SCSI tape driver
|
|
(<B><A HREF="/cgi-bin/man/man2html?4+st">st</A></B>(4)),
|
|
|
|
and
|
|
the RAID controller via the SCSI generic driver
|
|
(<B><A HREF="/cgi-bin/man/man2html?4+sg">sg</A></B>(4)),
|
|
|
|
with device nodes named
|
|
<I>/dev/sd*</I>,
|
|
|
|
<I>/dev/st*</I>,
|
|
|
|
and
|
|
<I>/dev/sg*</I>,
|
|
|
|
respectively.
|
|
<A NAME="lbAJ"> </A>
|
|
<H3>HPSA-specific host attribute files in /sys</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1"><I>/sys/class/scsi_host/host*/rescan</I>
|
|
|
|
<DD>
|
|
This is a write-only attribute.
|
|
Writing to this attribute will cause the driver to scan for
|
|
new, changed, or removed devices (e.g., hot-plugged tape drives,
|
|
or newly configured or deleted logical drives, etc.)
|
|
and notify the SCSI midlayer of any changes detected.
|
|
Normally a rescan is triggered automatically
|
|
by HP's Array Configuration Utility (either the GUI or the
|
|
command-line variety);
|
|
thus, for logical drive changes, the user should not
|
|
normally have to use this attribute.
|
|
This attribute may be useful when hot plugging devices like tape drives,
|
|
or entire storage boxes containing preconfigured logical drives.
|
|
<DT id="2"><I>/sys/class/scsi_host/host*/firmware_revision</I>
|
|
|
|
<DD>
|
|
This attribute contains the firmware version of the Smart Array.
|
|
<DT id="3"><DD>
|
|
For example:
|
|
<DT id="4"><DD>
|
|
|
|
|
|
# <B>cd /sys/class/scsi_host/host4</B>
|
|
# <B>cat firmware_revision</B>
|
|
7.14
|
|
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAK"> </A>
|
|
<H3>HPSA-specific disk attribute files in /sys</H3>
|
|
|
|
<DL COMPACT>
|
|
<DT id="5"><I>/sys/class/scsi_disk/c:b:t:l/device/unique_id</I>
|
|
|
|
<DD>
|
|
This attribute contains a 32 hex-digit unique ID for each logical drive.
|
|
<DT id="6"><DD>
|
|
For example:
|
|
<DT id="7"><DD>
|
|
|
|
|
|
# <B>cd /sys/class/scsi_disk/4:0:0:0/device</B>
|
|
# <B>cat unique_id</B>
|
|
600508B1001044395355323037570F77
|
|
|
|
|
|
<DT id="8"><I>/sys/class/scsi_disk/c:b:t:l/device/raid_level</I>
|
|
|
|
<DD>
|
|
This attribute contains the RAID level of each logical drive.
|
|
<DT id="9"><DD>
|
|
For example:
|
|
<DT id="10"><DD>
|
|
|
|
|
|
# <B>cd /sys/class/scsi_disk/4:0:0:0/device</B>
|
|
# <B>cat raid_level</B>
|
|
RAID 0
|
|
|
|
|
|
<DT id="11"><I>/sys/class/scsi_disk/c:b:t:l/device/lunid</I>
|
|
|
|
<DD>
|
|
This attribute contains the 16 hex-digit (8 byte) LUN ID
|
|
by which a logical drive or physical device can be addressed.
|
|
<I>c</I>:<I>b</I>:<I>t</I>:<I>l</I>
|
|
|
|
are the controller, bus, target, and lun of the device.
|
|
</DL>
|
|
<P>
|
|
|
|
For example:
|
|
<DL COMPACT>
|
|
<DT id="12"><DD>
|
|
|
|
|
|
# <B>cd /sys/class/scsi_disk/4:0:0:0/device</B>
|
|
# <B>cat lunid</B>
|
|
0x0000004000000000
|
|
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAL"> </A>
|
|
<H3>Supported ioctl() operations</H3>
|
|
|
|
For compatibility with applications written for the
|
|
<B><A HREF="/cgi-bin/man/man2html?4+cciss">cciss</A></B>(4)
|
|
|
|
driver, many, but
|
|
not all of the ioctls supported by the
|
|
<B><A HREF="/cgi-bin/man/man2html?4+cciss">cciss</A></B>(4)
|
|
|
|
driver are also supported by the
|
|
<B>hpsa</B>
|
|
|
|
driver.
|
|
The data structures used by these ioctls are described in
|
|
the Linux kernel source file
|
|
<I>include/linux/cciss_ioctl.h</I>.
|
|
|
|
<DL COMPACT>
|
|
<DT id="13"><B>CCISS_DEREGDISK</B>, <B>CCISS_REGNEWDISK</B>, <B>CCISS_REGNEWD</B>
|
|
|
|
<DD>
|
|
These three ioctls all do exactly the same thing,
|
|
which is to cause the driver to rescan for new devices.
|
|
This does exactly the same thing as writing to the
|
|
hpsa-specific host "rescan" attribute.
|
|
<DT id="14"><B>CCISS_GETPCIINFO</B>
|
|
|
|
<DD>
|
|
Returns PCI domain, bus, device and function and "board ID" (PCI subsystem ID).
|
|
<DT id="15"><B>CCISS_GETDRIVVER</B>
|
|
|
|
<DD>
|
|
Returns driver version in three bytes encoded as:
|
|
<DT id="16"><DD>
|
|
|
|
|
|
(major_version << 16) | (minor_version << 8) |
|
|
<BR> (subminor_version)
|
|
|
|
|
|
<DT id="17"><B>CCISS_PASSTHRU</B>, <B>CCISS_BIG_PASSTHRU</B>
|
|
|
|
<DD>
|
|
Allows "BMIC" and "CISS" commands to be passed through to the Smart Array.
|
|
These are used extensively by the HP Array Configuration Utility,
|
|
SNMP storage agents, and so on.
|
|
See
|
|
<I>cciss_vol_status</I>
|
|
|
|
at
|
|
|
|
|
|
for some examples.
|
|
</DL>
|
|
<A NAME="lbAM"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?4+cciss">cciss</A></B>(4),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?4+sd">sd</A></B>(4),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?4+st">st</A></B>(4),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+cciss_vol_status">cciss_vol_status</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+hpacucli">hpacucli</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+hpacuxe">hpacuxe</A></B>(8),
|
|
|
|
<P>
|
|
|
|
|
|
|
|
and
|
|
<I>Documentation/scsi/hpsa.txt</I>
|
|
|
|
and
|
|
<I>Documentation/ABI/testing/sysfs-bus-pci-devices-cciss</I>
|
|
|
|
in the Linux kernel source tree
|
|
|
|
|
|
|
|
<A NAME="lbAN"> </A>
|
|
<H2>COLOPHON</H2>
|
|
|
|
This page is part of release 5.05 of the Linux
|
|
<I>man-pages</I>
|
|
|
|
project.
|
|
A description of the project,
|
|
information about reporting bugs,
|
|
and the latest version of this page,
|
|
can be found at
|
|
<A HREF="https://www.kernel.org/doc/man-pages/.">https://www.kernel.org/doc/man-pages/.</A>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="18"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="19"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="20"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DL>
|
|
<DT id="21"><A HREF="#lbAE">Options</A><DD>
|
|
<DT id="22"><A HREF="#lbAF">Supported hardware</A><DD>
|
|
<DT id="23"><A HREF="#lbAG">Configuration details</A><DD>
|
|
</DL>
|
|
<DT id="24"><A HREF="#lbAH">FILES</A><DD>
|
|
<DL>
|
|
<DT id="25"><A HREF="#lbAI">Device nodes</A><DD>
|
|
<DT id="26"><A HREF="#lbAJ">HPSA-specific host attribute files in /sys</A><DD>
|
|
<DT id="27"><A HREF="#lbAK">HPSA-specific disk attribute files in /sys</A><DD>
|
|
<DT id="28"><A HREF="#lbAL">Supported ioctl() operations</A><DD>
|
|
</DL>
|
|
<DT id="29"><A HREF="#lbAM">SEE ALSO</A><DD>
|
|
<DT id="30"><A HREF="#lbAN">COLOPHON</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:06:01 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|