nwpa_mpt.txt Driver File Contents (LSINetware.exe)

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

INSTALLATION GUIDE FOR THE MPT DRIVER: LSIMPTNW.HAM V2.00.00 


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.0 operating system environments. It is 
divided into the following sections:

Introduction
     Features
     LSI Logic Device Supported
     Description
     ASPI Support

Installing Your NWPA NetWare Driver
     Preparing Your System for NWPA Drivers
     NetWare 5.1 and 6.0 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 SCSI MPT-controller or processors.  The MPT SCSI 
BIOS (version 5.02 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 SCSI 
solution within the NetWare environment.

A single driver is provided for the Novell NetWare versions 5.1 and
6.0 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 NWPA drivers can be downloaded from the LSI Logic 
      Web site at http://www.lsilogic.com. After you are connected to this 
      Web site, place your cursor on the Get Drivers option in the menu bar. 
      Click on the Drivers selection. Choose the Novell NetWare operating 
      system for SCSI from the list. Click on the Go button. Follow the
      instructions on subsequent screens to download the drivers.


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

The MPT HAM driver supports these features:

o  Performs Data Tranfers at up to Ultra320 SCSI speeds
o  Supports Domain Validation  
o  Suppports Synchronous negotiation (Fast/Ultra/Ultra2/Ultra160/Ultra320 SCSI)
o  Supports multiple host adapters 
o  Supports multiple logical unit numbers (LUNS)  
o  Offers Large LUN support (larger than 7.844 gigabytes) 
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 Wide SCSI (single-ended and differential) 
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 
o  Support for SCSI Magneto Optical devices via NetWare's SCSI MO.CDM

In conjunction with Novell software: 

o  Supports the ASPI interface via NetWare's NWASPI.NLM 
o  Support for SCSI CD-ROM devices via NetWare's SCSICD.CDM 
o  Support for tape devices by using NetWare's NWTAPE.CDM for
   NetWare versions 5.1 and 6.0.                                  

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


o  NWPA.NLM must be version 3.12 (or higher) for NetWare 6.0, 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  LSI53C1020, LSI53C1030 (SCSI Chips)
o  LSI20320, LSI21320, LSI22320 (Host Adapters)

*  *  *  *  *  *  *  *  *  *  * 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 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, SCSI CD-ROM devices, SCSI Magneto Optical devices, SCSI tape 
devices, and SCSI changer devices. In addition, third party vendors are 
developing CDMs to support their specific devices. 


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

NWPA ASPI support is provided via NetWare's NWASPI driver. NetWare, or third 
party applications, may use this interface to communicate with a SCSI device 
attached to an LSI Logic MPT-controller, including SCSI tape devices 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 SCSI channel 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 5.xx 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.0  New 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 enable the Wide SCSI Option is: 

     load LSIMPTNW.HAM wide=off


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 Synchronous SCSI Option *   *   *

     Syntax: synchronous=<option>[targetIDlist] or
             sync=<option>[targetIDlist] or
             sync=<option>[targetIDlist] or
             speed=<option>[targetIDlist]

     Default value: Maximum of the HBA
     
     Examples of rate specifier are:

     0 MBybtes or 10 MBybtes (mega bytes per second)
     20 MT or 40 MT (mega transfers per second) 

    Valid options:
                        0         = asynchronous
                        5         =   5   mt/sec
                        10        =  10   mt/sec
                        20        =  20   mt/sec
                        40        =  40   mt/sec
                        80        =  80   mt/sec
                        160       = 160   mt/sec
                        
                        OFF       = asynchronous
                        ASYNC     = asynchronous
                        MAX       = Adapter maximum rate
     
   
     Function: Set synchronous transfer rate for specified target(s).

     Possible Impact: Could cause a device to operate slower than
                      its maximum speed.

     This synchronous SCSI option allows you to enable/disable support of Fast, 
     Ultra, Ultra2, Ultra160 and Ultra320  SCSI synchronous data transfers 
     when using a Fast, Ultra, Ultra2, Ultra160, or Ultra320 SCSI controller. 
     Synchronous data transfers increase the I/O performance of a system. 

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



*   *   * Using the Width Option *   *   *

     Syntax: width=<option>[targetIDlist or
             wide=<option>[targetIDlist] or
             wid=<option>[targetIDlist]

     Default value: on

     Valid options: narrow =  8 bit data bus
                    wide   = 16 bit data bus
                    off    =  8 bit data bus
                    on     = 16 bit data bus
                    8      =  8 bit data bus
                    16     = 16 bit data bus
                    max    = Adapter maximum width

     Function: Set bus width negotiations for specified targets.

     This option allows you to disable support of wide SCSI when using a
     a wide SCSI controller. Set this option to "narrow", "off", or "8"
     to disable a wide SCSI device when an 8-bit SCSI cable is connected
     on the bus between the wide SCSI host adapter and the wide
     device. This type of connection prohibits the transfer of wide data.
     If this option is set to  "narrow", "off", or "8", the wide device still
     works, but all data transferred to or from the device is narrow (8 bit).
     The driver does not initiate a wide SCSI transfer request negotiation.
     Alternatively, to enable support of wide SCSI tranfers, set this 
     option to "wide", "on", or "16".


           
********************* Important Additional Information ********************** 


*  *  *  *  *  *  *  *  * Supported DOS Configurations *  *  *  *  *  *  *  * 

The following are the DOS configurations supported by the LSIMPTNW.HAM 
driver:

     MPT 5.XX or greater BIOS, without ASPIMPT.SYS   
     MPT 5.XX BIOS with ASPIMPT.SYS    
     No MPT BIOS, ASPIMPT.SYS*  

*In addition to ASPIMPT.SYS (version 5.XX or greater), SYMCD.SYS and/or 
 SYMDISK.SYS can be loaded for DOS CD-ROM and DOS Magneto Optical (MO) support,
 respectively. SYMCD.SYS and SYMDISK.SYS are NOT required for CD-ROM or MO 
 support under NetWare. 


*   *   * Supported DOS Drivers *   *   *

The MPT ASPIMPT.SYS (version 5.02 or greater> DOS driver supports the 
MPT 5.xx or later BIOS. SYMCD.SYS and SYMDISK.SYS provide support for CD-ROM 
and MO devices under DOS. Neither SYMCD.SYS nor SYMDISK.SYS are required for
NetWare support of CD-ROM and MO devices. For SCSI CD-ROM installation, 
ASPIMPT.SYS and SYMCD.SYS are required.

The MPT NWPA driver, LSIMPTNW.HAM supports the list of DOS drivers described 
below.

*    * ASPIMPT.SYS *    *

The ASPIMPT.SYS driver provides an ASPI layer interface for disk and non-disk
devices. If NetWare is being installed from a SCSI CD-ROM device on a LSI
Logic controller, SYMCD.SYS is required with ASPIMPT.SYS.

*    * SYMCD.SYS *    *

To install the NetWare operating system from CD-ROM, load the SYMCD.SYS driver
with ASPIMPT.SYS. Once the NetWare operating system installation has completed, 
SYMCD.SYS is not needed. The NetWare NWPA environment provides support for 
SCSI CD-ROMs through the NetWare driver interface. 

*    * MSCDEX.EXE *    *

The MSCDEX.EXE driver (provided with DOS) is required in conjunction with 
SYMCD.SYS to install NetWare from a CD-ROM. 

*    * SYMDISK.SYS *    *

The SYMDISK.SYS driver provides support for removable media and large sector
size devices under DOS. This driver is not required for NetWare support of 
these devices.

Note: The NetWare drivers can function independently of any DOS drivers, except
for the installation of NetWare from a SCSI CD-ROM.
        

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: web2, load: 1.17