*****************************************************************************
SCOUNIX.TXT
*****************************************************************************
INSTALLATION GUIDE FOR THE SDMS SCO UNIX DRIVER V4.04
This file describes the features and use of the Symbios SDMS device driver
for the SCO UNIX operating system environments. These instructions assume
that you are using a Symbios host adapter and appropriate SCSI devices. You
only need to "link" the new Symbios driver if you have a Symbios host adapter
in the system. Go to the Troubleshooting section for further information
about installation to an IDE Hard Drive.
This file is divided into the following sections:
Introduction
Features
Description
Installing Your SCO Unix Driver
Procedure 1, New System Installation
Installing the SCO UNIX Driver
Install SCSI Device Support
Procedure 2, Existing System Installation
Existing System Installation
Install your Symbios Driver
Adding a SCSI Disk Drive
Adding a SCSI Tape Drive
Adding a SCSI CD-ROM
Troubleshooting
Please read the note below before proceeding with the installation instructions.
Note: 1) The 4.04 driver supports all of the OpenServer releases of SCO UNIX
(Releases 5.0.0, 5.0.2 and 5.0.4).
2) The 4.04 driver diskette contains two packages. 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 CD-ROM 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 ********************************
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 two packages:
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 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 the 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. Installing UNIX and the proper Symbios driver for the first time on
a boot drive.
2. Loading or updating the proper Symbios driver on a boot drive.
* * * Procedure 1: New System Installation * * *
If you plan to perform a new SCO UNIX installation that includes the proper
Symbios driver, then follow this procedure. Procedure 1 uses a Boot Time
Loadable Driver (BTLD) to provide a user friendly method for installing SCO
UNIX onto a hard disk drive.
* * * Procedure 2: 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 2 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, CD-ROM 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.
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 the SCO UNIX Driver *********************
* * * * * * Procedure 1: 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 "boot:" prompt (prompt appears without the double qoutes), type:
link
Press Enter.
c. At the next prompt type:
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.
If symha has been entered, the system prompts you to enter a routine:
"Please enter
which routine (0-40) to replace '?' to list),
'a' to add "slhainit" at the end [default],
'n' to do nothing, or 'q' to quit"
Enter the indicated routine number that appears above this message.
Then the system may prompt with another inquiry:
"Please enter
which routine (0-2) to replace '?' to list),
'a' to add "slhapoll" at the end [default],
'n' to do nothing, or 'q' to quit"
Enter the indicated routine number that appears above this message.
e. Continue the installation according to the SCO UNIX documentation.
f. The system automatically creates a UNIX kernel file called unix.safe
during installation. To utilize this UNIX kernel, type after the
"boot:" prompt:
unix.safe
2. Install SCSI device support.
a. Continue from Procedure 2, step 3.
* * * * * * Procedure 2: 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. The system automatically creates a UNIX kernel file called unix.safe
during installation. To utilize this UNIX kernel, type after the
"boot:" prompt:
unix.safe
2. Install your Symbios driver.
a. Insert the Symbios BTLD diskette in the drive and type:
installpkg
Press Enter 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:
slha
for SCO OpenServer Releases 5.0.0 and 5.0.2
symha
for SCO OpenServer Release 5.0.4
Press Enter 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:
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 an additional Symbios host adapter is being added to the SCO UNIX
kernel, the system may prompt 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 then
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.
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 return to step 3b.
h. A prompt appears to create a new kernel. Type y if this is the last
device to be added, or type n if additional devices are to be added.
See step 6, "Rebuilding the Kernel," if you replied y; return to step 3
if you replied n.
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:
slha
for SCO OpenServer
Press Enter.
f. The system prompts for the host adapter that supports the tape drive.
Type the correct host adapter number, and press Enter.
If an additional Symbios host adapter is being added to the SCO UNIX
kernel, the system may prompt 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 then
prompts for the host adapter identifier of the preceding step.
g. 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.
h. The system prompts for the SCSI ID of the tape drive. Type the SCSI ID
number of the tape drive and press Enter.
i. 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.
j. A list appears that shows the special devices created. Press Enter,
and another list appears that shows 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.
k. A prompt appears to create a new kernel. Type y if this is the last
device to be added, or type n if additional devices are to be added.
See step 6, "Rebuilding the Kernel," if you replied y; return to step 3
if you replied n.
5. Adding a SCSI CD-ROM Drive.
Note: If you are not adding a SCSI CD-ROM drive to this system, go to
Step 6.
a. At the command prompt, type:
mkdev cdrom
Press Enter
b. The CD-ROM Configuration Program menu appears. Select option 1 to
install a CD-ROM drive and press Enter.
c. The system prompts to configure the CD-ROM Drive. Type y and press
Enter.
d. 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:
slha
for SCO OpenServer
Press Enter.
e. The system prompts for the host adapter that supports the CD-ROM drive.
Type the correct host adapter number and press Enter.
If an additional Symbios host adapter is being added to the SCO UNIX
kernel, the system may prompt 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 then
prompts for the host adapter identifier of the preceding step.
f. With SCO OpenServer, the system prompts for the bus number of
the CD-ROM. 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.
g. The system prompts for the SCSI ID of the CD-ROM Drive. Type the SCSI
ID number and press Enter.
h. The system prompts for the LUN of the CD-ROM drive. Type the desired LUN
and press Enter, or press Enter for the default value of zero.
i. The system prompts 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 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 CD-ROM
Configuration Program menu. Type q and press Enter to terminate the
CD-ROM Configuration Program menu.
j. A prompt appears to create a new kernel. Type y if this is the last
device to be added, or type n if additional devices are to be added.
See step 6, "Rebuilding the Kernel," if you replied y; return to step 3
if you replied n.
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 "boot:" prompt appears, press Enter and
the new kernel loads.
e. Log in as usual.
* * * * * * * * * * * Troubleshooting * * * * * * * * * *
The following conditions should exist after a successful installation:
The directory etc/conf/sdevice.d should contain a file named slha. 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 entry for each Symbios host
adapter configured in the system.
The second field in the sdevice file should read 'Y'.
A slha entry should appear in the mdevice file.
A slha entry for each configured SCSI device should appear in the
mscsi file.
Directory /etc/conf/pack.d/slha should exist and contain the files Driver.o
and space.c.
The following are some potential problems and their suggested solutions:
* * * Problem * * *
Loading the SCO UNIX kernel to an IDE Hard Drive
* * * Solution * * *
You only need to "link" if you have a SCSI device attached to a Symbios Host
Adapter. Follow the instructions in the SCO UNIX Installation documentation.
Once the installation has completed, then go to Step 2 in Procedure 2 and use
the installpkg to install your Symbios driver.
* * * Problem * * *
A SCSI device is not found.
* * * Solution * * *
a. Reboot and press Cntl C when prompted to view the Configuration Utility
displays.
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 CD-ROM drive is not seen during installation.
* * * Solution * * *
Use the Configuration Utility to check that the CD-ROM 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 CD-ROM drive does not conflict with any
other SCSI device ID.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.