Copyright 2000, Compaq Computer Corporation

Compaq Array Controller Support For IBM OS/2

This driver provides support for the following Array controllers:

* Compaq Integrated Smart Array Controller
* Compaq Smart Array 322DC Controller
* Compaq Smart Array 431 Controller
* Compaq Smart Array 4250ES Controller
* Compaq Smart Array 4200 Controller
* Compaq Smart Array 221 Controller
* Compaq Smart Array 3200 Controller
* Compaq Smart Array 3100ES Controller
* Compaq SMART-2DH Array Controller
* Compaq SMART-2P Array Controller
* Compaq SMART-2SL Array Controller
* Compaq SMART-2E Array Controller
* Compaq SMART Array Controller
* Compaq 32-bit Intelligent Drive Array Controller-2 (IDA-2)
* Compaq 32-bit Intelligent Drive Array Controller (IDA)
* Compaq Intelligent Array Expansion System (IAES)

Table Of Contents

1.0 Introduction
2.0 Controller Ordering
3.0 Configuration
4.0 Partitioning
5.0 Installing OS/2 to an IDA or SMART Drive
6.0 Booting from IDA or SMART Controllers
7.0 Command Line Switches
8.0 Hot-plug and Online Redundancy
9.0 Troubleshooting

1.0 Introduction

This document contains information on the use of the CPQARRAY.ADD driver for
IBM OS/2 as published by IBM Corporation. For the purposes of this
README file any reference to OS/2 will refer to: OS/2 Flavors

The CPQARRAY.ADD driver supports the Compaq SCSI Managed Array Technology
(SMART-2 & SMART) Controllers, the Compaq 32-bit Intelligent Drive
Array (IDA-2 & IDA), and the Compaq Intelligent Array Expansion System (IAES).
Do not use the older DISK01.SYS driver with these types of drives.

2.0 Controller Ordering

See here for Configuring Controller Order. The following set of rules must be followed
for the driver to function properly with other storage controllers configured in the system

NOTE: The Compaq System Configuration Utility does NOT automatically enforce these rules.
Follow them carefully when configuring the system.

1. If booting from a Compaq drive array controller, then the Compaq Array driver
CPQARRAY.ADD entry must be present in the CONFIG.SYS.

2. The Compaq IAES Controller is not a bootable device and therefore cannot be the
primary or boot controller. The system must boot from the Compaq SMART or IDA Controller
(controller order = First).

3. If an IDA or IDA-2 controller is installed on the system references to, the
IBM1S506.ADD and/or CPQEIDE.ADD must be deleted in CONFIG.SYS.

3.0 Configuration

The SCSI drives on Compaq Storage Systems need to be configured as Drive Arrays
and RAID (Redundant Array of Inexpensive/Independent Disks) volumes. This can be
done using the Compaq Array Configuration Utility available on Utilities Diskette-1.
The Compaq Array Configuration Utility also supports online configuration of
Drive Arrays and RAID volumes on OS/2 for all controllers supported by the driver
(listed above) but NOT Compaq Smart Array 4200 Controller and above.

4.0 Partitioning

See Partitioning Information

5.0 Installing IBM OS/2 on A Smart or IDA Drive

If you use SmartStart (highly recommended), all required drivers will be automatically
copied. Otherwise, please follow these steps:

1. Before starting to install, you must ensure that the Compaq Array driver
CPQARRAY.ADD is present in the Utilities Diskette-1 of your OS/2 installation diskettes.
You can use the Compaq OS/2 CD-ROM Installation Utility to add the driver.

2. Boot from the OS/2 diskette labeled Installation Diskette, and follow the procedures
for an OS/2 installation.

6.0 Booting IBM OS/2 from SMART or IDA Controllers

This section describes additional information on booting a system from a Compaq
SMART or IDA Controller. The Compaq Array driver must always be present when
booting from a Compaq SMART or IDA Controller (the Compaq IAES is not a bootable device).
If a SMART or IDA Controller is the primary disk controller, edit the CONFIG.SYS
file and make sure the "BASEDEV=CPQARRAY.ADD" entry in the file is the first
BASEDEV ADD entry present. This will guarantee that the CPQARRAY.ADD driver
will be the first ADD driver loaded and thus cause OS/2 to assign the first hard drive on the
first SMART or IDA Controller as the boot drive. For example:

BASEDEV=CPQARRAY.ADD
BASEDEV=CPQFCAL.ADD

If OS/2 will be booting from another controller, order the other controller first.
For example:

BASEDEV=CPQ53CX.ADD
BASEDEV=CPQARRAY.ADD

Remove all IDE or ESDI (ST-506) disk drivers from the CONFIG.SYS if you are using a
Compaq IDA or IDA-2 controller. Ensure that the "BASEDEV=IBM1S506.ADD" or
"BASEDEV=CPQEIDE.ADD" line is deleted.

7.0 Command Line Switches

These switches provide certain features that can be used for specific purposes as
described below.

The /PERF:[memory blocks] switch

This command line switch is a non-standard switch implemented for the
CPQARRAY.ADD. It should be used to modify the performance characteristics of the
driver when using SMART controllers. Under heavy disk utilization, this command switch
will allow greater performance based on the number associated with the [memory blocks]
parameter. The larger the [memory blocks] parameter the better the performance under heavy
disk utilization. Be aware that when you increase this parameter, the CPQARRAY.ADD
driver will use more memory.

Syntax : BASEDEV=CPQARRAY.ADD /PERF:[memory blocks]

