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.