***************************************************************************
				UNIXDRV.TXT
***************************************************************************
This file describes the features and use of the NCR SDMS device drivers for 
the SCO UNIX operating system. It is divided into the following sections:

Introduction
SCO UNIX 3.2v4x
	Features
	Description
	Installation
	Troubleshooting
Important Additional Information
***************************************************************************


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

SCO UNIX is the first UNIX operating system licensed for IBM-compatible 
microcomputers. The integrated communications, file system, international 
application support, and documentation create an ideal platform for those 
requiring a full-featured, UNIX-based operating system. SCO UNIX takes full 
advantage of the capabilities of the 80386 and above microprocessors.

SCO UNIX 3.2v4x provides Basic Utilities, and Extended Utilities, as well 
as their Development System packages. These items, plus the installation 
software, are provided on diskettes (also available on tape or CD). SCO has 
labeled these diskettes: N(1-2) and M1 for Installation, B(1-3) for Basic 
Utilities, and X(1-7) for Extended Utilities.

The NCR SDMS 3.0 SCSI device drivers are linked into the UNIX kernel. The 
rebuilt kernel must reside on the boot drive: either an internal, non-SCSI 
hard drive (IDE, ESDI, or ST506) or a SCSI hard drive. SDMS facilitates 
this by providing a Boot Time Loadable Driver (BTLD) and the CAM3 SCSI 
configuration tool. The BTLD permits an easy installation of UNIX onto a 
SCSI hard disk with the software provided by SCO. The CAM3 SCSI 
configuration tool simplifies loading the SCSI device drivers into the 
operating system (see figure 4-1).

The following sections provide instruction on configuring the SCO UNIX 
kernel with the SCSI device drivers, adding SCSI peripheral devices, and 
installing SCO UNIX onto a SCSI hard drive. These instructions assume you 
are familiar with UNIX system administration.



****************************** SCO UNIX 3.2v4x ****************************


* Features *

Provides easy Unix installation on a SCSI hard disk with the NCR Boot Time 
	Loadable Driver (BTLD)
Provides easy SCSI device support installation with the NCR CAM3 SCSI 
	configuration tool
Supports synchronous negotiation (including fast SCSI)
Supports multiple host adapters
Supports Disconnect/Reselect
Supports scatter/gather
Allows tagged command queuing
Provides dynamic interrupt mapping
Sopports Wide SCSI (single-ended and differential)
Supports target initiated negotiation
Allows shared interrupts


* Description *

UNIX installation on a SCSI system requires that a copy of SCO UNIX be 
created that contains the device drivers to support SCSI devices. 
The installation of UNIX depends on how the SCSI devices will be 
configured. There are two possible installation procedures:

1. Install UNIX and the SCSI device drivers on a non-SCSI boot drive.

2. Install UNIX and the SCSI device drivers on a SCSI boot drive.

Procedure 1

If SCSI devices will be attached to a SCSI host bus adapter card while 
using a non-SCSI hard drive (IDE, ESDI, ST506) as the boot hard drive, 
execution of procedure 1 is all that is necessary. This will install the 
NCR SCSI UNIX device drivers on the non-SCSI boot drive to access the SCSI 
devices. SCSI devices supported include tape drives, CD-ROM drives, and 
SCSI hard disk drives that will be used as secondary storage.

Procedure 2

If the user plans to install a SCSI hard disk drive to be used as the boot 
hard drive, then procedure 2 will be executed. Procedure 2 uses a Boot Time 
Loadable Driver (BTLD) to provide a user friendly method for installing 
UNIX onto a SCSI hard disk drive.

To use the BTLD, the Basic and Extended Utilities packages provided by SCO 
must be included during the installation.

Each of these procedures are described in detail below. NCR recommends that 
the entire installation is accomplished in one session. Be sure that the 
installer has sufficient time (possibly an hour) available to complete this 
without interruption.

The NCR CAM3 SCSI Configuration Tool

Both installation procedures use the NCR CAM3 SCSI configuration tool to 
load the SCSI device drivers into the operating system. This utility is 
provided on the diskette with the NCR SDMS drivers for SCO UNIX. The CAM3 
main menu presents the following options:

		The CAM3 Main Menu Options

	1. Configure the NCR SCSI Device Drivers
	2. Add or Remove Specific Devices
	3. Relink Unix
	4. Remove All SCSI Devices
	5. Show Current SCSI Configuration

