Copyright 2000, Compaq Computer Corporation

Compaq Storage Controller Configuration Utility for OS/2 Ver 1.30

TABLE OF CONTENTS:

1.0 General Description
2.0 Description of Menu Items
     2.1 View Controller Information.
     2.2 Replace Controller
     2.3 Make redundant back-up pair
     2.4 Dissolve redundant back-up pair
     2.5 Help
     2.6 Exit
3.0 Driver versions/Controllers Supported
     3.1 Drivers and their versions supporting this utility
     3.2 List of controllers supporting Hot replace option
     3.3 List of controllers for making and dissolving Redundant Back-up pair
4.0 Terms and definitions
5.0 Other features supported
6.0 Do's and Don'ts
7.0 Limitations
8.0 Errors and suggested action
     8.1 All Phases
     8.2 Replace Phase
     8.3 Make Phase
     8.4 Dissolve Phase
9.0Installation Details

1.0 General Description

The Compaq Storage Controller Configuration Utility for OS/2 is intended to provide
the support for
-  On-line Replacement of Controllers
-  On-line Redundancy Option
With the correct versions of the drivers installed, this utility provides above-mentioned
support for controllers mentioned in "Driver versions/Controllers Support".

2.0 Description of Menu Items

2.1 View Controller Information

View Controller Information provides the Controller details as listed below for
each Storage Controller (SCSI/Array/Fibre Channel Array) present in the system.

Slot - Slot number of the controller

Controller - Name of the controller
One of SCSI/Array/Fibre Channel Array controllers listed in
"Driver versions/Controllers Support".

Hot-plug - Indicates whether the slot in which the controller is present is hot-pluggable
or not. (Yes/No)

Status - Status of the controller (Healthy/Failed)

Mode - Current Mode of operation for the controller (Active/ Standby/ Standalone/ Offline)

Pairing Slot - If a controller is paired, this field gives the slot number of the controller with
which given controller is paired.


   (In case of SCSI controllers the information about paired port is also specified).

Firmware - Firmware version of the controller present in a given slot.
(Applicable to Array controllers only)

2.2 Replace Controller

This option enables the replacement of an existing controller with a similar/same type of
controller, provided the existing controller is present in a hot-pluggable slot. On Selection
of this option, the utility guides you to carry out replace operation of either healthy or
failed controller with similar/same type of controller. In case the controller being replaced
is healthy, the utility prompts for confirmation of replacement operation.

Under heavy disk activity, it is not preferable to perform a replacement operation. In such
cases, the utility prompts you to stop the disk activity.

Replacing with similar type of controllers is possible only in case of Compaq Array Controllers.

2.3 Make redundant back-up pair

This option enables you to create a Redundant Back-up Pair with two controllers
one of which should be a standalone controller and the other should be an offline
controller.

For creating a redundant back up pair, the utility prompts you to specify the primary
and secondary controller slot numbers. Before proceeding with the pairing operation, the
utility confirms the specified controller slot numbers. The utility then prompts you to
make the appropriate connections, which will be validated by the corresponding driver.
If the connections are valid, i.e. if the controllers that are to be paired are connected
to the same storage box or hub as the case may be, the utility returns a success and
updates the config.sys file accordingly. You need not create a pair every time the
system is rebooted but the corresponding driver knows that the given two controllers are
paired by the entry present in config.sys.

Under heavy disk activity, it is not preferable to perform the pairing operation. In such
cases, the utility informs you to stop all the disk activity before proceeding with pairing.

Array controllers:
- You need to specify slot numbers of the Array Controllers to be paired when prompted
by the utility.
- You need to specify the switch over time when prompted by the utility.
- Port numbers are not relevant in case of Array Controllers.
- Controller connected to the primary port of the back plane (SCSI-3 I/O board in the
storage box), will be always configured as active even if it is specified otherwise.
This is to avoid any confusion that might arise when the system is rebooted/storage box
is power cycled.

SCSI Controllers:
- You need to specify slot and port numbers of the controllers to be paired when prompted
by the utility.
- You need to specify the switch over time when prompted by the utility.
- Controller connected to the primary port of the back plane (SCSI-3 I/O board
in the storage box), will be always configured as active. This is to avoid any confusion
that might arise when the system is rebooted/storage box is power cycled.

