***************************************************************************** UNIXWARE.TXT ***************************************************************************** Installation Guide for SDMS UnixWare 2.1.x Driver Version 4.08.00 This file describes the features and use of SDMS Device Drivers for the SCO UnixWare 2.1.x operating system environment. It is divided into the following sections: Note: The 4.08.00 driver only supports UnixWare 2.1.x. If you need support for UnixWare 2.0.X, please use the 3.02.00 driver, which can be obtained from LSI Logic's website located at www.lsilogic.com. Introduction Features Symbios Devices Supported Description How to Install Your SDMS UnixWare Driver Installing the c8xx Driver During UnixWare Installation Updating UnixWare with the c8xx Driver Troubleshooting ******************************* Introduction ******************************** UnixWare 2.1.x extends the Unix SVR4.2 operating system. UnixWare features include a graphical user interface (GUI), networking, application compatibility, multitasking capability, and multi-user capability. Additionally, UnixWare provides multiprocessor support. The SDMS c8xx driver allows SCO UnixWare operating systems to interface with SCSI devices connected to the Symbios SYM53C8XX family of chipsets and/or Symbios 8XX host adapter cards. The following sections describe the procedures to install the driver during a first time installation of UnixWare, and to update a previously installed UnixWare with the SDMS c8xx driver. * * * * * * * * * * * * Features * * * * * * * * * * * o Allows easy installation using UnixWare tools o Provides wide and synchronous negotiation (including Fast SCSI/Ultra SCSI/ Ultra2 SCSI) o Supports multiple host adapters o Supports disconnect/reselect o Allows multiple and non-contiguous Logical Unit Numbers (LUNs) support o Supports dynamic interrupt mapping o Supports scatter/gather o Supports wide SCSI o Supports SCSI pass-through functionality o Supports tagged command queuing o Provides multiprocessor support o Supports target-initiated negotiation o Supports NVRAM and NVS Configuration data areas o Supports Termination Control using NVRAM and NVS settings * * * * * * * * * Symbios Devices Supported * * * * * * * * The SDMS C8XX driver supports the following devices and Symbios host adapters based on those devices: o SYM53C810, SYM53C810A, SYM53C810AE (SYM8100S, SYM8100ASP) o SYM53C815 (SYM815XS, SYM8150SP) o SYM53C825, SYM53C825A (SYM8250S, SYM8251S, SYM8251D, SYM8250ASP, SYM8251ASP, SYM8251AD) o SYM53C860, SYM53C860AE (SYM8600SP) o SYM53C875, SYM53C875E (SYM8750SP, SYM8751SP, SYM8751D) o SYM53C876 (SYM22801, SYM22802) o SYM53C885 o SYM53C895, (SYM8951U, SYM8952U) o SYM53C896, (SYM22910, SYM21002) * * * * * * * * * * * * Description * * * * * * * * * * The 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. The installation media kit includes a host adapter diskette. This diskette also contains a bundled c8xx driver. If you have both a c8xx diskette directly from LSI Logic and the host adapter diskette from the media kit, use the latest release of the c8xx driver by inserting its diskette first when host adapter diskettes are requested during installation. ******************* Installing the SDMS UnixWare c8xx Driver **************** * * * * * * * * * New System Installation * * * * * * * * * 1. Boot the computer using the Install diskette delivered with the UnixWare Operating System media kit. With UnixWare 2.1.x, there is one diskette. 2. Follow the instructions on the screen. 3. Insert the PCI SCSI SCO UnixWare driver diskette when prompted to insert a host adapter diskette. To install other host adapter drivers, then insert the host adapter diskette provided with the UnixWare media kit when requested. If there are no other host adapter drivers to install, continue the installation. 4. The system loads the required drivers, such as c8xx, and indicates when they are loaded. 5. At the end of the installation you will see a prompt to reinsert the HBA driver diskette. Insert the PCI SCSI SCO UnixWare driver diskette and press Enter. The kernel will be built and the installation will terminate. 6. Remove the driver diskette when prompted to do so and reboot the system. * * * * * * * * * Existing System Installation * * * * * * * * * * * Adding or Updating the c8xx 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 if this is needed. 3. Once the old kernel is saved, insert the PCI SCSI SCO UnixWare driver diskette. 4. Load the driver using the pkgadd command by typing: pkgadd -d diskette1 5. Select c8xx package. The c8xx driver on this diskette is then loaded onto the system. 6. The system will again prompt you to load a driver even if loading was successful. Type q (quit) and press Enter. 7. Verify that the driver is now loaded successfully by typing: pkginfo c8xx 8. The package information should look like this: system c8xx Symbios IHV HBA 9. After the c8xx package is loaded, a message indicating a system reboot is necessary may appear. To reboot, type this command: 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 next section titled Troubleshooting. If the reboot is successful, the system is ready to use. * * * * * * * * * * Troubleshooting * * * * * * * * * * * * * Problem * * * Driver Installation Fails. * * * Solution * * * You will need to utilize the unix.safe kernel file that was created before installing the c8xx host adapter driver. a. Reboot the system. b. Wait for the Operating System Logo to appear, then press the space bar to begin an interactive boot session. c. When the interactive boot prompt appears, type: KERNEL=unix.safe go d. The operating system logo will reappear. The system will then boot from the Unix kernel specified above.