IBM SSA Advanced SerialRAID/X Adapter for PC Servers Windows 2000 Server Family Device Drivers and Utilities Last updated : 16th February 2001 1.0 - Introduction 2.0 - Before You Install your Adapter .1 - Getting PC Server BIOS Updates .2 - Software Requirements .3 - Hardware Requirements .4 - Getting Help .4.1- Service and Technical Support .4.2- Defect Reporting 3.0 - Installing Adapters .1 - USERS WITH MORE THAN ONE TYPE OF IBM SSA RAID ADAPTER .2 - Installing the IBM Advanced SerialRAID/X .3 - Possible warning message from Windows 2000 .4 - Migrating from Windows NT4 to Windows 2000 .5 - Migrating SSA Resources to the IBM Advanced SerialRAID/X .6 - 2-way Fast Write cache on IBM Advanced SerialRAID/X 4.0 - SSA Resource Configuration and Event Logging .1 - RSM Configurator .2 - SSA Event Logger 5.0 - SSA Microcode Download Utilities .1 - Adapter Microcode Download Utility - ISSAADLD.EXE .2 - Disk Microcode Download Utility - ISSADDLD.EXE .3 - Enclosure Microcode Download Utility - ISSAEDLD.EXE 6.0 - Having Problems? .1 - Further Reading 1.0 INTRODUCTION ---------------- This readme file contains installation instructions for the IBM Advanced SerialRAID/X Adapter. It also contains instructions relating to using the download utilities for updating adapter, enclosure and drive microcode under Windows 2000 Server Family. Please also refer to the Section 6.0 Having Problems? before calling a service representative. 2.0 BEFORE INSTALLING YOUR ADAPTER ---------------------------------- The IBM Advanced SerialRAID/X Adapter has been certified by Microsoft Hardware Quality Labs for use with Windows 2000 Server and Advanced Server using Microsoft Cluster Services. See http://www.microsoft.com/hwtest/signatures 2.1 Getting PC Server BIOS Updates ---------------------------------- NOTE: It is recommended that you ensure that the Server you are using has the latest BIOS. This can be obtained from the following sites: www.pc.ibm.com/us/netfinity : IBM PC Company Web site. www.compaq.com : Compaq company Web site. www.hp.com : Hewlett Packard company Web site. www.dell.com : DELL Company Web site. 2.2 Software Requirements ------------------------- It is assumed that Windows 2000 is already installed. Supported Operating Systems : * Windows 2000 Server * Windows 2000 Advanced Server * Windows 2000 Advanced Server with Cluster Services 2.3 Hardware Requirements ------------------------- For a list of IBM and OEM Intel PC Servers which have been tested by IBM please refer to our Customer Support Website: http://www.storage.ibm.com/hardsoft/products/ssa * 5 MB of free disk space * 0.5 MB of free memory * 2-button mouse or other pointing device. * IBM Advanced SerialRAID/X Adapter. *** IMPORTANT *** Windows 2000 requires an adapter firmware level greater than 8500. Before installing the adapter under Windows 2000 you must ensure the firmware level is greater than 8500. To do this create a PC-DOS Configurator and Utilities Diskette (available from the Website) and boot the server from this disk. Run the issacfg.exe program to verify that the adapter VPD ROS Level is greater than 8500. If it is not you must follow the instructions in the DOS readme file (on the diskette) to upgrade the firmware. You should install the latest firmware available from the website: http://www.storage.ibm.com/hardsoft/products/ssa 2.4 Getting Help ---------------- In all cases consult the documentation provided with your adapter, and enclosure. These documents are also available in PDF format from the website. - Installation Guide - User's Guide and Maintenance Information Manual - Technical Reference Manual 2.4.1 Service and Technical Support ----------------------------------- We are happy 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 - SSA Online Customer Support Homepage (All adapter/drive microcode and all customer host software including device drivers - look here first) http://www.storage.ibm.com/hardsoft/products/ssa For Product Information: http://www.storage.ibm.com/storage/ 2.4.2 Defect Reporting ---------------------- Please report any defects to the supplier of your adapter. 3.0 INSTALLING ADAPTERS ----------------------- Please note : 1) The Host Software programs are automatically copied to the directory "\issa", located on the system partition. 2) We recommend RAID-1 and RAID-10 arrays be created with the Initial rebuild option set to On. 3) Clicking the right mouse button on IBMSSA.SYS in Windows 'Explorer' either on the original install diskette or in the winnt\system32\drivers directory brings up the "Properties box". Clicking on the version tab will give information useful when diagnosing any problems if they need to be reported to an IBM representative. The Product Version and Internal Name being the most important as they show the date and level of the device driver. This information is also available in the Remote Systems Management (RSM) configurator and when looking at the SSA Adapter details in the Windows Device Manager. 4) The host software can be installed from the Customer Support Web site: http://www.storage.ibm.com/hardsoft/products/ssa For more information relating to these software components refer to the Installation Guide, User's Guide and Maintenance Information Manual and the SSA Tools Menu HTML help files available through RSM. 5) If you are planning to use Microsoft Cluster Services you should refer to the following website prior to planning your configuration: http://www.microsoft.com/windows2000/library/planning/server/clustersteps.asp 3.1 USERS WITH MORE THAN ONE TYPE OF SSA ADAPTER IN A SERVER ------------------------------------------------------------ Only the IBM Advanced SerialRAID/X Adapter has been certified for use with Windows 2000. IBM and Microsoft have not tested and do not support other SSA adapters when used with Windows 2000. If you have other IBM SSA RAID Adapters installed in your server they will be listed as IBM Advanced SerialRAID/X Adapters. The device driver will recognise these and any suitable resources will be made available to the operating system. HOWEVER this is an unsupported configuration. 3.3 Installing the IBM Advanced SerialRAID/X Adapter. ----------------------------------------------------- You should ensure that the device driver you are running is the latest level, which may be downloaded from http://www.storage.ibm.com/hardsoft/products/ssa If you are upgrading an existing driver goto 1) If you are installing the driver for the first time goto 2) 1) To manually check the version of the device driver you are currently running open Windows Explorer at: :\winnt\system32\drivers Right click on the file ibmssa.sys and select properties, and view the Version tab. The version is shown at the top of this tab. Repeat this process with the latest version on the supplied Windows 2000 Device Driver, usually extracted to :\issa\update\driver If the version in the \winnt\system32\drivers directory is lower, you should continue with step 2. Otherwise you need do nothing. 2) Start Computer Management from the Administrative Tools Menu. Select the Device Manager snap-in. The adapter will be listed as an SSA Controller under the Other Devices tree. Double click the device and select the drivers tab on the resultant dialog box. Click Update/Reinstall Driver, when prompted select "Search for driver" and then select the checkbox to specify a location. Enter c:\issa\update\driver or wherever you extracted the device driver package to. Windows should recognise the adapter and complete installation without further user interaction. You do not need to reboot - the device driver will start when installation is complete. 3) You should now install the Host Software supplied on the CD-ROM or obtain updated versions of the SSA Event Logger and RSM from the SSA Customer Support Homepage. http://www.storage.ibm.com/hardsoft/products/ssa 3.3 Possible warning message from Windows 2000 ---------------------------------------------- After installation of the SSA Adapter and driver, you may receive the following Windows 2000 warning message: "unexpected removal of 'unknown media changer device'" This will occur in the following scenario: The SSA adapter and device driver have been installed in the using system, but no "System (PC)" devices have been defined. In this situation, the device driver generates a pseudo-device "media change device" in order to hold the device driver interfaces open. When you subsequently define one or more "System (PC)" disks and re-discover devices using the Windows 2000 Device Manager, the device driver will find the new system disks. The pseudo device is no longer required and is therefore removed by the device driver. Because Windows itself did not perform the removal of the device, and hence did not expect the device to be removed the warning message is displayed. This warning can therefore be ignored. NB : This only happens if you have no system disks defined, subsequently define system disks, and then re-discover devices. 3.4 Migration from Windows NT4 to Windows 2000 ---------------------------------------------- You should follow the instructions listed on the Microsoft Website relating to migrating your system from Windows NT4 to 2000. Special care must be taken when migrating Windows NT4 Enterprise Edition using Cluster Services. http://www.microsoft.com/windows2000/upgrade/path/winnt4ent.asp 3.5 Migrating SSA resources to the IBM Advanced SerialRAID/X Adapter -------------------------------------------------------------------- This adapter supports the migration of RAID-0 and RAID-5 arrays created with the IBM SSA RAID Adapter (Note: The SSA RAID Adapter supported RAID arrays split across the A and B loops of the adapter. You MUST migrate arrays so that all the members of an array are on one loop before migrating to the Advanced SerialRAID/X Adapter). This adapter also supports the migration of RAID-5 arrays created with the IBM SerialRAID Adapter. All other RAID arrays (RAID-1) must be deleted (or reconfigured as RAID-0 or RAID-5) prior to the members of these arrays being used as SSA resources. 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. If the array utilised the Fast Write Cache feature you must first "delete FW" with RSM on the array view page before you can detach the array. Once an array has been migrated, you cannot re-attach it to the old adapter. 3.6 2-way Fast Write cache on IBM Advanced SerialRAID/X Adapter ----------------------------------------------------------------- Firmware level 8500, or later, for the IBM Advanced SerialRAID/X Adapter supports the use of the fast write cache (FWC) in two-way configurations, for example using Microsoft Cluster Server (MSCS). If you are using MSCS, upgrading to firmware 8500 or later, and you wish to upgrade your arrays or disks to use FWC, then you should follow this procedure: 1) Go into Services and stop Microsoft Cluster Service on both hosts. 2) Upgrade the IBM Advanced SerialRAID/X Adapter firmware on both hosts to 8500 or later. 3) Using Remote System Manager (RSM), select the logical view. 4) For each array and JBOD (System Disk) attached to Windows write down the resource number. 5) For each array and JBOD in turn, detach it and then create a Fast Write Resource out of it. 6) Re-attach the array or JBOD ensuring that the original resource number is retained. DO NOT DELETE THE MBR OTHERWISE DATA WILL BE LOST ! 6) Start Microsoft Cluster Service on both hosts. 7) Bring up Microsoft Cluster Admin. 8) If any disk group fails - reboot both servers and start Microsoft Cluster Admin. again. 9) Use Cluster Admin. to bring online any offline disk resources. Wait until the cluster is stable. 10) Verify the system is now operational. 4.0 SSA Resource Configuration and Event Logging ------------------------------------------------ 4.1 RSM Configurator -------------------- This configurator is a web based Windows Service that can be used remotely to configure resources. For more information see the readmesa.txt in the RSM package available from : http://www.storage.ibm.com/hardsoft/products/ssa (Usually extracted to c:\issa\update\rsm\readmesa.txt) 4.2 SSA Event Logger -------------------- The SSA Event Logger is required to pick up and analyse important events occurring in the SSA subsystem. See elogger.txt on the CD-ROM provided with some adapters or visit : http://www.storage.ibm.com/hardsoft/products/ssa 5.0 SSA Microcode Download Utilities ------------------------------------ IMPORTANT NOTES RE: MICROCODE DOWNLOADING ----------------------------------------- * Do NOT download whilst disks are performing I/O. * All open occurrences of the SSA Text/RSM Configurators should also be closed, prior to performing the download. Since RSM may be in use by a remote user, you should stop the "SSA Remote Systems Management" service prior to performing the download - remembering to restart it when all downloads have completed. * If your Windows boot device is an SSA Resource, YOU SHOULD NOT APPLY MICROCODE UPDATES FROM WINDOWS, see the DOS readme file from how to apply downloads from DOS. * 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. 5.1 Adapter Firmware Download - ISSAADLD.EXE -------------------------------------------- ISSAADLD downloads an adapter microcode image to a specific SSA adapter, or to all SSA adapters of the correct type it can find. The LL or "Loadable Microcode Level" can be found in the Adapter VPD details viewable via the RSM configurator Adapter View page. IBM SSA Adapter Firmware Downloader for Windows, version 1.v (v is version number) usage: issaadld [-a node] [-q] [-p] firmware.Lxx flags: -a node identify adapter by node number (default all adapters) -q quiet mode (default is verbose) -p pause just before loading firmware firmware.Lxx input adapter firmware image file (xx is LL field) The adapter microcode image file type is identified by the file extension. xxxxxxxx.L05 : image file for LL05 IBM Advanced SerialRAID/X 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 file extension is not altered. NOTE: Versions of the ISSAADLD program prior to v1.7 should NOT be used with this adapter. Examples -------- To download a particular adapter microcode image (ADAP8520.L05 for instance) to ALL IBM Advanced SerialRAID/X Adapters : issaadld ADAP8520.L05 To download a particular adapter microcode image (ADAP8520.L05 for instance) just to the adapter which is 'Node 13' : issaadld -a 13 ADAP8520.L05 (The relevant node number can be found in the Adapter List page of RSM) 5.2 Disk Microcode Download - ISSADDLD.EXE ------------------------------------------ IBM SSA Disk Microcode Downloader for Windows, version 1.v (v is version number) usage: issaddld [-a node] [-u uid] [-v vendor] [-f] [-q] [-p] ttttllll.DL flags: -a node identify adapter by node number (default all adapters) -u uid disk 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) -p pause just before loading microcode ttttllll.DL input disk microcode image file tttt is the product type llll is the code level Examples -------- For drive microcode updates please refer to the drvupdos.txt file supplied with the new drive microcode files. 5.3 Enclosure Controller Microcode Download - ISSAEDLD.EXE ---------------------------------------------------------- IBM SSA Enclosure Microcode Downloader for Windows, version 1.v (v is version number) usage: issaedld [-a node] [-d disp] [-e eli] [-f] [-t] [-q] [-p] mcodeNNN.hex flags: -a node only download enclosure(s) attached to an adapter -d disp only download enclosure(s) with "disp" on their LED displays -e eli only download enclosure with Enclosure Logical Identifier "eli" -f force download, even if it downgrades microcode -t temporary download -q quiet mode (default is verbose) -p pause just before loading microcode mcodeNNN.hex input Intel Hex microcode file (NNN is code level) Examples -------- To download a new level of controller microcode image (for instance mcode020.hex) to ALL the suitable enclosures on ALL the adapters : issaedld mcode020.hex To download a new level of controller microcode image (for instance mcode020.hex) to ALL the suitable enclosures attached to the adapter with node number 12 : issaedld -a 12 mcode020.hex To download a new level of controller microcode image (for instance mcode020.hex) to ALL suitable enclosures with LED display names of "TEST" : issaedld -d TEST mcode020.hex 6.0 Having Problems? -------------------- The MAXIMUM_TARGETS_PER_BUS has been increased in Windows 2000 from 32 to 128. Resources that are attached and assigned resource numbers in the range 0-127 will appear on logical SCSI bus 0. Similarily resources assigned resource numbers in the range 128-255 will appear on logical SCSI bus 1. Note that some SCSI programming interfaces only support 16 targets per bus. In this instance, resource numbers should be assigned within the ranges 0-15 and 128-143. 6.1 Further Reading ------------------- The CD-ROM supplied with your adapter contains Adobe Acrobat (PDF) versions of the : Installation Guide User's Guide and Maintenance Information Manual These can be found in the \docs directory of the CD-ROM. PostScript versions are also supplied or visit : http://www.storage.ibm.com/hardsoft/products/ssa Trademarks and Notices ---------------------- The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM, OS/2, Netfinity, Netfinity Manager Microsoft and Windows 2000 are trademarks or registered trademarks of Microsoft Corporation. Adobe, Acrobat and the Acrobat Logo are trademarks of Adobe Systems Incorporated. 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.