QLogic QLA23xx SCSI Miniport Driver for Windows NT 4.0 (x86) Contents -------- 1. OS Support 2. HBA support 3. Supported Features 4. Creating the Driver Diskette 5. Installing the Driver 5.1. Initial OS installation with the QLogic Controller as Boot 5.2. Initial OS installation with the QLogic Controller as Add-On 5.3. Adding the QLogic Controller to the Existing OS 5.4. Updating the Existing QLogic Driver 6. Removing the Driver 7. Driver Parameters 7.1. System Registry Parameters 7.2. NVRAM Parameters 8. Limitations 9. Additional Notes 10. Using Fast!UTIL to change the connection options 11. Diskette Content 12. Contacting QLogic ====================================================================== 1. OS Support ------------- This driver works with Windows NT 4.0 (x86) operating systems. Earlier versions of Windows NT and Windows 2000 are not supported. ====================================================================== 2. HBA Support ------------- This driver works with the following HBA models: QLA230x, QLA231x and QLA234x. ====================================================================== 3. Supported Features --------------------- * 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 * Extended Lun support * IP support * Dynamic LUN Masking support * Scan attached target device by port name * FC Tape support * Management Server interface support ====================================================================== 4. Creating the Driver Diskette ------------------------------- 1. Locate the driver you want on the QLogic website and click "Link to driver." 2. When prompted "What would you like to do with this file?" choose "Save this program to disk". Specify a temporary location on the hard drive and download the driver. 3. Insert a blank diskette in the diskette drive A:. 3. Run the self-extracting file you just downloaded specifying A:\ for "Unzip To Folder:". ====================================================================== 5. Installing the Driver ------------------------ This section is divided into the following four sections. 1. Initial OS installation with the QLogic HBA as Boot 2. Initial OS installation with the QLogic HBA as Add-on 3. Adding the QLogic HBA to the Existing OS 4. Updating the existing QLogic Driver ====================================================================== 5.1. Initial OS installation with the QLogic HBA as Boot -------------------------------------------------------- Perform the following steps to initially install Windows NT on the Fibre Channel drive attached to the QLogic HBA. 1. Start NT installation procedure using Windows NT Setup diskettes. 2. After the standard devices have been detected and configured, use "S" option to "Specify Additional Device". 3. Select "Other" and press ENTER. 4. Insert the QLogic driver diskette and press ENTER. 5. Select "QLogic QLA23xx PCI Fibre Channel Adapter" and press ENTER. 6. Continue with standard installation procedure. ====================================================================== 5.2. Initial OS installation with the QLogic HBA as Add-On ---------------------------------------------------------- Perform the following steps to install Windows NT and the QLogic driver on the device not attached to the QLogic HBA. * Same as section 5.1. above ====================================================================== 5.3. Adding the QLogic HBA to the Existing OS --------------------------------------------- Perform the following steps to add the QLA23xx driver to the existing Windows NT system. 1. Click on "Start". 2. Under "Settings", click on "Control Panel". 3. Select "SCSI Adapters" applet from the Control Panel. 4. Select the "Drivers" tab and then click on "Add". 5. Click on "Have Disk". 6. Insert the QLogic driver diskette. 7. Enter "A:\NT" for the path to NT driver and click "OK". 8. Choose "QLogic QLA23xx PCI Fibre Channel Adapter" and click "OK". 9. Select "Yes" to restart system. ====================================================================== 5.4. Updating the Existing QLogic Driver ---------------------------------------- Perform the following steps if the driver is already installed and you want to install an updated version of the driver. 1. Open a DOS Command Prompt window. 2. Change the current directory to the Windows NT driver directory: CD %SystemRoot%\SYSTEM32\DRIVERS 3. Make a backup copy of the old driver: COPY QL2300.SYS QL2300.SAV 4. Insert the diskette with updated driver and copy it over the old driver: COPY A:\NT\QL2300.SYS 5. Shutdown and reboot the system to use the updated driver. ====================================================================== 6. Removing the Driver ---------------------- Perform the following steps to uninstall the QLogic QLA23xx driver from Windows NT: 1. Click on "Start". 2. Under "Settings", click on "Control Panel". 3. Select "SCSI Adapters" applet from the Control Panel. 4. Select the "Drivers" tab and then click on "QLogic QLA23xx PCI Fibre Channel Adapter". 5. Click on "Remove". 6. Select "Yes" to restart system. ====================================================================== 7. Driver Parameters -------------------- The driver parameters are divided into System Registry Parameters and NVRAM Parameters sections. ====================================================================== 7.1. System Registry Parameters ------------------------------- * 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: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on MaximumSGList:REG_DWORD:0x21 4. 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 33 (0x21). 5. Click OK. 6. Exit the Registry Editor, then shutdown and reboot the system. * NumberOfRequests Windows NT supports the "NumberOfRequests" registry parameter to specify the maximum number of outstanding requests per adapter. When the QLogic 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. * FabricSupported By default, the driver supports Fibre Channel fabric (switch). Should you wish to disable fabric support please use the following procedure: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string "FabricSupported=" does not exist, append to end of string ;FabricSupported=0 5. If the string "FabricSupported=1" exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. * LargeLuns - Support for more than 8 LUNs To support more than 8 LUNs it is recommended that the Windows NT service pack 4 or higher be installed. The OEMSETUP.INF file has been changed to automatically update the registry to enable up to 255 LUNs using NT 4.0 Service Pack 4 or higher. This is done via the 'LargeLuns' parameter in the registry. IMPORTANT! If the OS support for large luns is enabled, the miniport's extended LUN support MUST be disabled! To disable the miniport's entended LUN support, run the Host Adapter's embedded Fast!Util and set the 'Luns per Target' parameter to 0. Should you wish to disable OS support for more than 8 luns, please use the following procedure: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on "LargeLuns:REG_DWORD:0x01" 4. Change the data value from 1 to 0 5. Exit the Registry Editor, then shutdown and reboot the system. * 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: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string "Portname=" does not exist, append to end of string ;Portname=0 5. If the string "Portname=1" exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. * FCTape To configure the driver to support FC tape, please use the following procedure: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string "FCTape=" does not exist, append to end of string ;FCTape=1 5. If the string "FCTape=0" exists, change the value from 0 to 1. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. * 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 reset 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 to SAN devices only if necessary 1 Upon receiving RSCN, always performs Cluster logins 2 Upon receiving RSCN, attempts to detect whether the system is running in the Cluster SAN/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 the driver to handle RSCN differently, please use the following procedure: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string "MSCS=" does not exist, append to end of string ;MSCS=n where n = 0, 1, or 2. 5. If the string "Portname=" exists, change the value to the desired value. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. * UseSameNN By default, if you have multiple Fibre Channel HBAs on the same system, the driver will assign the world wide node name obtained from the first HBA to the rest of the HBAs. If you wish to have each HBAs to assume the world wide node name based on its own NVRAM content, you need to disable this feature by setting the UseSameNN parameter to 0. Please use the following procedure to change the UseSameNN parameter: 1. Click on "Start", select "Run", and open the REGEDT32 program. 2. Select HKEY_LOCAL_MACHINE and follow the tree structure down to the QLogic driver as follows: HKEY_LOCAL_MACHINE SYSTEM CurrentControlSet Services Ql2300 Parameters Device 3. Double click on DriverParameters:REG_SZ:MSCS=2;UseSameNN=1 4. If the string "UseSameNN=" does not exist, append to end of string ;UseSameNN=0 5. If the string "UseSameNN=1" exists, change the value from 1 to 0. 6. Click OK. 7. Exit the Registry Editor, then shutdown and reboot the system. ====================================================================== 7.2. NVRAM Parameters --------------------- The NVRAM features described below are hard-coded in the driver. The changes made for the particular NVRAM feature in the Fast!Util do not take effect unless otherwise noted. * None. ====================================================================== 8. Limitations -------------- * None. ====================================================================== 9. Additional Notes ------------------- * When using LUN masking, masking off LUN 0 for a target will cause Disk Administrator to report an offline device representing LUN 0. This is because LUN 0 must be reported to NT to allow NT to scan for the remaining LUNs on the target. The LUN masking code in the driver will allow this, but mask off all other access to LUN 0. NT will interpret this as LUN 0 being online for some period of time, then going offline. Disk Administrator will show this as a device that now reports "Configuration information not available". * When attaching more than 19 devices to an adapter, the "SCSI Adapters" control panel application fails to list the adapter and the attached devices. The devices are correctly displayed by the Registry Editor and by the Disk Administrator. NOTE: This problem has been fixed in the Service Pack 6 or above. * Missing LUNs if more than 64 LUNs are connected to the HBA with NT4.0 SP5 and SP6 When a system is configured with LARGE LUN Support, for example on a Fibre Channel HBA, some of the LUNs assigned to disks or other devices are not visible to other system drivers and as a result are not available to the system. Of 256 possible LUNs, only 231 LUNs are visible. The missing LUNs include the following ranges: 64 to 71 128 to 135 192 to 199 255 A SP6 hot fix is available to address this issue. * Duplicate LUN 0 when LargeLuns Registry Key Enabled When the LargeLuns registry value is enabled for a SCSI adapter and the device supports the SCSI Report LUNs command, LUN 0 may incorrectly be reported multiple times. For example, if Bus 0, Target ID (TID) 3, LUN 0 supports Report LUNs, IOCTL_SCSI_GET_INQUIRY_DATA might display information similar to this: Bus TID LUN Claimed Inquiry String Unique or Duplicate --- --- --- ------- -------------- ------------------- 0 3 0 Y SEAGATE ST1255N Unique 0 3 0 Y SEAGATE ST1255N Duplicate 0 3 3 Y SEAGATE ST1255N Unique This is caused by the way ScsiPort.sys parses the returned Report LUNs Data. The driver incorrectly saves multiple structures representing LUN 0 internally, and this information is passed to the SCSI class drivers or applications via IOCTL_SCSI_GET_INQUIRY_ DATA. The Windows NT 4.0 Service Pack 5 fixes this issue. * 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_ID=FFFFFDh) 80h Switch Name Server (S_ID=FFFFFCh) 81h Switch Embedded Port (FFFc4xh) used for FC-4 probing (Brocade only) FFh IP Broadcast * Connection options The following connection options are supported: Value Connection ----- ---------- 00 Loop only 01 Point-to-point only 02 Loop preferred, otherwise point-to-point The connection option is currently being stored in the "Connection Options Bits" (Bits 6-4) of the "Additional Firmware Options" field of the NVRAM. The default value of the connection option is 2. * 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 13 Enable FC Confirm 1 Additional Firmware Options 12 Enable FC Tape 1 The NVRAM can be changed using QLogic supplied utility. The second way is to set the FCTape DriverParameters in the registry to 1. * Notes on using the QLogic Optimizing & Multipath driver to do failover on JBOD To allow the failover feature to work properly with JBOD configuration using the QLogic Optimizing & Multipath driver, you need to enable device tracking by node name. This can be done by setting the Portname value of the DriverParameters registry to 0, as described in the previous section. * To ensure the driver function properly, the driver changes some of the system related registry entries such as the disk timeout value of the system disk driver during driver installation through the use of the OEMSETUP.INF file. Those values are not being restored upon driver removal. * Notes on LUN 0 issue In order for NT4 to see the device properly, LUN 0 has to be configured. * Updating the system with earlier version of the driver that does not have QLogic Api included Starting with v8.1.5, the driver installation installs both the driver and the QLogic Api (qlsdm.dll). This is reflected in the oemsetup.inf of the driver. However, Windows appears to always reference the latest oemsetup.inf during driver update and when you try to update the driver with earlier version of the driver release that does not come with the QLogic Api, Windows asks you for the file. The work around is to copy the %SystemRoot%\system32\qlsdm.dll file to the root directory of the floppy so that the update can be complete. ====================================================================== 10. Using Fast!UTIL to change the connection options ---------------------------------------------------- The connection option of the QLA2300 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 ISP2300 RISC processor use during the initialization process. To change the change the connection option using the Fast!UTIL, please follow the steps below: 1. Reboot the system. 2. When you see the QLogic QLA2300 BIOS banner and the message: Press <Alt-Q> for Fast!UTIL press ALT-Q and the QLogic Fast!UTIL menu will come up. 3. If you have more than one QLA2300 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 QLA2300 HBA in the system, the "Fast Util Options" menu will come up directly. 4. 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 highlighted by default. 5. On the "Configuration Settings" menu, use the DOWN ARROW key to move the cursor to the "Extended Firmware Settings" and press ENTER. 6. 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. 7. 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 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 2, just use the DOWN ARROW key to select option 2 and press ENTER. Note: if you do not want to make any change, just press ESC to exit this menu. 8. 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. 9. Press ESC again to go back to the "Configuration Settings" screen. 10. 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 the "Save changes" option and press ENTER. This will save the connection option you just changed for the selected HBA. 11. 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. 12. 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. 13. The system will reboot and the new connection option will be effective when the system comes up. ====================================================================== 11. Diskette Content -------------------- The following files on this diskette support Windows NT: 1. QLOGIC - Diskette identification file 2. TXTSETUP.OEM - Text mode installation script 3. \NT\OEMSETUP.INF - Installation script 4. \NT\QL2300.CAT - Catalog file 5. \NT\QL2300.SYS - QLA23xx PCI Fibre Channel miniport driver 6. \NT\README.TXT - This file ====================================================================== 12. Contacting QLogic --------------------- Please visit QLogic's website (http://www.qlogic.com). On this site you will find product information, our latest drivers and links for technical assistance if needed. ====================================================================== Copyright (c) 1999-2003 QLogic Corporation. All rights reserved.Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.