
***************************************************************************** 
                                 SCOUNIX.TXT
***************************************************************************** 

INSTALLATION GUIDE FOR THE SDMS SCO UNIX DRIVER V4.03.00

This file describes the features and use of the Symbios SDMS device driver 
for the SCO Unix operating system environments. It is divided into the 
following sections:

Note:  1) The 4.03.00 driver supports SCO Unix Open Desktop 3.0 and any of the
          three releases of SCO OpenServer (Releases 5.0.0, 5.0.2 and 5.0.4).
       2) The 4.03.00 driver diskette contains three packages. Package bhba is
          for Open Desktop 3.0, package slha is for SCO OpenServer Releases 5.0.0
          and 5.0.2, and package symha is for SCO OpenServer Release 5.0.4.
       3) Within the text instructions for adding SCSI Disk Drives, Tape Drives, 
          and CDROM drives, you will be prompted to check whether the driver is
          the default value or enter the exact driver name. With the previous
          Symbios Boot Time Loadable Driver (BTLD), the package name and the driver
          name for OpenServer were both slha. With this BTLD, both package symha 
          and package slha contain drivers named slha. The driver code is identical
          but one of the OS interface routines is "linked" to a different macro. 

Introduction
     Features
     Description

Installing Your SCO Unix Driver
     Procedure 1, Existing System Installation
     Procedure 2, New System 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.

To connect SCSI devices to one or more host adapters, you must place the
proper host adapter driver in the SCO UNIX kernel. Your Symbios Boot
Time Loadable Driver (BTLD) diskette contains three packages:

     bhba contains the driver for SCO UNIX 3.2v4x (Open Desktop 3.0)
     slha contains the driver for SCO OpenServer Releases 5.0.0 and 5.0.2
     symha contains the driver for SCO OpenServer Release 5.0.4

You must link-edit the proper driver into the SCO UNIX kernel. The kernel 
must reside on the boot drive: either an internal, non-SCSI hard drive (for
example, IDE), or a SCSI hard drive attached to host adapter 0 with SCSI ID 
0 and LUN 0. The BTLD permits an easy installation of Unix with the software
provided by SCO. 

SCO UNIX Release 3.2v4x provides installation diskettes labeled N1, N2, and M1.
Additional software is provided on CDROM, tape cartridge, or diskettes.
These media, along with the Symbios BTLD diskette, are needed to 
perform a new installation of your bhba driver onto a boot drive.

SCO OpenServer provides only one installation diskette, labeled Boot 
Disk. This diskette, along with your Symbios BTLD diskette, and other software 
media, are used during a SCO OpenServer installation.

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


*  *  *  *  *  *  *  *  *  *  *  *  Features *  *  *  *  *  *  *  *  *  *  *

o  Provides easy Unix installation on a hard disk with the Symbios Boot 
   Time Loadable Driver (BTLD) diskette 
o  Multiple processor support (with SCO Symmetrical Multiprocessing Support 
   package installed) 
o  Supports synchronous negotiation (including fast, Ultra, and Ultra2 SCSI) 
o  Supports Wide SCSI (single-ended and differential) 
o  Supports Disconnect/Reselect 
o  Supports Scatter/Gather 
o  Allows tagged command queuing 
o  Provides dynamic interrupt mapping 
o  Supports target initiated negotiation 
o  Allows shared interrupts 
o  Supports Multiple LUNs 
o  Allows automatic drive spin up 
o  Supports RAID up to 1024 byte block sizes
o  Supports NVRAM and NVS configuration data areas 


*  *  *  *  *  *  *  *  *  *  *  * Description *  *  *  *  *  *  *  *  *  * 

Unix installation on a SCSI system requires creation of a SCO UNIX kernel 
that contains the SCSI driver to support SCSI devices. There are two possible 
installation procedures:

1. Loading or updating the proper Symbios driver on a boot drive.

2. Installing UNIX and the proper Symbios driver for the first time on 
   a SCSI boot drive.


*   *   * Procedure 1: Existing System Installation *   *   * 

If you plan to attach SCSI devices to a Symbios host adapter while 
using a non-SCSI hard drive (for example, IDE) as the boot hard drive already 
containing a SCO UNIX system, execution of Procedure 1 is all that is 
necessary. This installs the Symbios driver on the non-SCSI boot drive. 
Some of the SCSI devices supported include tape drives, CDROM drives, and 
SCSI hard disk drives used as secondary storage. This procedure is also 
followed to replace a previously installed Symbios driver on a SCSI or 
non-SCSI boot drive.


