*******************************************************************
			  UNIX.TXT
*******************************************************************
This file describes the features and use of the NCR SDMS SCO UNIX 
Driver v3.04.00 for the SCO UNIX 3.2v4x operating system 
environment. It is divided into the following sections:

Introduction
	Features
	Description
Installing the Drivers for SCO UNIX 3.2v4x
	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. 
These items are provided on diskettes (also available on tape 
or CD). SCO has labeled these diskettes: B(1-3) for Basic Utilities, 
and X(1-7) for Extended Utilities. SCO also provides installation 
diskettes N1, N2, and M1.

The NCR SCSI Host Bus Adapter (HBA) driver allows utilization of 
SCSI devices attached to an NCR host adapter card. This HBA driver 
must be link-edited into the SCO UNIX kernel before SCSI devices 
can be utilized. The kernel must reside on the boot drive: either 
an internal, non-SCSI hard drive (IDE, ESDI, or ST506) or a SCSI 
hard drive. NCR facilitates link-editing by providing two packages, 
a Boot Time Loadable Driver (BTLD) and the CAM3 SCSI configuration 
tool. Both of these packages reside on our BTLD diskette. 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 adding SCSI peripheral device support into the operating 
system.

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


*** Features ***

Provides easy UNIX installation on a SCSI hard disk with the 
	NCR SDMS 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 wide SCSI (single-ended and differential)
Supports multiple host adapters
Supports Disconnect/Reselect
Supports scatter/gather
Allows tagged command queuing
Provides dynamic interrupt mapping
Supports target initiated negotiation
Allows shared interrupts
Supports Multiple LUNs
Allows automatic drive spin up
Supports RAID up to 1024 byte block sizes


*** Description ***

UNIX installation on a SCSI system requires that a SCO UNIX 
kernel be created that contains the SCSI HBA driver to support 
SCSI devices. There are two possible installation procedures:

1. Loading or updating the NCR SCSI HBA driver on a boot drive.

2. Install UNIX and the NCR SCSI HBA driver for the first time 
   on a SCSI boot drive.


* Procedure 1 *

If SCSI devices will be attached to an NCR 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 HBA driver on the 
non-SCSI boot drive in order to access the SCSI devices. Some 
of the SCSI devices supported include tape drives, CD-ROM drives, 
and SCSI hard disk drives that will be used as secondary storage. 
This procedure is followed to update a previously installed 
NCR SCSI HBA driver on both SCSI and non-SCSI drives.

* Procedure 2 *

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

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

Each of these procedures is 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 may use the NCR CAM3 SCSI configuration 
tool to load the NCR SCSI HBA driver into the SCO UNIX 
kernel. This utility is provided on the SDMS BTLD diskette 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 to the 
system configuration.



*********** Installing the Drivers for SCO UNIX 3.2v4x ***********


* 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 HBA driver. 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 the UNIX kernel. 
   Log in as root and issue the command:

		cp /unix /unix.good 

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

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

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

		unix.good

   To restore the valid system UNIX kernel from the saved UNIX 
   kernel, type at the system prompt:

		cp /unix.good /unix

2. Install the NCR SCSI HBA driver.

   a. Insert the NCR BTLD 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. "bhba" is an internal name used as an alias for the NCR SCSI 
      HBA driver. If the NCR SCSI HBA 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 you are installing a newer version.

   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 what SCSI devices 
      are installed, type 5 and press Enter to show the current 
      SCSI configuration. If you are only updating the NCR 
      SCSI HBA driver, skip to section 6 to rebuild the kernel.

   g. From the CAM3 main menu, select option 1 to configure the 
      NCR SCSI HBA driver. 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 adapter software select 1 from 
      this menu.

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

NOTE: If the system indicates that the proper interrupt lines for 
      the SCSI host 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.

NOTE: 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 
      configuration. Note the bus number of the NCR host adapter. 
      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 explanatory text. A prompt will appear to add 
      another SCSI disk. Type y and press Enter. Select option 2 
      to add a drive to the NCR SCSI host adapter 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 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. If the ID 
      entered is in the range 8-15, a prompt requests verification 
      that the device being added is a wide (16-bit) device, as 
      only wide devices may have IDs greater than 7. Type y and 
      press Enter if the device is wide. Type n and press Enter if 
      an ID greater than 7 was incorrectly entered for a narrow 
      (8-bit) device. The Target ID prompt is then re-issued so 
      the Target ID may be correctly entered.

   g. The system will prompt for the LUN (Logical Unit Number) of 
      the SCSI hard drive. Type the desired LUN and press Enter, 
      or press Enter for the default value of zero.

   h. The system will prompt to update the SCSI Configuration file. 
      Type y and press Enter if the displayed values are correct. 
      Type n if the values are incorrect, and retry from step 3d.

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

