Compaq Fibre Channel Array Controller Readme

Compaq Fibre Channel Array Controller Support For IBM OS/2

Table Of Contents

1.0 Introduction
2.0 Relevant Files
3.0 Controller Ordering
4.0 Partitioning
5.0 Installation
6.0 Configuration
7.0 Hot-plug and Online Redundancy
8.0 Command Line Switches
9.0 Troubleshooting
10.0 Limitation

1.0 Introduction

This document contains information for the Compaq Fibre Channel Controller device driver
for OS/2, (CPQFCAL.ADD and CPQFCSD.SYS) for IBM OS/2 as published by IBM Corporation.
Any reference to OS/2 in this README will refer to OS2 Flavors

The Compaq Fibre Channel Array Controller driver supports the Compaq Fibre Channel Storage
Systems on OS/2. The Compaq Fibre Channel Storage System consists of the Compaq Fibre
Channel Host controller and the Compaq Fibre Channel Array controller connected in a Fibre
Channel Arbitrated Loop (FCAL).

Each Compaq Fibre Channel Host Controller supports up to six (in 7 port hub) and eleven ( in
12 port hub) Compaq Fibre Channel Array controllers on every loop connected using the Compaq
Fibre Channel Hub.

2.0 Relevant Files

CPQFCAL.HTM - This file.
CPQFCAL.ADD - Driver file.
CPQFCSD.SYS - Support Driver file.
CPQFCAL.DDP - Profile used by DDINSTAL.EXE.

3.0 Controller Ordering

See Configuring Controller Order for more information

Booting off a drive on a Compaq Fibre Channel Storage System is NOT supported.
The statement "BASEDEV=CPQFCAL.ADD" therefore should NOT be first
BASEDEV ADD entry in CONFIG.SYS. This statement SHOULD be preceded by the
entry corresponding to the boot controller driver such as:

1. If booting off a Compaq SCSI controller, the CONFIG.SYS entries should be as follows:

BASEDEV=CPQ53CX.ADD
BASEDEV=CPQFCAL.ADD
BASEDEV=CPQFCSD.SYS

2. If booting off a Compaq Array controller, the CONFIG.SYS entries should be as follows:

BASEDEV=CPQARRAY.ADD
BASEDEV=CPQFCAL.ADD
BASEDEV=CPQFCSD.SYS

4.0 Partitioning

4.1 OS/2 Limitations

See Partitioning Information.

5.0 Installation

The procedures are described in the Installing a Compaq OS/2 Driver.

6.0 Configuration

The SCSI drives on Compaq Fibre Channel Storage Systems need to be configured
as Drive Arrays and RAID (Redundant Array of Inexpensive/Independent Disks) volumes.

7.0 Hot-plug and Online Redundancy

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

Hot replacement is supported for the following controller :

* Compaq Fibre Channel Host Controller/P
* Compaq 64-Bit/66MHz Fibre Channel Host Adapter

The driver also supports online making/dissolving of redundant back-up pair of
two Fibre Channel 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 driver :

* Compaq 32-bit Helper Driver for OS/2 (CPQB32.SYS v3.20 or later)

8.0 Command Line Switches

These switches provide certain features, which may be used, for specific purposes
as described below.

1. The /V switch :

The Verbose mode switch is a standard command line switch, which causes the driver
to print information to the screen when it loads. The identity of the driver along with
the current version number will be displayed. In addition, the information regarding the
adapters and the drives attached to them will be displayed. The Adapter information
will include the IRQ number, slot number. The Drive information will include
the physical and logical drive count.

Syntax : BASEDEV=CPQFCAL.ADD /V

2. /A:[adapter index] [unit parameters]

Property : This command line switch is a standard command line switch, which will
cause the driver to modify its behavior towards 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 driver. 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 CPQFCAL.ADD, with the
lowest configured adapter being the secondary controller.

Controller Order Adapter Index
     2                   0
     3                   1
     5                   2

-I[unit parameters]

This ADD only support the /I parameter, to 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 driver from recognizing the specified adapter. Use this parameter when you
intend to allow another driver to control a specific adapter.
Example:
You are running NetWare on your OS/2 2.x 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=CPQFCAL.ADD /A:2 /I

3. /R:[Primary Slot],[Secondary Slot];

This option is used to configure a duplex pair for controller redundancy.
The Primary Slot parameter specifies the active/primary controller and
the Secondary Slot parameter specifies the redundant controller.
This option should always end with a semicolon.

Example:
BASEDEV=CPQFCAL.ADD /R:2,3;

This specifies that, the controller on slot 2 is primary and the controller on slot 3
is redundant.

BASEDEV=CPQFCAL.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.

9.0 Troubleshooting

The system may not boot if `BASEDEV=CPQFCAL.ADD' is the first BASEDEV ADD entry in
CONFIG.SYS. The first BASEDEV ADD entry should correspond to the boot
controller driver (such as CPQ53CX.ADD OR CPQARRAY.ADD).
* The driver MUST be loaded by a BASEDEV= statement in the CONFIG.SYS file.
This statement is automatically inserted by the 'ddinstal' installation procedure.
The Compaq Fibre Channel Array Controllers must be flashed with the latest available
firmware. This can be checked by using the Version Control feature in Compaq Insight
Manager
* The driver requires the Compaq BIOS-32 driver (CPQB32.SYS) in the system configuration
to support the Integrated Management Log on the Compaq ProLiant servers that have this
feature. Refer Installation of CPQB32 for installing Compaq 32-bit helper driver.
Note :
The statement 'BASEDEV=CPQB32.SYS' MUST be present in CONFIG.SYS
for making use of the Integrated Management Log.
* For OS/2 Warp Server Advanced 4.0 and OS/2 Warp Server SMP 4.0,
If the logical drive size is more than 40 GB, add maxheap = 8192 statement in
Hpfs386.ini file in IBM386FS directory. Also make sure that the System
RAM is more than 64 MB.

10.0 Limitation :

If two FCA Controllers in the system are configured as a redundant pair and the
Compaq Array Configuration Utility is running and the primary controller fails,
then all the nodes connected to the pair will be shown as locked. The lock can be
released by switching OFF and again switching ON the Compaq Fibre Channel
Array Storage System. The nodes now will be identified through the secondary controller.

-------------------------------------------------------------------------------------------------------------

* 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.