Dell PowerEdge RAID Controller Device Driver for Netware 5.x. 6.x Version: 7.02c TABLE OF CONTENTS 1.0 Introduction 2.0 Compatibility / Minimum Requirements 3.0 Installation Instructions 3.1 Fresh Installation of the Netware Driver 3.2 Adding/Upgrading the Netware Driver to an Existing Installation 3.2.1 For Netware 5.1 and 6.0 3.2.2 For Netware 6.5 3.3 Utilities 3.3.1 DellMGR 3.3.2 DellMon 4.0 Fixes or Enhancements in this Release 5.0 Additional Information 6.0 Revision History ================ 1.0 Introduction ================ This is the driver for following PowerEdge Expandable RAID Controllers: PERC 4e/Di, 4e/Si, 4e/DC PERC 4/Di, 4/DC, 4/SC PERC 3/QC, 3/DC, 3/DCL, 3/SC ========================================= 2.0 Compatibility / Minimum Requirements: ========================================= This Device Driver is compatible with the following firmware versions: Controller Recommended firmware Description PERC 3/QC 198N PERC 3 Quad Channel PERC 3/DC 198N PERC 3 Dual Channel PERC 3/DCL 198N PERC 3 Dual Channel Lite PERC 3/SC 198N PERC 3 Single Channel PERC 4/Di 421N PERC 4 Integrated on PE 1750 PERC 4/Di 251N PERC 4 Integrated on PE 2600 PERC 4/SC 351N PERC 4 Single Channel PERC 4/DC 351N PERC 4 Dual Channel PERC 4e/Di 521N PERC 4e Integrated on PE 2800, 2850 PERC 4e/Si 521N PERC 4e Integrated on PE 1850 PERC 4e/DC 521N PERC 4e Dual Channel ============================= 3.0 Installation Instructions ============================= 1. Download the perc-nw-7.02c-A10.exe to a directory on your hard drive. The file downloaded is a self-extracting executable. 2. Execute the download file and unzip the driver files to a floppy diskette. There are two methods for installing the Novell NetWare drivers and applications: 3.1 Fresh Installation of the Netware Driver ============================================ Follow the instructions in the Novell NetWare Installation Guide to install NetWare on the server. 1. Boot to the Novell Netware OS CD. 2. Follow the instructions on the screen until you reach the Storage Driver Support screen. This screen is used to add, change or delete drivers. 3. Select Storage Adapters on the Storage Driver Support screen. 4. Delete any existing PERC adapters. 5. Press "Insert" to add unlisted drivers. Press "Insert" again. A path displays. 6. Insert the driver diskette created above into the floppy drive and press "Enter". 7. The system finds the PEDGE3.HAM driver. 8. Return to the Driver Summary screen. Continue the installation. 3.2 Adding/Upgrading the Netware Driver to an Existing Installation =================================================================== 3.2.1 For Netware 5.1 and 6.0 ----------------------------- Follow the instructions to add the driver to an existing installation. 1. Create a driver diskette. 2. Once the NetWare server is up, type: nwconfig 3. Press "Enter" to access the NetWare Configuration Utility. 4. On the Configuration Options screen, select Driver Options and press "Enter". 5. Under the Driver Options, select Configure Disk and Storage Options, then press "Enter". 6. Under the Additional Driver Actions menu, press the down arrow key to select the Additional Driver option, then press "Enter". 7. Press "Insert" to install an unlisted driver. 8. Press "F3" to specify a different path. 9. Insert the driver diskette into the diskette drive and press "Enter". The file pedge3.ham displays under the option Select a Driver to Install. 10. Highlight pedge3.ham and press "Enter". 11. Select Yes to copy pedge3.ham files to C:\NWSERVER. 12. Select No to save the existing file messages to C:\NWSERVER. 13. Under pedge3 Parameters, perform the following steps to provide the slot number. 14. Press "Alt-Esc" to access System Console. 15. On the System Console, type: load pedge3 16. Press "Enter". The following supported slot options display: No Selection PCI Slot_2.1 (HIN 203) 17. Write down the number after "HIN". In the example in step 15, it is 203. 18. Under Choice, type: 0 for the option No Selection. 19. Press "Alt-Esc" until you exit the System Console and return to the pedge3 Parameters screen in the NetWare Configuration Utility. 20. Under Slot Number, enter the slot number you obtained from System Console and press "Enter". 21. Press "F10" to save the pedge3 parameters. 22. Under Driver pedge3 Parameters Actions, select Save Parameters and Load Driver, and press "Enter". 23. Select No when asked to load additional drivers. pedge3 will be listed on the Selected Disk Driver screen. 24. Exit the NetWare Installation Utility. 25. From server console, type: "reset server" to restart the server for the changes to take effect. 3.2.2 For Netware 6.5 --------------------- Follow the instructions to add the driver to an existing installation. 1. Create a driver diskette. 2. Once the NetWare server is up, from System Console, type: hdetect Press "Enter" to access the NetWare Installation utility for drivers. 3. Select Continue to see the Storage device drivers detected by the server. 4. Select Modify option to highlight Storage adapters driver. Press "Enter". 5. Press Modify option to select the Driver name and press "Enter". 6. When the target Storage driver name is highlighted, press "Del" key to delete this existing driver. 7. If prompt appears, select "Yes" to remove entry from the .NCF file. 8. Press "Ins" key to Add a driver. 9. Press "Ins" key again to Add an unlisted driver. 10. Press "F3" key to specify the path where the new driver is located. 11. Insert the driver diskette created above into the diskette drive and press "Enter". Please wait until the next screen appears. 12. Select "Return to driver summary" and press "Enter". 13. Select "Load" from the Options choices and press "Enter". NOTE: If the driver fails to load, please follow the steps 13a to 13i; otherwise, continue to step 14: 13a. From System Console, type: "unload pedge3" and press "Enter". Press "Y" and then "Enter" at the prompt. 13b. Type "load a:pedge3" to check the slot number for the device. The following supported slot options display: No Selection PCI Slot_2.1 (HIN 203) 13c. Write down the number after "HIN". In this example, it is 203. 13d. Under Choice, type: 0 for the option (No Selection). 13e. Press "Alt-Esc" until you exit the System Console and return to the "pedge3" parameters screen in the NetWare Configuration Utility. 13f. Under Slot Number, enter the slot number you obtained from System Console and press "Enter". 13g. Press "Esc" key and select 'Return to driver list', press "Enter". 13h. Select 'Return to driver summary' and press "Enter". 13i. Select 'Load' from the Options choices and press "Enter". 14. Select 'Continue' option, and press "Enter" 15. Select 'Continue' at the Protocol Options to exit the Netware Installation utility for drivers. 16. Verify Startup.ncf has the correct driver and slot number entry. 17. From server console, type: "reset server" to restart the server for the changes to take effect. 3.3 Utilities ============= DellMGR and DellMon utilities are automatically installed during driver installation. 3.3.1 DellMGR ------------- DellMGR is a character-based, non-GUI utility which allows configuration changes to disk arrays and logical disks. It provides similar support to the BIOS configuration utility from the operating system. Usage: To use, type "dellmgr". 3.3.2 DellMon ------------- DellMon is a monitor utility which once loaded in to memory keeps monitoring various activities on the RAID system. It keeps running in the background and displays various messages to the user. It supports multiple adapters and is a command line based utility. Usage: - Load dellmon.nlm [-runckon] [-rcwZ] [-rcdY] [-rchX] [-rcdateMM/DD/YYYY] [-b{username1}] [-b{username2}] (Loads the monitor in to memory with the parameters given on command line) - Unload dellmon.nlm Unloads the monitor from the memory.) Parameters: -runckon: specifies scheduled check consistency will be performed -rcwZ: specifies the scheduled week (Z can be 0-51, default is 0, means everyday) -rcdY: specifies the scheduled day of the week(Y can be 1-7, default is 1) -rchX: specifies the scheduled hour of the day(X can be 0-23, default is 10) -rcdateMM/DD/YYYY: specifies the scheduled date(default is the system date) -b{username1}: broadcast messages will be shown to username1, username2.. By default, messages will be shown on the console. ========================================= 4.0 Fixes or Enhancements in this Release ========================================= Pedge3.ham v.7.02c 1. After a command timed out, there is a driver condition that can allow it to use the same commandID for the next command. This has the potential to cause a firmware hang when multiple commandIDs are in use. This has been addressed by allowing the commandID to be freed only after the firmware has completed the command, even if the driver has already completed the command with the timeout error. 2. Command notimeout is not being set for Physical driver format and Tape erase. The timeout for this command will now be set to notimeout for the above operation codes. ========================== 5.0 Additional Information ========================== 1. Usage of Dellmgr or Dellmon on systems with more than 2GB of memory, is possible ONLY AFTER the support pack 2, (Nw51sp2. for Netware 5.1 is applied, and the Server is restarted). 2. After Random Logical drive deletion, the user needs to rescan the bus: For Netware 5.1 "list devices" on the system console. For Netware 6.0 "list devices" on the system console or scan for devices from the Novell Console One (GUI). Failure to scan the bus cause some delay between the dellmgr invokes. 3. When upgrading the driver on a boot controller, the following steps should be performed: a) On the Netware system at the DOS prompt, browse to the driver directories (the default O/S directory and any other directories created by the administrator). b) Rename the old 'pedge3.ddi' and 'pedge3.ham files to 'pedge3old.ddi' and 'pedge3old.ham'. c) Copy the 'pedge3.ddi' and 'pedge3.ham' file for the new driver to the directories. d) Reboot. c:\nwserver\drivers is the default O/S drivers' directory, but c:\dell\drivers directory will also be present on systems that have been installed using the Dell DSA CD. 4. Some versions of Netware will load the IDEATA driver for the PERC Device. These instances of the IDEATA driver that display as "IDEATA.HAM | Standard ATA/IDE RAID Adapter Controller" must be deleted. Then the PEDGE3 driver can be loaded as specified in the install instructions. 5. Before deletion of a virtual disk or clearing the RAID controller disk configuration, all volumes on that virtual disk must first be dismounted. 6. The use of 2KB or 4KB stripe size is not recommended. 7. This driver revision (7.02c) may also be listed or referred to as 7.02.03. 8. A new add-in PERC adapter may not get properly recognized when inserted into a system that already has a PERC controller installed. A second copy of pedge3.ham should load automatically, but does not. Hdetect does not automatically select a driver and suggests manually choosing a storage driver from the list of available drivers. This message can be ignored. Press ESC and the correct driver will automatically load and startup.ncf will be updated with the pedge3.ham driver and associated slot. 9. If using Dellmgr to delete Virtual disks, the system must be rebooted before running MMPRV (NSS Media Mgr Provider) in the NSS Options Menu or the system may abend. 10. Powering off a tape device during a system backup may cause operating system errors to occur. ==================== 6.0 Revision History ==================== Changes from 7.01v to 7.01y Pedge3.ham v.7.01y 1. Addressed an issue where a SCSI cable pull during I/O operations could lead to the server to abend. The commands would time out in the ISR and the driver would try to access the timed out request callback function (which would be NULL.) This has been corrected. Changes from 7.01q to 7.01v Driver 7.01v 1. Added support for PCI Express 2. Modified POST banner to fit in the client window. New banner is: "PERC 3/SC/DC(L)/QC, 4/SC/DC/Di, 4e/SC/DC/Di/Si & CERC HAM Driver." Megammio 1.02h 1. Fixed persistent Array Manager failure after running in degraded mode. 2. Fixed system hang if Array Manager service started when no PERC controller present in system. Dellmgr 5.24 1. Fixed physical drive size coercion. 2. Addressed problem with "Prepare to remove" option in "objects->Physical Drive" menu 3. Fixed 2 cosmetic issues with initialize and reconstruction messages 4. Addressed failure to start a check consistency when back-ground init was already running for another logical drive. 5. Removed option to span R0. Dellmon 2.10 1. If drive state is changed from HOTSPARE to READY, it is now reported as "HOTSPARE to FAILED" instead of "HOTSPARE to READY". Netflash 1.16 1. Corrected version mismatch in “logger screen” in Netware environment and Utility Console. Changes from 7.01q to 7.01v Driver 7.01v 1. Added support for PCI Express 2. Modified POST banner to fit in the client window. New banner is: "PERC 3/SC/DC(L)/QC, 4/SC/DC/Di, 4e/SC/DC/Di/Si & CERC HAM Driver." Megammio 1.02h 1. Fixed persistent Array Manager failure after running in degraded mode. 2. Fixed system hang if Array Manager service started when no PERC controller present in system. Dellmgr 5.24 1. Fixed physical drive size coercion. 2. Addressed problem with "Prepare to remove" option in "objects->Physical Drive" menu 3. Fixed 2 cosmetic issues with initialize and reconstruction messages 4. Addressed failure to start a check consistency when back-ground init was already running for another logical drive. 5. Removed option to span R0. Dellmon 2.10 1. If drive state is changed from HOTSPARE to READY, it is now reported as "HOTSPARE to FAILED" instead of "HOTSPARE to READY". Netflash 1.16 1. Corrected version mismatch in “logger screen” in Netware environment and Utility Console. Driver changes from 7.01n to 7.01q 1) Added fix to resolve NetWare issue with deleting an offline volume. Driver changes from 6.02e to 7.01n 1. Fixed the interrupt and f/w command posted ' race condition'. 2. Updated the release notes for the supported controllers. 3. Suppressed the Enter Debugger for status SC_START_STOP, MEGA_LD_ERROR_ABORTED and MEGA_LD_ERROR_CORRECTED for logical drive. 4. The goToRealMode and exitToDOS routines modified to support for proper pending device request handling. 5. Suppressed the enter debugger for status SC_START_STOP, MEGA_LD_ERROR_ABORTED and MEGA_LD_ERROR_CORRECTED for logical drive. 6. Suppressed the enter debugger for status 5 for logical drive 7. Driver bugs fixed 8. Fixed the queue freeze issue that caused a certification test failure. 9. Fixed a faked command handling issue that led to a recursive Dellmgr invocation failure. 10. Fixed an issue when Open Manage service locks up NW6 server on PE6600 with 2 PERC 4 cards. 11. There was a driver bug in memory allocation routine that could cause a system hang or crash. This is fixed. 12. There is a possibility to fail to delete a Logical Drive randomly under extremely heavy I/O on that device going on. This is fixed. 13. There was a bug when you were spinning up or down a drive NW would abend. This is fixed. Megammio Version 1.02g Changes with respect to 1.02f 1. There is a filter to check the return value of NPA_HACB_Passthru API in the Mega_ASyncIO() function. In the filter, there is a chance to send the same request packet to the driver if the return value of NPA_HACB_Passthru API is NOT NULL. And if that happened, the system would crash.