*   *   * Procedure 2: New System Installation *   *   *

If you plan to perform a new SCO UNIX installation that includes the proper 
Symbios driver, then follow Procedure 2. Procedure 2 uses a Boot Time 
Loadable Driver (BTLD) to provide a user friendly method for installing SCO 
UNIX onto a hard disk drive.

Each of these procedures is described in detail below. Symbios recommends that
you complete the entire installation in one session. You should have sufficient
time (possibly over an hour) available to complete this without interruption.


************************ Installing Your SCO UNIX Driver ********************* 


*  *  *  *  *  * Procedure 1: Existing System Installation *  *  *  *  *

This procedure assumes SCO UNIX is already installed on a hard disk drive. 
This installation is necessary to build a new Unix kernel which includes the 
proper Symbios host adapter driver. The basic steps for accomplishing 
this are outlined below. For more details on Unix installation, refer to the 
SCO UNIX System Administrator's Reference manual.

1. If this is a SCO Unix 3.2v4x system, Symbios recommends creating a 
   second copy of the Unix kernel. Log in as root and issue the command:

   cp /unix /unix.safe 

   This creates a second copy of the Unix kernel under the name /unix.safe.

   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 after the prompt boot:

   unix.safe

   If this is an SCO OpenServer system, the system automatically creates a file
   unix.safe during installation.  To access this Unix kernel, type after the
   prompt boot:

   unix.safe

2. Install your Symbios driver.

   a. Insert the Symbios BTLD diskette in the drive and type: 

      installpkg

      Press the Enter key to continue.

   b. A prompt appears to insert the requested diskette. Since the Symbios 
      diskette is already inserted, press the Enter key to continue.

   c. A prompt now asks for the name of the package. Type:

      bhba
      for SCO UNIX Release 3.2v4x

      slha
      for SCO OpenServer Releases 5.0.0 and 5.0.2

      symha
      for SCO OpenServer Release 5.0.4

      Press the Enter key to continue.

   d. If a driver is already present from a previous installation, a prompt 
      inquires about replacing it. Reply y for yes. 

   e. Once the install package (installpkg) has completed, relink the kernel by
      executing /etc/conf/cf.d/link_unix.

   f. The system executes the command and then prompts for a response to:
      
      1.  Do you want this kernel to boot by default (y/n)? Type:
   
          y  

          Press Enter 

          Then the system backs up the old kernel.

      2.  Do you want the kernel environment rebuilt (y/n)? Type:

          y 

          Press Enter.

   g. To activate the new kernel, you must reboot the system. At the command 
      prompt, type:

      reboot

      Press Enter.


3. Adding a SCSI Disk Drive 

   Note: If you are not adding a SCSI disk drive to this system, go to step 4.

   a. At the command prompt, type:

       mkdev hd 

       Press Enter

   b. The system prompts for the identifier of the host adapter that supports 
      this device. If the default is correct, press Enter. If the default is 
      not correct, type:

      bhba
      for SCO UNIX Release 3.2v4x

      slha
      for SCO OpenServer

      Press Enter.

   c. The system prompts for the host adapter that supports the disk drive.
      Type the correct host adapter number and press Enter.

      If this is the first Symbios host adapter added to the SCO UNIX 
      kernel, the system prompts if you want to update the link-kit (add 
      another host adapter). Type y and press Enter. If you entered the host 
      adapter number incorrectly, type n, and press Enter. The system prompts 
      for the host adapter identifier of the preceding step.

   d. With SCO OpenServer, the system prompts for the bus number of 
      the disk drive. Since Symbios host adapters support one bus per 
      adapter, press Enter to get the default of zero, or type 0 (zero) and 
      press Enter.

      With SCO UNIX Release 3.2v4x, this prompt does not appear. Proceed to the
      next step.

   e. The system prompts for the Target ID of the disk drive. Type the SCSI 
      ID number of the disk drive and press Enter. If the ID entered is in 
      the range 8-15, a prompt requests verification that the device you are 
      adding 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 is incorrectly entered for a 
      narrow (8-bit) device. The Target ID prompt is then re-issued so you 
      can enter the correct Target ID.

   f. The system prompts for the Logical Unit Number (LUN) of the disk drive. 
      Type the desired LUN and press Enter, or press Enter for the default value
      of zero.

   g. The system prompts you 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.

   h. A prompt appears to create a new kernel. Type y if only one device or the
      last device, or type n if multiple devices are to be added later. See step
      6, "Rebuilding the Kernel," if you replied y.

