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



=-=-=-=-=-=-=-=-=
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  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, Y,
or 1 without distinction, or can be disabled with OFF, N, 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),    OFF
                    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

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


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.