Fibre Channel Array Controllers:
- You need to specify the slot numbers of the primary and secondary Fibre Channel
Array Controllers to be paired when prompted by the utility.
- Normal switch over time and port numbers are not relevant in case of Fibre Channel
Array Controllers.

2.4 Dissolve redundant back-up pair

This option enables you to dissolve an existing redundant back-up pair. You will be
prompted to enter the slot numbers of active and standby controllers to be dissolved.
The information regarding active and standby controller will be available in the
View Controller Information option. Once the pair is successfully dissolved
you can remove the connection from the standby controller. Once the pair is dissolved
successfully the command line for the corresponding driver is also removed from
config.sys.
- Please note that the dissolved offline controller cannot be connected to any logical
drives in the same boot.

2.5 Help

Help function in each menu/sub menu provides brief description of each menu item.

2.6 Exit

This option enables you to exit from out of the utility.

3.0 Driver Versions/Controllers Supported

3.1 Driver and their versions supporting this utility

     Driver        Version
  a) CPQ53CX.ADD    2.70 or later
  b) CPQARRAY.ADD   3.60 or later
  c) CPQFCAL.ADD   1.20 or later with
    CPQFCSD.SYS      1.00 or later.
  d) CPQB32.SYS     3.20 or later

3.2 List of controllers supporting Hot Replace option:

Compaq Fibre Channel Controllers

Compaq Fibre Channel PCI Controller

Compaq Array Controllers

Compaq SMART-2 PCI Controller
Compaq SMART-2/SL Array controller
Compaq SMART-2/DH Array Controller
Compaq SMART-3100ES Array Controller
Compaq SMART-3200 Array Controller
Compaq SMART-221 Array Controller
Compaq SMART-4200 Array Controller
Compaq SMART-4250ES Array Controller
Compaq SMART-431 Array Controller
Compaq RAID LC2 Controller

Compaq SCSI PCI Controllers

Compaq 32-Bit Fast-Wide SCSI-2 Controller/P
Compaq Wide-Ultra SCSI Controller
Compaq Dual Channel Wide Ultra SCSI-3 Controller
Compaq 64 bit Dual Channel Wide Ultra2 SCSI Controller

3.3 List of controllers for making and dissolving Redundant Back-up pair

All the controllers listed in Sec 3.2 and the following:

Compaq Fibre Channel Controllers

Compaq Fibre Channel EISA Controller

Compaq Array Controllers

Compaq SMART 2E Controller

Compaq SCSI Controllers

Compaq SCSI 825 Controller

In case of SCSI Controllers the information will be displayed for each port
in the particular slot.

4.0 Terms and definitions

Active
- If the controller is part of a redundant back-up pair and is presently
the active controller.

Standby
- If the controller is part of a redundant back-up pair and is presently
redundant/non-active.

Standalone
- Controller that is not a part of a pair, but which has logical drives connected
to it when the system was booted.

Offline
- Controller is not connected to any storage box/hub as the case may be.
- When the corresponding driver is not using that controller for any operation on the
storage boxes if connected.

Switchover Time
- Period (in hours) after which the control switches from primary controller to the secondary
controller in a redundant configuration, in case of Compaq SCSI and Array controllers.
This feature is given to notify you if the secondary controller fails in a redundant
configuration. The normal switchover can be disabled by specifying a timeout value zero.
The default switchover time is half an hour. Note that this option is not available in
Fibre Channel Array controllers.

5.0 Other features Supported

1. Upgrading the controller is possible in following cases
  a) SMART - 2P with SMART - 2DH
  b) SMART - 2SL with SMART - 221

2. Upgrading the controller firmware is possible. Firmware of the newly inserted controller
can be greater than the firmware version of previous controller.

6.0 Do's and Don'ts

Do's

1. Replace a controller with a similar type of controller.
2. Replace a controller with a healthy controller.
3. Ensure that slot switch is closed properly after a controller has been replaced.
4. Connect the primary controller (incase of SCSI and Array controllers) to the primary
port of the back plane (SCSI-3 I/O board on the storage box). Note that if you switch off
and on the storage box for any reason, the primary port of the back-plane controller will
be active.
5. Ensure that the connections to the storage box are correct and valid after creating a
redundant back-up pair.
6. Connect the controllers to be paired to the same hub in case of Fibre Channel Array
controllers.
7. Ensure that the firmware version of the controller to be inserted is greater than or
equal to the firmware version of the controller being removed.
8. Stop all the activities on the concerned controller before replace/on-line pair/on-line
dissolve operation.