4. Adding a SCSI Tape Drive.

   Note: If you are not adding a SCSI tape drive to this system, go to step 5.

   a. At the command prompt, type:

      mkdev tape 

      Press Enter 

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

   c. 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. 

   d. The system prompts to configure the tape drive. Type y and press Enter. 

   e. The system prompts for the identifier of the host adapter that supports 
      this device. If the default is correct, press Enter. If the default is 
      not correct, type:

      bhba
      for SCO UNIX Release 3.2v4x

      slha
      for SCO OpenServer

      Press Enter.

   h. The system prompts for the host adapter that supports the tape drive. 
      Type the correct host adapter number, and press Enter.

      If this is the first Symbios host adapter added to the SCO UNIX 
      kernel, the system prompts if you want to update the link-kit (add 
      another host adapter). Type y and press Enter. If you entered the host 
      adapter number incorrectly, type n, and press Enter. The system prompts 
      for the host adapter identifier of the preceding step.

   i. With SCO OpenServer, the system prompts for the bus number of 
      the tape drive. Since Symbios host adapters support only one bus 
      per adapter, press Enter to get the default of zero, or type 0 (zero) 
      and press Enter.

      With SCO UNIX Release 3.2v4x, this prompt does not appear. Proceed to the 
      next step.

   j. The system prompts for the SCSI ID of the tape drive. Type the SCSI ID 
      number of the tape drive and press Enter. 

   k. The system prompts for the LUN of the tape drive. Type 0 (zero) and press
      Enter. The system then prompts to update the SCSI configuration file. Type
      y and press Enter.

   l. A list is displayed showing the special devices 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.

   m. A prompt appears to create a new kernel. Type y if only one device or the
      last device, or type n if multiple devices are to be added later. See step 6,
      "Rebuilding the Kernel" if you replied y.  

5. Adding a SCSI CDROM Drive.

   Note: If you are not adding a SCSI CDROM drive to this system, go to 
         Step 6.

   a. At the command prompt, type:

      mkdev cdrom

      Press Enter

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

   e. The system prompts to configure the CDROM Drive. Type y and press 
      Enter.

   f. The system prompts for the identifier of the host adapter that supports 
      this device. If the default is correct, press Enter. If the default is 
      not correct, type:

      bhba
      for SCO UNIX Release 3.2v4x

      slha
      for SCO OpenServer

      Press Enter.

   g. The system prompts for the host adapter that supports the CDROM drive. 
      Type the correct host adapter number and press Enter.

      If this is the first Symbios host adapter added to the SCO UNIX 
      kernel, the system prompts if you want to update the link-kit (add 
      another host adapter). Type y and press Enter. If you entered the host 
      adapter number incorrectly, type n, and press Enter. The system prompts 
      for the host adapter identifier of the preceding step.

   h. With SCO OpenServer, the system prompts for the bus number of 
      the CDROM. Since Symbios host adapters support only one bus per 
      adapter, press Enter to get the default of zero, or type 0 (zero) and 
      press Enter.

      With SCO UNIX Release 3.2v4x, this prompt does not appear. Proceed to the
      next step.

   i. The system prompts for the SCSI ID of the CDROM Drive. Type the SCSI 
      ID number and press Enter.

   j. The system prompts for the LUN of the CDROM drive. Type the desired LUN 
      and press Enter, or press Enter for the default value of zero.

   k. The system prompts to update the SCSI configuration file. Type y and 
      press Enter. A prompt appears to configure a CDROM/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 displays the High Sierra/ISO9600 file system Configuration 
      Program menu. Select option 1 to add High-Sierra and press Enter. The 
      system updates the SCSI configuration file and returns to the CDROM 
      Configuration Program menu. Type q and press Enter to terminate the 
      CDROM Configuration Program menu. 

   l. A prompt appears to create a new kernel. Type y if only one device or the
      last device, or type n if multiple devices are to be added later. See step
      6, "Rebuilding the Kernel" if you replied y.

6. Rebuilding the Kernel.

   a. To rebuild the kernel, execute the command:

      /etc/conf/cf.d/link_unix

   b. The system displays a message and then prompts for a responses:
      
      1.  Do you want this kernel to boot by default (y/n)? Type:
   
          y  

          Press Enter 

          Then the system backs up the old kernel.

      2.  Do you want the kernel environment rebuilt (y/n)? Type:

          y 

          Press Enter.

   c. To activate the new kernel, you must reboot the system. Type the 
      command:

      reboot

      Press Enter.

   d. After the system reboots and the prompt boot: appears, press Enter and 
      the new kernel loads.

   e. Log in as usual.


