****************************************************************************
SCOOPENSERVER.TXT
*****************************************************************************
INSTALLATION GUIDE FOR THE SDMS SCO OPENSERVER BTLD DRIVER V4.11.00
This file describes the features and use of the SDMS device driver for the
SCO OpenServer 5 operating system environments. These instructions assume that
you are using an LSI Logic host adapter and appropriate SCSI devices. You only need
to "link" the new SDMS device driver if you have an LSI Logic 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
LSI Logic Devices Supported
Description
Installing Your SCO OpenServer Driver
Procedure 1, New System Installation
Installing the SDMS BTLD Driver
Installing SCSI Device Support
Procedure 2, Existing System Installation
Installing the SDMS BTLD Driver
Adding a SCSI Disk Drive
Adding a SCSI Tape Drive
Adding a SCSI CD-ROM
Troubleshooting
Read the information below before proceeding with the installation instructions.
1) The 4.11.00 driver supports all of the OpenServer 5 releases of
SCO UNIX (Releases 5.0.0, 5.0.2, 5.0.4 and 5.0.5).
2) The 4.11.00 driver diskette contains package slha, which is for all
SCO OpenServer 5 releases.
3) Within the text instructions for adding SCSI disk drives, tape
drives, and CD-ROM drives, the system prompts you to check whether
the driver is the default value or enter the exact driver name. The
package name and the driver name are slha.
Note: The current SCO OpenServer drivers can be downloaded from the LSI Logic web
site at http://www.lsilogic.com. After you are connected to this web site,
place your cursor on the Get Drivers option in the menu bar. Click on
the Drivers selection. Choose the SCO OpenServer 5 operating system for
SCSI and click on the Go button. Follow the instructions on subsequent
screens to download the driver.
******************************* Introduction ********************************
SCO OpenServer 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 OpenServer 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 OpenServer kernel. The SDMS Boot Time
Loadable Driver (BTLD) diskette contains the driver for SCO OpenServer 5
in one package and named:
slha
You must link-edit the proper driver into the SCO OpenServer 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 driver permits an easy installation of SCO OpenServer with
the software provided by The Santa Cruz Operation (SCO).
SCO OpenServer 5 provides only one installation diskette, labeled Boot
Disk. This diskette, along with the SDMS BTLD driver diskette, and other
software media, are used during an SCO OpenServer installation.
The slha driver allows SCO OpenServer 5.X operating systems to interface with
SCSI devices connected to the LSI Logic family of chipsets and/or LSI Logic
host adapter cards. Driver 4.11.00 support for the Ultra160 LSI53C1000 and
LSI53C1010 chipsets and Ultra160 host adapter boards.
The following sections provide instructions for configuring the SCO OpenServer
kernel with your SDMS driver, installing SCO OpenServer onto a hard drive, and
adding SCSI peripheral devices. These instructions assume that you are familiar
with UNIX system administration.
* * * * * * * * * * * * Features * * * * * * * * * * *
The BTLD driver supports these features:
o Easy UNIX installation on a hard disk with the SDMS Boot Time Loadable
Driver (BTLD) diskette
o Ultra160 Data Transfers (for LSI53C1010 devices)
o Ultra160 Domain Validation
o Wide and synchronous negotiation (including Fast SCSI/Ultra SCSI/
Ultra2 SCSI)
o Parallel Protocol Request (PPR) negotiation to SCSI-3 devices for
Ultra160 Double Transition <DT> data transmission
o Multiple host adapters
o Disconnect/Reselect
o Multiple and non-contiguous Logical Unit Numbers (LUNs) support
o Dynamic interrupt mapping
o Scatter/Gather
o Wide SCSI
o SCSI pass-through functionality
o Tagged command queuing
o Multiprocessor support
o Target-initiated negotiation
o Automatic drive spinup
o NVRAM and NVS configuration data areas
o Termination control using NVRAM and NVS settings
o RAID up to 1024 byte block sizes
* * * * * * * * LSI Logic Devices Supported * * * * * * * * *
All LSI Logic devices and host adapters have undergone a name change. They
have transitioned from a SYM prefix to an LSI prefix. No name changes have
occurred for the SDMS SCO OpenServer 5 driver.
The BTLD driver supports the following LSI Logic devices and their associated
host adapters:
o LSI53C810, LSI53C810A, LSI53C810AE (LSI8100S, LSI8100ASP, LSI20810)
o LSI53C815 (LSI815XS, LSI8150SP)
o LSI53C825, LSI53C825A (LSI8250S, LSI8251S, LSI8251D, LSI8250ASP, LSI8251ASP,
LSI8251AD)
o LSI53C860, LSI53C860AE (LSI8600SP, LSI20860)
o LSI53C875, LSI53C875E (LSI8750SP, LSI8751SP, LSI8751D)
o LSI53C876 (LSI22801, LSI22802)
o LSI53C885
o LSI53C895, (LSI8951U, LSI8952U)
o LSI53C896 (LSI22910, LSI21002, LSI22902)
o LSI53C895A (LSI8953U)
o LSI53C1510
o LSI53C1000 (LSI20160, LSI20160L)
o LSI53C1010 (LSI22915A, LSI21040, LSI22903, LSI21003)
Note: The current SCO OpenServer driver can be downloaded from the LSI Logic
Web site. After you are connected to this Web site, place your cursor
on the Get Drivers option in the menu bar. Click on the Drivers
selection. Choose the SCO OpenServer 5.X operating system for SCSI
and click on the Go button. Follow the instructions on subsequent
screens to download the driver.
* * * * * * * * * * * * Description * * * * * * * * * *
UNIX installation on a SCSI system requires creation of a SCO OpenServer kernel
that contains the SCSI driver to support SCSI devices. The two possible
installation procedures are:
1. Installing UNIX and the proper SDMS BTLD driver for the first time on
a boot drive.
2. Loading or updating the proper SDMS BTLD driver on a boot drive.
* * * Procedure 1: New System Installation * * *
To perform a new SCO OpenServer installation that includes the proper SDMS
driver, then follow this procedure. Procedure 1 uses a Boot Time Loadable
Driver (BTLD) to provide a user-friendly method for installing SCO OpenServer
onto a hard disk drive.
* * * Procedure 2: Existing System Installation * * *
To attach SCSI devices to an LSI Logic host adapter while using a non-SCSI hard
drive (for example, IDE) as the boot hard drive already containing a SCO OpenServer
system, execution of Procedure 2 is all that is necessary. This procedure
installs the SDMS 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 SDMS driver on a SCSI boot drive.
Each procedure is described in detail below. LSI Logic recommends that you
complete the entire installation in one session. To complete this installation
without interruption, you should have sufficient time (possibly over an hour).
************************ Installing the SCO OpenServer Driver *********************
This section provides installation instructions for new systems.
Procedure 1:
This procedure installs SCO OpenServer onto a hard disk drive. This installation is
necessary to build a new UNIX kernel that includes your SDMS 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 OpenServer Handbook.
1. Link the SDMS BTLD into the UNIX kernel during installation.
a. Insert the SCO OpenServer installation diskette and reboot the system. For
SCO OpenServer 5, 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
Do not remove the diskette. Press Enter.
d. When prompted during the installation, insert either the proper
installation diskette or the SDMS BTLD diskette, and press Enter.
The system may prompt 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 precedes 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 precedes this message.
e. Continue the installation according to the SCO OpenServer documentation.
f. To install SCSI device support, continue from the section on Adding a
SCSI Disk Drive in the instructions for existing system installations.
Note: The SCO OpenServer system automatically creates a unix.safe file during
installation. If you need to return to this initial UNIX kernel due to
problems with subsequent installation procedures, type unix.safe at the
boot prompt.
************************ Installing the SCO OpenServer Driver *********************
This section provides installation instructions on existing systems.
Procedure 2:
This procedure assumes SCO OpenServer is already installed on a hard disk drive.
This installation is necessary to build a new UNIX kernel that includes the
proper LSI Logic host adapter driver. The basic steps for accomplishing
this task are outlined below. For more details on UNIX installation, refer to
the SCO OpenServer System Administrator's Reference Manual.
Note: The SCO OpenServer system automatically created a unix.safe file during
installation. If you need to return to this initial UNIX kernel due to
problems with installation procedures, type unix.safe at the boot prompt.
1. Installing the SDMS driver
a. Insert the SDMS BTLD diskette in the drive and type:
installpkg
Press Enter to continue.
A prompt appears to insert the requested diskette, which has
already been inserted.
b. Press Enter.
A prompt now asks for the name of the package.
c. Type:
slha
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
typing:
/etc/conf/cf.d/link_unix
at the command prompt.
f. The system executes the command and then prompts for a series of
responses to:
1. Do you want this kernel to boot by default (y/n)?
Type: y
Press Enter.
The system backs up the old kernel.
2. Do you want the kernel environment rebuilt (y/n)?
Type: y
Press Enter.
g. Reboot the system to activate the new kernel by typing at the command
prompt:
reboot
Press Enter.
2. Adding a SCSI Disk Drive
Note: If you are not adding a SCSI disk drive to this system, go to step 4.
a. To add a SCSI disk drive, type at the command prompt:
mkdev hd
Press Enter.
The system prompts for the identifier of the host adapter that supports
this device.
b. If the default is correct, press Enter. If the default is
not correct, type:
slha
Press Enter.
The system prompts for the host adapter that supports the disk drive.
c. Type the correct host adapter number and press Enter.
Note: If an additional LSI Logic host adapter is being added to the
SCO OpenServer 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
correctly.
or
Type n and press Enter if you entered the host adapter number
incorrectly.
The system then prompts for the host adapter identifier of the
preceding step.
The system prompts for the SCSI bus number of the disk drive.
LSI Logic host adapters support one bus per adapter.
d. Press Enter to get the default of zero, or type 0 (zero) and press Enter.
The system prompts for the target ID of the disk drive.
e. 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.
The system prompts for the Logical Unit Number (LUN) of the disk drive.
f. Type the desired LUN and press Enter, or press Enter for the default
value of zero.
The system prompts you to update the SCSI Configuration file.
g. Type y and press Enter if the displayed values are correct.
or
Type n if the values are incorrect, and retry from step 3d.
A prompt appears to create a new kernel.
h. Type y if this is the last device to be added.
or
Type n if additional devices are to be added.
i. Go to step 6, "Rebuilding the Kernel," if you replied y; return to step 2
if you replied n.
3. Adding a SCSI Tape Drive
Note: If you are not adding a SCSI tape drive to this system, go to step 5.
a. To add a SCSI tape drive, type at the command prompt:
mkdev tape
Press Enter.
The Tape Drive Configuration Program menu appears.
b. Select option 1 to install a tape drive, and press Enter.
The Tape Drive Installation Menu appears.
c. Select option 1 to install a SCSI tape drive, and press Enter.
The system prompts for the identifier of the host adapter that supports
this device.
d. Press Enter if the default is correct. If the default is not correct,
type:
slha
Press Enter.
The system prompts for the host adapter that supports the tape drive.
e. Type the correct host adapter number, and press Enter.
If an additional LSI Logic host adapter is being added to the SCO OpenServer
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 correctly.
or
Type n and press Enter if you entered the host adapter number incorrectly.
The system then prompts for the host adapter identifier of the
preceding step.
The system prompts for the SCSI bus number of the tape drive. LSI Logic
host adapters support only one bus per adapter.
f. Press Enter to get the default of zero, or type 0 (zero) and
press Enter. Note that dual channel devices appear as two host adapters.
The system prompts for the SCSI ID of the tape drive.
g. Type the SCSI ID number of the tape drive and press Enter.
The system prompts for the LUN of the tape drive.
h. Type 0 (zero) and press Enter.
The system prompts to update the SCSI Configuration file.
i. Type y and press Enter.
The system prompts for a "Vendor Identification" string.
j. Type the desired string or press Enter to use the default value.
The system prompts for a "SCSI version."
k. Type the desired version or press Enter to use the default value.
The system prompts for a "Response Data Format."
l. Type the desired format or press Enter to use the default value.
The system displays the tape drive types that are supported.
m. Type the number of the tape drive type that matches the tape
drive that is being installed and press Enter.
The system displays a list of links to the installed tape and
the current boot string.
n. Type the desired string, "rm" to remove the string, or "q" to
quit and press Enter.
The system displays the SCSI on Enhanced Tape Drive Configuration
menu.
o. Type q and press Enter to terminate this menu.
The system displays the Tape Drive Configuration Program menu.
p. Type q and press Enter to terminate this menu.
The system prompts to create a new kernel.
q. Type y if this is the last device to be added.
or
Type n if additional devices are to be added.
r. Go to step 6, "Rebuilding the Kernel," if you replied y; return to
step 2 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. To add a SCSI CD-ROM drive, type at the command prompt:
mkdev cdrom
Press Enter.
The CD-ROM Configuration Program menu appears.
b. Select option 1 to install a CD-ROM drive and press Enter.
The system prompts to configure the CD-ROM Drive.
c. Type y and press Enter.
The system prompts for the identifier of the host adapter that supports
this device.
d. Press Enter if the default is correct. If the default is incorrect,
type:
slha
Press Enter.
The system prompts for the host adapter that supports the CD-ROM drive.
e. Type the correct host adapter number and press Enter.
If an additional LSI Logic host adapter is being added to the SCO OpenServer
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 correctly.
or
Type n and press Enter if you entered the host adapter number incorrectly.
The system then prompts for the host adapter identifier of the
preceding step.
The system prompts for the SCSI bus number of the CD-ROM. LSI Logic host
adapters support only one bus per adapter.
f. Press Enter to get the default of zero, or type 0 (zero) and press Enter.
The system prompts for the SCSI ID of the CD-ROM Drive.
g. Type the SCSI ID number and press Enter.
The system prompts for the LUN of the CD-ROM drive.
h. Type the desired LUN and press Enter, or press Enter for the default
value of zero.
The system prompts to update the SCSI Configuration file.
i. Type y and press Enter.
A prompt appears to configure a CD-ROM or tape installation device.
j. Unless this is desired, type n and press Enter.
A prompt appears to add a High-Sierra file system.
k. Type y and press Enter.
The system displays the High Sierra/ISO9600 file system Configuration
Program menu.
l. 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.
m. Type q and press Enter to terminate the CD-ROM Configuration Program menu.
A prompt appears to create a new kernel.
n. Type y if this is the last device to be added,
or
Type n if additional devices are to be added.
o. Go to step 6, "Rebuilding the Kernel," if you replied y; return to
step 2 if you replied n.
6. Rebuilding the Kernel
a. To rebuild the kernel, type at the command prompt:
/etc/conf/cf.d/link_unix
b. The system prompts for responses to these messages:
1. Do you want this kernel to boot by default (y/n)?
Type: y
Press Enter.
The system backs up the old kernel.
2. Do you want the kernel environment rebuilt (y/n)?
Type: y
Press Enter.
c. Reboot your system to activate the new kernel. Type the
command:
reboot
Press Enter.
d. After the system reboots and the "boot:" prompt appears, press Enter to
load the new kernel.
e. Log in as usual.
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 LSI Logic 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.
* * * * * * * * * * * Troubleshooting * * * * * * * * * *
Some potential problems and their suggested solutions are:
* * * Problem * * *
Loading the SCO OpenServer kernel to an IDE hard drive
* * * Solution * * *
You only need to "link" if you have a SCSI device attached to an LSI Logic
host adapter. Follow the instructions in the SCO OpenServer Installation
documentation. Once the installation has completed, then go to Step 1 in
Procedure 2 and use "installpkg" to install your SDMS driver.
* * * Problem * * *
A SCSI device is not found.
* * * Solution * * *
a. Reboot and press Cntl C when prompted to view the SCSI BIOS Configuration
Utility displays.
b. Verify the device is on the correct host adapter and ID. 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 * * *
Reinstall the proper SDMS driver using the installpkg utility.
Remember to relink the kernel and then reboot the system.
* * * Problem * * *
The root disk is not found or the partitioning of the disk fails.
* * * Solution * * *
If your boot drive is a SCSI disk, use the SCSI BIOS Configuration Utility
to check that the disk is assigned SCSI ID 0 (zero) and is configured to host
adapter 0 (zero), LUN 0 (zero).
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.