IBM SSA RAID Adapters for PC Servers
------------------------------------
Windows NT Device Drivers and Utilities - README.TXT
----------------------------------------------------
This "readme.txt" file contains installation instructions for the IBM SSA
RAID Cluster Adapter and the IBM SSA RAID Adapter Device Drivers . Please
ensure the section you are reading is applicable to the adapter being
configured. It also contains instructions relating to the and Utility
Software for use with Windows NT. Please also refer to the sections
"Problems?" and "PC Server BIOS levels" in this readme file for other
important information about this product.
This README file is divided into the following categories:
- Before You Install either IBM SSA RAID Adapter.
- Software Requirements.
- Hardware Requirements.
- Getting Help.
- Installing the IBM SSA RAID Cluster Adapter.
- Configurator Error codes.
- Trademarks.
Before You Install the IBM SSA RAID Cluster Adapter / IBM SSA RAID Adapter
--------------------------------------------------------------------------
PC Server BIOS Levels
---------------------
NOTE: It is recommended that you ensure that the Server you are using
has the latest BIOS. These can be obtained from the follow sites:
(919)-517-0001 : IBM PC Company BBS Research Triangle Park, USA.
ftp.pc.ibm.com : IBM PC Company anonymous ftp site.
www.compaq.com : Compaq company web site.
www.hp.com : Hewlett Packard company web site.
At the time of writing, the tested levels are:
PC Server 704 PCI/EISA, Flash BIOS 10 (06-26-97)
PC Server 720 PCI/MCA, Flash BIOS v1.09 (06-16-97)
PC Server 520 PCI/EISA, Flash BIOS 16T3C (07-15-96)
PC Server 320 PCI/EISA, Flash BIOS 16T3B (07-15-96)
PC Server 330/325 PCI/EISA, Ship level at time of writing
COMPAQ ProLiant 1500, COMPAQ System BIOS E12 (12/30/1996)
COMPAQ ProLiant 2500, COMPAQ System BIOS E24 (12/30/1996)
COMPAQ ProLiant 5000, COMPAQ System BIOS E16 (12/30/1996)
COMPAQ ProLiant 6000, COMPAQ System BIOS E20 (05/16/1997)
HP NetServer LH Pro, Phoenix BIOS v 4.05.14PF P and P (12/11/96)
HP NetServer LX Pro, AMIBIOS - American Megatrends V 1.00.4.CD0L
Windows NT Level
----------------
NOTE: It is recommended that you ensure that the version of Windows Windows
being used has the latest level service pack applied. At the time of
writing this was Service Pack 3 for NT4.0.
They may be obtained from Microsoft's ftp site at:
ftp.microsoft.com/bussys/winnt/winnt-public/fixes/usa/nt40/ussp3 (SP 3)
Hardware Requirements
---------------------
- A supported PC Server platform which has a PCI bus (level 2.1).
- 1 MB of fixed disk space above that required by NT.
- .5 MB of memory above that required by NT.
- 2-button mouse or other pointing device.
- IBM SSA RAID Cluster Adapter / IBM SSA RAID Adapter, installed into a PCI
slot of the personal computer.
Compaq Installation Restrictions
--------------------------------
Proliant 1500 - A maximum of 2 Adapters is supported
PCI Bus Slot With Handle? Comments
Bus 0 P6 Yes Valid slot.
Bus 0 P7 Yes Valid slot.
Bus 0 P8 Yes Valid slot.
Proliant 2500 - A maximum of 3 Adapters is supported
Cards may be inserted into any of the 2500's PCI slots except slot P6,
where interference with the computers chassis may cause damage to the
SIMM module when a card is removed from P6.
PCI Bus Slot With Handle? Comments
Bus 0 P1 Yes Valid slot.
Bus 0 P2 Yes Valid slot.
Bus 0 P3 Yes Valid slot.
Bus 0 P4 Yes Valid slot.
Bus 0 P5 NO Valid Slot.
Bus 0 P6 NO **DO NOT USE** Will destroy SIMM banks.
Proliant 5000 - A Maximum of 3 Adapters is supported
Some restrictions apply when populating both buses with Adapters -
which is recommended for performance reasons. The table below shows all
restrictions. All other configurations are supported.
Bus 0 Bus 1 RESTRICTION
P6 P2 Can populate either PCI Slot but NOT both with SSA Adapters
P7 P3 Can populate either PCI Slot nut NOT both with SSA Adapters
P8 P4 Can populate either PCI Slot but NOT both with SSA Adapters
All slots may require minor adjustment of the card stabiliser, loosen one
of the screws holding the plastic card stabiliser to the casing and
re-align to accommodate as required, remembering to tighten the screw again
when finished.
PCI Bus Slot With Handle? Comments
Bus 1 P2 Yes Valid Slot.
Bus 1 P3 Yes Valid Slot.
Bus 1 P4 Yes Valid Slot.
Bus 0 P5 NO Valid Slot.
Bus 0 P6 NO Valid Slot.
Bus 0 P7 NO Valid Slot.
Bus 0 P8 NO Valid Slot.
Proliant 6000 - A Maximum of 3 Adapters is supported
There are no PCI slot restrictions
Hewlett Packard NetServer LH Pro
Los Gatos 1/2M and 1Mbyte SSA cards may be inserted into any of the five
HP LH Netserver PCI slots. However the spacing of the PCI connectors in
the LH may prevent two SSA cards, or an SSA card and another full length
card from being placed in adjacent slots.
PCI Bus Slot With Handle? Comments
Bus 1 P5 Yes Valid Slot.
Bus 1 P6 Yes Valid Slot.
Bus 1 P7 Yes Valid Slot.
Bus 1 P8 Yes Valid Slot.
Bus 0 P9 NO Valid Slot.
Hewlett Packard NetServer LX Pro
Los Gatos 1/2M and 1Mbyte SSA cards may be inserted into any of the six
HP LX Netserver PCI slots. However the spacing of the PCI connectors in
the LX may prevent two SSA cards, or an SSA card and another full length
card from being placed in adjacent slots.
PCI Bus Slot With Handle? Comments
Bus 0 P1 Yes Valid Slot.
Bus 0 P2 Yes Valid Slot.
Bus 0 P3 Yes Valid Slot.
Bus 1 P4 Yes Valid Slot.
Bus 1 P5 Yes Valid Slot.
Bus 1 P6 Yes Valid Slot.
Getting Help
------------
Documentation
Service and Technical Support
Defect Reporting
Available Documentation
-----------------------
- Installation and Users Guide S32H-3816-xx
- Maintenance Information Manual S32H-3817-xx
- Technical Reference Manual SA33-3268-xx
Service and Technical Support
-----------------------------
We are ready to help you with your IBM SSA RAID Adapter questions. You can
contact us through one of the following:
For Technical Support:
- Please contact your supplier in the first instance
- BBS, for latest files etc.
o US: (919) 517-0001 (300 - 28.8K, 8-N-1)
o UK: (0)1705-492831 (2.4K - 14.4K, 8-N-1)
o Germany: (0)6131-845070 (2.4K - 14.4K, 8-N-1)
For Product Information:
- WWW, http://www.storage.ibm.com/storage
Defect Reporting
----------------
Please report any defects to the supplier of your adapter.
INSTALLING THE IBM SSA RAID CLUSTER ADAPTER : 96H9835
-----------------------------------------------------
Before installing the IBM SSA RAID Cluster Adapter Device Drivers for NT
------------------------------------------------------------------------
Any arrays previously configured by this or previous adapters must be
deleted prior to the members of this array being used as single SSA
devices. Partition information on the array should first be removed by
using Disk Administrator and then the array can be detached and deleted
by the configurator.
Users who may have created RAID-5 or RAID-0 arrays on previous IBM SSA
adapters are advised that any data required on these disks MUST be
migrated to either single SSA devices or RAID-1 arrays and the original
arrays deleted BEFORE attaching to the IBM SSA Cluster adapter.
You should also ensure that the device driver you are running is the
latest level, which may be downloaded from
http://www.pc.ibm.com/us/searchfiles.html (keywords "ssa raid")
Installing the IBM SSA RAID Cluster Adapter Device Drivers for NT 4.0
---------------------------------------------------------------------
1) Select START from the taskbar.
2) Select SETTINGS then CONTROL PANEL.
3) Select SCSI ADAPTERS.
- Click DRIVERS tab.
- Click ADD button.
- Click HAVE DISK.
- Insert IBM SSA NT Drivers diskette and click OK.
- Select "96H9835 IBM SSA RAID Cluster Adapter"
- Click OK.
- Change path displayed to A:\ if necessary.
- Click CONTINUE.
4) A setup message will appear:
The PC Server in which the 'IBM SSA RAID Cluster Adapter' is installed
MUST be assigned a unique designator. The following panel will allow
you to select the 'PC Server Designator' for this PC Server
This allows the selection of whether the server is to be the (A) or (B).
Select the required option and click OK.
5) It is now necessary to install the IBM SSA-SCSI Driver, a setup message
will appear:
The SSA install program has detected that you need also to install
the IBM SSA-SCSI Driver. When asked to Reboot your machine,select
'no' and install the IBM SSA-SCSI driver by clicking 'Add' at the
'Installed Drivers' menu and then select IBM SSA-SCSI Driver from
the 'Install Driver' menu.
Click OK and select No from the next menu.
6) Click ADD button.
- Select "IBM SSA-SCSI Driver"
- Click OK.
- Change path displayed to A:\ if necessary.
- Click CONTINUE.
7) A setup message will appear:
The IBM SSA-SCSI Driver has been installed. This driver will
replace the NT supplied Disk.sys. If you remove the IBM SSA
Adapter Driver, you should also remove this IBM SSA-SCSI Driver
Click OK.
8) A setup message will appear:
The device driver and various utilities programs to enable you
to use the IBM SSA RAID Adapter has been successfully installed
on your operating system and the SSA Event Logging Service has been
installed.
Click OK and then click Yes to restart the machine.
Once you have restarted your machine you can run the SSA Configurator
("install drive"\issa\issacfg), this will give you access to the
functions required to make the SSA resources available to your
operating system
INSTALLING THE IBM SSA RAID ADAPTER : 32H3821
---------------------------------------------
Installing the IBM SSA RAID Adapter Device Drivers for NT 4.0
-------------------------------------------------------------
1) Select START from the taskbar.
2) Select SETTINGS then CONTROL PANEL.
3) Select SCSI ADAPTERS.
- Click DRIVERS tab.
- Click ADD button.
- Click HAVE DISK.
- Insert IBM SSA NT Drivers diskette and click OK.
- Select "32H3821 IBM SSA RAID Adapter"
- Click OK.
- Change path displayed to A:\ if necessary.
- Click CONTINUE.
4) The ISSA device driver will now be copied your system.
5) It is now necessary to install the IBM SSA-SCSI Driver, a setup message
will appear:
The SSA install program has detected that you need also to install
the IBM SSA-SCSI Driver. When asked to Reboot your machine,select
'no' and install the IBM SSA-SCSI driver by clicking 'Add' at the
'Installed Drivers' menu and then select IBM SSA-SCSI Driver from
the 'Install Driver' menu.
Click OK and select No from the next menu.
6) Click ADD button.
- Select "IBM SSA-SCSI Driver"
- Click OK.
- Change path displayed to A:\ if necessary.
- Click CONTINUE.
7) A setup message will appear:
The IBM SSA-SCSI Driver has been installed. This driver will
replace the NT supplied Disk.sys. If you remove the IBM SSA
Adapter Driver, you should also remove this IBM SSA-SCSI Driver
Click OK.
8) A setup message will appear:
The device driver and various utilities programs to enable you
to use the IBM SSA RAID Adapter has been successfully installed
on your operating system and the SSA Event Logging Service has been
installed.
Click OK and then click Yes to restart the machine.
Once you have restarted your machine you can run the SSA Configurator
("install drive"\issa\issacfg), this will give you access to the
functions required to make the SSA resources available to your
operating system
9) Now remove any diskettes, shutdown and reboot your operating system.
NOTES:
------
1) The utilities programs are automatically copied to a directory "\issa",
located on the NT's system partition, during SETUP.
2) If you install the SSA Device Drivers AT THE SAME time that you install
Microsoft's Windows NT, then you will need to reinstall them once the
operating system installation has been completed - overwriting the IBM
SSA RAID Adapter device driver which was used during initial setup of
the operating system. It is only during the "Adding a SCSI Adapter"
option from an installed copy of NT that the utility programs are copied
to your system.
NOTE: NT will detect that the driver already exists. Please replace the
existing driver with the 'new' one, i.e. use the support diskette
again. If your operating system is also on an SSA disk drive then
you must NOT perform a reboot during the Device Driver uninstall or
reinstall process.
3) Clicking the right mouse button in 'Explorer' on NT of IBMSSA.SYS either
on the original install diskette or in the system drivers directory
brings up the "Properties box". Clicking on the version tab will give
information useful in the diagnosis of any problems if they need to be
reported to an IBM representative.
Utilities Software
------------------
The following utilities are copied to the "\issa" directory during SETUP.
ISSAELIN.EXE - SSA Event Logger service install
ISSAELSR.EXE - SSA Event Logger service requester
ISSAELOG.EXE - SSA Event Logger
EVNINST.TXT - Event Logger Install Text File
EVNCTRLF.TXT - Event Logger Control File
EVNLOG.NLS - Event Logger National Language Support (UK English)
ISSACFG.EXE - SSA Configurator
CFGMENU.NLS - Configurator Menu National Language Support (UK English)
CFGHELP.NLS - Configurator Help National Language Support (UK English)
Adapter Firmware Download - ISSAADLD.EXE
-------------------------
What it does
------------
ISSAADLD downloads an adapter microcode image to a specific SSA adapter,
or to all SSA adapters of the correct type it can find.
usage: issaadld [-n node] [-a] [-Q] microcode
flags: -n node identify adapter by node number (default all adapters)
-a microcode is in AIF format (default is customer package)
-Q quiet mode (default is verbose)
microcode input adapter microcode image file
The adapter microcode image file is identified by the subscript. These are:
xxxxxxxx.L03 : image file for 512K adapters
xxxxxxxx.L11 : image file for 1M adapters
xxxxxxxx.L10 : image file for 1M cluster adapters.
The adapter download program checks the "Loadable microcode field" in the
adapter VPD in order that the wrong image is not inadvertently loaded to the
card. Care should be taken if renaming the files that the subscript is not
altered.
NOTE: Versions of the ISSAADLD program dated prior to that of this
installation should NOT be used. This program was intended to
service the 512K adapter only.
Examples
--------
To download a particular adapter microcode image (LD960701.L10, for
instance) to ALL 1M cluster adapters:
issaadld LD960701.L10
To download just to the 1M SSA adapter which is 'Node 13':-
issaadld -n 13 LD960701.L11
Important
---------
Do NOT download whilst disks are performing I/O. All open occurrences of the
SSA Configurator should also be closed, prior to performing the download.
Only use this utility program when instructed to do so by your service
representative since downloading incorrect images, for example, could have
a detrimental effect on your SSA Subsystem.
Errors may be generated in SSA Event Log. These can be ignored and are
a result of adapter reset which is necessary to initialise the new microcode.
DASD Microcode Download - ISSADDLD.EXE
-----------------------
ISSADDLD downloads a disk microcode image to a specific disk, or to ALL
disks on a given SSA Adapter, or to all disks on all SSA Adapters.
usage: issaddld [-a node] [-u uid] [-v vendor] [-f] [-q] microcode
flags: -a node identify adapter by node number (default all adapters)
-u serial 15 character full serial number (default all disks)
-v vendor identify drive vendor (default is IBM)
-f force download (default is to upgrade)
-q quiet mode (default is verbose)
microcode input disk microcode image file
Examples
--------
To download a new IBM DFHC microcode image (for instance, DCHC8181.DL) to
ALL the disks on ALL the adapters
issaddld DCHC8181.DL
To update ALL the DCHC disks on the adapter referred to as node 13:-
issaddld -a 13 DCHC8181.DL
Important
---------
Do NOT download to disks whilst they are performing I/O.
Only use this utility program when instructed to do so by your service
representative since downloading incorrect images, for example, could have
a detrimental effect on your SSA Subsystem.
Problems?
---------
1) If your primary boot device is a logical SSA drive (RAID arrays can NOT
be used), then the SSA adapter must be installed into a PCI slot with a
lower number than that in which any SCSI adapters are installed.
2) With the IBM SSA cluster adapter if the operating system is to be
on two linked machines each with a PRIVATE SSA disk, then the following
should be observed.
During the early install process, the partner machine is rebooted, the
local private SSA disk becomes unavailable and setup cannot proceed. It
is recommended that installation takes place on one node with the other
powered down. Once completed it is then possible install the next node
with the first powered down.
Partner machines should only be reset if the main machine has FULLY
finished the boot sequence. Rebooting or resetting the partner machine
at any other time may lead to failure of NT.
3) If an SSA disk is formatted using the Configurator function, Disk Service
Aids, and power is lost to the disk or the disk is prematurely removed, it
will be shown with a status of FAILED. The disk also will appear in the
Rejected Disk menu of the Configurator. In order to return it to a GOOD
status, it is necessary to delete it from the Rejected Disk Menu, using
the DELETE key, and BEFORE any further action is taken, the machine
rebooted. Once the machine has rebooted, running the Configurator will
show that this disk now appears as a New Disk. BEFORE any other action is
taken this disk must be formatted from the Disk Service Aids menu and
allowed to complete. Once complete the disk status will return to GOOD and
it can be used normally.
Configurator Error codes
========================
The Configurator displays error codes in a meaningful textual fashion.
The error codes include:
0xfffd : General non-specific failure return code.
0xfffc : Hardware error.
0xfff8 : Illegal request.
0xfff0 : Not in table. Can't find disk with given serial number.
0xffe2 : Not yet implemented.
0xffef : Disk is currently offline.
0xffe0 : Not found.
0xfe1e : Array is broken or degraded. Some operations require a
non-degraded array.
0xfe1a : NVRAM error. Its probably full with dormant entries. You could go
and delete a few and then retry.
0xfe17 : Bad component exchange candidate.
0xfe18 : Array is broken. Some operations require a non-broken array.
0xfe13 : Bad new component serial number. New component is not suitable
for component exchange.
0xfe11 : Bad disk serial number. Perhaps the disk went offline.
0xfe0c : Bad serial number. Perhaps there is already an array with this
name.
0xff3a : Can't delete in-use resource. You can only delete dormant NVRAM
entries.
0xff39 : Operation is not applicable for resource type. Perhaps you're
trying to do a disk type of operation to an NVRAM entry
(you can only list and delete these).
0xff38 : NVRAM is defective. The only sensible option here is to replace
the module.
Trademarks and Notices
----------------------
The following terms are trademarks of the IBM Corporation in the
United States or other countries or both:
IBM, OS/2
Microsoft and Windows are trademarks or registered trademarks of
Microsoft Corporation.
Novell Netware is a trademark or registered trademark of Novell Inc.
Other company, product, and service names may be trademarks or service
marks of others.
THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM
DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING
WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR
PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS
DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY
PATENTS OR COPYRIGHTS.
Note to U.S. Government Users -- Documentation related to restricted
rights -- Use, duplication or disclosure is subject to restrictions
set forth in GSA ADP Schedule Contract with IBM Corp.