Some of these options are referred to in the following procedures. After 
completion of either installation procedure, CAM3 can be invoked again 
from the UNIX prompt by typing:

mkdev cam3

In this way CAM3 can be used to make subsequent changes in the installation.


* Installation *

Procedure 1

This procedure assumes UNIX is already installed on an IDE, ESDI, or ST506 
hard disk drive. It will show how to include the device drivers needed to 
access SCSI devices installed after the non-SCSI drive. This installation 
is necessary to build a new UNIX kernel which includes the NCR SCSI device 
drivers. The basic steps for accomplishing this are outlined below. Further 
detail on UNIX installation can be found in the SCO UNIX System 
Administrator's Reference manual.

1. NCR recommends creating a second copy of UNIX. Log in as root and issue 
the command:

	cp /unix /unix.good 

This creates a second copy of UNIX under the name /unix.good.

If any problems arise with the kernel being built in UNIX, this procedure 
ensures that a valid copy of UNIX will be available. 

To access this valid UNIX copy, type at the colon after the boot message:
		
	unix.good

To replace the system UNIX with the working UNIX copy, type at the system 
prompt:
		
	cp /unix.good /unix

2. Install the NCR SDMS SCSI UNIX device drivers.

	a. Insert the SCO SDMS SCSI Drivers floppy diskette in the drive 
	and type:
	
		installpkg
 
	Press the Enter key to continue.

	b. A prompt will appear to insert the requested floppy diskette. 
	Since the NCR diskette has already been inserted, press the Enter 
	key to continue.

	c. A prompt will then ask for the name of the package. Type:

		cam3

	Press the Enter key to continue.

	d. If the SDMS driver is already present from a previous 
	installation, a prompt inquires about replacing it. Do not replace 
	it unless there is reason to believe it is corrupted, or a newer 
	version is available.

	e. To execute CAM3, remove the NCR floppy diskette from the drive 
	(since CAM3 has been installed on the hard drive), then type:

		mkdev cam3

	Press the Enter key to continue.

	f. The CAM3 main menu is displayed. To check that there are no SCSI 
	devices installed, press 5 and Enter to show the current SCSI 
	configuration. There should be no SCSI devices listed. If there 
	are, press 4 for the option to remove all SCSI devices, then press 
	y and Enter to accept the removal.

	g. From the CAM3 main menu, select option 1 to configure the NCR 
	SCSI device drivers. Three options are displayed: 
	
		1. Configure NCR Host Adapter Software 
		2. Remove NCR Host Adapter Software from System 
		Configuration
		3. Return to Main Menu 

	h. To configure the NCR host bus adapter software select 1 from 
	this menu.

	i. Each device driver in UNIX is assigned a number known as the 
	major device number. The major device number assigned to the host 
	bus adapter is displayed. Write this number down, as it may be 
	required later, and keep it with the UNIX documentation.

	j. A prompt is displayed to set the interrupt line to be used by 
	the host bus adapter. The SDMS SCO UNIX driver performs dynamic 
	interrupt mapping. Therefore, press 0 (zero) and Enter. To exit 
	this process, press Enter, or type q and press Enter.

	If the system indicates that the proper interrupt lines for the 
	SCSI host bus adapter are not available, review the section under 
	Troubleshooting concerning possible kernel rebuild problems and 
	edit the sdevice entries to eliminate the conflict. 

