IBM Advanced SerialRAID/X Adapter for PC Servers Novell NetWare Device Drivers and Utilities Last Updated : 11th April 2000 This file contains information you need to install the IBM Advanced SerialRAID/X Adapter for use with NetWare. Please also refer to the sections "Possible Problems" and "PC Server BIOS levels" for other important information about this product. This README file is divided into the following categories: 1.0 Before You Install the IBM Advanced SerialRAID/X Adapter - PC Server BIOS Level - Software Requirements - Hardware Requirements 2.0 Getting Help 3.0 Installing IBM Advanced SerialRAID/X Adapter under NetWare 4.2 4.0 Installing IBM Advanced SerialRAID/X Adapter under NetWare 5.0 5.0 Migrating to 2-way Fast Write 6.0 Possible Problems 7.0 Configurator Error codes 8.0 Trademarks 1.0 Before You Install the IBM Advanced SerialRAID/X Adapter ------------------------------------------------------------ For a list of IBM and OEM Intel PC Servers which have been tested by IBM please refer to our Customer Support Web site: http://www.storage.ibm.com/hardsoft/products/ssa PC Server BIOS Level -------------------- 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. Software Requirements --------------------- Novell NetWare version 4.2 or version 5.0. Hardware Requirements --------------------- - A supported PC Server platform which has a PCI bus (specification level 2.1) and runs Novell NetWare version 4.2 or 5.0. - 1 MB of fixed disk space above that required by NetWare. - .5 MB of memory above that required by NetWare. - IBM Advanced SerialRAID/X Adapter installed into a PCI slot of the PC Server. If necessary update the firmware on the adapter to the latest level available from the Customer Support Web site: http://www.storage.ibm.com/hardsoft/products/ssa 2.0 Getting Help ---------------- Documentation. Service and Technical Support. Available Documentation ----------------------- In all cases, consult the documentation provided with your adapter, and enclosures. - Installation Guide - User's Guide and Maintenance Information Manual - Technical Reference Manual Service and Technical Support ----------------------------- We are happy to help you with your IBM Advanced SerialRAID/X 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/ Defect Reporting ---------------- Please report any defects to the supplier of your adapter. 3.0 Installing IBM Advanced SerialRAID/X Adapter under NetWare 4.2 ------------------------------------------------------------------ The instructions in this section are for Novell NetWare 4.2. - Installation an a new server - Installation on an existing server Installing NetWare 4.2 onto an SSA Resource in a new server ----------------------------------------------------------- This section describes the steps involved in configuring and installing the adapter on a new server which will have its operating system installed on the SSA devices from where it will boot. It is assumed that the adapter is already installed into the system unit and that all the required disks are connected with the appropriate cabling. In order for the server to boot from the SSA adapter please ensure that the BIOS on the card is enabled. 1. Using a bootable floppy disk boot the machine to a DOS prompt. Insert the SSA driver disk that contains the DOS configuration program. From the command line type: a:\issacfg then press 2. This will load the DOS based configuration software. Configure the adapter and disks according to your requirements. 3. Once you have configured the adapter and disks restart the machine and install DOS. (See manufacturer's instructions). You will need a CD-ROM drive so please ensure that you include CD-ROM support within your DOS installation. 4. Remove the floppy disk and reboot the system to DOS. Insert your NetWare 4.2 CD into the CD-ROM. Type: d: then press install then press (where d: is the drive letter to which your CD-ROM is mapped) 5. Follow the manufacturer's installation guidelines. When the screen Choose the Server Drivers - Summary is displayed you will see a small Driver Actions menu. Choose Select additional or modify selected Disk/LAN drivers and press . The highlight will move to Disk and CD-ROM Drivers, press . The Additional Driver Actions menu will appear. Choose Select an additional driver then press . 6. You will be taken to a screen giving a list of alternative drivers. Insert your SSA driver disk into the floppy drive then press to Install an unlisted driver. The machine will ask for the path to your new drivers. The default is a:\ so just press . 7. The system will scan the floppy drive and present you with a menu asking you to select a driver to install. Select ISSAV4E0.HAM and press . The driver and support files will be copied to the system. 8. You will then be shown the Driver ISSAV4E0 Parameter Actions menu. Select Select/Modify driver parameters and press . 9. Enter the Slot Number and press . Press or to Save parameter settings. Next, select Save parameters and continue from the Parameter Actions menu and press . 10. You will then be asked if you wish to select an additional disk driver. Select Yes or No according to your configuration and press . 11. Once back to the Additional Driver Actions menu select Continue Installation and press to return to the Choose the Server Drivers - Summary screen. 12. In the Driver Actions menu choose Continue Installation and press . All your selected drivers will be loaded and the NetWare installation will continue. 13. Once the installation is complete go to the System Console and type: load install then press 14. At the Installation Options menu select Product Options and press to take you to the Other Installation Actions menu. From here select Install a product not listed and press . 15. The default location for the product installation is A:\. Press to specify a different location if necessary. Once the file location is given then the IBM Advanced SerialRAID/X Adapter Utilities will be copied to the C:\NWSERVER directory and your AUTOEXEC.NCF file will be modified to load the utilities upon startup. 16. Once all the files have been copied you will be returned to the Other Installation Actions menu. Select Return to the previous menu and press . From the Installation Options menu select Exit and press . Confirm your exit from NWCONFIG to take you back to the system console. 17. From the prompt type: down and press then type: exit and press this will return you to the DOS prompt. 18. At the DOS prompt type: server then press This will restart the server now using the changes to the system startup files. You should now verify that you have successfully installed the drivers. You can find instructions for doing this at Verifying the 4.2 Installation below. NOTE: We recommend that the latest service packs are applied to the system. Installation on an existing server ---------------------------------- These instructions assume that the operating system has already been installed and that the adapter has been installed in the system unit. 1. From the console of your NetWare 4.2 server load the install utility by typing: load install then press 2. Select Driver options and press . 3. From the sub menu select Configure disk and storage device drivers and press . 4. From the Additional Driver Actions menu select Load an additional driver and press . 5. The system will scan for new drivers and then present a list of available ones. At this point press to Install an unlisted driver. 6. Drive A: is the default path so you may need to press to Specify a different source drive/directory. 7. Once the given location has been scanned a window is displayed showing the title Select a driver to install. Select ISSAV4E0.HAM and press . 8. You will be asked if you want to copy the driver ISSAV4E0.HAM. Select Yes and press . 9. You will then be asked to specify your boot path. The default is C:\NWSERVER. Type in the path to SERVER.EXE if it is different from the default and press . The driver files will be copied to the system. 10. Once the driver files have been copied the Driver ISSAV4E0 Parameter Actions menu is displayed. Select Select/Modify driver parameters and press . 11. Enter the Slot Number and press . Press or to Save parameter settings. Next, select Save parameters and load driver and press . The driver will be loaded. 12. You will be asked if you want to select an additional disk driver. Select No and press . 13. At the Additional Driver Actions menu select Return to previous menu and press . 14. At the Driver Options menu select Return to previous menu and press . 15. At the Installation Options menu select Product Options and press to take you to the Other Installation Actions menu. From here select Install a product not listed and press . 16. The default location for the product installation is A:\. Press to specify a different location if necessary. Once the file location is given then the IBM Advanced SerialRAID/X Adapter Utilities will be copied to the C:\NWSERVER directory and your AUTOEXEC.NCF file will be modified to load the utilities upon startup. 17. Once all the files have been copied you will be returned to the Other Installation Actions menu. Select Return to the previous menu and press . From the Installation Options menu select Exit and press . Confirm your exit from NWCONFIG to take you back to the system console. 18. From the prompt type: down and press then type: exit and press this will return you to the DOS prompt. 19. At the DOS prompt type: server then press This will restart the server and implement the changes to the system startup files. Verifying the 4.2 installation ------------------------------ Once the adapter(s), driver software, and configuration utilities have been installed then they may all be checked for successful installation by following the procedure below. 1. Probably the best way to test if all has gone according to plan is to restart the server. So from the system console type: down and then press When the server is down type: restart server This will bring the server up again and run all of your startup files. 2. From the console type: modules issa*.* The screen should display the following files loaded: ISSAV4E0.HAM ISSAINJ.NLM ISSAELOG.NLM 3. From the console type: load c:\nwserver\issacfg.nlm and then press to load the ISSA configuration utility. Once it has started select SSA Adapter List from the main menu and press . You should now see a display giving an entry for each SSA adapter installed in your system unit. NOTE: We recommend that the latest service packs are applied to the system. 4.0 Installing IBM Advanced SerialRAID/X Adapter under NetWare 5.0 ------------------------------------------------------------------ The instructions in this section are for Novell NetWare 5.0 - Installation an a new server - Installation on an existing server Installing NetWare 5.0 onto an SSA Resource in a new server ----------------------------------------------------------- This section goes through the steps involved in configuring and installing the adapter on a new server which will have its operating system installed on the SSA devices from where it will boot. It is assumed that the adapter is already installed into the system unit and that all the required disks are connected with the appropriate cabling. In order for the server to boot from the SSA adapter please ensure that the BIOS on the card is enabled. 1. Using a bootable floppy disk boot the machine to a DOS prompt. Insert the SSA driver disk that contains the DOS configuration program. From the command line type: a:\issacfg then press 2. This will load the DOS based configuration software. Configure the adapter and disks according to your requirements. 3. Once you have configured the adapter and disks restart the machine and install DOS.(See manufacturer's instructions). You will need a CD-ROM drive so please ensure that you include CD-ROM support within your DOS installation. 4. Remove the floppy disk and reboot the system to DOS. Insert your NetWare 5.0 CD into the CD-ROM. Type:- d: then press install then press (where d: is the drive letter to which your CD-ROM is mapped) 5. Follow the manufacturer's installation guidelines. When the screen appears that shows the detected devices select Modify from the Options menu. 6. Move down to Storage Adapters and press . You will then be shown a screen giving all currently detected storage drivers. Press to add a new driver. 7. A screen showing all available divers is then displayed. Press to Add an unlisted driver. The default path is a:\ press to specify a different path if the SSA driver is in another location. 8. Once the correct location is given the SSA driver files will be copied to the system. Once copied you will see a screen showing all currently selected storage drivers. In the Additional Driver Options menu at the bottom of the screen select Return to driver summary and press . 9. You will be returned to the driver summary screen. In the Options menu at the bottom of the screen select Continue and press . 10. Continue with the operating system installation following the manufacturer's instructions. When finished you will be asked to restart the server. Select Yes and press . 11. Once the server has restarted go to the system console and type: load nwconfig then press 12. At the Configuration Options menu select Product Options and press to take you to the Other Installation Actions menu. From here select Install a product not listed and press . 13. The default location for the product installation is A:\. Press to specify a different location if necessary. Once the file location is given then the IBM Advanced SerialRAID/X Adapter Utilities will be copied to the C:\NWSERVER directory and your AUTOEXEC.NCF file will be modified to load the utilities upon startup. 14. Once all the files have been copied you will be returned to the Other Installation Actions menu. Select Return to the previous menu and press . From the Configuration Options menu select Exit and press . Confirm your exit from NWCONFIG to take you back to the system console. 15. From the prompt type: restart server and press this will restart the server and initialise the changes made to the autoexec.ncf file. You should now verify that you have successfully installed the drivers. You can find instructions for doing this at Verifying the 5.0 Installation below. NOTE: We recommend that the latest service packs are applied to the system. Installation on an existing server ---------------------------------- These instructions assume that the operating system has already been installed and that the adapter has been installed in the system unit. 1. From the console of your NetWare 5.0 server load the configuration utility by typing: load nwconfig then press 2. Select Driver Options and press . From the Driver Options menu select Configure disk and storage device drivers and press . 3. From the Additional Driver Actions menu select Select an additional driver and press . You will be shown the Select a driver menu and from here you need to press to Install an unlisted driver. 4. The default path is a:\ press to specify a different path if the SSA driver is in another location. The machine will search the given location for any available drivers. Once complete you will be shown the Select a driver to install menu. Select ISSAV4E0.HAM and press . 5. You will be asked if you want to copy the driver. Select Yes and press . 6. You will then be asked to specify the server boot path. c:\nwserver is the default but change this if your system is different then press to copy all the necessary files to your server. 7. Next you will be shown a screen with the Driver ISSAV4E0 Parameter Actions menu at the bottom. Choose Select/Modify driver parameters and press . Type in the Slot Number and press . Next press to Save parameter settings. Now select Save parameters and load driver from the menu and press . 8. The driver will be loaded and you will then be asked if you want to select an additional disk driver. Select No and press . 9. The system will now go back to the Additional Driver Actions menu. Select Return to previous menu and press . At the Driver Options menu select Return to previous menu and press . 10. You will now be back at the Configuration Options menu. Select Exit and press . The system will ask you to confirm your exit from the utility, select Yes and press . 11. Once the server has returned to the system console type: load nwconfig then press 12. At the Configuration Options menu select Product Options and press to take you to the Other Installation Actions menu. From here select Install a product not listed and press . 13. The default location for the product installation is A:\. Press to specify a different location if necessary. Once the file location is given then the IBM Advanced SerialRAID/X Adapter Utilities will be copied to the C:\NWSERVER directory and your AUTOEXEC.NCF file will be modified to load the utilities upon startup. 14. Once all the files have been copied you will be returned to the Other Installation Actions menu. Select Return to the previous menu and press . From the Configuration Options menu select Exit and press . Confirm your exit from NWCONFIG to take you back to the system console. 15. From the prompt type: restart server and press this will restart the server and initialise the changes made to the autoexec.ncf file. Verifying the 5.0 installation ------------------------------ Once the adapter(s), driver software, and configuration utilities have been installed then they may all be checked for successful installation by following the procedure below. 1. Probably the best way to test if all has gone according to plan is to restart the server. So from the system console type: down and then press When the server is down and back at the DOS prompt type:- server and then press This will bring the server up again and run all of your startup files. 2. Once the server is back up go to the system console and type: modules issa*.* The screen should display the following files loaded: ISSAV4E0.HAM ISSAINJ.NLM ISSAELOG.NLM 3. From the console type: load c:\nwserver\issacfg.nlm and then press to load the ISSA configuration utility. Once it has started select SSA Adapter List from the main menu and press . You should now see a display giving an entry for each SSA adapter installed in your system unit. NOTE: We recommend that the latest service packs are applied to the system. 5.0 Migrating to 2-way Fast Write --------------------------------- Firmware level 7100, 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 Novell Cluster Services (NCS). If you are using NCS, upgrading to firmware 7100 or later, and you wish to upgrade your arrays or disks to use FWC, then you should follow this procedure: 1) In the AUTOEXEC.NCF file, comment out the line which starts NCS: LDNCS.NCF. 2) Down the servers and upgrade the IBM Advanced SerialRAID/X Adapter firmware on both servers to 7100 or later. 3) Bring the servers back up, go to a client and start Remote System Manager (RSM). 4) From the logical view, select each array and JBOD (System Disk) attached to NetWare 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 ! 7) On both servers uncomment the line LDNCS.NCF. 8) Down the servers and bring them up again. 9) Novell Cluster Services, the arrays and JBODs should come up normally. If you do not use RSM, then the above procedure can also be done using the DOS-based Text Configurator, ISSACFG, as follows: 1) Down the servers and upgrade the IBM Advanced SerialRAID/X Adapter firmware on both servers to 7100 or later. 2) While still in DOS use ISSACFG to select each array and JBOD (System Disk) attached to NetWare write down the resource number. 3) For each array and JBOD in turn, detach it and then create a Fast Write Resource out of it. 4) Re-attach the array or JBOD ensuring that the original resource number is retained. DO NOT DELETE THE MBR OTHERWISE DATA WILL BE LOST ! 5) Bring up both servers in NetWare. Your volumes should now function normally. 6.0 Possible Problems --------------------- ISSACFG/ISSAELOG UNABLE TO ACCESS NLS FILES? This probably means that the server has been set up to REMOVE DOS copying the IBM SSA support files to the SYS volume. CREATING RAID ARRAYS? If you wish to create a RAID array you should ensure that all of the disks you elect to use as array members are the same capacity. NOTE: The smallest capacity of an array member is used when determining the size of the array. SYSTEM HANGS ON RELOAD Isolated incidents have been seen when NetWare fails to restart if the server is downed and restarted. It is recommended that your PC is rebooted each time you wish to start NetWare. 7.0 SSA Configurator Error Messages ----------------------------------- The Configurator does not currently display all error codes it 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. 8.0 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.