UNIXWARE.TXT Driver File Contents (Sdms43.zip)

***************************************************************************** 
                                 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

How To Update Drivers Manually

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.

server: web5, load: 0.58