3. Adding a SCSI Hard Drive to UNIX. If a SCSI hard disk drive will not be 
added to this system, go to step 4.

	a. Select option 5 from the CAM3 main menu to show SCSI 
	configuraton. Note the bus number of the NCR controller. You will 
	need it throughout this installation procedure.

	b. From the CAM3 main menu, select option 2 to add or remove 
	specific devices. A list will appear showing the current 
	configuration followed by a menu of these options: 

		Add or Remove Specific Devices Menu Options

		1. Reconfigure Sdsk (Disk Drive)
		2. Reconfigure Stp (Tape Drive)
		3. Reconfigure Srom (CD-ROM)
		4. Invoke the SCO low level SCSI Configuration script
		5. Return to the previous menu

	To add the SCSI hard disk drive, select option 1 to reconfigure 
	Sdsk, and press Enter. 

	c. Read the explanatory text that appears and follow the prompts. 
	Press Enter at the next two prompts to scroll through the 
	explanitory text. A prompt will appear to add another SCSI disk. 
	Answer y and press Enter. Select option 2 to add a drive to the 
	SCSI controller and press Enter.

	d. The system will prompt for the prefix of the SCSI host adapter 
	that supports this device. If the default is bhba, press Enter. If 
	the default is not bhba, type:

		bhba

	Press Enter.

	e. The system will prompt for which SCSI host adapter supports the 
	SCSI hard drive. Type the correct path number (bus number) and 
	press Enter.

	f. The system will prompt for the Target ID of the SCSI hard drive. 
	Type the SCSI ID number and press Enter.

	g. The system will prompt for the LUN (Logical Unit Number) of the 
	SCSI hard drive. Press 0 (zero) and press Enter.

	h. The system will prompt to update the SCSI Configuration file. 
	Answer y and press Enter.

	i. A prompt appears to create a new kernel to effect the driver 
	change. Answer n (as this will be done later) and press Enter.

4. Adding a SCSI Tape Drive to UNIX. If a SCSI tape drive will not be added 
to this system, go to step 5.

	a. Select option 5 from the CAM3 main menu to show SCSI 
	configuraton. Note the bus number of the NCR controller. You will 
	need it throughout this installation procedure.

	b. From the CAM3 main menu, select option 2 to add or remove 
	specific devices. A list will appear showing the current 
	configuration followed by a menu of choices. To add the SCSI tape 
	drive, select option 2 and press Enter.

	c. Instructions on using a SCSI tape drive are displayed. Press 
	Enter at the next three prompts to scroll through the explanitory 
	text and start the mkdev tape utility for installing a tape drive. 

	d. The Tape Drive Configuration Program menu appears. Select 
	option 1 to install a tape drive, and press Enter. 

	e. The Tape Drive Installation Menu appears. Select option 4 to 
	install a SCSI tape drive, and press Enter. From the next list 
	select the type of SCSI tape drive to install, and press Enter.

	f. The system will prompt to configure the tape drive. Press y and 
	Enter.

	g. The system will prompt for the prefix of the SCSI host adapter 
	that supports this device. If the default is bhba, press Enter. If 
	the default is not bhba, type:

		bhba

	Press Enter.

	h. The system will prompt for which bhba SCSI host adapter supports 
	the tape drive. Type the correct path number (bus number) and press 
	Enter.

	i. The system will prompt for the SCSI ID of the SCSI tape drive. 
	Type the correct ID number (two is recommended) of the tape drive 
	and press Enter. 

	j. The system will prompt for the LUN (Logical Unit Number) of the 
	tape drive. Press 0 (zero) and Enter. The system will then prompt 
	to update the SCSI configuration file. Answer y and press Enter. 

	k. A list will be displayed showing the special devices that have 
	been created. Press Enter, and a list is displayed showing the 
	links to the installed tape drive. When prompted for a boot string, 
	press q and Enter to return to the Tape Drive Configuration Program 
	menu. Press q and Enter to continue.

	l. A prompt appears to create a new kernel to effect the driver 
	change. Answer n (as this will be done later) and press Enter.