4. Adding a SCSI Tape Drive.

NOTE: 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 
      configuration. Note the path number of the NCR host adapter. 
      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 a 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 
      explanatory 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. Type y 
      and press 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 NCR SCSI host adapter 
      supports the tape drive. Type the correct path number and 
      press Enter.

   i. The system will prompt for the SCSI ID of the SCSI tape 
      drive. Type the correct ID number of the tape drive and 
      press Enter. 

   j. The system will prompt for the LUN (Logical Unit Number) 
      of the tape drive. Type 0 (zero) and press Enter. The system 
      will then prompt to update the SCSI configuration file. 
      Type 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, type q and press Enter to return to the 
      Tape Drive Configuration Program menu. Type q and press Enter 
      to terminate the Tape Drive Configuration Program menu.

   l. A prompt appears to create a new kernel to change the 
      configuration. Type n (as this will be done later) and press 
      Enter to return to the CAM3 main menu.

5. Adding a SCSI CD-ROM Drive.

NOTE: 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 
      configuration. Note the path number of the NCR host adapter. 
      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 
      explanatory 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. 
      Type 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 NCR SCSI host adapter 
      supports the CD-ROM drive. Type the correct path 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. Type 0 (zero) and press Enter.

   j. The system will prompt to update the SCSI configuration 
      file. Type y and press Enter. A prompt appears to configure 
      a CD-ROM/TAPE installation device. Unless this is desired, 
      type n and press Enter. A prompt appears to add a high-sierra 
      file system. Type 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. Type q and press Enter 
      to terminate the CD-ROM Configuration Program menu. 

   k. A prompt appears to create a new kernel for the configuration 
      change. Type 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. Type y 
      and press Enter. The kernel will now be linked, which takes 
      a few 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. 
      Type y and Enter.

   d. The system will prompt whether to rebuild the kernel 
      environment. Type y and press Enter. When the CAM3 main 
      menu appears, type q 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 SCO UNIX on a SCSI hard disk drive. 
This installation is necessary to build a new UNIX kernel that 
includes the NCR SCSI HBA driver. Further detail on UNIX 
installation can be found in the SCO UNIX System Administrator's 
Reference manual.

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

   a. Insert the SCO UNIX N1 installation diskette and reboot 
      the system.

   b. At the Boot: prompt type:

		link

      Press Enter.

   c. At the next prompt type:

		bscam

NOTE: bscam refers to the NCR SCSI HBA driver package.

      Do not remove the N1 diskette. Press Enter.

   d. At the next prompt, replace the N1 diskette with the NCR 
      BTLD diskette, and press Enter.

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

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

NOTE: Remember that the Basic and Extended Utilities packages 
      must be loaded when using the BTLD.

   f. NCR recommends creating a second copy of the UNIX kernel. 

      Log in as root and issue the command:

		cp /unix /unix.good 

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

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

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

		unix.good

      To restore the valid system UNIX kernel from the saved UNIX 
      kernel, type at the system prompt:

		cp /unix.good /unix

2. Install SCSI device support.

   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. This file contains the bhba sdevice entries.
- The directory etc/conf/cf.d contains files sdevice, mdevice, and 
  mscsi. Files sdev.hdr and mdev.hdr describe the values of the 
  possible field entries in the files sdevice and mdevice, 
  respectively.

	- The sdevice file should contain a bhba entry for each 
	  NCR host adapter card configured in the system.
	- 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.


The following are some problems and their suggested solutions:

AN INTERRUPT CONFLICT MESSAGE APPEARS.

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.

Reboot to observe the system configuration table when it appears.

Look for bhba entries for each SCSI device connected to an NCR SCSI 
host adapter.

Check to see that the desired value for each field exists.

UNIX SYSTEM BEHAVES UNRELIABLY AFTER A CONFIGURATION CHANGE.

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.

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

Rebuild the kernel.

DURING INSTALLATION, THE ROOT DISK IS NOT FOUND, OR THE 
PARTITIONING OF THE DISK FAILS.

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.

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.

During installation, the user is given the option of retaining 
current partitions on the root hard disk. For instance, there may 
be a DOS partition or a user UNIX partition already established on 
the drive; usually, these partitions are desired. However, the root 
and swap partitions are established during installation. If problems 
exist with these partitions, the DOS FDISK procedure may need to be 
executed to delete these partitions before installation.



*************** 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, 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. Type 0 (zero) and press Enter.

9. The system will prompt to update the SCSI configuration file. 
   Type 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. Type n (as this will be done later) and 
   press Enter.

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