[memory blocks] A number in the range of 3 to 9 indicating the amount of memory blocks
allocated per SMART controller in the system. The driver runs at a default value of 5.
To determine the amount of memory being used you can use this formula:
Number of SMART controllers * [memory blocks] * 64kb

Example : BASEDEV=CPQARRAY.ADD /PERF:6
The /V Switch:

The Verbose mode command line switch is a standard command line switch,
which causes the driver to print information to the screen when it loads. The driver will
identify itself along with the current revision. Then information concerning the adapters
and the drives attached to them will be provided. Adapter information includes IRQ,
slot number, and controller order number. Drive information includes physical and logical
drive count.

Syntax : BASEDEV=CPQARRAY.ADD /V
The /A:[adapter index] [unit parameters] switch :

This is a standard command line switch, which will determine the relation between the
driver and the adapters.
[adapter index] The adapter index is a number used to identify a controller. The index
is based on '0' for the lowest controller order number associated with the adapter
controlled by this ADD. The index is incremented by one for each controller in the
system as you move up the controller configuration order.

Example:
A system that has three adapters, that are controlled by the Compaq Array driver, with
the lowest configured adapter being the secondary controller.

Controller Order           Adapter Index
      2                    0
      3                    1
      5                    2

[unit parameters] This ADD only supports the /I parameter which will ignore a controller.
The following unit parameter is available:

/I Ignore the specified adapter; do not control the adapter with this driver. This parameter
prevents the ADD driver from recognizing the specified adapter. Use this parameter when
you intend to allow another driver to control a specific adapter. Warning! Be careful not to
ignore the primary controller or boot controller, because this would cause the system to
be unable to boot.
Example:
You are running NetWare on your OS/2 system and you want a NetWare NLM to
control adapter 2 instead of the ADD driver. The following statement would
prevent the ADD driver from claiming adapter 2.

BASEDEV=CPQARRAY.ADD /A:2 /I

The /R:[PrimarySlot],[SecondarySlot]; Switch:
This option is used to configure a duplex pair for controller redundancy.
The PrimarySlot parameter specifies the active/primary controller and
the SecondarySlot parameter specifies the inactive/redundant controller.
This option should always end with a semicolon.
Example:
BASEDEV=CPQARRAY.ADD /R:2,3;
This specifies that, the controller on slot 2 is primary and the controller on slot 3 is redundant.
BASEDEV=CPQARRAY.ADD /R:2,3;6,5;

More than one duplex pair can be configured, by specifying primary and secondary
slot numbers separated by a semicolon, as shown above. Here, controllers on slot 2
and 3 form a duplex pair and controllers on slot 6 and 5 form the second duplex pair.

The /SW:[days] Switch:
This switch is used in conjunction with /R option. This option enables switch over to
the secondary/redundant controller every specified days. This is to ensure that the
secondary controller is healthy. If this option is not specified, the switch over to the
redundant controller will be disabled.
Example: BASEDEV=CPQARRAY.ADD /R:2,3;  /SW:1 This indicates that the
controller switchover from active to redundant takes place every
24 hours to ensure that the back-up controller is healthy.

8.0 Hot-plug and Online Redundancy

The driver supports Hot-replacement of PCI Array Controllers present in Hot plug
slots of a system.

Hot replacement is supported for the following controllers :

* Compaq Integrated Smart Array Controller
* Compaq Smart Array 431 Controller
* Compaq Smart Array 4250ES Controller
* Compaq Smart Array 4200 Controller
* Compaq Smart Array 221 Controller
* Compaq Smart Array 3200 Controller
* Compaq Smart Array 3100ES Array Controller
* Compaq SMART-2DH Array Controller
* Compaq SMART-2P Array Controller
* Compaq SMART-2SL Array Controller

The driver also supports Online making/dissolving of redundant back-up pair of
similar controllers present in the system. To make a redundant back-up pair, one
controller should be a standalone controller and the other should be an offline
controller.

To support the Hot plug feature, it is necessary to have installed the following drivers :
 * Compaq 32-bit Helper Driver for OS/2 (CPQB32.SYS v3.20 or later)

For more help on Hot replace of the controllers,
please refer Compaq Storage Configuration Utility help file.

9.0 Troubleshooting

* The driver MUST be loaded by a BASEDEV= statement in the CONFIG.SYS file. This
statement is automatically inserted by the Installation procedure.

* The driver CPQARRAY.ADD v3.40 and later take 2-3 minutes to load if the
array controllers are configured as duplex pairs using the command line option (/R).

* You should use the latest firmware for your SMART Array controllers.
This can be checked by using the Version Control feature in Compaq Insight Manager.

* If you are using the SMART controller, please be sure you have version 2.04 or later
of the SMART controller firmware. This version of firmware can be found on the Compaq
Options ROMPAQ Diskette version 2.08 or later. This revision of the firmware
fixes a possible data loss problem associated with warm booting your system.

* The driver requires the Compaq BIOS-32 helper driver (CPQB32.SYS) in the system
Configuration to support the Integrated Management Log on the Compaq ProLiant
servers that have this feature. Please refer to Installation of CPQB32 for installing Compaq
32 - Bit helper driver.

* Please edit the HPFS386.ini file in the IBM386FS directory, if you are using any HPFS
drive and if you have system RAM greater than 64 MegaBytes, to add the following entry :
MAXHEAP=8192

Note : The statement 'BASEDEV=CPQB32.SYS' MUST be present in CONFIG.SYS for
making use of the Integrated Management Log.

Copyright 2000, Compaq Computer Corporation

All rights reserved.

* OS/2 is a registered trademark of the IBM Corporation.
Other product names mentioned herein may be trademarks or registered
trademarks of their respective companies.