5. Adding a SCSI CD-ROM Drive to UNIX. If a SCSI CD-ROM drive will not be 
added to this system, go to Step 6.

	a. Select option 5 from the CAM3 main menu to show SCSI 
	configuraton. Note the bus number of the NCR controller. You will 
	need it throughout this installation procedure.
	
	b. From the CAM3 main menu, select option 2 to add or remove 
	specific devices. A list will appear showing the current 
	configuration followed by a menu of choices. To add the SCSI 
	CD-ROM drive, select option 3 and press Enter.

	c. Instructions on using a CD-ROM drive are displayed. Press Enter 
	two more times at the prompts to scroll through the explanitory 
	text and start the mkdev cdrom utility for installing a CD-ROM 
	drive. 

	d. The CD-ROM Configuration Program menu appears. Select option 1 
	to install a CD-ROM drive and press Enter.

	e. The system will prompt to configure the CD-ROM Drive. Answer y 
	and press Enter.

	f. The system will prompt for the prefix of the SCSI host adapter 
	that supports this device. If the default is bhba, press Enter. If 
	the default is not bhba, type:

		bhba
	
	Press Enter.

	g. The system will prompt for which SCSI host adapter supports the 
	CD-ROM drive. Type the correct path number (bus number) and press 
	Enter.

	h. The system will prompt for the SCSI ID of the CD-ROM Drive. Type 
	the ID number and press Enter.

	i. The system will prompt for the LUN (Logical Unit Number) of the 
	CD-ROM drive. Press 0 (zero) and press Enter.

	j. The system will prompt to update the SCSI configuration file. Answer
	y and press enter. A prompt appears to configure a CD-ROM/TAPE
	installation device. Unless this is desired, answer n and press 
	Enter. A prompt appears to add a high-sierra file system. Answer y 
	and press Enter. The system will display the High Sierra/ISO9600 
	filesystem Configuration Program menu. Select option 1 to add 
	high-sierra and press Enter. The system updates the SCSI 
	configuration file and returns to the CD-ROM Configuration Program 
	menu. Select q and press Enter to continue. 

	k. A prompt appears to create a new kernel to affect the driver 
	change. Answer n (as this will be done later) and press Enter.

6. Rebuilding the Kernel.
	
	a. The system now returns to the CAM3 main menu. Select option 3 to 
	relink UNIX and press Enter.

	b. A prompt will appear asking to rebuild the kernel. Answer y and 
	press Enter. The kernel will now be linked, which takes 
	approximately 3 minutes. Messages will appear while the kernel is 
	linking.

	c. When the kernel has been rebuilt, the system will prompt as to 
	whether this kernel is to boot by default. Press y and Enter.

	d. The system will prompt whether to rebuild the kernel 
	environment. Press y and Enter. When the CAM3 main menu appears, 
	press q and Enter. At the custom Main Menu, highlight Quit and 
	press Enter. 

	e. To activate the new kernel the system must be rebooted. Type the 
	command:

		reboot

	Press Enter.

	f. Press Enter at the Boot: prompt and the new kernel will load. If 
	there is a host bus adapter with an NCR ROM installed, the NCR 
	device driver will display a load message when the kernel loads.

	g. Log in as usual.


Procedure 2

This procedure will install UNIX on a SCSI hard disk drive. It will include 
the SCSI device drivers needed to access SCSI devices installed after the 
SCSI drive. This installation is necessary to build a new UNIX kernel that 
includes the NCR SCSI device drivers. Further detail on UNIX installation 
can be found in the SCO UNIX System Administrators Reference manual.

1. Link the BTLD into the UNIX kernel during installation. 

	a. If the SCSI hard disk has any existing partitions, delete them.

	b.Insert the SCO UNIX N1 installation disk and reboot the system.

	c. At the Boot: prompt type:

		link

	Press Enter.

	d. At the next prompt type:

		bscam

	bscam refers to the SDMS driver package

	Do not remove the N1 diskette. Press Enter.

	e. At the next prompt, replace the N1 diskette with the SCO SDMS 
	Device Drivers diskette (which contains the BTLD), and press Enter.

	When using the BTLD to install UNIX, the CAM3 configuration tool is 
	automatically installed.

	f. Continue from this point as a normal installation according to 
	the SCO UNIX documentation.

	Remember, the Basic and Extended Utilities packages must be loaded 
	when using the BTLD.

	g. NCR recommends creating a second copy of UNIX. 

	Log in as root and issue the command:

		cp /unix /unix.good 

	This creates a second copy of UNIX under the name /unix.good.

	If any problems arise with the kernel being built in UNIX, this 
	procedure ensures that a valid copy of UNIX will be available. 

	To access this valid UNIX copy, type at the colon after the boot 
	message:

		unix.good

	To replace the system UNIX with the valid UNIX, type at the system 
	prompt:

		cp /unix.good /unix

2. Install the NCR SDMS SCSI UNIX device drivers.

	a. After rebooting the system, type:

		mkdev cam3

	Press Enter to continue.

	b. Continue from Procedure 1, step 2f.


* Troubleshooting *

