]>
Commit | Line | Data |
---|---|---|
f8f39c1e MK |
1 | .\" Copyright (C) 2011, Hewlett-Packard Development Company, L.P. |
2 | .\" Written by Stephen M. Cameron <scameron@beardog.cce.hp.com> | |
3 | .\" Licensed under GNU General Public License version 2 (GPLv2) | |
4 | .\" | |
b9d931bb SC |
5 | .\" shorthand for double quote that works everywhere. |
6 | .ds q \N'34' | |
f8f39c1e | 7 | .TH HPSA 4 2011-09-21 "Linux" "Linux Programmer's Manual" |
b9d931bb SC |
8 | .SH NAME |
9 | hpsa \- HP Smart Array SCSI driver | |
10 | .SH SYNOPSIS | |
11 | .nf | |
12 | modprobe hpsa [ hpsa_allow_any=1 ] | |
13 | .fi | |
14 | .SH DESCRIPTION | |
15 | .B hpsa | |
16 | is a SCSI driver for HP Smart Array RAID controllers. | |
b3acff55 MK |
17 | .SS Options |
18 | .IR "hpsa_allow_any=1" : | |
b9d931bb SC |
19 | This option allows the driver to attempt to operate on |
20 | any HP Smart Array hardware RAID controller even if it is | |
b3acff55 MK |
21 | not explicitly known to the driver. |
22 | This allows newer hardware | |
23 | to work with older drivers. | |
24 | Typically this is used for example | |
b9d931bb SC |
25 | to allow installation of OSes from media which predates the |
26 | RAID controller though it may also be used to enable hpsa to | |
27 | drive older controllers that would normally be handled by the | |
b3acff55 MK |
28 | .BR cciss (4) |
29 | driver. | |
30 | These older boards have not been tested and are | |
31 | not supported with | |
32 | .BR hpsa , | |
33 | and | |
34 | .BR cciss (4) | |
35 | should still be used for these. | |
36 | .SS Supported Hardware | |
b9d931bb SC |
37 | The |
38 | .B hpsa | |
39 | driver supports the following Smart Array boards: | |
40 | .nf | |
41 | ||
b3acff55 MK |
42 | Smart Array P700M |
43 | Smart Array P212 | |
44 | Smart Array P410 | |
45 | Smart Array P410i | |
46 | Smart Array P411 | |
47 | Smart Array P812 | |
48 | Smart Array P712m | |
49 | Smart Array P711m | |
50 | StorageWorks P1210m | |
b9d931bb SC |
51 | |
52 | .fi | |
b3acff55 | 53 | .SS Configuration Details |
b9d931bb SC |
54 | To configure HP Smart Array controllers, use the HP Array Configuration Utility |
55 | (either hpacuxe or hpacucli) or the Offline ROM-based Configuration Utility (ORCA) | |
56 | run from the Smart Array's option ROM at boot time. | |
57 | .SH FILES | |
b3acff55 | 58 | .SS Device Nodes |
b9d931bb SC |
59 | Logical drives are accessed via the SCSI disk driver (sd), |
60 | tape drives via the SCSI tape driver (st), and | |
61 | the RAID controller vi the SCSI generic driver (sg), with | |
b3acff55 MK |
62 | device nodes named |
63 | .IR /dev/sd*, | |
64 | .IR /dev/st* , | |
65 | and | |
66 | .IR /dev/sg* , | |
67 | respectively. | |
68 | .SS HPSA-Specific Host Attribute Files in /sys | |
69 | .TP | |
70 | .I /sys/class/scsi_host/host*/rescan | |
71 | the host "rescan" attribute is a write only attribute. | |
72 | Writing to this | |
b9d931bb SC |
73 | attribute will cause the driver to scan for new, changed, or removed devices |
74 | (e.g. hot-plugged tape drives, or newly configured or deleted logical drives, | |
b3acff55 MK |
75 | etc.) and notify the SCSI midlayer of any changes detected. |
76 | Normally this is | |
b9d931bb SC |
77 | triggered automatically by HP's Array Configuration Utility (either the GUI or |
78 | command line variety) so for logical drive changes, the user should not | |
b3acff55 MK |
79 | normally have to use this. |
80 | It may be useful when hot plugging devices like | |
b9d931bb | 81 | tape drives, or entire storage boxes containing pre-configured logical drives. |
b3acff55 MK |
82 | .TP |
83 | .I /sys/class/scsi_host/host*/firmware_revision | |
b9d931bb | 84 | The "firmware_revision" attribute contains the firmware version of the Smart Array. |
b3acff55 | 85 | |
b9d931bb | 86 | For example: |
302d12b7 | 87 | |
b9d931bb | 88 | .nf |
b6c0e2d4 MK |
89 | # \fBcd /sys/class/scsi_host/host4\fP |
90 | # \fBcat firmware_revision\fP | |
b3acff55 | 91 | 7.14 |
b9d931bb SC |
92 | .fi |
93 | ||
b3acff55 MK |
94 | .SS HPSA-Specific Disk Attribute Files in /sys |
95 | .TP | |
96 | .I /sys/class/scsi_disk/c:b:t:l/device/unique_id | |
b9d931bb SC |
97 | contains a 32 hex-digit unique ID for each logical drive |
98 | .nf | |
b3acff55 | 99 | |
b9d931bb SC |
100 | For example: |
101 | ||
b6c0e2d4 MK |
102 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP |
103 | # \fBcat unique_id\fP | |
b3acff55 | 104 | 600508B1001044395355323037570F77 |
b9d931bb | 105 | .fi |
b3acff55 MK |
106 | .TP |
107 | .I /sys/class/scsi_disk/c:b:t:l/device/raid_level | |
b9d931bb SC |
108 | contains the RAID level of each logical drive. |
109 | .nf | |
b3acff55 | 110 | |
b9d931bb | 111 | For example: |
302d12b7 | 112 | |
b6c0e2d4 MK |
113 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP |
114 | # \fBcat raid_level\fP | |
b3acff55 | 115 | RAID 0 |
b9d931bb | 116 | .fi |
b3acff55 MK |
117 | .TP |
118 | .I /sys/class/scsi_disk/c:b:t:l/device/lunid | |
b9d931bb SC |
119 | (where c:b:t:l are the controller, bus, target and lun of the device) |
120 | contains 16 hex-digit (8 byte) LUN ID by which a logical drive or | |
121 | physical device can be addressed. | |
122 | .nf | |
b3acff55 | 123 | |
b9d931bb | 124 | For example: |
302d12b7 MK |
125 | |
126 | # \fBcd /sys/class/scsi_disk/4:0:0:0/device\fP | |
127 | # \fBcat lunid\fP | |
b3acff55 | 128 | 0x0000004000000000 |
b9d931bb | 129 | .fi |
b3acff55 | 130 | .SS Supported ioctl() operations |
b9d931bb SC |
131 | For compatibility with applications written for the cciss driver, many, but |
132 | not all of the ioctls supported by the cciss driver are also supported by the | |
b3acff55 MK |
133 | hpsa driver. |
134 | The data structures used by these are described in | |
135 | the kernel source file | |
136 | .IR include/linux/cciss_ioctl.h . | |
137 | .TP | |
138 | .BR CCISS_DEREGDISK ", " CCISS_REGNEWDISK ", " CCISS_REGNEWD | |
139 | The above three ioctls all do exactly the same thing, | |
140 | which is to cause the driver to rescan for new devices. | |
141 | This does exactly the same thing as writing to the | |
142 | hpsa-specific host "rescan" attribute. | |
143 | .TP | |
144 | .B CCISS_GETPCIINFO | |
b9d931bb | 145 | Returns PCI domain, bus, device and function and "board ID" (PCI subsystem ID). |
b3acff55 MK |
146 | .TP |
147 | .B CCISS_GETDRIVVER | |
b9d931bb | 148 | Returns driver version in three bytes encoded as: |
b3acff55 MK |
149 | .sp |
150 | (major_version << 16) | (minor_version << 8) | | |
151 | (subminor_version) | |
152 | .TP | |
153 | .BR CCISS_PASSTHRU ", " CCISS_BIG_PASSTHRU | |
b9d931bb SC |
154 | Allows "BMIC" and "CISS" commands to be passed through to the Smart Array. |
155 | These are used extensively by the HP Array Configuration Utility, SNMP storage | |
b3acff55 MK |
156 | agents, etc. |
157 | See | |
158 | .I cciss_vol_status at | |
159 | .I http://cciss.sf.net | |
160 | for some examples. | |
b9d931bb | 161 | .SH "SEE ALSO" |
b3acff55 MK |
162 | .BR cciss (4), |
163 | .BR sd (4), | |
164 | .BR st (4), | |
165 | .BR cciss_vol_status (8), | |
166 | .BR hpacucli (8), | |
167 | .BR hpacuxe (8), | |
168 | .IR http://cciss.sf.net , | |
169 | and the linux kernel source files | |
170 | .I Documentation/scsi/hpsa.txt | |
171 | and | |
172 | .I Documentation/ABI/testing/sysfs-bus-pci-devices-cciss | |
2df38100 MK |
173 | .\" .SH AUTHORS |
174 | .\" Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel | |
175 | .\" and probably some other people. |