
QLogic QLA2300 SCSI PnP Miniport Driver for Windows .NET/XP/2000 (x86) 


Contents 
========

1.    OS Support
2.    Supported Features
3.    Release History
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 release of driver works with Windows .NET/XP/2000 (x86).


======================================================================

2. Supported Features 
---------------------

*  Windows .NET/XP/2000 SCSI PnP interface 
*  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
*  Reduced Interrupt Operation


======================================================================

3. Release History 
------------------

Please refer to Release Notes.

======================================================================

4. Creating the Driver Diskette
-------------------------------

1. Locate the driver you want on the QLogic website and click "Link to 
   driver."
2. If 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 Controller as Boot
2. Initial OS installation with the QLogic Controller as Add-on
3. Adding the QLogic Controller to the Existing OS
4. Updating the existing QLogic Driver


======================================================================

5.1. Initial OS installation with the QLogic Controller as Boot
---------------------------------------------------------------

Follow the procedure below to initially install Windows on the 
boot disk attached to the QLogic QLA2300 adapter: 

1. Start Windows installation procedure using the Setup 
   diskettes or CD.
2. If you are booting from the CD, press F6 if you see the message

       Press F6 if you want to install a thrid party SCSI or RAID 
       Driver ...

   After all the standard devices have been loaded, press S to Specify
   Additional Device. Go to step 5.
3. If you are booting from the floppy diskette, after the standard 
   devices have been detected and configured, press S to Specify 
   Additional Device. 
4. Select Other and press ENTER.
5. Insert the QLogic software diskette and press ENTER. 
6. Select the QLogic QLA2300 PCI Fibre Channel Adapter
   and press ENTER. 
7. Continue with standard installation procedure. 


======================================================================

5.2. Initial OS installation with the QLogic Controller as Add-On
-----------------------------------------------------------------

Perform the following steps to install Windows and the QLogic 
driver on the device not attached to the QLA2300 controller.

1.  Start Windows installation procedure using the Setup 
    diskettes or CD.
2.  When Windows detects 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.
3.  Click Next.
4.  Select Search for a suitable driver for my device (recommended).  
    Click Next.
5.  Scroll down the Hardware types list, select SCSI and RAID 
    controllers and click Next.
6.  Insert the QLogic Software Diskette into drive A: and click Have 
    Disk.
7.  On the Install From Disk screen, type in

       A:\

    and click OK. 
8.  Click Next.
9.  On the Start Device Driver Installation screen, click Next.
10. When the Digital Signature Not found screen appears, select Yes.
11. Click Finish on the Upgrade Device Driver Wizard/Completing the 
    Upgrade Device Driver Wizard.
12. You will be prompted the message: 

       Your hardware settings have changed. You must restart your 
       computer for these changes to take effect.

       Do you want to restart your computer now?

    Click Yes to restart the computer right away.


======================================================================

5.3. Adding the QLogic Controller to the Existing OS 
----------------------------------------------------

Perform the following steps to add the driver to the existing Windows
2000 system.

QLogic QLA2300 HBAs 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 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 Search for a suitable driver for my device (recommended).  
    Click Next.
6.  Scroll down the Hardware types list, select SCSI and RAID 
    controllers and click Next.
7.  Insert the QLogic Software Diskette into drive A: and click Have 
    Disk.
8.  On the Install From Disk screen, type in

       A:\

    and click OK. 
9.  Click Next.
10. On the Start Device Driver Installation screen, click Next.
11. When the Digital Signature Not found screen appears, select Yes.
12. Click Finish on the Upgrade Device Driver Wizard/Completing the 
    Upgrade Device Driver Wizard.
13. You will be prompted the message: 

       Your hardware settings have changed. You must restart your 
       computer for these changes to take effect.

       Do you want to restart your computer now?

    Click Yes to restart the computer right away.

Notes
-----

*  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 QLogic QLA2300 PCI Fibre Channel Adapter message. 
   Follow the procedure below to complete the driver installation:

   1.  When the Digital Signature Not Found screen is displayed, 
       select Yes.
   2.  When the Insert Disk message appears, insert the QLogic 
       Software Diskette into drive A: and click OK.
   3.  Click Finish on the Found New Hardware Wizard/Completing the 
       Found New Hardware Wizard screen.
   4.  You will be prompted the message: 

          Your hardware settings have changed. You must restart your 
          computer for these changes to take effect.

          Do you want to restart your computer now?

       Click Yes to restart the computer right away.

