Readme.txt Driver File Contents (ql21nw_v5.40s.exe)

     QLogic QLA2x00 HAM Driver for NetWare 5.xx and 4.xx


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.3.1. Adding the Driver for the First Time
5.3.2. Adding Additional QLogic QLA2x00 Controller
5.4. Updating the Existing QLogic Driver 
6. Removing the Driver
7. Driver Parameters
7.1. System Parameters
7.2. NVRAM Parameters
8. Limitations
9. Additional Notes
9.1. Novell NetWare support of QLogic HAM driver
9.2. PCI Hot Plug
9.3. 256 LUN Support
9.4. Support for DMI
9.5. Multipath support
10. Diskette Content
11. Contacting QLogic

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

1. OS Support 
-------------

This driver has been tested with NetWare 4.2 and 5.x.


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

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

* PCI Hot Plug
* 256 LUN Support
* DMI

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

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

Please refer to Release Notes.

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

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

Locate the driver you want on the QLogic website and click "Link to 
driver." 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. Insert a blank diskette in 
the diskette drive. 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
---------------------------------------------------------------

Perform the following steps to initially install NetWare on the Fibre
Channel disk drive attached to the QLA2x00 controller.

1. If you haven't already done so, install DOS on your boot disk.
2. Follow the standard NetWare instructions to begin the installation.
3. When prompted to "Choose the Server Drivers - Disk Driver", press 
   <Insert> to install an unlisted driver.
4. Insert the QLogic driver diskette and press <F3> to specify the
   path to the QLogic HAM driver:

       A:\NETWARE

5. Press <Enter> to select the QLogic HAM driver.
6. Follow the standard NetWare installation procedure and complete 
   the installation.

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

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

Perform the following steps to install <OS> and the QLogic driver on 
the device not attached to the QLA2x00 controller.

Same as section 5.1.

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

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

Perform the following steps to add the driver to the existing NetWare 
system.

5.3.1. Adding the Driver for the First Time
-------------------------------------------

1. From the NetWare server prompt, load the appropriate NetWare 
   program:

       LOAD INSTALL  (NetWare 4.xx)
       LOAD NWCONFIG (NetWare 5.x)

2. Select "Driver options" from the main menu.
3. Select "Configure disk and storage device drivers".
4. Select "Select an additional driver".
5. Press <Insert> to install an unlisted driver.
6. Insert the QLogic Fibre Channel Software diskette and press <F3>
   to specify the path to the QLogic HAM driver:

       A:\NETWARE

7. Press <Enter> to select the QLogic HAM driver and select "Yes"
   to copy the driver from the diskette to the server directory.

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

5.3.2. Adding Additional QLogic QLA2x00 Controller
--------------------------------------------------

To support multiple adapters, add one LOAD command per adapter to
your STARTUP.NCF file (LOAD QL2x00.HAM SLOT=n).  The "SLOT=n" 
command line parameter is provided for specifying which adapter to 
configure for each load instance. If the driver is loaded manually
from the server prompt and there are multiple adapters, the user
will be required to pick a slot number from a list.

The QLogic Fibre Channel QL2x00 HAM driver reads the onboard NVRAM 
and supports all of the customized configuration parameters for the 
adapter and the attached Fibre Channel devices.  Use the <ALT-Q> key 
combination during boot to access the adapter's configuration options.

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

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. From the NetWare server prompt, load the appropriate NetWare 
   program:

       LOAD INSTALL  (NetWare 4.xx)
       LOAD NWCONFIG (NetWare 5.x)

2. Select "Driver options" from the main menu.
3. Select "Configure disk and storage device drivers".
4. Select "Deselect a selected driver".
5. Choose the QL2x00 HAM driver
6. Select "Select an additional driver".
7. Press <Insert> to install an unlisted driver.
8. Insert the QLogic Fibre Channel Software diskette and press <F3>
   to specify the path to the QLogic HAM driver:

       A:\NETWARE

9. Press <Enter> to select the QLogic HAM driver and select "Yes"
   to copy the driver from the diskette to the server directory.
10. Select "Select/Modify drivers parameter".
11. Insert the Slot Number and press <F10>.
12. Select "Save parameters and load driver".


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

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

1. From the NetWare server prompt, load the appropriate NetWare 
   program:

       LOAD INSTALL  (NetWare 4.xx)
       LOAD NWCONFIG (NetWare 5.x)

2. Select "Driver options" from the main menu.
3. Select "Configure disk and storage device drivers".
4. Select "Deselect a selected driver".


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

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

SLOT=x

   Load the driver in the NetWare server prompt (:) by typing the 
   load command with the Slot parameter. For example,

       LOAD QL2X00.HAM SLOT=x

   where x is the slot identification number.

/LUNS

   If you want to enable LUN support, add LUNS switch to the load 
   command. For example,

       LOAD QL2X00.HAM SLOT=x /LUNS

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

8. Limitations
--------------

* None

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

9. Additional Notes
-------------------

9.1. Novell NetWare support of QLogic HAM driver
------------------------------------------------

The following drivers are provided with Novell NetWare for supporting
various Fibre Channel devices through the Fibre Channel HAM driver:

