***************************************************************************** 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 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.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 SCSI Fibre Channel protocol. 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 Features for Parallel SCSI devices only: 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 Wide SCSI (single-ended and differential) 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 LSISAS1068 (SAS chips) o LSI53C1020, LSI53C1030 (SCSI Chips) o LSIFC929X (Fibre Channel Chips) o LSI20320, LSI21320, LSI22320 (Host Adapters) o LSI7202 (Fibre Channel 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 tape devices, and SCSI changer 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 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=\CDROM.SYS /d: DEVICE=\SYMDISK.SYS DEVICE=\HIMEM.SYS DEVICE=\EMM386.SYS 3. If SCSI CD-ROM support is required, then add the following: DEVICE=\ASPIMPT.SYS DEVICE=\SYMCD.SYS /d: 4. Add the following line to the AUTOEXEC.BAT file: DEVICE=\mscdex /d: * * * * * * 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= 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= 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=