=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Adaptec 7800 Family Manager Set v3.01 for NetWare =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- Welcome to Adaptec 7800 Family Manager Set v3.01 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=- The following information is available in this README file: o Supported Hardware o Changes From Prior Release o Installation Instructions Installing the DSK Driver When Installing NetWare v3.12 for the First Time Installing the Driver in an Existing NetWare v4.xx Installation Loading the Driver at Server Bootup o Known Issues o Additional Notes o Command Line Options o Diskette Contents o Contacting Adaptec =-=-=-=-=-=-=-=-=-= Supported Hardware =-=-=-=-=-=-=-=-=-= The following Adaptec SCSI Host Adapters are supported by the 7800 FMS v3.01. The list (Fast/Ultra Adapters) is supported by the AIC7870.DSK driver. Fast/Ultra Adapters Description ------------------- ----------- AHA-2910C PCI-to-Fast SCSI (non-bootable) AHA-2915C PCI-to-Fast SCSI (non-bootable) AHA-2920C PCI-to-Fast SCSI AHA-2930C PCI-to-Ultra Single-ended SCSI AHA-2940 PCI-to-Fast SCSI AHA-2940W PCI-to-Fast and Wide Single-ended SCSI AHA-2940AU PCI-to-Ultra Single-ended SCSI AHA-2940U PCI-to-Ultra Single-ended SCSI AHA-2940U Dual DualChannel PCI-to-Ultra Internal Single-ended SCSI with 50-pin external connector AHA-2940UW PCI-to-Ultra Wide Single-ended SCSI AHA-2940UW Dual DualChannel PCI-to-Ultra Wide Single-ended SCSI with Wide external connector AHA-2944W PCI-to-Fast and Wide Differential SCSI AHA-2944UW PCI-to-Ultra Wide Differential SCSI AHA-3940 MultiChannel PCI-to-Fast SCSI AHA-3940W MultiChannel PCI-to-Fast and Wide SCSI AHA-3940U MultiChannel PCI-to-Ultra SCSI AHA-3940UW MultiChannel PCI-to-Ultra Wide SCSI AHA-3940UWD MultiChannel PCI-to-Ultra Wide SCSI with dual external connectors AHA-3944UWD MultiChannel PCI-to-Ultra Wide Differential SCSI with dual external connectors AHA-3940AU MultiChannel PCI-to-Ultra SCSI AHA-3940AUW MultiChannel PCI-to-Ultra Wide SCSI AHA-3940AUWD MultiChannel PCI-to-Ultra Wide SCSI with dual external connectors AHA-3944AUWD MultiChannel PCI-to-Ultra Wide Differential SCSI with dual external connectors AHA-4944W Quad Channel PCI-to-Fast and Wide Differential SCSI AHA-4944UW Quad Channel PCI-to-Ultra Wide Differential SCSI AIC-7850 Single-chip PCI-to-Fast SCSI AIC-7855 Single-chip PCI-to-Fast SCSI AIC-7856 Single-chip PCI-to-Fast SCSI AIC-7860 Single-chip PCI-to-Ultra SCSI AIC-7870 Single-chip PCI-to-Fast and Wide SCSI AIC-7880 Single-chip PCI-to-Ultra Wide SCSI AIC-7895 Single-chip PCI-to-MultiChannel Ultra Wide SCSI =-=-=-=-=-=-=-=-=-=-=-=-=-= Changes From Prior Release =-=-=-=-=-=-=-=-=-=-=-=-=-= Adaptec 7800 Family Manager Set v3.01 features enhancements from the previous v3.00 version. These features include: o Support for a wider variety of Adaptec host adapters o Support for NetWare NWPA =-=-=-=-=-=-=-=-=-=-=-=-=-= Installation Instructions =-=-=-=-=-=-=-=-=-=-=-=-=-= This section explains how to install the Adaptec 7800 Family Manager Set v3.01 Driver AIC7870.DSK (UltraSCSI) for Novell NetWare - NetWare v3.1x, v4.0, and v4.1x. If you are performing a first time NetWare installation, see Installing the Driver When Installing NetWare. If NetWare is already installed in your system, see Installing the Driver When NetWare is Already Installed, below. Installing the DSK Driver When Installing NetWare v3.12 for the First Time -------------------------------------------------------------------------- Follow these instructions only if you are installing NetWare v3.1x for the first time: 1. Follow the procedures in your NetWare documentation for installing a new server. 2. When you see the NetWare colon prompt (:), use the load command to install the driver from the Adaptec 7800 Family Manager Set v3.01 diskette for NetWare. The correct syntax to load the 7800 Family driver is :load [pathname]aic7870 [options] The command line options are not case sensitive. Placing commas between command line options is optional. See Command Line Options below for possible values. (NOTE: The ASPITRAN.DSK file must reside in the same path as AIC7870.DSK, because NetWare attempts to load the file automatically.) (NOTE: To load the driver automatically at server bootup, copy the driver to the server's startup directory and modify the STARTUP.NCF file. See Installing the Driver When NetWare is Already Installed and Loading the Driver at Server Bootup, below) 3. Load the NetWare install program from the NetWare colon prompt (:load install). Follow the instructions in the NetWare documentation to complete the installation (e.g., creating disk partitions, system volumes, etc.) of your server. Installing the DSK Driver When Installing NetWare v4.xx for the First Time -------------------------------------------------------------------------- Follow these instructions only if you are installing NetWare 4.0 or v4.1x for the first time: 1. Begin installation of NetWare v4.0 or v4.1x on your server as instructed in your NetWare documentation. 2. When a screen appears that asks you to select a disk driver, press F10. 3. When "Choose the Server Drivers - Summary" appears, press Enter. 4. Move highlight to "Disk and CD-ROM Drivers" and press Enter. 5. Deselect all "AIC7870" drivers that are picked up by Netware. 6. Highlight "Select an additional driver" and press Enter. 7. When a screen appears that asks you to select a disk driver, press Ins. 8. Insert the Adaptec 7800 Family Manager Set v3.01 diskette for NetWare into your floppy drive. 9. Press F3 and specify the path to the AIC7870.DSK driver for NetWare (e.g., a:\netware\v4_xx on the diskette). 10. Select AIC7870.DSK and press ENTER. 11. Select "Continue installation" to complete the installation. (NOTE: To load the driver automatically at server bootup, make sure the STARTUP.NCF file includes the load command line for your host adapter. See "Loading the Driver at Server Bootup", below.) Installing the Driver in an Existing NetWare v4.xx Installation --------------------------------------------------------------- To update or install the AIC7870.DSK driver when NetWare v4.xx is already installed, follow the instructions in this section. The procedures are similar for all versions of NetWare. Procedures that are specific to a NetWare version are noted when necessary. 1. Make a backup copy of the old driver (if it exists) before installing the new driver. 2. Copy the AIC7870.DSK driver from the 7800 Family Manager Set v3.01 diskette for NetWare into the server's startup directory (e.g. c:\nwserver, c:\server.40, etc.) on your hard disk. This overwrites any existing version of the driver in the directory. (NOTE: For NetWare v4.xx, the driver file is located in the \netware\v4_xx directory on the diskette.) 3. If necessary, modify the load command line in the STARTUP.NCF so that the proper path to the driver and all appropriate command line options are specified. See the "Loading the Driver at Server Bootup and Command Line Options sections, below.) The correct syntax to load the 7800 Family Manager driver is: load [pathname]aic7870 [options] Command line options are not case sensitive. Placing commas between command line options is optional. See "Command Line Options", below, for possible values. Loading the Driver at Server Bootup ----------------------------------- To automatically load the AIC7870.DSK at server bootup, the STARTUP.NCF file (usually located in your server's startup directory) must contain a load command line that specifies the location of the driver and any appropriate command line options (see Command Line Options, below). For additional information on the STARTUP.NCF file, refer to your NetWare documentation. (NOTE: To load the driver from your hard disk, the AIC7870.DSK driver and ASPITRAN.DSK module must be copied from the Adaptec 7800 Family Manager Set v3.01 diskette for NetWare to a directory on your hard disk [usually the server's startup directory (e.g., c:\nwserver)]). The correct syntax to load the driver is load [pathname]aic7870 [options] For example, the command line to load the driver from the c:\nwserver directory, with the "verbose=" option on is load c:\nwserver\aic7870 verbose=y Command line options are not case sensitive. Placing commas between command line options is optional. See Command Line Options, below, for possible values. To modify the STARTUP.NCF file, follow these steps: (NOTE: You can also use your DOS text editor to modify the STARTUP.NCF file.) 1 Type load install at the NetWare prompt and press ENTER. 2 Select the appropriate menu choice that allows you to edit the STARTUP.NCF file. 3 Make the necessary changes. When you are done, press ESC. =-=-=-=-=-=-= Known Issues =-=-=-=-=-=-= o There is a known problem which occurs during the installation of Netware 4.0X, that involves the DDI file used during the initialization of the host adapter device driver. The DDI file does not contain all the possible slot number options available on all PCI systems, as there are too many combinations. As a result, during the installation procedure, NetWare will report that it is unable to load the driver in the given amount of time. This is because the DDI file does not contain any slot options, which causes NetWare not to load the driver. Note, however, that this is not an error. The user simply needs to go to the console screen and manually enter in the correct slot number and installation will continue. o A second known problem exists that will hang the server after loading the host adapter device driver. This problem involves targets that do not support scanning of multiple luns, with the command line option lun_enable. The user simply needs to set the command line option multlun_targets to only scan targets that support multiple luns. This problem is known to occur with Quantum Empire 540S drives. o Novell recommends not using IRQ 15 for host adapters. If your system bios allows the assignment of IRQs, change your adapters IRQ to a value other than 15. o On NetWare 4.11, without media in the CD-ROM drive, and using built in driver support for CD-ROMs, the message "No CD-ROM Devices Registered with NetWare." is reported, if "cd device list" is issued. o There is a known problem with some hard drives that are less than or equal to 1 GB. If these drives were previously formatted using the Adaptec 7800 Family Manager Set v2.1x driver for Netware, and are now being upgraded to the 7800 Family Manager Set v3.01 driver, the user may have problems in finding the device during initialization. If this occurs, use the following command line option in your STARTUP.NCF file: ext_tran=n o On some system configurations and during a first time installation or when upgrading to the 7800 Family Manager Set v3.01 driver, the user may see a window with the following warning message: "One or more partitions on drive 0 are inconsistent with the driver geometries (xxx heads, xx sectors, and xxx cylinders) that NetWare is using. You may continue and edit the partition anyway, although this inconsistency could create problems later on." This message is shown when the "Installation Options" window appears, and the user highlights and selects "Disk Options", followed by "Modify Disk Partitions and Hot Fix". The user should simply continue to the "Disk Partitions Options" window to edit the partition, and installation will complete successfully. o On some SMP systems, if the IRQ setting is set to "Auto" in the system's BIOS then NW 4.11 installation will hang at loading a NIC driver. This problem was tested with a Tyan P5 SMP, and it did show up. The problem did not show up on the DEC SMP system. This is being addressed by Novell. (#12764) o Certain systems will not run Sbackup under NetWare v3.12. NetWare v4.11 runs it with no problems. This is a Novell issue which is currently being addressed. (#12199) =-=-=-=-=-=-=-=-= Additional Notes =-=-=-=-=-=-=-=-= o The Netware driver has been submitted for Novell Certification. o All of Adaptec's NetWare drivers have full support for standard SCSI disk drives, "NetWare Ready" drives, and removable media disk drives (including optical drives). o For NetWare patches and other latest information, reference the Novell website at http://developer.novell.com/cgi-bin/devnet o The AIC7870.DSK driver also contains a built-in ASPI manager. This allows for other NetWare Loadable Modules (NLMs) to gain access to the host adapter. Given the flexibility of ASPI, several companies are currently providing server-based tape backup solutions through ASPI. SBackup is a server based tape backup solution which is shipped by Novell with NetWare. SBackup supports the ASPI interface. There are other ASPI modules already developed or under development. A programming specification is available from Adaptec if you are interested in writing your own NetWare 386 ASPI module. o If your file server does a lot of IO operations and you want to try optimizing its performance, you can adjust the "max_tags=?" command line switch. This switch controls the maximum number of tagged commands outstanding at a given device. Refer to your disk-drive's documentation to determine if tagged-queuing is supported, and the maximum number of outstanding commands supported. Its default value is 16. The following are examples of how to change this feature: For all 7800 Manager Set host adapters: :load aic7870 max_tags=2 For UltraSCSI or earlier only host adapters: :load aic7870 tag_disable=ffff The first example shows how to use the max_tags command line option. The max_tags parameter can be set between 1 and 128. Larger values give the drives more opportunity for optimization, but take up more memory in the server. For several reasons, you may want to use a lower value of max_tags. For some drives, maximum performance is achieved with a max_tags less than the maximum supported by the drive. Also, some drives may not support the driver's maximum count of 128, or may suffer starvation problems with large counts, leading to drive deactivation. The second example applies only to the AIC7870.DSK driver. It turns off tagged-queuing for all devices. This may be necessary for starvation-prone drives. o The Adaptec 7800 Family Manager Set v3.01 NetWare driver no longer supports the slot=0 command line option. For the AIC7870.DSK driver, if no slot is mentioned on the command line, the driver is loaded for all host adapters present in the system. =-=-=-=-=-=-=-=-=-=-= Command Line Options =-=-=-=-=-=-=-=-=-=-= (NOTE: Possible values for command line options can be enabled with ON, Y, or 1 without distinction, or can be disabled with OFF, N, or 0.) The following table shows driver command line options: (NOTE: Those command line options indicated with an asterisk are specific only for the AIC7870.DSK driver.) OPTION DEFINITION POSSIBLE DEFAULT VALUES VALUES ----------------------------------------------------------------------------- auto_bus_fairness= Enable/disable auto SCSI OFF, ON ON bus fairness algorithm auto_disable_tagq= Enable/disable auto OFF, ON ON disable tag queuing algorithm auto_flush_diskreq= Enable/disable auto disk OFF, ON ON flush algorithm bus_release= Passed to HIM --- --- * cdrom= Indicate if CDROM OFF (ASPI), ON * devices are controlled by ON (Driver) driver or ASPI dev_enable= Bitmask which enables Hexadecimal FFFF (Scan scanning on selected 0-FFFF all targets) targets edge_or_level= Determines edge or level --- --- * triggered interrupt ext_tran= Determine translation Y Standard, unless * method for a new drive (Extended), set to extended in the system; extended N (Standard) by SCSI-Select or standard fixed_disk= Indicate if fixed disks OFF (ASPI), ON * are controlled by driver ON (Driver) or ASPI flush_diskreq= Send occasionally Hexadecimal 0 (Disabled for ordered tags to targets 0-FFFF all targets) instr= Enable/disable recording OFF (Disable), OFF * of I/O statistics and ON (Enable) errors int Required by Netware --- --- * interrupt_level Sets interrupt level. Used --- --- * if PCI config space is not setup correctly by BIOS io_combine= Maximum number of IO's 1 - 64 16 * that will be combined into (1-32 for one using scatter/gather AIC7870.DSK) lun_enable= LUN scan enable mask Hexadecimal 1 (Scan LUN on all targets 0 - FF 0 only) max_nontags= Maximum number of --- --- * non-tagged I/Os that will be active per device max_sectors= Maximum number of 1 - 256 256 * sectors that will be combined using scatter/gather. Max value is MaxRequestSize (128) x IOCombine(64) max_tags= Maximum number of 1 - 128 16 tagged I/O's which will be active per device mem Required by NetWare --- --- * multlun_targets= Bitmask that enables Hexadecimal FFFF (LUNs LUNS on selected 0 - FFFF on all targets) targets pcimech Selects hardware --- --- * mechanism to address PCI registers prompt= Prompt all available Y, N N * slots to load the driver on read_after_write= Enable write with 0 (OFF), 1 * verify for writes 1 (ON) removable= Indicate if removable OFF (ASPI), ON * media is controlled ON (Driver) by driver or ASPI start_unit= Target id mask to send Hexadecimal 0 (No start * start unit SCSI command 0 - FFFF unit cmd. to any target) tag_disable= Target tag queuing Hexadecimal 0 (Enabled for * disable mask 0 - FFFF all targets) verbose= Display host adapter Y, N N settings slot= Obtains a physical slot Dependent on If none number for the host system specified, adapter configuration driver loaded for all available slots (AIC78U2.HAM - NetWare prompts user to choose) Bit Mask Options ---------------- Use this example to aid in calculating bit mask options hex values. Each SCSI device ID 0-7 (or 0-15 for wide host adapters) is enabled by a 1 in its corresponding bit position. In this example, lun_enable=05 enables scanning for LUNs 0 and 2 on all targets. Bit Position |-------------------------------------------------------| SCSI ID | 15 14 13 12 | 11 10 09 08 | 07 06 05 04 | 03 02 01 00 | |-------------------------------------------------------| 0, 2 | 0 0 0 0 | 0 0 0 0 | 0 0 0 0 | 0 1 0 1 | |-------------------------------------------------------| Converted | | | | | binary to | | | | | hex: | 0 | 0 | 0 | 5 | = 05h |-------------------------------------------------------| =-=-=-=-=-=-=-=-= Diskette Contents =-=-=-=-=-=-=-=-= The following files are included in this diskette: o README.TXT - This file In the \netware\v3_1x Directory ------------------------------- o AIC7870.DSK - AIC-7870 Family of Host Adapters Driver For NetWare 386 v3.1x. o ASPITRAN.DSK - ASPI Transport Layer Manager Driver for NetWare v3.1x. o ASPICD.DSK - CD-ROM Driver for NetWare v3.1x. In the \netware\v4_xx Directory ------------------------------- o AIC7870.DSK - AIC-7870 Family of Host Adapters Driver For NetWare 386 v4.xx. o AIC7870.DDI - Driver definition information file for NetWare v4.xx only. o ASPITRAN.DSK - ASPI Transport Layer Manager Driver for NetWare v4.xx. o ASPITRAN.DDI - Driver definition information file for NetWare v4.xx only. o ASPICD.DSK - CD-ROM Driver for NetWare v4.xx. o ASPICD.DDI - Driver definition information file for NetWare v4.xx only. o NWPALOAD.NLM - File required by the NetWare Bus Interface o NWPA.NLM - File required by the NetWare Bus Interface o NBI.NLM - File required by the NetWare Bus Interface