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



INSTALLATION GUIDE 
FOR THE SYMBIOS LOGIC SDMS UNIXWARE DRIVER V3.02


This file describes the features and use of the Symbios Logic SDMS 
Device Drivers for the Novell UnixWare 2.0x and the more
recent SCO UnixWare 2.xx operating system environments. 
It is divided into the following sections:

Introduction
	Features
	Description
How to Install Your SDMS UnixWare Driver
	Installing the Driver During UnixWare Installation
	Updating UnixWare 2.xx with the C8xx Driver
	Troubleshooting
**********************************************************

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

UnixWare 2.xx extends the UNIX SVR4.2 operating system,
allowing tight integration with NetWare 
in an easy to use graphical form. UnixWare features
include a graphical user interface, NetWare networking, 
application compatibility, multitasking capability, and 
multi-user capability. In addition UnixWare 2.xx provides 
multiprocessor support.

The storage device drivers for UnixWare are based on the 
Portable Device Interface (PDI) architecture. PDI logically 
breaks down a driver into a controller specific portion 
(C8xx host adapter driver) and a device specific portion 
(the target driver). The third component is SDI (the SCSI Device 
Interface), a kernel resident driver that interfaces with 
both the target driver and host adapters.

The Symbios Logic SDMS C8xx driver allows Novell UnixWare 
and SCO UnixWare operating systems to interface with SCSI 
devices connected to a Symbios Logic 53C8xx chipset and/or 
Symbios Logic 8xxxx host adapter cards. The driver can be 
statically linked (integrated) or dynamically linked (loadable) 
with the kernel. If the driver is integrated with the kernel, 
then the rebuilt kernel must reside on the boot drive. The 
following sections describe the procedures to install the 
driver during a first time installation of UnixWare, and to 
update already installed UnixWare with the Symbios Logic 
SDMS C8xx driver.


**** Features ****

Allows easy installation using PDI - ID tools.
Provides synchronous negotiation including Fast SCSI and Ultra SCSI (Fast-20)
Supports multiple host adapters
Supports Disconnect/Reselect
Allows multiple and non-contiguous LUN support
Supports dynamic interrupt mapping
Supports scatter/gather
Wide device support 
Supports SCSI pass-through functionality
Supports tagged command queuing
Supports request concatenation
Multiprocessor support


**** Description ****

The Symbios Logic SDMS C8xx driver for Novell UnixWare 
and SCO UnixWare operating systems is available on a 
3.5 inch floppy diskette labeled SDMS PCI UnixWare (2.x). 
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.

In addition, for SCO UnixWare 2.1 and later, the Host Adapter 
diskette contains the C8xx driver for use during initial
installation of SCO UnixWare. If you have both the c8xx driver 
directly from Symbios Logic and also the driver bundled with
the UnixWare Operating System, use the latest release of the c8xx
driver.



******** How to Install Your SDMS UnixWare Driver ********


*** Installing the Driver During UnixWare Installation ***

When performing UnixWare installation, if the computer is 
set up to boot from the SCSI bus through a Symbios Logic 53C8xx 
chipset, the driver is automatically linked statically 
with the kernel to suit the setup. You must follow the 
instructions in the UnixWare Installation Handbook before 
installing the driver.

1. Boot the computer using the Install diskette delivered 
   with the UnixWare Operating System distribution package. 

2. Follow the instructions on the screen.

3. Insert the SDMS PCI UnixWare driver diskette 
   when prompted to insert the Host Adapter diskette and 
   press Enter. 

   When the driver is loaded, a message "C8xx driver is 
   loaded" appears on the screen. 
   
   If you want to install other host adapter drivers, then insert 
   the IHV HBA diskette provided with the UnixWare 
   distribution package and press Enter.

4. Follow instructions on the screen or refer to the 
   UnixWare Installation Handbook to complete installation.

   NOTE: During the installation, if the driver does not 
   find a hard disk on which to install the operating 
   system, it aborts the process.

5. At the end of the installation you might see a prompt to 
   reinsert the driver diskette. Insert the SDMS PCI 
   UnixWare driver diskette and press Enter.
 
   The kernel is rebuilt and the system gets ready to boot 
   from the SCSI disk drive.

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