*  QLogic is in the processing of obtaining a Digital Signature for 
   the driver through the official WHQL process from Microsoft. Once a
   valid Digital Signature has been obtained and put in the CAT file,
   the Digital Signature Not found screen should not appear.

======================================================================

5.4. Updating the Existing QLogic Driver
----------------------------------------

*  Windows 2000

Perform the following steps if the driver is already
installed and you want to install an updated version of the driver.

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 QLogic QLA2300 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 device drivers for this device
    so that I can choose a specific driver.  Click Next.
6.  Insert the QLogic Software Diskette into drive A: and click Have 
    Disk.
7.  On the Copy manfacturer's files from, type in

       A:\

    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. When the Digital Signature Not found screen appears, select Yes.
11. Click Finish on the Upgrade Device Driver Wizard/Completing the 
    Upgrade Device Driver Wizard.
12. You will be prompted the message: 

       Your hardware settings have changed. You must restart your 
       computer for these changes to take effect.

       Do you want to restart your computer now?

    Click Yes to restart the computer right away.

*  Windows XP

Perform the following steps if the driver is already
installed and you want to install an updated version of the driver.

1.  Start the Device Manager by clicking Start, pointing to Settings, 
    clicking Control Panel, performance and maintenance, administrative tools,
    double clicking computer management and then 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.  Double click the QLogic QLA23xx PCI Fibre Channel Adapter from the devices 
    list.
4.  Click the Driver tab, and then click Update Driver to start the 
    Upgrade Device Driver Wizard.
5.  Select - Install from a list or specific location (Advanced). Click Next.
6.  Select - Don't search I will choose the driver to install. Click next.
7.  Insert the QLogic Software Diskette into drive A: and click Have 
    Disk.
8.  On the Copy manufacturer’s files from, type in

       A:\

    and click OK. 
9.  Click Next on the Hardware Update Wizard/Select the Device 
    Driver screen.
10. When the Hardware Installation screen appears, select Continue Anyway.
11. Click Finish on the Hardware Update Wizard/Completing the 
    Upgrade Device Driver Wizard.
12. Click Close on the Qlogic QLA23xx PCI Fibre Channel Adapter Properties screen. 
13. You will be prompted with the message: 

       Your hardware settings have changed. You must restart your 
       computer for these changes to take effect.

       Do you want to restart your computer now?

    Click Yes to restart the computer right away.


Note
----

*  QLogic is in the processing of obtaining a Digital Signature for 
   the driver through the official WHQL process from Microsoft.  Once 
   a valid Digital Signature has been obtained and put in the CAT 
   file, the Digital Signature Not found screen should not appear.
    

======================================================================

6. Removing the Driver
----------------------

To uninstall a Plug and Play device:

*   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 will recognize that it has been removed. 


======================================================================

7. Driver Parameters
--------------------

The driver parameters are divided into System Parameters and NVRAM 
Parameters sections.


======================================================================

7.1. System Registgry Parameters
--------------------------------

*  MaximumSGList

   Windows includes enhanced scatter/gather list support for 
   doing very large SCSI I/O transfers. Windows 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
                      hp2300
                         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 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.
  
*  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
                      hp2300
                         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
-------------------

*   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

*   Connection options

    The following 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

    The connection option is currently stored in the NVRAM and can be 
    changed through the FastUtil.  The default value of the connection
    mode is 2.

*   FC Tape support

    This can be enabled/disabled in the Fast!Util\Extended Firmware
    Settings.

*   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.

*   Management Server API support

    Currently, the Management Server API support is only available for
    ISP2300 product family and the only switch that support the 
    Management Server is Brocade Model 2400 ("Cocoon").

*   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 hightlighted 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 2, 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 3 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: 

1.  QLOGIC            - Diskette identification file 
2.  TXTSETUP.OEM      - Driver installation script for text mode 
                        installation 
3.  OEMSETUP.INF      - Driver installation script
4.  QLPSEUDO.INF      - Pseudo device installation script
5.  QL2300.CAT        - Catalog file
6.  HP2300.SYS        - QLogic QLA2300 PCI Fibre Channel miniport 
                        driver
7.  RELEASE.TXT       - Release notes
8.  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) 2000 QLogic Corporation. All rights reserved. 
