**********************************************************
This file describes the features and use of the NCR SDMS 
Device Drivers for the Novell UnixWare 1.x and 2.x
operating system environments. The current driver (version
3.00.00) supports UnixWare 1.x only. A version for 2.x will 
be available soon. This document is divided into the
following sections:

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

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

UnixWare 1.x and UnixWare 2.x extend the UNIX SVR4.2 
operating system, allowing tight integration with NetWare 
in an easy to use graphical form. The features of UnixWare 
include a graphical user interface, NetWare networking, 
application compatibility, multitasking capability, and 
multi-user capability. In addition Unixware 2.x 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 HBA 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 HBAs.

The NCR SDMS 3.0 C8xx driver allows Novell UnixWare 
operating systems to interface with SCSI devices connected 
to an NCR 53C8xx chipset and/or NCR 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 NCR SDMS 3.0 
C8xx driver.


**** Features ****

Allows easy installation using PDI - ID tools.
Provides synchronous negotiation (including fast SCSI)
Supports multiple host adapters
Supports Disconnect/Reselect
Allows multiple and non-contiguous LUN support
Supports dynamic interrupt mapping
Supports scatter/gather
Wide device support 
	(UnixWare 1.1 will not support a device with id > 7)
Supports SCSI pass-through functionality
Supports tagged command queuing
Supports request concatenation
Additional Features for UnixWare 2.x
Multiprocessor support


**** Description ****

The NCR SDMS 3.0 C8xx driver for Novell UnixWare operating 
systems is available on a 3.5 inch floppy diskette labeled 
SDMS 3.0 PCI UnixWare (1.x/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.

Currently, the Novell UnixWare Host Adapter diskette does 
not contain the C8xx driver. However, in the future the 
driver will be on this diskette.



******** 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 an NCR 53C8xx 
chipset then the driver is automatically linked statically 
with the kernel to suit the setup. Be sure to follow the 
instructions in the UnixWare Installation Handbook before 
installing the driver.

1. Boot the computer using the Boot diskette 1 delivered 
   with UnixWare 1.x distribution package. 

   For UnixWare 2.x use the Install diskette.

2. Follow the instructions on the screen.

3. Insert the SDMS 3.0 PCI UnixWare (1.x/2.x) 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 for Unixware 2.x system. 
   During UnixWare 1.x installation the driver displays the 
   banner and the number of host adapter cards it found. 

   If you want to install other HBA 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 be prompted to 
   reinsert the driver diskette. Insert the SDMS 3.0 PCI 
   UnixWare (1.x/2.x) diskette and press Enter.
 
   The kernel gets 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 1.x/2.x 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. By 
reviewing the following questions, you will be able to 
determine which procedure to follow.

Q: Are you installing the driver as a dynamically loadable 
   driver?

If you want to install the driver as a dynamically loadable 
driver then follow instructions in sections:

	Loading the Package.
 
	Modify Configuration file, depending on the version 
	of your operating system.

	Loading Loadable module. 

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

If the answer is no on a UnixWare 1.x system then follow 
instructions in sections: 

	Loading the Package.

	Modify Configuration file for UnixWare 1.x.

	Rebuild the UnixWare Kernel

	Booting the system with the New Kernel

If the answer is no on a UnixWare 2.x system then follow 
instructions in sections: 

	Loading the Package.

	Modify Configuration file for UnixWare 2.x.

	Rebuild the UnixWare Kernel

	Booting the system with the New Kernel

If the answer is yes on either a UnixWare 1.x or a 
UnixWare 2.x system then follow the instructions in 
sections:

	Loading the Package.

	Rebuild the UnixWare Kernel.

	Booting the system with the New 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 3.0 PCI 
UnixWare (1.x/2.x) 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 will reprompt 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 

8. The package information should look like this:

	system c8xx AT&T GIS IHV HBA



* Modify Configuration file for UnixWare 1.x *

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

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

2. Using a text editor, add the following as a second line 
   in the c8xx file:

	$loadable c8xx

   or type the following commands:

	sed '1a\^J\$loadable  c8xx'  c8xx >> c8xx

   The characters ^J mean you should hold the Control key 
   and press the J key at the same time, or instead of ^J 
   press \ and then press Enter.

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

	/etc/conf/bin/idbuild  -M  c8xx



* Modify Configuration file for UnixWare 2.x *

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 > /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 gets 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. A base kernel rebuild is necessary to incorporate the 
   installed driver. Type the following line:

	/etc/conf/bin/idbuild  -B

2. Copy the new kernel into the appropriate directory as 
   follows:

	/etc/conf/bin/idmkinit  -o  /etc
	/etc/conf/bin/idcpunix

3. Reboot the system as follows:

	init 6



* Booting the System with the New Kernel *

During the boot process the driver scans the SCSI bus and 
lists the devices found on it. If during boot the kernel 
panics, 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 HBA 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. On a UnixWare 1.1 system, when the "Enter the 
	   name of a kernel to boot" message appears, type:

		unix.good

	d. On a UnixWare 2.0 system, when the [boot#] prompt 
	   is displayed, type:

		KERNEL=unix.good
		go

	e. The NOVELL logo and "Booting UnixWare..." will 
	   reappear. Then the system will start booting from 
	   the unix kernel you specified in the previous step.