The following conditions should exist after a successful installation:

	- The directory etc/conf/sdevice.d should contain a file named 
	bhba.
	- The bhba file should contain the bhba sdevice entry.
	- There should be a bhba entry for each SDMS SCSI controller 
	configured in the system in the sdevice file.
	- The second field for bhba in the sdevice file should be set to Y.
	- There should be a bhba entry in the mdevice file.
	- There should be a bhba entry for each SCSI device in the mscsi 
	file.
	- The directory etc/conf/pack.d/bhba should exist and contain the 
	files Driver.o, RAMcore.h, and space.c.

To solve some problems it is necessary to be aware of certain files in the 
UNIX system. The directory etc/conf/cf.d contains the files sdevice, 
mdevice, and mscsi. Two other files in this directory, sdev.hdr and 
mdev.hdr, describe the values of the possible field entries in sdevice and 
mdevice.

The following are some problems and their suggested solutions:

AN INTERRUPT CONFLICT MESSAGE APPEARS.

	a. In the sdevice file, check the fifth field of the bhba entry 
	for a conflict with that of any competing driver.

A SCSI DEVICE CANNOT BE FOUND.

	a. Reboot to observe the system configuration table when it 
	appears.

	b. Look for bhba entries for each SCSI device connected to an NCR 
	SCSI controller.

	c. Also, check to see that the desired value for each field exists.

UNIX SYSTEM BEHAVES UNRELIABLY AFTER A CONFIGURATION CHANGE.

	a. Whenever the hardware or software configuration is altered, the 
	kernel must be rebuilt. Use the Relink UNIX option of the CAM3 
	configuration tool, or change to the /etc/conf/cf.d directory and 
	type:

		./link_unix

	to rebuild the kernel.

DURING KERNEL REBUILD, AN ERROR MESSAGE INDICATES THE CHARACTER DEVICE 
NUMBER OF DEVICE cn CONFLICTS WITH THE CHARACTER DEVICE NUMBER OF bhba.

	a. Reinstall the CAM3 software using the installpkg utility. 
	Remember to reload the bhba driver.

	b. Rebuild the kernel.

DURING INSTALLATION, THE ROOT DISK IS NOT FOUND, OR THE PARTITIONING OF 
THE DISK FAILS.
	
	a. If a SCSI tape drive is used in the initial installation:

		The SCSI tape drive ID should be set to "2", and it should 
		be configured to path 0, LUN 0.

		The ID of the tape drive should not conflict with any other 
		SCSI device ID.

	b. If a SCSI CD-ROM drive is used in the initial installation:

		The SCSI CD-ROM drive ID should be set to "5", and it 
		should be configured to path 0, LUN 0.

		The ID of the CD-ROM drive should not conflict with any 
		other SCSI device ID.

	c. Make sure no previous partitions exist on the root hard drive.



******************** Important Additional Information *********************


How to Remove a SCSI Hard Drive From SCO UNIX

1. From the CAM3 main menu, select the option to add or remove specific 
devices. A list will appear showing the current configuration followed by a 
menu of choices. To remove a SCSI hard drive, select option 4 and press 
Enter.

2. A user prompt to review SCSI ID information is displayed. After 
responding to the prompt, press Enter to start the mkdev .scsi utility for 
removing a SCSI hard drive.

3. The .scsi utility program menu appears. Select option 2 to remove a hard 
drive and press Enter.

4. The system will prompt to remove a SCSI device. Select option 1 to 
remove a hard drive and press Enter.

5. The system will prompt for the prefix of the SCSI host adapter that 
supports the device. If the default is bhba, press Enter. If the default is 
not bhba, type:

	bhba

Press Enter.

6. The system will prompt for which SCSI host adapter supports the hard 
drive. Respond with the correct path number (bus number), and press Enter.

7. The system will prompt for the SCSI ID of the hard drive. Type the ID 
number and press Enter.

8. The system will prompt for the LUN (Logical Unit Number) of the drive. 
Press 0 (zero) and press Enter.

9. The system will prompt to update the SCSI configuration file. Answer y 
and press Enter. The system updates the SCSI configuration file and returns 
to the Main CAM3 Program menu.

10. A prompt appears to create a new kernel to effect the system 
configuration change. Answer n (as this will be done later) and press 
Enter.

Go to step 6 (Rebuilding the Kernel) in Procedure 1.

