
               QLogic QLA2100 PCI Fibre Channel Adapter
                  QL2100 HAM Driver for NetWare 4.1X

Release Notes:

  This release has been tested with Novell NetWare version 4.11.  
  The QLogic QL2100 HAM driver supports the QLogic QLA21xx
  PCI Fibre Channel host adapters.  As of this date, the driver 
  and host adapter has been tested only with disk type devices. 

This document is divided into 6 Sections

   Section 1: NetWare files on this disk.
   Section 2: Installation of NetWare onto a Fibre Channel disk.
   Section 3: Adding a QLogic Adapter to an existing system.
   Section 4: Novell NetWare support of QLogic HAM driver.
   Section 5: Troubleshooting.
   Section 6: PCI Hot Plug.
   Section 7: 128 LUN Support.

  
Section 1: NetWare files on this disk
-------------------------------------

  The following files are on this diskette for supporting NetWare 4.1X:

    \NETWARE4\QL2100.DDI    Driver description file

    \NETWARE4\QL2100.HAM    NetWare 4.X HAM driver for supporting the
                            QLogic Fibre Channel PCI QLA21xx host adapters

    \NETWARE4\README.TXT    This file

    \NETWARE4\QLNWCDRM.SYS  DOS based CD-ROM device driver


Section 2: Installation of NetWare onto a Fibre Channel disk
------------------------------------------------------------

  To initially install NetWare on a Fibre Channel disk attached to the 
  QLogic Fibre Channel adapter and/or to install NetWare from a CD-ROM 
  player attached to a SCSI adapter:

    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:\NETWARE4

    5. Press <Enter> to select the QLogic HAM driver.

    6. Continue with the standard NetWare installation procedure.


Section 3:  Adding a QLogic Adapter to an existing system
---------------------------------------------------------

  To install the QLogic Fibre Channel QL2100 HAM driver on previously 
  installed NetWare system perform the following steps:

    1. From the NetWare server prompt, load the NetWare Install program:
    
            LOAD INSTALL

    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:\NETWARE4

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


Section 4:  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

  SCSI2TP.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).

  
Section 5:  Troubleshooting
---------------------------

  To support multiple adapters, add one LOAD command per adapter to
  your STARTUP.NCF file. (LOAD QL2100.HAM SLOT=xxxx) The "SLOT=xxxx" 
  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 QL2100 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.

  
Section 6: 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 QL2100.HAM SLOT=3
        

Section 7: 128 LUN Support
--------------------------

  NOTE: The following applies ONLY to QL2100.HAM Version 2.xx drivers:

  Please note that when adapter is configured for greater than 8 LUNS,
  actual LUNs are mapped to virtual ID/LUN pairs as follows:

        n = The adapter's configured Number of LUNs per ID
            (settable via the ALT-Q FastUTIL utility)

        M = Maximum Number of Loop IDs (FC ports) = 1008 / n

  The following table shows the maxmium number of IDs (M) available
  for the configured number of LUNs (n):

        Configured     Calculated
        LUNs per ID   Max Loop IDs
             n              M
        -----------   ------------
           128              7
            64             15
            32             31
            16             63
             8            126
        -----------   ------------

  This means that you must configure the Loop ID (FC Port address)
  for each target device in the range specified by the Max Loop IDs
  (ie: each device Loop Id must be in the range 0 to M - 1 inclusive).


