File Name: Readme.txt This README file contains the latest information about installing IBM Netfinity Fibre Channel Host Bus Adapter Device Driver for Windows 2000. Refer to the IBM Support Website for the latest information and updated readme file (See Section 6.1 below). Last Update: 06/01/00 CONTENTS -------- 1.0 Overview 2.0 Change History 3.0 Installation and Setup Instructions 4.0 Configuration Information 5.0 Unattended Mode 6.0 Web Sites and Support Phone Number 7.0 Trademarks and Notices 8.0 Disclaimer 1.0 Overview -------------- 1.1 Overview The new IBM Netfinity Fibre Channel Host Bus Adapater has the following supported features: - Windows 2000 SCSI PnP interface - Extended Lun support - Support Point-To-Point F port, FL port, N port and Arbitrated Loop configurations - Provide Enhanced Loop Id support (251 Loop Ids) in F port configuration - Full-duplex operation in loop configuration (2200A only) - Support IP requests via a separate NDIS miniport driver - Dynamic LUN Masking support - Device scanning by port name - FC Tape support - Management Server interface support - 2200G support - Reduced Interrupt Operation 1.2 Limitations N/A 1.3 Enhancements N/A 1.4 Recommendations and Prerequisites 1.5 Dependencies: TBD 2.0 Change History -------------------- N/A 3.0 Installation and Setup Instructions ----------------------------------------- 3.1 Instructions for Installing Code for First Time IBM Netfinity QLA boards are devices that are Plug and Play compatible to your computer. The step-by-step procedure to install a Plug and Play device is: 1. Connect the device to the appropriate slot on your computer according to the device manufacturer’s instructions. 2. Restart or turn on your computer. 3. When your computer comes up, Windows 2000 will detect the newly installed device by displaying the Found New Hardware with SCSI controller message and start the Found New Hardware wizard program to start the process of installing a device driver for the newly installed device. 4. Click Next. 5. Select Display a list of the known drivers for this device so that I can choose a specific driver. Click Next. 6. Scroll down the Hardware types list, select SCSI and RAID controllers and click Next. 7. Insert the IBM Netfinity Software Diskette into drive A: and click Have Disk. 8. On the Install From Disk screen, type in A:\W2K and click OK. 9. Click Next. 10. On the Start Device Driver Installation screen, click Next. 11. If the Digital Signature Not found screen appears, select Yes. 12. Click Finish on the Upgrade Device Driver Wizard/Completing the Upgrade Device Driver Wizard. 3.2 Instructions for Updating Code If the miniport driver is already installed and you are installing an updated version of the driver, follow this procedure: 1. Start the Device Manager by clicking Start, pointing to Settings, clicking Control Panel, double clicking System applet, clicking Hardware tab, and clicking the Device Manager button. 2. Use scroll bar to scroll down the list of hardware types, double click the SCSI and RAID controller. 3. Select IBM Netfinity QLA2200 PCI Fibre Channel Adapter from the devices list and then click Properties. 4. Click the Driver tab, and then click Update Driver to start the Upgrade Device Driver Wizard. Click Next. 5. Select Display a list of the known drivers for the device so that I can choose a specific driver and click Next. 6. Insert the IBM Netfinity Software Diskette into drive A: and click Have Disk. 7. On the Copy manfacturer's files from, type in A:\W2K and click OK. 8. Click Next on the Upgrade Device Driver Wizard/Select a Device Driver screen. 9. Click Next on the Upgrade Device Driver Wizard/Start Device Driver Installation screen. 10. If the Digital Signature Not found screen appears, select Yes. 11. Click Finish on the Upgrade Device Driver Wizard/Completing the Upgrade Device Driver Wizard. NOTE: If the driver has already been installed once, and you are adding an additional HBA onto the system, when the system comes up, it will detect the device correctly by displaying the Found New Hardware with IBM Netfinity QLA2200 PCI Fibre Channel Adapter message. Follow the procedure below to complete the driver installation: 1. If the Digital Signature Not Found screen is displayed, select Yes. 2. When the Insert Disk message appears, insert the IBM Netfinity Software Diskette into drive A: and click OK. 3. Click Finish on the Found New Hardware Wizard/Completing the Found New Hardware Wizard screen. 3.3 Instructions for Uninstalling Driver To uninstall a Plug and Play device: 1. Turn off your computer and remove the device from your computer according to the manufacturers instructions. NOTE: You do not normally have to use the Device Manager or the Hardware wizard to uninstall a Plug and Play device. After you have removed the device from your computer, and you have restarted your computer, Windows 2000 will recognize that it has been removed. 4.0 Configuration Information ------------------------------- 4.1 General Notes 1. Windows 2000 uses the ANSI-approved version field of the Inquiry data returned by the target device to determine whether it should support only 8 LUNs or 255 LUNs. If the field indicates that the target device complies to SCSI-3 standard, the operating system will enable more than 8 LUNs support. Else, it will support only 8 LUNs. 2. Enhanced Loop Id Of 0 - FFh Loop Ids, some are preallocated for special functions and are not available for use by devices: Loop Ids Functions -------- --------- 7Eh FL_Port (S_ID=FFFFFEh) 7Fh Switch Fabric Controller (S_IS=FFFFFDh) 80h Switch Name Server (S_ID=FFFFFCh) 81h Switch Embedded Port (FFFc4xh) used for FC-4 probing (Brocade only) FFh IP Broadcast 3. ISP connection options The following ISP connection options are supported: Value Options ----- ------- 00 Start in loop mode, by transmitting Lip F7F7 01 Start in point-to-point mode, by transmitting NOS/OLS 02 Start in loop mode first, then switch to point-to-point mode if NOS is detected 03 Start in point-to-point mode first, then switch to loop mode if Lip is detected The connection option is currently stored in the NVRAM and can be changed through the FastUtil. The default value of the connection mode is 3. Since the connection option 3 is tailored to point-to-point environment, it may not work well with loop devices that does not fully support point-to-point primitives. It is recommended to use connection option 0 for loop only environments, especially for loop environments that involve Microsoft Cluster. 4. FC Tape support There are two ways to enable FC tape support, the first method is to set/clear the following bits in the Firmware Options and Additional Firmware Options fields in the NVRAM: Field Bit Description Value ----- --- ----------- ----- Firmware Options 15 Extended Control Block 1 Firmware Options 14 Name Option 1 Additional Firmware Options 15 No Logo on Link Down 1 Additional Firmware Options 13 Enable FC Confirm 1 Additional Firmware Options 12 Enable FC Tape 1 The NVRAM can be changed using IBM supplied QL2xUtil.exe utility. The second way is to set the FCTape DriverParameters in the registry to 1. 5. Support IP requests via a separate NDIS miniport driver This miniport is capable of handling both SCSI and IP requests. In order to enable the IP support, you need to install a separate NDIS miniport driver from IBM that will work with this miniport. If you have multiple QLA2200 HBAs in the system and in order to enable the IP for each of the HBA, you need to install a NDIS miniport driver for each instance of the QLA2200 miniport using the Network applet. 6. Management Server API support Currently, the Management Server API support is only available for ISP2200 product family. There are only certain models of switches that support the Management Server e.g. Brocade Model 2800. 7. Using Fast!UTIL to change the connection options The connection option of the QLA2200 HBA is stored in the NVRAM of the HBA. It defines the type of connection (loop or point-to-point) or connection preference with which the ISP2200 RISC processor use during the initialization process. To change the change the connection option using the Fast!UTIL, please follow the steps below: A. Reboot the system. B. When you see the QLA2200 BIOS banner and the message: Press for Fast!UTIL press ALT-Q and the Fast!UTIL menu will come up. C. If you have more than one QLA2200 HBA's in the system, the "Select Host Adapter" menu will appear. Use the UP ARROW or DOWN ARROW keys to select the HBA you like the connection option to be changed (each HBA in the list is differentiated by its unique I/O Address) and press ENTER. The "Fast!UTIL Options" menu will come up. If you have only one QLA2200 HBA in the system, the "Fast Util Options" menu will come up directly. D. Select "Configuration Settings" from the Fast!UTIL Options menu by using the UP ARROW or DOWN ARROW keys and hit ENTER. The "Configuration Settings" option should be hightlighted by default. E. On the "Configuration Settings" menu, use the DOWN ARROW key to move the cursor to the "Extended Firmware Settings" and press ENTER. F. The "Extended Firmware Settings" menu will appear. The "Connection Options" field of the menu shows the current connection option value the HBA has. On the "Extended Firmware Settings" menu, use the DOWN ARROW key to move the cursor to the "Connection Options" and press ENTER. A menu with the available connection options will appear. G. Use the UP ARROW or DOWN ARROW keys to move the cursor to the desired option. The available options are: Option Type of Connection ------ ------------------ 0 Loop only 1 Point to point only 2 Loop preferred, otherwise point to point 3 Point to point perferred, otherwise loop (default setting) If the current setting is 3, the default setting and you would like to change it to 0, just use the UP ARROW key to select option 0 and press ENTER. If the current setting is 0 and you would like to change it to 3, just use the DOWN ARROW key to select option 3 and press ENTER. NOTE: If you do not want to make any change, just press ESC to exit this menu. H. After you hit ENTER, the "Extended Firmware Settings" menu should re-appear and the value shown for the "Connection Options" field should display the value you just selected. Press ESC to exit the "Extended Firmware Settings" menu. I. Press ESC again to go back to the "Configuration Settings" screen. J. Press ESC again and the "Configuration settings modified" menu will appear, if you have made any changes. The "Save changes" option should already be highlighted. If not, select the "Save changes" option and press ENTER. This will save the connection option you just changed for the selected HBA. K. The "Fast!UTIL Options" screen will appear after the changes have been saved. If you have more than one HBAs in the system, and would like to change the connection option for the other HBA, move the cursor to the "Select Host Adapter" option and press Enter. This will allow you to go back to the "Select Host Adapter" menu to select another HBA. Go back to step 3 to repeat the process of changing the connection options for the next HBA. Press ESC to exit the Fast!UTIL if there is only one HBA in the system, or there is no need to make addtional changes. L. The "Exit Fast!UTIL" will pop up. The "Reboot System" option should be highlighted. If not, select the "Reboot System" option. Press ENTER to reboot the system. M. The system will reboot and the new connection option will be effective when the system comes up. 4.2 Registry Paramters for Drivers 1. MaximumSGList Windows NT includes enhanced scatter/gather list support for doing very large SCSI I/O transfers. Windows NT supports up to 256 scatter/gather segments of 4096 bytes each, allowing transfers up to 1048576 bytes. NOTE: the OEMSETUP.INF file has been updated to automatically update the registry to support 65 scatter/gather segments. Normally, no additional changes will be necessary as this typically results in the best overall performance. If you wish to alter this value, please use the following procedure: A. Click on "Start", select "Run", and open the REGEDT32 program. B. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM NEtfinity driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2200 Device Parameters C. Double click on MaximumSGList:REG_DWORD:0x41 D. Enter a value from 16 to 255 (0x10 hex to 0xFF). A value of 255 (0xFF) enables the maximum 1 MByte transfer size. Setting a value higher than 255 results with the default of 64K transfers. The default value is 65 (0x41). E. Click OK. F. Exit the Registry Editor, then shutdown and reboot the system. 2. NumberOfRequests Windows 2000 supports the "NumberOfRequests" registry Parameter to specify the maximum number of outstanding requests per adapter. When the IBM driver is installed, the registry will be automatically updated with this parameter set to a value of 150 (0x96). WARNING: DO NOT increase this parameter above 150. Doing so can result in a system failure. 3. FabricSupported By default, the driver supports Fibre Channel fabric (switch). Should you wish to disable fabric support please use the following procedure: A. Click on "Start", select "Run", and open the REGEDT32 program. B. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM Netfinity driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2200 Parameters Device C. Double click on DriverParameters:REG_SZ:FabricSupported=1; FabricDeviceCount=64;ConfigRequired=0 D. If the string "FabricSupported=" does not exist, append to end of string ;FabricSupported=1 E. If the string "FabricSupported=1" exists, change the value from 1 to 0. F. Click OK. G. Exit the Registry Editor, then shutdown and reboot the system. 4. Portname By default, the driver track devices by their port names. To configure the driver to track devices by node names, please use the following procedure: A. Click on "Start", select "Run", and open the REGEDT32 program. B. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM Netfinity driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2200 Parameters Device C. Double click on DriverParameters:REG_SZ:FabricSupported=1; FabricDeviceCount=64;ConfigRequired=0 D. If the string "Portname=" does not exist, append to end of string ;Portname=0 E. If the string "Portname=1" exists, change the value from 1 to 0. F. Click OK. G. Exit the Registry Editor, then shutdown and reboot the system. 5. FCTape To configure the driver to support FC tape, please use the following procedure: A. Click on "Start", select "Run", and open the REGEDT32 program. B. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM Netfinity driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2200 Parameters Device C. Double click on DriverParameters:REG_SZ:FabricSupported=1; FabricDeviceCount=64;ConfigRequired=0 D. If the string "FCTape=" does not exist, append to end of string ;FCTape=1 E. If the string "FCTape=0" exists, change the value from 0 to 1. F. Click OK. G. Exit the Registry Editor, then shutdown and reboot the system. 6. MSCS In SAN configuration, driver is required to handle RSCN efficiently to avoid disruption of I/O because of unnecessary re-logins. However, in Microsoft Cluster environment, it is necessary for the driver performs re-logins because the shared storage subsystems may be reseted by other initiators through a ResetBus operation. The driver parameter MSCS is designed to accommodate the conflicting needs on how to handle RSCN in both environments. It accepts three values: Value RSCN Handling Environment ----- ------------- ----------- 0 Upon receiving RSCN, performs logins SAN to devices only if necessary 1 Upon receiving RSCN, always performs Cluster logins 2 Upon receiving RSCN, attempts to SAN/Cluster detect whether the system is running in the Cluster environment during boot. If yes, always performs logins upon receiving RSCN. If not, performs logins only if necessary By default, the Oemsetup.inf file is set up to have MSCS set to 2. To change the driver to handle RSCN differently, please use the following procedure: A. Click on "Start", select "Run", and open the REGEDT32 program. B. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the IBM Netfinity driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2200 Parameters Device C. Double click on DriverParameters:REG_SZ:FabricSupported=1; FabricDeviceCount=64;ConfigRequired=0 D. If the string "MSCS=" does not exist, append to end of string ;MSCS=n where n = 0, 1, or 2. E. If the string "Portname=" exists, change the value to the desired value. F. Click OK. G. Exit the Registry Editor, then shutdown and reboot the system. 4.3 Hardware Status and Information 4.4 Unsupported Configurations 5.0 Unattended Mode --------------------- N/A 6.0 WEB Sites and Support Phone Number ---------------------------------------- 6.1 IBM Support Web Site: http://www.pc.ibm.com/support 6.2 IBM Marketing Netfinity Web Site: http://www.pc.ibm.com/netfinity 6.3 If you have any questions about this update, or problem applying the update go to the following Help Center World Telephone Numbers URL: http://www.pc.ibm.com/qtechinfo/YAST-3P2QLY.html. 7.0 Trademarks and Notices ---------------------------- 7.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM Netfinity Qlogic is a registered trademark of QLogic Corporation. Microsoft and Windows are trademarks or registered Trademarks of Microsoft Corporation. Other company, product, and service names may be trademarks or service marks of others. 8.0 Disclaimer ---------------- 8.1 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. 8.2 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 Corporation.