SCSIHD.CDM    NetWare CDM driver for supporting SCSI hard disk devices
SCSICD.CDM    NetWare CDM driver for supporting SCSI CD-ROM devices
SCSIMO.CDM    NetWare CDM driver for supporting SCSI magneto-optical 
              storage devices
NWTAPE.CDM    NetWare CDM driver for supporting SCSI tape devices 
              (SBACKUP requires this driver)
NWASPI.CDM    NetWare CDM driver for supporting SCSI devices through 
              the ASPI interface (see note below)
CDROM.NLM     NetWare CD-ROM driver for supporting CD-ROM devices

After the HAM driver is loaded, the CDM drivers will be loaded
automatically by NetWare as needed.

NOTE: Contact Novell for any missing CDM drivers that you need.
      (the NWASPI.CDM driver is missing on the NetWare 4.1 release.)


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


9.2. PCI Hot Plug
-----------------

NOTE: This procedure addresses only the driver-related portion of the
      PCI Hot Swap operation. The server must have PCI slots that are
      capable of being powered up and down independently.  Depending 
      on the server platform, this entire operation may be controlled
      by a platform specific software module supplied by the platform
      vendor. In such a case, these commands are issued directly to
      the driver and do not require the operator to enter them. 

PCI Hot Plug works by unloading a specific instance of the driver 
associated with a specific host adapter. It allows a failed adapter 
to be removed and replaced by an adapter of the same type without 
disrupting the operation of other adapters of the same type. The 
steps necessary to perform a hot swap operation are listed below. 

1. Type "List Devices" at the server console.  You will see a list 
   similar to this example:

       [V591-A0-D0:0] SCSI HARD DISK
       [V591-A0-D1:0] SCSI HARD DISK
       [V591-A1-D3:0] SCSI HARD DISK
       [V591-A1-D4:0] SCSI HARD DISK

2. If it were desired to remove host adapter instance 0 controlling 
   the first two hard drives, the operator would enter the following
   command:

       REMOVE STORAGE ADAPTER A0

3. After the host adapter has been replaced, the operator would make 
   the new adapter operational by loading another instance of the 
   driver using the normal load command syntax.  For example:

       LOAD QL2x00.HAM SLOT=3

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

9.3. 256 LUN Support
--------------------

To find all LUNS, load the driver with the /LUNS qualifier. 
For example:

    LOAD QL2x00.HAM SLOT=3 /LUNS

Or, if the driver is already loaded, use the command SCAN ALL LUNS at
the server console prompt to find all LUNS (new and existing LUNS).

NOTE: The following applies ONLY to QL2x00.HAM Version 5.xx drivers:

    * The driver reports actual LUN numbers without ID/LUN mapping.
    * The driver reports virtual ID numbers due to the dynamic nature of 
      fabrics.

To use more than 8 LUNs per ID, the following modules MUST be updated:

    a.  SCSIHD.CDM     for use with hard disk drives
    b.  SCSICD.CDM     for use with cd-rom drives
    c.  SCSIMO.CDM     for use with magneto-optical disk drives
    d.  SCSI2TP.CDM    for use with tape drives
    e.  SCSICHGR.CDM   for use with media changers

The new versions of these modules are available from Novell.

IMPORTANT!  With the new CDM modules, set the LUNs Per Target 
            parameter in Fast!Util to the required number of 
            LUNs per target ID.

With the old CDM modules, only 8 LUNs per target ID are allowed. 
Set the LUNs Per Target parameter to 8 in Fast!Util.

If not using multiple LUNs per ID, set this parameter to 0.

To set the LUNs Per Target parameter:

1. Reboot the hardware, and do ALT-Q when QL2x00 banner appears.
2. Select the desired adapter.
3. Select Configuration Settings.
4. Select Advanced Adapter Settings.
5. Select LUNs Per Target and change the LUNs Range.
6. Press ESC twice and select Save.
7. Press ESC again and select Reboot. 

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

9.4. Support for DMI
--------------------

This driver supports DMI (Desktop Management Interface) allowing
QLogic adapter information and statistics to be queried by a remote
Windows NT client running the QLogic QLview for Fibre application. 

Please refer to the readme file for the QLogic QLview for Fibre for 
further information.

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

9.5.  Multipath support
-----------------------------
The driver by default will present only one path to NetWare if multiple
adapters are connected to the same storage device. This prevents volumes from
being double mapped and causing mount corruption.

To disable multi-path mode and allow Netware to see all paths, load
the driver with the /ALLPATHS option, as shown here:

    LOAD QL2x00.HAM SLOT=3 /LUNS /ALLPATHS

The /ALLPATHS option may be required if an upper layer failover CDM
is present (the CDM is expecting to see all paths to each device).


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

10. Diskette Content
--------------------

\NETWARE\QL2x00.DDI     Driver description file
\NETWARE\QL2x00.HAM     NetWare HAM driver for supporting the QLogic
                        Fibre Channel PCI QLA2x00 host adapters
\NETWARE\RELEASE.TXT    Release Notes
\NETWARE\README.TXT     This file


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

11. 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. 
Download Driver Pack

How To Update Drivers Manually

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.

server: web4, load: 0.81