1HPSA(4) Kernel Interfaces Manual HPSA(4)
2
6 hpsa - HP Smart Array SCSI driver
7
9 modprobe hpsa [ hpsa_allow_any=1 ]
10
12 hpsa is a SCSI driver for HP Smart Array RAID controllers.
13
15 hpsa_allow_any=1 This option allows the driver to attempt to operate on
16 any HP Smart Array hardware RAID controller even if it is not
17 explicitly known to the driver. This allows newer hardware to
18 work with older drivers. Typically this is used for example to
19 allow installation of OSes from media which predates the RAID
20 controller though it may also be used to enable hpsa to drive
21 older controllers that would normally be handled by the cciss
22 driver. These older boards have not been tested and are not
23 supported with hpsa and cciss should still be used for these.
24
27 The hpsa driver supports the following Smart Array boards:
28 Smart Array P700M
30 Smart Array P212
31 Smart Array P410
32 Smart Array P410i
33 Smart Array P411
34 Smart Array P812
35 Smart Array P712m
36 Smart Array P711m
37 StorageWorks P1210m
38
41 To configure HP Smart Array controllers, use the HP Array Configuration
42 Utiltiy (either hpacuxe or hpacucli) or the Offline ROM-based Configu‐
43 ration Utility (ORCA) run from the Smart Array's option ROM at boot
44 time.
45
47 DEVICE NODES
48 Logical drives are accessed via the SCSI disk driver (sd), tape drives
49 via the SCSI tape driver (st), and the RAID controller vi the SCSI
50 generic driver (sg), with device nodes named /dev/sd*, /dev/st*, and
51 /dev/sg*, respectively.
52 HPSA SPECIFIC HOST ATTRIBUTE FILES IN /sys
54 /sys/class/scsi_host/host*/rescan the host "rescan" attribute is a
55 write only attribute. Writing to this attribute will cause the
56 driver to scan for new, changed, or removed devices (e.g. hot-
57 plugged tape drives, or newly configured or deleted logical
58 drives, etc.) and notify the SCSI midlayer of any changes
59 detected. Normally this is triggered automatically by HP's
60 Array Configuration Utility (either the GUI or command line
61 variety) so for logical drive changes, the user should not nor‐
62 mally have to use this. It may be useful when hot plugging
63 devices like tape drives, or entire storage boxes containing
64 pre-configured logical drives.
65 /sys/class/scsi_host/host*/firmware_revision The "firmware_revision"
68 attribute contains the firmware version of the Smart Array. For
69 example:
70 root@host:/sys/class/scsi_host/host4# cat firmware_revision
71 7.14
72 HPSA SPECIFIC DISK ATTRIBUTE FILES IN /sys
75 /sys/class/scsi_disk/c:b:t:l/device/unique_id contains a 32 hex-digit
76 unique ID for each logical drive
77 For example:
78 root@host:/sys/class/scsi_disk/4:0:0:0/device# cat unique_id
80 600508B1001044395355323037570F77
81 /sys/class/scsi_disk/c:b:t:l/device/raid_level contains the RAID level
83 of each logical drive.
84 For example:
85 root@host:/sys/class/scsi_disk/4:0:0:0/device# cat raid_level
86 RAID 0
87 /sys/class/scsi_disk/c:b:t:l/device/lunid (where c:b:t:l are the con‐
89 troller, bus, target and lun of the device) contains 16 hex-
90 digit (8 byte) LUN ID by which a logical drive or physical
91 device can be addressed.
92 For example:
93 root@host:/sys/class/scsi_disk/4:0:0:0/device# cat lunid
94 0x0000004000000000
95
97 For compatibility with applications written for the cciss driver, many,
98 but not all of the ioctls supported by the cciss driver are also sup‐
99 ported by the hpsa driver. The data structures used by these are
100 described in include/linux/cciss_ioctl.h
101 CCISS_DEREGDISK CCISS_REGNEWDISK CCISS_REGNEWD
103 The above three ioctls all do exactly the same thing, which is
105 to cause the driver to rescan for new devices. This does
106 exactly the same thing as writing to the hpsa specific host
107 "rescan" attribute.
108 CCISS_GETPCIINFO Returns PCI domain, bus, device and function and
111 "board ID" (PCI subsystem ID).
112 CCISS_GETDRIVVER Returns driver version in three bytes encoded as:
115 (major_version << 16) | (minor_version << 8) | (subminor_ver‐
116 sion)
117 CCISS_PASSTHRU CCISS_BIG_PASSTHRU Allows "BMIC" and "CISS" commands to
120 be passed through to the Smart Array. These are used exten‐
121 sively by the HP Array Configuration Utility, SNMP storage
122 agents, etc. See cciss_vol_status at http://cciss.sf.net for
123 some examples.
124
128 cciss(4), hpacucli(8), sd(4), st(4), hpacuxe(8), cciss_vol_status(8),
129 http://cciss.sf.net, and from the linux kernel source, Documenta‐
130 tion/scsi/hpsa.txt and Documentation/ABI/testing/sysfs-bus-pci-devices-
131 cciss
132
134 Don Brace, Steve Cameron, Tom Lawler, Mike Miller, Scott Teel and prob‐
135 ably some other people.
136 hpsa HPSA(4)