*****************************************************************************
                                  NWPA_MPT_INSTALL.TXT  
***************************************************************************** 

INSTALLATION GUIDE FOR THE MPT DRIVER: LSIMPTNW.HAM  


This file describes the features and use of the LSI Logic Fusion-MPT (TM) 
NetWare Peripheral Architecture (NWPA) device drivers for the Novell 
NetWare 5.1 and Novell Netware 6.5 operating system environments. It is 
divided into the following sections:

Introduction
     Features
     LSI Logic Device Supported
     Description
     Configuration IOCTL Interface Support
     ASPI Support

Installing Your NWPA NetWare Driver
     Preparing Your System for NWPA Drivers
     NetWare 5.1 and 6.5 New Installations 
     Reconfiguring Driver Options 

Command Line Options 
     Information Option 
          Using the Help Mode Option 
     NetWare NWPA Driver Customizable Options 
          Using the Elevator Threshold Option 
          Using the Handles Option 
          Using the Minimum Timeout Option 
          Using the Tagged Queuing Option
          Using the Scan Option 
          Using the Synchronous SCSI Option
          Using the Verbose Option 
          Using the Width Option 
         
Important Additional Information 
     Supported DOS Configurations
     Supported DOS Drivers 
          ASPIMPT.SYS
          SYMCD.SYS 
          MSCDEX.EXE 
          SYMDISK.SYS 


************************* LSI Logic NWPA Driver *************************

The LSI Logic MPT NWPA driver for the Novell NetWare operating system allows 
you to utilize an LSI Logic SAS MPT-controller or processors.  The MPT SAS 
BIOS (version 6.04.00 or higher) controls these controllers or processors with 
NetWare.  This driver along with the designated LSI Logic SCSI MPT-controllers
or processors and an appropriate Custom Device Module (CDM), provide a SAS 
solution within the NetWare environment.

A single driver is provided for the Novell NetWare versions 5.1 and
6.5 environments. This document explains how to install and use the 
LSI Logic MPT NWPA SCSI Host Adapter Module (HAM) driver for NetWare.

Note:  Current Netware drivers can be downloaded from the LSI Logic web site at 
       http://www.lsilogic.com/support.  After you are connected to this web 
       site, go to the "Download Center". Select the product category, then the 
       appropriate product. A bullet in the Drivers section will display all 
       driver packages associated with the product selection.



*  *  *  *  *  *  *  *  *  *  * Features  *  *  *  *  *  *  *  *  *  *  * 

The MPT HAM driver supports these features:

o  Supports multiple host adapters 
o  Supports multiple logical unit numbers (LUNS)  
o  Offers Large LUN support (larger than 7.844 gigabytes) 
o  Supports Serial Attached SCSI(SAS) protocol with SAS or SATA devices.
o  Supports Disconnect/Reselect 
o  Supports tagged command queuing 
o  Supports simple and ordered queue tags
o  Supports Scatter/Gather
o  Supports shared interrupts 
o  Supports MPT 5.xx BIOS (with ASPIMPT.SYS version 5.02 or greater)
o  Supports MPT 5.xx BIOS (without ASPIMPT.SYS) 
o  Supports MPT 5.xx DOS drivers 


In conjunction with Novell software: 

o  Support for the MPI IOCTL Interface for NetWare using the LSICFGNW.NLM
    utility driver.
o  Support for SCSI CD-ROM devices via NetWare's SCSICD.CDM 
o  Support for tape and ASPI devices by using NetWare's NWTAPE.CDM for
    NetWare versions 5.1 and 6.5.                                  

In addition to the Release Definitions, the following restrictions apply:


o  NWPA.NLM must be version 3.20.04 (or higher) for NetWare 6.5, or version 3.09 
   (or higher) for Netware 5.1 or newer in SMP environments.

   1. To upgrade to SMP after NetWare has been installed and while you are in
      the server prompt, type:

      load install

      A menu appears.

   2. Select the Multiprocessor selection.

      Then, another menu appears.

   3. Select the default:

      MPS14

   4. Follow the remaining prompts and then exit load install.

   5. Shut down the server, and reboot the system.


Note: Other third party CDMs may also support these devices. 


*  *  *  *  *  *  *  *  *  * LSI Logic Devices Supported *  *  *  *  *  *  * 

The LSIMPTNW.HAM supports the following devices and associated LSI Logic host 
adapters:

o  SAS1068 
o  SAS1064

*  *  *  *  *  *  *  *  *  *  * Description  *  *  *  *  *  *  *  *  *  * 

The LSI Logic MPT NWPA solution consists of the device driver, LSIMPTNW.HAM 
and the NetWare NWPA installation file LSIMPTNW.DDI.


LSIMPTNW is an NWPA Host Adapter Module (HAM). In order to support Serial
Attached SCSI devices, you must load the HAM module in conjunction 
with a SCSI Custom Device Module (CDM). Novell has developed generic 
CDMs to support SCSI Hard Drives.  These can be used with the SAS HAM and SAS devices. 
In addition, third party vendors are developing
CDMs to support their specific devices. 