Don'ts

1. Don't Run Array Configuration Utility during replacement/make pair/dissolve pair.
2. Don't power off the storage box during replacement/make pair/dissolve pair.
3. Don't add/remove/interchange hard drives to/from the storage box during
replacement/make pair/dissolve pair operations.
4. Don't remove the cable connected to the active port of the back plane (SCSI-3 I/O
board of the storage box).
5. Don't kill the utility during replacement/on-line pair/on-line dissolve process.
Though the drivers take care to restore the old configuration, the results can be
unpredictable at times.
6. Don't interchange the cables connected to the ports/buses during replacement.
7. Don't Pair 2 ports on a single controller as a redundant back-up pair.

7.0 Limitations

1. The information displayed by the Compaq Insight Manager may not be accurate after
the process of replacement/make pair/dissolve pair operations.
2. Pairing of 2 ports on the same SCSI controller as a redundant back-up pair is not supported.

Limitations for Array Controllers:

1. The controllers being replaced should be of a similar type or an upgrade version.
2. The firmware version of the controller being replaced should be same or upgrade.
3. Making/Dissolving of Online redundant back-up pair is not supported for :
  * Compaq Smart 3100ES Array Controller
  * Compaq Smart 3200 Array Controller
4. Pairing of 2 buses on the same Array controller as a redundant back-up pair is not supported.
5. Pairing of 2 dissimilar Array controllers as redundant back-up pair is not supported.

8.0 Errors and Suggested action

8.1 All Phases

Error No. - 0x212
Description - In situations where in there is heavy disk activity for a particular controller
being replaced / paired / dissolved.
Suggested Action - Stop all disk activities to the concerned controller before continuing
with Replace / Make / Dissolve Pair.

Error No. - 0x214
Description - In situation when the system is stabilizing after a replacement of a controller
or making/dissolving of a redundant back-up pair.
Suggested Action - Wait for a few seconds until system stabilizes before retrying the activity.

8.2 Replace Phase

Error No. - 0x101
Description - The Compaq 32-bit helper driver (CPQB32.SYS) is not loaded.
Suggested Action - Load the proper version of the CPQB32.SYS (Version 3.20 or later).
Make entry "BASEDEV=CPQB32.SYS" in the CONFIG.SYS file and reboot the system.

Error No. - 0x102
Description - The proper version of the Compaq 32-bit helper driver (CPQB32.SYS) is
not loaded.
Suggested Action - Load the proper version of the CPQB32.SYS (Version 3.20 or later)
and reboot the system.

Error No. - 0x103
Description - The system does not support Hot Replace facility.
Suggested Action - Hot replace option is possible only in systems with Hot-plug slots.

Error No. - 0x104
Description - The slot specified is not a physical slot.
Suggested Action - Specify a correct slot number.

Error No. - 0x105
Description - Only controllers in Hot-Plug slots can be replaced with.
Suggested Action - Specify a Hot-Plug slot for replacement.
View the controller details in the utility to check for hot-plug slots.

Error No. - 0x106
Description - A controller has to be present in the specified slot for it
to be replaced.
Suggested Action - View the controller details in the utility to check for
the presence of storage controllers.

Error No. - 0x201
Description - No controller is inserted in the specified slot.
Suggested Action - With the help of the utility insert the controller properly
in the specified slot and close the switch correctly.

Error No. - 0x202
Description - The controller inserted in the slot is FAILED.
Suggested Action - With the help of the utility insert a healthy controller
in the specified slot.

Error No. - 0x207
Description - The controller replaced has a firmware version less than the
controller present earlier.
Suggested Action - Insert a controller with firmware version greater than or equal
to that of the controller to be replaced.

Error No. - 0x20C
Description - The controller inserted in the specified slot is different from the
controller removed and / or the controller is not inserted properly.
Suggested Action - View the controller details in the utility for more information.

Error No. - 0x210
Description - The cable is not connected to the storage box and/or box power is
switched OFF.
Suggested Action - No possible remedies. Data may be lost.

Error No. - 0x211
Description - In case of ARRAY Controller, if Bus-0 is interchanged to Bus-1 after
replacement of controller and in case of SCSI Controller, ports are interchanged after
controller replacement, OR,
During the process of making pair secondary port of the SCSI-3 I/O controller not connected.
Suggested Action - No possible remedies. Data may be lost.