*  *  *  *  *  * Procedure 2: New System Installation *  *  *  *  *  *  * 

This procedure installs SCO UNIX onto a hard disk drive. This installation is 
necessary to build a new Unix kernel that includes your Symbios driver. 
During installation, you are given the option of retaining current partitions 
on the root hard disk. For instance, you could have a DOS partition or a user 
Unix partition already established on the drive. For more details on Unix 
installation, refer to the SCO UNIX System Administrator's Reference manual. 


1. Link the Symbios BTLD into the Unix kernel during installation.

   a. Insert the SCO UNIX installation diskette and reboot the system. For 
      SCO OpenServer, this diskette is labeled Boot Disk.

   b. At the prompt boot: type:

      link

      Press Enter.

   c. At the next prompt type:

      bhba
      for SCO UNIX Release 3.2v4x

      slha
      for SCO OpenServer Releases 5.0.0 and 5.0.2

      symha
      for SCO OpenServer Release 5.0.4

      Do not remove the diskette. Press Enter.

   d. When prompted during the installation, insert either the proper 
      installation diskette(s) or the Symbios BTLD diskette, and press Enter.

   e. Continue the installation according to the SCO UNIX documentation.

   f. If this is a SCO Unix 3.2v4x system, Symbios recommends creating a 
      second copy of the Unix kernel. Reboot the system, log in as root and 
      issue the command:

      cp /unix /unix.safe 

      This creates a second copy of the Unix kernel under the name /unix.safe.

      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 after the prompt boot:

      unix.safe

      If this is an SCO OpenServer system, the system automatically creates a file
      unix.safe during installation.  To access this Unix kernel, type after the
      prompt boot:

      unix.safe

2. Install SCSI device support.

   a. Continue from Procedure 1, step 3.


*  *  *  *  *  *  *  *  *  *  * Troubleshooting *  *  *  *  *  *  *  *  *  *

The following conditions should exist after a successful installation:

The directory etc/conf/sdevice.d should contain a file named slha or bhba, 
depending on your SCO UNIX Release. This file contains the 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 slha or bhba entry for each Symbios host 
     adapter configured in the system.

     The second field in the sdevice file should read 'Y'.

     A slha or bhba entry should appear in the mdevice file.

     A slha or bhba entry for each configured SCSI device should appear in the
     mscsi file.

Directory /etc/conf/pack.d/slha or /etc/conf/pack.d/bhba should exist and 
contain the files Driver.o and space.c.

The following are some potential problems and their suggested solutions:

*   *   * Problem *   *   *

A SCSI device is not found.

*   *   * Solution *   *   *

a. Reboot and press Cntl C to view the Configuration utility.  

b. Verify the device is on the correct host adapter and ID.

c. If the device is not shown, then it is probaby turned off or a cabling 
   problem exists.

*   *   * Problem *   *   *

UNIX System behaves unreliably after a configuration change.

*   *   * Solution *   *   *

Whenever the hardware or software configuration is altered, you must rebuild 
the kernel. Use the directory /etc/conf/cf.d and type:

     ./link_unix

to rebuild the kernel.

*   *   * Problem *   *   *

An error message occurs during the rebuild of the kernel.

*   *   * Solution *   *   *

a. Reinstall the proper Symbios driver using the installpkg utility. 
   Remember to relink the kernel.

b. Reboot the system.

*   *   * Problem *   *   *

The root disk is not found or the partitioning of the disk fails.

*   *   * Solution *   *   *

a. If your boot drive is a SCSI disk, use the Configuration utility to check
   that the disk is assigned SCSI ID 0 (zero) and is configured to host
   adapter 0 (zero), LUN 0 (zero).

*   *   *  Problem  *   *   *

a. A SCSI tape drive is not seen during installation.

*   *   *  Solution  *   *   *

   Use the Configuration utility to check that the tape drive is assigned 
   SCSI ID 2, and that it is configured to host adapter 0 (zero), LUN 0 (zero).

   Also, verify that the ID of the tape drive does not conflict with any other
   SCSI device ID.

*   *   *  Problem  *   *   *

a. A SCSI CDROM drive is not seen during installation.

*   *   *  Solution  *   *   *

   Use the Configuration utility to check that the CDROM drive SCSI ID is set
   to 5, and that it is configured to host adapter 0 (zero), LUN 0 (zero).

   Also, verify that the ID of the CDROM drive does not conflict with any other 
   SCSI device ID.


