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.