8.3 Make Phase

Error No. - 0x107
Description - The controller in the same slot cannot be paired or dissolved.
Suggested Action - Specify different slot numbers.
View the controller details for more information.

Error No. - 0x108
Description - The port number specified is not correct.
(Only in case of SCSI controllers).
Suggested Action - Specify a valid port number. View the controller details
for more information.

Error No. - 0x109
Description - At least one of the specified slots does not have a controller.
Suggested Action - Ensure that the specified slots have the respective
controllers. View the controller details for information regarding controller slot numbers.

Error No. - 0x10A
Description - Only similar controllers can be paired or dissolved.
Suggested Action - View the controller details for information about the
controllers present in the system.

Error No. - 0x10B
Description - The utility is unable to open the CONFIG.SYS file.
Suggested Action - Check if the CONFIG.SYS file is present in the root directory,
and check for the attributes of the file. (The file should not be read-only file)

Error No. - 0x203
Description - The controllers in the specified slots cannot be configured.
Suggested Action - View the controller details for more information. Probably
trying to pair two non similar controllers.

Error No. - 0x204
Description - At least one of the controllers in the specified slots is already paired.
Suggested Action - View the controller details for more information.

Error No. - 0x206
Description - The controllers and the nodes are not connected properly. / New or
different boxes have been connected. / One or more boxes have been removed.
Suggested Action - The possible causes are:
1. Cable of another ProLiant Storage box connected to the inserted controller.
2. All logical/physical drives that are connected to the inserted controller are failed.
3. Different logical drives connected to the same ProLiant Storage box and connected to the
inserted controller.

Check for the connection from the node (storage box) and the controller.

Error No. - 0x20D
Description - Pairing of the controllers selected cannot be done as both the controllers
have different storage box(es) / no boxes connected to them.
Suggested Action - View the controller details for more information.

Error No. - 0x20E
Description - The Pairing is not possible. The reasons may be one of the following.
1. The primary or secondary controller should have at least one node connected when the
system booted.
2. You may be trying to pair the secondary controller (of a dissolved pair) to an offline
controller.
Suggested Action - View the controller details for more information.

Error No. - 0x211
Description - In case of ARRAY Controller, if Bus-0 is interchanged to Bus-1 after
replacement of controller and in case of SCSI Controller, ports are interchanged after
controller replacement, OR,
During the process of making pair secondary port of the SCSI-3 I/O controller not connected.
Suggested Action - No possible remedies. Data may be lost.

Error No. - 0x213
Description - In case of SCSI Controllers, if the port numbers specified are incorrect.
Suggested Action - Only SCSI 876 Controller has two ports. Specify correct port
number and try again.

8.4 Dissolve Phase

Error No. - 0x107
Description - The controller in the same slot cannot be paired or dissolved.
Suggested Action - Specify different slot numbers.
View the controller details for more information.

Error No. - 0x109
Description - At least one of the specified slots does not have a controller.
Suggested Action - Ensure that the specified slots have the respective
controllers. View the controller details for information regarding controller slot numbers.

Error No. - 0x10A
Description - Only similar controllers can be paired or dissolved.
Suggested Action - View the controller details for more information about the
controllers present in the system.

Error No. - 0x10B
Description - The utility is unable to open the CONFIG.SYS file.
Suggested Action - Check if the CONFIG.SYS file is present in the root directory,
and check for the attributes of the file. (The file should not be read-only file)

Error No. - 0x203
Description - The controllers in the specified slots cannot be configured.
Suggested Action - View the controller details for more information. Probably
trying to pair two non similar controllers.

Error No. - 0x205
Description - At least one of the controllers in the specified slots is
Standalone / Offline / Paired with a different controller.
Suggested Action - View the controller details for more information.

Error No. - 0x20D
Description - The controllers in the specified slots cannot be dissolved.
Suggested Action - In case of SCSI and Array controllers, please ensure that the
active controller is connected to the active port (Port A) of the Ultra SCSI-3 I/O board.
Otherwise you may not be able to use the logical drives during the next boot.

Error No. - 0x213
Description - In case of SCSI Controllers, if the port numbers specified are incorrect.
Suggested Action - Only SCSI 876 Controller has two ports. Specify correct port
number and try again.

9.0 Installation Details

For installation details, please refer installation help file of Compaq Storage Configuration Utility.

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

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.