***************************************************************************** NWPA.TXT ***************************************************************************** INSTALLATION GUIDE FOR THE SDMS DRIVERS: LSI8XXNW.HAM V5.03.00 LSIHINW.HAM V5.03.00 LSI_U3NW.HAM V5.03.00 This file describes the features and use of the LSI Logic SDMS NWPA device drivers for the Novell NetWare v4.11 and v5.xx operating system environments. It is divided into the following sections: Introduction Features LSI Logic Devices Supported Description ASPI Support Installing Your NWPA NetWare Drivers Preparing Your System for NWPA Drivers For NetWare 5.XX New Installations For NetWare 4.XX New Installations For NetWare 4.XX SFT-III Installations Reconfiguring Driver Options Command Line Options Information Options Using the Help Mode Option NetWare NWPA Driver Customizable Options Using the Autosense Option Using the Domain Validation Option Using the Elevator Threshold Option Using the Handles Option Using the Host SCSI ID Option Using the LUN Option Using the Minimum Timeout Option Using the Negotiation Option Using the No Negotiation Option Using the Parity Option Using the Read Capacity Option Using the Scan Option Using the Slot Option Using the Spin Up Option Using the Synchronous Option Using the Tagged Queuing Option Using the Test Unit Ready Option Using the Verbose Option Using the Width Option Important Additional Information For Information Pertaining to a Specific Driver DOS Access Dependencies Supported DOS Configurations When Using the SDMS 4.XX BIOS When Using ASPI8XX.SYS Supported DOS Drivers ASPI8XX,SYS SYMCD.SYS MSCDEX.EXE SYMDISK.SYS When Using No SDMS BIOS *************************** SDMS NWPA Drivers *************************** The SDMS NWPA drivers for the Novell NetWare operating system allow you to utilize various LSI Logic SCSI controllers or processors. The SDMS SCSI BIOS (version 4.19) controls these controllers or processors with NetWare. The NWPA drivers along with the designated LSI Logic SCSI controllers or processors and an appropriate Custom Device Module (CDM) provide a SCSI solution within the NetWare environment. LSI Logic provides a single driver for the Novell NetWare versions 4.XX and 5.XX environments, which is dependent upon the chip set. This document explains how to install and use the LSI Logic NWPA SCSI Host Adapter Module (HAM) drivers 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 HAM drivers support these features: o Ultra160 Data Transfers (for LSI53C1010 and LSI53C1000) o Domain Validation (for LSI_U3NW.HAM driver only) o Synchronous negotiation (including Fast SCSI/Ultra SCSI/Ultra2 SCSI) o Multiple host adapters o Multiple Logical Unit Numbers (LUNs) o Large LUN support (larger than 7.844 Gbytes) o Disconnect/Reselect o Tagged command queuing o Simple and ordered queue tags o Scatter/Gather o Shared interrupts o Wide SCSI including single-ended and differential o NetWare 4.11 SFT-III o SDMS 4.19 or greater BIOS without ASPI8XX.SYS o SDMS 4.19 or older BIOS with ASPI8XX.SYS o SDMS 4.XX DOS drivers o Handles target initiated negotiation (wide and synchronous) o SCSI Magneto Optical devices by using NetWare's SCSI MO.CDM In conjunction with Novell software: o Supports the ASPI interface by using NetWare's NWASPI.NLM o Support for SCSI CD-ROM devices by using NetWare's SCSICD.CDM o Support for tape devices by using NetWare's NWTAPE.CDM for versions 4.XX and 5.XX In addition to the Release Definitions, the following restrictions apply: o Symmetric Multiprocessing (SMP) under NetWare 4.11 requires the following files: SCSIHD.DDI, SCSIHD.COM, and NWPA.NLM 2.32f. o The SCSIHD.COM and SCSIHD.DDI files should be dated 5MAR1998 and version 1.34 or newer for all environments. o NWPA.NLM must be dated 9FEB1998 and version 2.32f or newer in SMP environments. 1. To upgrade to SMP after NetWare version 4.XX 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. Down the server, and reboot the system. Note: Other third party CDMs may also support these devices. * * * * * * * * * * LSI Logic Devices Supported * * * * * * * * * All LSI Logic devices and host adapters have undergone a name change. They have transitioned from a SYM prefix to an LSI prefix. This name change also affects the drivers for NetWare. The LSI8XXNW.HAM supports the following devices and their associated LSI Logic host adapters: o LSI53C810, LSI53C810A, LSI53C810AE (LSI8100S, LSI8100ASP, LSI20810) o LSI53C815 (LSI815XS, LSI8150SP) o LSI53C825, LSI53C825A (LSI8250S, LSI8251S, LSI8251D, LSI8250ASP, LSI8251ASP, LSI8251AD) o LSI53C860, LSI53C860AE (LSI8600SP, LSI20860) o LSI53C875, LSI53C875E (LSI8750SP, LSI8751SP, LSI8751SPE, LSI8751D) o LSI53C876 (LSI22801, LSI22802) o LSI53C885 o LSI53C895 (LSI8951U, LSI8952U) The LSIHINW.HAM supports the following device and associated LSI Logic host adapters: o LSI53C895A (LSI8953U) o LSI53C896 (LSI22910, LSI21002, LSI22902) The LSI_U3NW.HAM supports the following device and associated LSI Logic host adapters: o LSI53C1000 (LSI20160, LSI20160L) o LSI53C1010 (LSI22915A, LSI21040, LSI22903, LSI20903, LSI21003) * * * * * * * * * * * Description * * * * * * * * * * The SDMS NWPA solution consists of the device drivers, LSI8XXNW.HAM, LSIHINW.HAM, LSI_U3NW.HAM and the NetWare NWPA installation files LSI8XXNW.DDI, LSIHINW.DDI, LSI_U3NW.DDI. LSI8XXNW.HAM, LSIHINW.HAM, and LSI_U3NW.HAM are NWPA Host Adapter Modules (HAMs). 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 by using NetWare's NWASPI driver. NetWare, or third party applications, may use this interface to communicate with a SCSI device attached to an LSI Logic controller, including SCSI-2 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 SDMS NWPA NetWare driver must be loaded once for each LSI Logic controller SCSI channel present in the system. * * * * * * * Preparing Your System for NWPA Drivers * * * * * * The SDMS NWPA drivers, LSI8XXNW.HAM, LSIHINW.HAM, and LSI_U3NW.HAM support the following DOS drivers: o ASPI8XX.SYS (Version 4.11 or greater) o SYMCD.SYS o SYMDISK.SYS These drivers do not support the older SDMS 3.XX DOS drivers (DOSCAM.SYS, MINICAM.SYS, CDROM.SYS, and SCSIDISK.SYS). The BIOS version 4.19 is the minimum SDMS BIOS required for NetWare without ASPI8XX.SYS (version 4.11 or greater). Please see the section titled "When using the 4.XX BIOS" regarding 8XX_32.ROM with SCAM enabled before upgrading the BIOS. To Upgrade the BIOS (boot ROM) from 3.XX,4.XX to 4.19: 1. Load the FLASH8X5.EXE program. 2. Select the appropriate BIOS file (that is, 8XX_64.ROM). You must use BIOS version 4.19 if not using the ASPI8XX.SYS driver. 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 these lines. LSI Logic recommends using the REM command to comment them out in case these lines are needed later. DEVICE=\DOSCAM.SYS DEVICE=\MINICAM.SYS DEVICE=\CDROM.SYS /d: DEVICE=\SCSIDISK.SYS DEVICE=\HIMEM.SYS DEVICE=\EMM386.SYS 3. If CD-ROM support is required, then add the following: DEVICE=\ASPI8XX.SYS DEVICE=\SYMCD.SYS /d: 4. Add the following line to the AUTOEXEC.BAT file: DEVICE=\mscdex /d: Note: The /d: is not a drive letter designation; it indicates the name you wish assigned to your CD-ROM. You must include the NAME, which can use any combination of up to 8 characters. * * * * * * * * * NetWare 5.xx 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. Insert the SDMS device drivers diskette into drive A: or B: when the NetWare installation procedure prompts you for a driver disk, 3. Press the INS key twice 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 LSI8XXNW.HAM, LSIHINW.HAM, or the LSI_U3NW.HAM driver will appear as a selection. The system prompts you with limited available command line options for loading the driver. A description of each option appears in the box at the bottom of the installation screen. Refer to the Command Line Options section for more information. Modify any option values as needed for this installation. 4. Follow the prompts to complete this installation. The HAM driver(s) are loaded for each LSI Logic controller SCSI channel from the first LOAD statement to the last LOAD statement. * * * * * * * * * NetWare 4.xx 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. Insert the SDMS device drivers diskette into drive A: or B: when the NetWare installation procedure prompts you for a driver disk, 3. Press the INS key twice 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 LSI8XXNW.HAM, LSIHINW.HAM, or the LSI_U3NW.HAM driver will appear as a selection. The system prompts the user with limited available command line options for loading the driver. A description of each option appears in the box at the bottom of the installation screen. Refer to the Command Line Options section for more information. Modify any option values as needed for this installation. 4. Load a separate instance of the driver for every LSI Logic controller SCSI channel or host adapter present in the system. 5. Accept the slot numbers displayed when prompted for a slot number. Make sure to write these slot numbers down for future reference. 6. a. When asked to edit the STARTUP.NCF file, make sure the LSI8XXNW.HAM (or LSIHINW.HAM or LSI_U3NW.HAM) is loaded once per LSI Logic controller SCSI channel present in the system. b. Add the statement SLOT= to each load line in the STARTUP.NCF, by specifying the slot numbers written down in step 6 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. * * * * * * * * NetWare 4.xx SFT-III Installations * * * * * * 1. Install your primary server following procedures for the native 4.11 installation. 2. Begin the SFT-III installation as instructed by NetWare installation procedures. 3. While installing the secondary server, you have the option of copying the LSI8XXNW.HAM driver from the primary server. Press F10 to accept. * * * * * * * * * Reconfiguring Driver Options * * * * * * * To reconfigure driver options, follow these steps: 1. To unload all instances of the driver, type: unload LSI8XXNW.HAM -or- unload LSIHINW.HAM -or- unload LSI_U3NW.HAM 2. To reload each instance of the driver with the desired option settings, type: load LSI8XXNW.HAM slot= -or- load LSIHINW.HAM slot= -or- load LSI_U3NW.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 LSI8XXNW.HAM, LSIHINW.HAM, and LSI_U3NW.HAM drivers have many tuning options. A list of 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. Use the options described below by placing the specified characters on the load command line for the NWPA driver. For example, if the Wide SCSI Option on the command line is desired, the load command line should look like this: load LSI8XXNW.HAM wide=off -or- load LSIHINW.HAM wide=off -or- load LSI_U3NW.HAM wide=off Note: No spaces are allowed within a specific command line option, but spaces are required between different command line options. * * * * * * * * * * * Information Option * * * * * * * * * The information option described below is: Using the Help Mode Option. * * * Using the Help Mode Option * * * Syntax: ? 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. For example, to specify a SCSI bus host identification value, you could use one of these three aliases: HostScsiId HostId Hid In this case, "hostscsiid", "hostid", and "hid" all specify the same option for the selection of the host adapter id. The alpha-case does not matter, so you can intermix upper and lower case in any way. * * * Using the Autosense Option * * * Syntax: autosense=