cpqary3 - provides disk and SCSI tape support for HP Smart Array


The cpqary3 module provides low-level interface routines between the
common disk I/O subsystem and the HP SMART Array controllers. The cpqary3
driver provides disk and SCSI tape support for the HP Smart Array

Please refer to the cpqary3 release notes, for the supported HP Smart
Array Controllers and Storage boxes.

Each controller should be the sole initiator on a SCSI bus. Auto
configuration code determines if the adapter is present at the Configured
address and what types of devices are attached to it.


Use the Array Configuration Utility to configure the controllers. Each
controller can support up to 32 logical volumes. In addition, each
controller supports up to a maximum of 28 connected SCSI tape drives.
With 1.90 and later versions of cpqary3 driver, HP Smart Array SAS
controllers, having Firmware Revision 5.10 or later, will support 64
logical drives. This firmware also supports Dual Domain Multipath

The driver attempts to initialize itself in accordance with the
information found in the configuration file, /kernel/drv/cpqary3.conf.

New component - hmaeventd which logs the storage events onto console and
to the Integrated Management Log is made a part of HPQhma 5.0.0 package,
which is not part of the operating system. Therefore, by default, notify
on event functionality is disabled in the driver from 2.1.0 onwards.
Storage event logging may be enabled in the driver by modifying
cpqary3.conf to set the cpqary3_noe property to "on". Modification of
driver properties requires reloading the driver, which in most cases will
occur only following a reboot of the system.

The target driver's configuration file shall need entries if support is
needed for targets numbering greater than the default number of targets
supported by the corresponding target driver.

By default, entries for SCSI target numbers 0 to 15 are present in
sd.conf. Entries for target numbers 16 and above must be added to the
'scsi' class in sd.conf to support additional corresponding logical

If SCSI tape drives are connected to the supported controllers, entries
for target IDs from 33 to 33+N must be added in the /kernel/drv/st.conf
file under 'scsi' class, where N is the total number of SCSI tape drives
connected to the controller with largest number of tape drives connected
to it, in the existing configuration. For example, two supported
controller, c1 and c2 are present in the system. If controller c1 has two
(2) tape drives and controller c2 has five (5) tape drives connected,
then entries for target IDs 33 thru 38 are required under 'scsi' class in
/kernel/drv/st.conf file. The maximum number of tape drives that can be
connected to a controller is 28. With 1.90 and later versions of cpqary3
driver, if tape drives are connected to Smart Array SAS controllers, then
target ID entries for tape drives from 65 to 65+N must be added in
/kernel/drv/st.conf file under the 'scsi' class.


/kernel/drv/cpqary3.conf - configuration file for CPQary3


sd(4D), st(4D), driver.conf(5)


The Smart Array controllers supported by the current version of the
cpqary3 driver do not support 'format unit' SCSI command. Hence,
selecting 'format' option under 'format' utility main menu is not
supported. In addition, the 'repair' option under 'format' utility main
menu is not supported as this operation is not applicable to Logical
volumes connected to the supported Smart Array controllers.

December 28, 2020 CPQARY3(4D)