*  *  *  *  *  *  *  *  *  *  * Configuration IOCTL Interface Support  *  *  *  *  *  *  *  *  *  * 

Support for the MPI IOCTL (see LSI specification for details) Interface for NetWare
is provided by the LSICFGNW.NLM utility driver.  This software in conjunction with
this driver provides an interface for management and SCSI pass through utility
applications.  If this functionality is required by your application, the LSICFGNW.NLM
software must be loaded after the driver instances are loaded.  This can be
accomplished by adding the following line to the startup.ncf file:
  LOAD LSICFGNW.NLM
Only one instance of this NLM should be loaded.   The NLM will automatically
attach to all of the adapter driver instances at that point.  In order for the
LSICFGNW.NLM software to load from the startup.ncf file it should be placed in the
C:\NWSERVER directory on the DOS partition.



*  *  *  *  *  *  *  *  *  *  * ASPI Support  *  *  *  *  *  *  *  *  *  * 

NWPA ASPI support is provided via NetWare's NWTAPE driver. NetWare, or third 
party applications, may use this interface to communicate with a SAS/SATA device 
attached to an LSI Logic MPT-controller using NWTAPE.CDM.


******************** Installing Your NWPA NetWare Drivers ******************* 

Install NetWare as described in the Novell NetWare Installation Manual. The 
following information is provided to assist in the installation.

The LSI Logic MPT NWPA NetWare driver must be loaded once for each LSI Logic 
MPT-controller present in the system.


*  *  *  *  *  *  *  Preparing Your System for NWPA Drivers  *  *  *  *  *  * 

The LSI Logic NWPA driver, LSIMPTNW.HAM supports the following DOS
drivers:

     o  ASPIMPT.SYS  (Version 5.02 or greater)  
     o  SYMCD.SYS   
     o  SYMDISK.SYS  
 
The MPT BIOS version 6.04 is the minimum MPT BIOS required for NetWare when
not used with ASPIMPT.SYS. 


To Check the Status of DOS drivers: 

1. Edit the CONFIG.SYS file. 

2. If any of the following lines appear, you may remove or delete them.
   LSI Logic recommends using the REM command to comment them out in case these
   lines are needed later.
    
     DEVICE=<path>\CDROM.SYS /d:<name>    
     DEVICE=<path>\SYMDISK.SYS
     DEVICE=<path>\HIMEM.SYS
     DEVICE=<path>\EMM386.SYS    

3. If SCSI CD-ROM support is required, then add the following: 
   
     DEVICE=<path>\ASPIMPT.SYS    
     DEVICE=<path>\SYMCD.SYS /d:<name>   

4.  Add the following line to the AUTOEXEC.BAT file:
     
     DEVICE=<path>\mscdex /d:<name> 

*  *  *  *  *  * NetWare 5.1 and 6.5 Installations  *  *  *  *  *  *

1. Begin the file server installation according to the instructions in the 
   file server installation chapter in the Novell NetWare Installation 
   Manual.

2. When the NetWare installation procedure prompts you for a Disk Driver, 
   insert the LSI Logic device driver diskette into drive A: or B:. Then 
   use the INS key to select an unlisted driver. A dialog box appears. If  
   the driver diskette is in the A: drive, press Enter to continue. If 
   the driver diskette is in the B: drive, press F3 (to specify the 
   path to search for the driver), and enter the drive letter: 

     B:
    
   and press Enter.

   The LSIMPTNW.HAM driver will appear as a selection.
   
   Note: If the INS key option does not appear during the installation, choose
         Server Drivers to go to the Summary page. Highlight Disk and CD-ROM 
         Drivers (e.g., IDEATA). Press Enter and load an additional driver. 
         Then press the INS key. The system defaults to the A: path. Highlight 
         the LSI Logic NWPA driver and press Enter. Select Yes to save and move 
         the driver into the operating system. Press Enter to copy the files. 
  
3. Next the system prompts the user with the available command line options to
   load the driver. A description of each option appears in the box at the
   bottom of the installation screen. A more detailed description is given in 
   the section titled Command Line Options. Modify any option values as needed.

4. Load a separate instance of the driver for every LSI Logic controller SCSI 
   channel or host adapter present in the system.

5. When prompted for a slot number, accept the slot numbers displayed. Make 
   sure to write these slot numbers down for later use.

6. When asked to edit the STARTUP.NCF file, make sure the LSIMPTNW.HAM  
   is loaded once per LSI Logic controller SCSI channel. Add the statement 
   SLOT=<slot number> to each load line in the STARTUP.NCF, specifying the slot 
   numbers written down in step 5 above, with only one slot number per load 
   instance. The HAM driver(s) are loaded for each LSI Logic controller SCSI 
   channel from the first LOAD statement to the last LOAD statement.




*  *  *  *  *  *  *  *  * Reconfiguring Driver Options  *  *  *  *  *  *  *   

To reconfigure driver options, you must follow these steps: 

1. To unload all instances of the driver, type: 

     unload LSIMPTNW.HAM


2. To reload each instance of the driver with the desired option settings, type: 

     load LSIMPTNW.HAM slot=<slot number> <options>

