hpsa(4) - c7

1HPSA(4)                    Linux Programmer's Manual                   HPSA(4)
2
3
4

NAME

6       hpsa - HP Smart Array SCSI driver
7

SYNOPSIS

9       modprobe hpsa [ hpsa_allow_any=1 ]
10

DESCRIPTION

12       hpsa is a SCSI driver for HP Smart Array RAID controllers.
13
14   Options
15       hpsa_allow_any=1:  This  option allows the driver to attempt to operate
16       on any HP Smart Array hardware RAID  controller,  even  if  it  is  not
17       explicitly  known  to  the  driver.  This allows newer hardware to work
18       with older drivers.  Typically this is used to  allow  installation  of
19       operating  systems from media that predates the RAID controller, though
20       it may also be used to enable hpsa  to  drive  older  controllers  that
21       would  normally  be handled by the cciss(4) driver.  These older boards
22       have not been tested and are not  supported  with  hpsa,  and  cciss(4)
23       should still be used for these.
24
25   Supported hardware
26       The hpsa driver supports the following Smart Array boards:
27
28           Smart Array P700M
29           Smart Array P212
30           Smart Array P410
31           Smart Array P410i
32           Smart Array P411
33           Smart Array P812
34           Smart Array P712m
35           Smart Array P711m
36           StorageWorks P1210m
37
38   Configuration details
39       To configure HP Smart Array controllers, use the HP Array Configuration
40       Utility (either hpacuxe(8) or hpacucli(8))  or  the  Offline  ROM-based
41       Configuration  Utility  (ORCA) run from the Smart Array's option ROM at
42       boot time.
43

FILES

45   Device nodes
46       Logical drives are accessed via the  SCSI  disk  driver  (sd(4)),  tape
47       drives  via  the  SCSI tape driver (st(4)), and the RAID controller via
48       the SCSI generic driver (sg(4)),  with  device  nodes  named  /dev/sd*,
49       /dev/st*, and /dev/sg*, respectively.
50
51   HPSA-specific host attribute files in /sys
52       /sys/class/scsi_host/host*/rescan
53              This  is a write-only attribute.  Writing to this attribute will
54              cause the driver to scan for new, changed,  or  removed  devices
55              (e.g,.  hot-plugged  tape drives, or newly configured or deleted
56              logical drives, etc.)  and  notify  the  SCSI  midlayer  of  any
57              changes  detected.  Normally a rescan is triggered automatically
58              by HP's Array Configuration Utility (either the GUI or the  com‐
59              mand-line  variety);  thus,  for logical drive changes, the user
60              should not normally have to use this attribute.  This  attribute
61              may  be  useful  when  hot plugging devices like tape drives, or
62              entire storage boxes containing pre-configured logical drives.
63
64       /sys/class/scsi_host/host*/firmware_revision
65              This attribute contains the firmware version of the Smart Array.
66
67              For example:
68
69                  # cd /sys/class/scsi_host/host4
70                  # cat firmware_revision
71                  7.14
72
73   HPSA-specific disk attribute files in /sys
74       /sys/class/scsi_disk/c:b:t:l/device/unique_id
75              This attribute contains a 32 hex-digit unique ID for each  logi‐
76              cal drive.
77
78              For example:
79
80                  # cd /sys/class/scsi_disk/4:0:0:0/device
81                  # cat unique_id
82                  600508B1001044395355323037570F77
83
84       /sys/class/scsi_disk/c:b:t:l/device/raid_level
85              This attribute contains the RAID level of each logical drive.
86
87              For example:
88
89                  # cd /sys/class/scsi_disk/4:0:0:0/device
90                  # cat raid_level
91                  RAID 0
92
93       /sys/class/scsi_disk/c:b:t:l/device/lunid
94              This  attribute  contains  the  16  hex-digit (8 byte) LUN ID by
95              which a logical drive  or  physical  device  can  be  addressed.
96              c:b:t:l are the controller, bus, target and lun of the device.
97
98              For example:
99
100                  # cd /sys/class/scsi_disk/4:0:0:0/device
101                  # cat lunid
102                  0x0000004000000000
103
104   Supported ioctl() operations
105       For  compatibility  with  applications written for the cciss(4) driver,
106       many, but not all of the ioctls supported by the  cciss(4)  driver  are
107       also  supported  by the hpsa driver.  The data structures used by these
108       ioctls   are   described   in   the   Linux    kernel    source    file
109       include/linux/cciss_ioctl.h.
110
111       CCISS_DEREGDISK, CCISS_REGNEWDISK, CCISS_REGNEWD
112              These  three  ioctls  all do exactly the same thing, which is to
113              cause the driver to rescan for new devices.  This  does  exactly
114              the  same  thing  as  writing to the hpsa-specific host "rescan"
115              attribute.
116
117       CCISS_GETPCIINFO
118              Returns PCI domain, bus, device and function and "board ID" (PCI
119              subsystem ID).
120
121       CCISS_GETDRIVVER
122              Returns driver version in three bytes encoded as:
123
124                  (major_version << 16) | (minor_version << 8) |
125                      (subminor_version)
126
127       CCISS_PASSTHRU, CCISS_BIG_PASSTHRU
128              Allows  "BMIC"  and  "CISS" commands to be passed through to the
129              Smart Array.  These are used extensively by the HP Array Config‐
130              uration Utility, SNMP storage agents, etc.  See cciss_vol_status
131              at ⟨http://cciss.sf.net⟩ for some examples.
132

COLOPHON

141       This page is part of release 3.53 of the Linux  man-pages  project.   A
142       description  of  the project, and information about reporting bugs, can
143       be found at http://www.kernel.org/doc/man-pages/.
144
145
146
147Linux                             2012-08-05                           HPSA(4)

NAME

SYNOPSIS

DESCRIPTION

FILES

SEE ALSO

COLOPHON