***************************************************************************** 
                                 UNIXWARE.TXT  
***************************************************************************** 

Installation Guide for SDMS UnixWare 2.1.x Driver Version 4.08.00
                       and
                       SDMS UnixWare 7 Driver Version 4.21.00. 

This file describes the features and use of SDMS Device Drivers for the
   SCO UnixWare 2.1.x and UnixWare 7 operating system environments.  
   It is divided into the following sections:

Note: The 4.08.00 driver should be used with UnixWare 2.1.x.  Use the 4.21.00 
      driver for UnixWare 7.  If you need support for UnixWare 2.0.X, please 
      use the 3.02.00 driver.  For information on DMI 2.0 for UnixWare, refer 
      to the UWDMI2_0 text file.

Introduction
     Features
     Description
How to Install Your SDMS UnixWare Driver
     Installing the c8xx Driver During UnixWare Installation
     Updating UnixWare with the c8xx Driver
Troubleshooting
     


******************************* Introduction ******************************** 

UnixWare 2.1.x and UnixWare 7 extends the Unix SVR4.2 operating system. 
UnixWare features include a graphical user interface (GUI), networking, 
application compatibility, multi-tasking capability, and multi-user 
capability.  In addition UnixWare provides multiprocessor support.

The SDMS c8xx driver allows SCO UnixWare operating systems to interface with
SCSI devices connected to the Symbios SYM53C8XX family of chipsets and/or 
Symbios 8XX host adapter cards.

The following sections describe the procedures to install the driver during a 
first time installation of UnixWare, and to update a previously installed
UnixWare with the SDMS c8xx driver. 


*  *  *  *  *  *  *  *  *  *  *  * Features *  *  *  *  *  *  *  *  *  *  *

o  Allows easy installation using UnixWare tools. 
o  Provides wide and synchronous negotiation (including Fast SCSI, Ultra SCSI,  
   and Ultra2 SCSI) 
o  Supports multiple host adapters 
o  Supports disconnect/reselect 
o  Allows multiple and non-contiguous LUN support 
o  Supports scatter/gather 
o  Supports wide SCSI 
o  Supports SCSI pass-through functionality 
o  Supports tagged command queuing 
o  Provides multiprocessor support
o  Supports target-initiated negotiation
o  Supports NVRAM and NVS Configuration data areas 
o  Supports Termination Control via NVRAM and NVS settings


*  *  *  *  *  *  *  *  *  *  *  * Description *  *  *  *  *  *  *  *  *  *

The SDMS c8xx driver for SCO UnixWare operating systems is available on a
3.5 inch floppy diskette labeled PCI SCSI SCO UnixWare.  Use this diskette to
load the driver during the installation of the operating system, or to
access the devices on the SCSI bus after a UnixWare installation.  The 
following sections describe these procedures.

The installation media kit includes a host adapter diskette. This diskette 
also contains a bundled c8xx driver. If you have both a c8xx diskette 
directly from LSI Logic and the host adapter diskette from the media kit,
use the latest release of the c8xx driver by inserting its diskette first 
when the host adapter diskettes are requested during installation.


******************* Installing the SDMS UnixWare c8xx Driver **************** 


*  *  *  *  *  *  *  *  *  New System Installation *  *  *  *  *  *  *  *  *      


1. Boot the computer using the Install diskette(s) delivered with the UnixWare 
   Operating System media kit.  With UnixWare 2.1.x, there is one diskette.  
   UnixWare 7 has two diskettes.

2. Follow the instructions on the screen.

3. Insert the PCI SCSI SCO UnixWare driver diskette when prompted to insert a 
   Host Adapter diskette. 

   If you want to install other host adapter drivers, then insert the HBA 
   diskette provided with the UnixWare media kit when requested.
   
   If there are no other host adapter drivers to install, continue the 
   installation. 

4. The system loads the required drivers, such as c8xx, and indicates when 
   they are loaded.

5. At the end of the installation you will see a prompt to reinsert the HBA
   driver diskette.  Insert the PCI SCSI SCO UnixWare driver diskette and press 
   Enter.  The kernel will be built and the installation will terminate.

6. Remove the driver diskette when prompted to do so and reboot the system.


*  *  *  *  *  *  *  *  * Existing System Installation *  *  *  *  *  *  *  *


*   *   * Adding or Updating the c8xx Package *   *   *

Before you install the c8xx driver, make a backup copy of the existing 
kernel:

1. Log on as root.

2. At the shell prompt type:

   cp  /stand/unix  /stand/unix.safe

   Use this copy of the old kernel to reboot the system if the driver 
   installation fails.  Refer to the later section titled Troubleshooting for 
   more information if this is needed.

3. Once the old kernel is saved, insert the PCI SCSI SCO UnixWare driver 
   diskette.

4. Load the driver using the pkgadd command by typing:

        pkgadd -d diskette1

5. Select c8xx package.  The c8xx driver on this diskette is then loaded onto
   the system.

6. The system will again prompt you to load a driver even if loading was 
   successful.  Type q (quit) and press Enter.

7. Verify that the driver is now loaded successfully by typing:

        pkginfo c8xx 

8. The package information should look like this:

        system c8xx Symbios IHV HBA

9. After the c8xx package is loaded, a message indicating a system reboot
   is necessary may appear.  To reboot, type the following command:

              init 6    

During the boot process, the driver scans the SCSI bus and lists the devices 
found on it.  If the kernel panics during boot, then reboot the system with 
the saved copy of the old kernel.  Booting from the saved copy of the kernel 
is described in the following section titled Troubleshooting.  If the reboot 
is successful, the system is ready to use.


*  *  *  *  *  *  *  *  *  * Troubleshooting *  *  *  *  *  *  *  *  *  *

*   *   * Problem *   *   *

Driver Installation Fails.

*   *   * Solution *   *   *

You will need to utilize the unix.safe kernel file that was created 
   before installing the c8xx host adapter driver. 

a. Reboot the system.

b. Wait for the Operating System Logo to display, then press the 
   space bar to begin an interactive boot session.

c. When the interactive boot prompt appears:

   If the system is UnixWare 2.1.x, type:

     KERNEL=unix.safe

     go

   If the system is UnixWare 7, type:

     boot unix.safe

d. The operating system logo will reappear.  The system will then boot
   from the Unix kernel specified above.

