;...............................................................;
;	SCO.Txt 			v3.04	Mar-95		;
;...............................................................;

Driver for SCO UNX is in another diskette of UNIX format.
Following is the description for this driver set.

**************************************************************************
		DEVICE DRIVER FOR SCO UNIX
**************************************************************************

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.

;.......eof.P815.Txt............................................;
