*****************************************************************************
UNIXWARE.TXT
*****************************************************************************
Installation Guide For the Symbios SDMS UnixWare Driver V4.04.
This file describes the features and use of the Symbios SDMS Device
Driver for the SCO UnixWare 2.1 or later (including UnixWare 7) operating
system environments. It is divided into the following sections:
Note: The 4.04 driver only supports UnixWare 2.1.X and later. If you need
support for UnixWare 2.0.X please use the 3.02.00 driver.
Introduction
Features
Description
How to Install Your SDMS UnixWare Driver
Installing the Driver During UnixWare Installation
Updating UnixWare 2.1 or UnixWare 7 with the c8xx Driver
Loading The Package
Configure for Statically Linked Driver
Configure for Dynamically Loadable Driver
Loading Loadable Module
Rebuild the UnixWare Kernel
Troubleshooting
Driver Installation Fails
******************************* Introduction ********************************
UnixWare 2.1 and UnixWare 7 extends the Unix SVR4.2 operating system, allowing
tight integration with NetWare in an easy to use graphical form. UnixWare
features include a graphical user interface, NetWare networking, application
compatibility, multitasking capability, and multi-user capability. In
addition UnixWare provides multiprocessor support.
The storage device drivers for UnixWare are based on the Portable Device
Interface (PDI) architecture. PDI logically breaks down a driver into a
controller specific portion (c8xx host adapter driver) and a device specific
portion (the target driver). The third component is SDI (the SCSI Device
Interface), a kernel resident driver that interfaces with both the target
driver and host adapters.
The Symbios SDMS c8xx driver allows SCO UnixWare (previously Novell
UnixWare) operating systems to interface with SCSI devices connected to a
Symbios SYM53C8XX chipset and/or Symbios 8XX host adapter cards. The driver can
be statically linked (integrated) or dynamically linked (loadable) with the
kernel. If the driver is integrated with the kernel, then the rebuilt kernel
must reside on the boot drive. The following sections describe the procedures
to install the driver during a first time installation of UnixWare, and to
update already installed UnixWare with the Symbios SDMS c8xx driver.
* * * * * * * * * * * * Features * * * * * * * * * * *
o Allows easy installation using PDI - ID tools.
o Provides synchronous negotiation including Fast SCSI, Ultra SCSI,
and Ultra2 SCSI
o Supports multiple host adapters
o Supports Disconnect/Reselect
o Allows multiple and non-contiguous LUN support
o Supports dynamic interrupt mapping
o Supports scatter/gather
o Wide device support
o Supports SCSI pass-through functionality
o Supports tagged command queuing
o Multiprocessor support
* * * * * * * * * * * * Description * * * * * * * * * *
The Symbios SDMS c8xx driver for SCO UnixWare operating systems is
available on a 3.5 inch floppy diskette labeled PCI SCSI SCO UnixWare.
Use this diskette to load the driver during the installation of the operating
system, or to access the devices on the SCSI bus after a UnixWare
installation. The following sections describe these procedures.
For SCO UnixWare 2.1 and later, the Host Adapter diskette contains the c8xx
driver for use during initial installation of SCO UnixWare. If you have both
the c8xx driver directly from Symbios and also the driver bundled with
the UnixWare Operating System, use the latest release of the c8xx driver.
******************* How to Install Your SDMS UnixWare Driver ****************
* * * * * Installing the Driver During UnixWare Installation * * * *
When performing UnixWare installation, if the computer is set up to boot from
the SCSI bus through a Symbios SYM53C8XX chipset, the driver is automatically
linked statically with the kernel to suit the setup. You must follow the
instructions in the UnixWare Installation Handbook before installing the driver.
1. Boot the computer using the Install diskette delivered with the UnixWare
Operating System distribution package.
2. Follow the instructions on the screen.
3. Insert the SDMS PCI UnixWare driver diskette when prompted to insert the
Host Adapter diskette and press Enter. The message "Please wait while
HBA hardware modules are being loaded" appears.
If you want to install other host adapter drivers, then insert the HBA
diskette provided with the UnixWare distribution package and press Enter.
If there are no other host adapter drivers to install, press F10 to continue
the installation and just follow the instructions.
4. The system loads the required drivers, such as c8xx and indicates when they
are loaded.
5. Continue to follow instructions on the screen or refer to the UnixWare
Installation Handbook to complete installation.
Note: During the installation, if the driver does not find a hard disk on
which to install the operating system, it aborts the process.
5. At the end of the installation you might see a prompt to reinsert the c8xx
driver diskette. Insert the SDMS PCI UnixWare driver diskette and press
Enter.
The kernel is rebuilt, and the system gets ready to boot from the SCSI disk
drive.
6. Remove the driver diskette when prompted to do so and reboot the system.
* * * * * * Updating UnixWare with the c8xx Driver * * * * * * * *
You may install the c8xx driver on a system currently running UnixWare by
using one of three different procedures. The method to use depends on the
setup of your system and on whether you want the system to remain running
during this process. By reviewing the following questions, you can determine
which procedure to follow.
Q: Is your Boot disk a SCSI hard disk on the SCSI bus connected to a Symbios
53C8XX chipset?
If the answer is yes, then you MUST statically link the kernel and reboot
the system. Follow the instructions in sections:
Loading the Package
Configure for Statically Linked driver
Rebuild the UnixWare Kernel
Q: Do you need or desire to install the driver without halting the system?
If the answer is yes, then you want to install the driver as a dynamically
loadable driver. Follow instructions in sections:
Loading the Package
Configure for Dynamically Loadable driver
Loading Loadable module
If the answer is no to the above questions, then follow instructions in
sections:
Loading the Package
Rebuild the UnixWare Kernel
* * * Loading the Package * * *
Before you install the c8xx driver, make a backup copy of the existing
kernel:
1. Log on as root.
2. At the shell prompt type:
cp /stand/unix /stand/unix.safe
Use this copy of the old kernel to reboot the system if the driver
installation fails. Refer to the later section titled Troubleshooting for
more information.
3. Once the old kernel is saved, insert the SDMS PCI UnixWare driver diskette.
4. Load the driver using the pkgadd command by typing:
pkgadd -d /dev/dsk/f0t
-or-
pkgadd -d diskette1
5. Select c8xx and press Enter. The c8xx driver gets loaded on the system.
6. The system again prompts you to load the driver even if loading was
successful. Type q (quit) and press Enter.
7. Verify that the driver is now listed and loaded successfully by typing:
pkginfo c8xx
8. The package information should look like this:
system c8xx Symbios IHV HBA
* * * Configure for Statically Linked Driver * * *
1. Make a backup copy of the c8xx system configuration file as follows:
cd /etc/conf/sdevice.d
cp c8xx /tmp/c8xx.sys
2. Check if System file configured is static. If the file contains the line
"$static", it is configured for static link. To look at this file, type the
following command:
cat c8xx
3. If the System file does not contain the text "$static" on the line
immediately following the "$version" line, add it using a text editor. Do
not include the double quotes.
* * * Configure for Dynamically Loadable Driver * * *
1. Make a backup copy of the c8xx system configuration file as follows:
cd /etc/conf/sdevice.d
cp c8xx /tmp/c8xx.sys
2. Remove the "$static" line from the c8xx file using a text editor, or by
typing the following commands:
grep -v '$static' c8xx > /tmp/c8xx.tmp
mv /tmp/c8xx.tmp c8xx
3. Configure the loadable driver into the system as follows:
/etc/conf/bin/idbuild -M c8xx
* * * Loading the Loadable Module * * *
1. Once the loadable driver is configured into the system, your driver is
ready to load into the running system using the modadmin command as
follows:
modadmin -l c8xx
Note: When the driver is loaded, it scans the SCSI bus and displays the
devices found on it. An integer module-id used to identify the c8xx
driver is displayed on the screen when loading completes.
2. To access the devices on the SCSI bus, create the entries into the device
table using pdi commands as follows:
cd /etc/scsi
./pdimkdev -ifS
./pdimkdtab -ifS
The system is now ready to use.
* * * Rebuilding the UnixWare Kernel * * *
1. Reboot the system. When the c8xx package is loaded, it sets a system flag
to automatically rebuild the kernel upon the next system boot. To reboot,
type the following commands:
cd /
init 6
During the boot process the driver scans the SCSI bus and lists the devices
found on it. If the kernel panics during boot, then reboot the system with
the saved copy of the old kernel. Booting from the saved copy of the kernel
is described in the following section titled Troubleshooting. If the reboot
is successful, the system is ready to use.
* * * * * * * * * * Troubleshooting * * * * * * * * * *
* * * Problem * * *
Driver Installation Fails.
* * * Solution * * *
a. Replace the system Unix with the backup copy you created before
attempting to install the c8xx host adapter driver. To perform this
task, reboot the system.
b. Wait for the "Booting UnixWare ..." prompt and the subsequent beep,
then press the space bar key to begin an interactive boot session.
c. When the [boot#] prompt is displayed:
If the system is UnixWare 2.1.x, type:
KERNEL=unix.safe
go
If the system is UnixWare 7, type:
boot=unix.safe
d. The Operating System logo and "Booting UnixWare..." reappears. Then
the system starts booting from the Unix kernel you specified in the
previous step.
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.