*** Updating UnixWare 2.xx with the C8xx Driver ***

You may install the C8xx driver on a system currently 
running UnixWare by using one of three different procedures. 
The method to use depends on the setup of your system and on
whether you want the system to remain running during this
process. By reviewing the following questions, you can 
determine which procedure to follow.

Q: Is your Boot disk a SCSI hard disk on the SCSI bus 
   connected to a Symbios Logic 53C8xx chipset?

If the answer is yes, then you MUST statically
link the kernel and reboot the system. Follow the 
instructions in sections:

	Loading the Package.

	Configure for Statically Linked driver

	Rebuild the UnixWare Kernel



Q: Do you need or desire to install the driver without halting 
   the system?

If the answer is yes then you want to install the driver as a 
dynamically loadable driver. Follow instructions in sections:

	Loading the Package.
 
	Configure for Dynamically Loadable driver

	Loading Loadable module. 




If the answer is no to the above questions then follow 
instructions in sections:

	Loading the Package.

	Rebuild the UnixWare Kernel




* Loading the Package *

Before you install the C8xx driver, make a backup copy of 
the existing kernel. To do so:

1. Log on as root.

2. At the shell prompt type

	cp  /stand/unix  /stand/unix.good

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.

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

4. Load the driver using the pkgadd command as follows:

	pkgadd -d diskette1

5. Select C8xx and press Enter. The C8xx driver gets loaded 
   on the system.

6. The system reprompts you to load the driver even if 
loading was successful. Type q (quit) and Enter.

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

	pkginfo c8xx 

8. The package information should look like this:

	system c8xx Symbios Logic IHV HBA



* Configure for Statically Linked Driver *

1. Make a backup copy of the c8xx system configuration 
file as follows:

	cd  /etc/conf/sdevice.d
	cp  c8xx  /tmp/c8xx.sys

2. Check if System file configured is static. If the file 
contains the line "$static" it is configured for static link. 
To look at this file type the following command:

	cat c8xx

3. If the System file does not contain the text "$static" on 
the line immediately following the "$version" line, add it
using a text editor. Do not include the double quotes.


* Configure for Dynamically Loadable Driver *

1. Make a backup copy of the c8xx system configuration 
file as follows:

	cd  /etc/conf/sdevice.d
	cp  c8xx  /tmp/c8xx.sys

2. Remove the "$static" line from the c8xx file using a text 
   editor, or by typing the following commands:

	grep  -v  '$static' c8xx > /tmp/c8xx.tmp
	mv  /tmp/c8xx.tmp  c8xx

3. Configure the loadable driver into the system as follows:

	/etc/conf/bin/idbuild  -M  c8xx



* Loading Loadable Module *

1. Once the loadable driver is configured into the system, 
   your driver is ready to load into the running system 
   using the modadmin command as follows:

	modadmin  -l  c8xx

   NOTE: When the driver is loaded, it scans the SCSI bus 
	and displays the devices found on it. An integer 
	module-id used to identify the C8xx driver is 
	displayed on the screen when loading completes.

2. To access the devices on the SCSI bus, create the entries 
   into the device table using pdi commands as follows:

	cd /etc/scsi
	./pdimkdev  -ifS
	./pdimkdtab  -ifS

   The system is now ready to use. 



* Rebuild the UnixWare Kernel *

1. Reboot the system. When the c8xx package is loaded it
sets a system flag to automatically rebuild the kernel upon
the next system boot. To reboot, type the following commands:

	cd /
	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 *********************


DRIVER INSTALLATION FAILS.

	a. Replace the system UNIX with the backup copy 
	   you created before attempting to install the 
	   C8xx host adapter driver. To perform this task, reboot 
	   the system.

	b. Wait for the "Booting UnixWare ..." prompt and 
	   the subsequent beep, then press the space bar 
	   key to begin an interactive boot session.

	c. When the [boot#] prompt is displayed, type:

		KERNEL=unix.good
		go

	d. The Operating System logo and "Booting UnixWare..." 
	   reappears. Then the system starts booting from 
	   the unix kernel you specified in the previous step.

