=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Adaptec 7800 Family Manager Set v2.0 for NetWare =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Welcome to Adaptec 7800 Family Manager Set v2.0 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= The following information is available in this README file: o Supported Hardware o Changes From Prior Release o Installation Instructions 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: Adaptec Host Adapter Description -------------------- ----------- AHA-2910 PCI-to-Fast SCSI (non-bootable) AHA-2930 PCI-to-Fast 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-2940UW PCI-to-Ultra Wide Single-ended SCSI 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 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 v2.0 features numerous enhancements including: o Support for new PCI IC's and Adaptec host adapters o Better performance than Adaptec 7800 Family Manager Set v1.30 o Support for Netware v4.11 =-=-=-=-=-=-=-=-=-=-=-=-=-= Installation Instructions =-=-=-=-=-=-=-=-=-=-=-=-=-= This section explains how to install the Adaptec 7800 Family Manager Set v2.0 Driver (aic7870.dsk) 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 Driver When Installing NetWare --------------------------------------------- To install the aic7870.dsk at the same time you install NetWare, follow the instructions below for the version of NetWare you are installing. NetWare v3.1x ------------- 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 v2.0 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. NetWare v4.0 or v4.1x --------------------- 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 INSERT. 3 Insert the Adaptec 7800 Family Manager Set v2.0 diskette for NetWare into your disk drive. 4 Press F3 and specify the path to the aic7870.dsk driver for NetWare (e.g., a:\netware\v4_xx on the diskette). 5 Select AIC7870.DSK and press ENTER. 6 Specify the server's startup directory (usually c:\server.40 for NetWare v4.0 or c:\nwserver for NetWare v4.1x) and press ENTER. 7 Select Continue the 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 you host adapter. See Installing the Driver When NetWare is Already Installed and Loading the Driver at Server Bootup, below.) Installing the Driver When NetWare is Already Installed ------------------------------------------------------- To update or install the aic7870.dsk driver when NetWare 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 v2.0 diskette for NetWare into the server's startup directory (e.g., c:\nwserver, c:\server.40, c:\server.312) on your hard disk. This overwrites any existing version of the driver in the directory. (NOTE: For NetWare v3.1x, the aic7870.dsk file is located in the \netware\v3_1x directory on the diskette; for NetWare v4.0 and v4.1x, the file is in \netware\v4_xx.) 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 Loading the Driver at Server Bootup and Command Line Options sections, below.) The correct syntax to load the 7800 Family 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 you hard disk, the aic7870.dsk driver and aspitran.dsk module must be copied from the Adaptec 7800 Family Manager Set v2.0 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 aic7870.dsk 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=yes 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. =-=-=-=-=-=-=-=-= Additional Notes =-=-=-=-=-=-=-=-= o The Netware driver has been submitted for Novell Certification. o All of Adaptec's NetWare 386 drivers have full support for standard SCSI disk drives, "NetWare Ready" drives, and removable media disk drives (including optical drives). o The 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: :load aic7870 max_tags=2 :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 turns off tagged-queuing for all devices. This may be necessary for starvation-prone drives. o ASPICD.DSK is no longer needed for CD-ROM support. If ASPICD.DSK is still used, the driver requires the command line option cdrom=OFF. o The Adaptec 7800 Family Manager Set v2.0 NetWare driver supports a new command line option, slot=0. This option, enabled by default, will load the driver for all available slots. =-=-=-=-=-=-=-=-=-=-= Command Line Options =-=-=-=-=-=-=-=-=-=-= (NOTE: Possible values for command line options can be enabled with ON, YES, or 1 without distinction, or can be disabled with OFF, NO, or 0.) The following table shows driver command line options: 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 YES Standard, unless method for a new drive (Extended), set to extended in the system; extended NO (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 io_combine= Maximum number of IO's 1 - 32 16 that will be combined into one using scatter/gather lun_enable= LUN scan enable mask Hexadecimal 1 (Scan LUN on all targets 0 - FF 0 only) max_tags= Maximum number of 1 - 128 16 tagged I/O's which will be active per device multlun_targets= Bitmask that enables Hexadecimal FFFF (LUNs LUNS on selected 0 - FFFF on all targets) targets prompt= Prompt all available YES, NO NO 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 YES, NO NO settings slot= Obtains a physical slot Dependent on If none number for the host system specified, adapter configuration 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: 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 =-=-=-=-=-=-=-=-=-= Contacting Adaptec =-=-=-=-=-=-=-=-=-= Electronic Support ------------------ Technical information, including product literature, answers to commonly asked questions, information on software upgrades and other topics is available electronically through the following: o Adaptec World Wide Web (WWW) site at http://www.adaptec.com. o File Transfer Protocol (FTP) server at ftp.adaptec.com. o CompuServe Adaptec Forum at GO ADAPTEC. o Adaptec USA Bulletin Board Service (BBS) at 408-945-7727; supports up to 28,800 bps (bits per second), 8 data bits, 1 stop bit, no parity. No product literature is available on the Adaptec BBS. o Interactive Fax System at 408-957-7150; available 23 hours a day, 7 days a week. The fax system is out of service 1 hour each day. Technical and Product Support ----------------------------- o For technical support and information about many of Adaptec’s electronic support services, call 800-959-SCSI (7274) or 408-945-2550, 24 hours a day, 7 days a week. o To use the Adaptec Interactive Support System, call 800-959-SCSI (7274) or 408-945-2550, 24 hours a day, 7 days a week. The system prompts you with questions regarding your problem and then provides step-by-step troubleshooting instructions. o To speak with a product support representative, call 408-934-SCSI (7274), M-F, 6:00 a.m. to 5:00 p.m., Pacific Time. After hours, on weekends, and on holidays, product support is also available for a fee at 800-416-8066. Sales and Ordering Information ------------------------------ o For sales information, call 800-442-SCSI (7274), M-F, 6:00 a.m. to 5:00 p.m., Pacific Time, or 408-945-8600 and ask for Inside Sales, M-F, 8:00 a.m. to 5:00 p.m., Pacific Time. o To order Adaptec software and SCSI cables, call 800-442-SCSI (7274), M-F, 6:00 a.m. to 5:00 p.m., Pacific Time. o To request additional documentation for Adaptec products, call 800-934-2766 or 510-732-3829, M-F, 6:00 a.m. to 5:00 p.m., Pacific Time.