3. If the changes made to the load options of one or more load instance are 
   permanent, and the driver is loaded automatically at server boot time, you 
   must specify these options in the STARTUP.NCF or AUTOEXEC.NCF file. 


*************************** Command Line Options **************************** 

The LSIMPTNW.HAM driver has many tuning parameters. A list of the tuning 
options is available below that include the default option along with a list
of valid options. Each option has a description of when to use it, the syntax 
used, and any impact its use may have on the system.

If an option is specified but the assignment is not valid, then the default 
value is used.

The options described below are used by placing the specified characters on 
the load command line for the NWPA driver. For example, the load command line 
to specify the Width SCSI Option: 

     load LSIMPTNW.HAM width=narrow


Note: No spaces are allowed in a single command line option, but spaces 
      are required between different command line options. 


*  *  *  *  *  *  *  *  *  * Information Option *  *  *  *  *  *  *  *  * 

*   *   * Using the Help Mode Option *   *   * 

     Command line option: ? or h

     Function: Display the options available in the driver.

     Possible Impact: The driver will not load with ? or h specified.

     This option is specified on the command line for a brief description of 
     each of the options available in the driver, as well as valid values for 
     each option. If the ? or h option is specified along with other 
     options, the help screen is invoked, the other options are ignored, and 
     the driver is not loaded. 


*  *  *  *  *  *  NetWare NWPA Driver Customizable Options  *  *  *  *  *  * 

Each command may be preceeded by a "/" or "-" for backwards compatibility at
the discretion of the user.

The line options with multiple names are simply aliases for the same command.

The command line is case insensitive, so you can mix upper and lower case.


*   *   * Using the Elevator Threshold Option *   *   *

     Syntax: elev=<option>[targetIDlist]
             elevator=<option>[targetIDlist]

     Default value: 32

     Valid options: 0-250 (0=disable)

     Function: Specify the maximum number of I/Os the HAM queues before 
     allowing NWPA to filter and organize requests.

     NWPA uses elevator queues to determine how many I/Os are queued to the 
     HAM before organizing requests and generating scatter gather lists. 
     If this number is set too low, then adapter I/O starvation can result. 
     If the number is too high, then sorting of I/Os and/or generation of 
     scatter gather lists might not occur. Varying the elevator threshold 
     value affects performance.


*   *   * Using the Handles Option *   *   *

     Syntax: handles=<option>[targetIDlist] or
             handle =<option>[targetIDlist] or
             hdl=<option>[targetIDlist]

     Default value: 144 handles

     Valid options: Number of handles

     Function: Defines the maximum number of bus/device/target handles

     For larger configurations, increase this value to the total number
     of bus/target/device(s) in a system.


*   *   * Using the Minimum Timeout Option *   *   *

     Syntax: mintimeout=<option>[targetIDlist] or
             mint=<option>[targetIDlist] 
                        
     Default value: 0 (a value of zero disables this feature)

     Valid options: 0-1200

     Function: Specifies the minimum device timeout in seconds.

     This option uses a timeout mechanism to support particularly slow
     devices. When a driver issues a command to a SCSI device, a timer
     is started. If the timer expires before the command completes, the
     driver assumes something has gone wrong and takes steps to recover.
     The minimum setting is 0, which is no timeout. 



*   *   * Using the Tagged Queuing Option *   *   * 

     Syntax: qtags=<option>[targetIDlist]
             qtag=<option>[targetIDlist]
             tag=<option>[targetIDlist]

     Default value: on

     Valid options: on, off

     Function: Enable/disable use of simple/ordered tagged command queueing.

     Enabling the qtags option causes the driver to issue tagged I/O requests 
     to the devices that support tagged queuing. Devices that do not support 
     tagged queuing are not issued tagged requests. Depending on the drive 
     controller, use of queue tags increases throughput of the device.
     However, the optimal number of queue tags is based on the specific 
     device type.  Tagged queuing may result in improved I/O throughput in  
     devices that support such an option.

*   *   * Using the Scan Option *   *   *

     Syntax: scan=<option>[targetIDlist][lunIDlist]    
                          
     Default value: list

     Valid options: on, off, list, or order

     Function: Specifies the Logical Unit Uumbers (LUNs) to scan.
               
     This option allows you to change the default for scanning LUNs per
     target ID on the SCSI bus.


*   *   * Using the Slot Option *   *   *

    Syntax: slot=<option>[targetIDlist]

    Default value: None

    Valid options: 0-10099

    Function: Specify the slot instance number of the LSI Logic  
    controller to which the load instance applies.

    The slot option specifies the LSI Logic controller SCSI channel (embedded
    chip or host adapter) that pertains to the current load. This information
    is required to load the driver. If this information is not specified on the 
    load line, the driver will prompt for the slot number. 


*   *   * Using the Verbose Option *   *   *

     Syntax: verbose=<option>[targetIDlist]

     Default value: off

     Valid options: on, off

     Function: Displays more detailed information on options and DOS
               configuration.

     This option is useful when multiple adapters are present in the system,
     and the PCI Device ID, the PCI Bus number, and the PCI Device/Function
     number for each adapter needs to be known. 




           
