**************************************************************************** UNIXWARE.TXT ***************************************************************************** Installation Guide for the SDMS UnixWare 7 Driver Version 4.24.00. This file describes the features and use of the SDMS Device Driver for the SCO UnixWare 7 operating system environment. This driver is referred to as "C8XX". Note: Use only driver version 4.24.00 for UnixWare 7. If you need support for UnixWare 2.1.x, use driver version 4.08.00. If you need support for UnixWare 2.0.X, use driver version 3.02.00. Either of these drivers can be obtained from LSI Logic's website located at www.lsilogic.com. Introduction Features LSI Logic 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 7 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 C8XX driver allows SCO UnixWare operating systems to interface with SCSI devices connected to the LSI Logic LSI53C8XX and LSI53C1XXX family of chipsets and/or LSI Logic 8XX/1XX host adapter cards. Driver 4.24.00 features support for the Ultra160 LSI53C1010 chipset and the associated host adapter boards. 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 this C8XX driver. Note: Current UnixWare 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 UnixWare operating system for SCSI and click on the Go button. Follow the instructions on subsequent screens to download the driver. * * * * * * * * * * * * Features * * * * * * * * * * * The C8XX driver supports these features: o Ultra160 Data Transfers (for LSI53C1010) o Domain Validation o Parallel Protocol Request (PPR) negotiation to SCSI-3 devices for Ultra160 Double Transition
data transmission o Easy installation using UnixWare tools o Wide and synchronous negotiation (including Fast SCSI/Ultra SCSI/ Ultra2 SCSI) 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 NVRAM and NVS Configuration data areas o Termination Control using NVRAM and NVS settings * * * * * * * * * 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 UnixWare driver. The C8XX driver supports the following devices and their associated LSI Logic 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, LSI8751SPE, LSI8751D) o LSI53C876/876E (LSI22801, LSI22802) o LSI53C885 o LSI53C895, (LSI8951U, LSI8952U) o LSI53C895A (LSI8953U) o LSI53C896 (LSI22910, LSI21002, LSI22902) o LSI53C1010 (LSI8955U, LSI21040, LSI22915, LSI22903) * * * * * * * * * * * * Description * * * * * * * * * * The C8XX driver for SCO UnixWare operating systems is available on a 3.5-inch 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 **************** This section provides installation instructions for new and existing UnixWare systems. * * * * * * * * * New System Installation * * * * * * * * * 1. Boot the computer using the Install diskettes delivered with the UnixWare Operating System media kit. UnixWare 7 has two diskettes. 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. The system loads the required drivers, such as C8XX, and indicates when they are loaded. At the end of the installation, you will see a prompt to reinsert the HBA driver diskette. 4. 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 section titled Troubleshooting for more information if necessary. 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 the C8XX package. The C8XX driver on this diskette is then loaded onto the system. The system will again prompt you to load a driver even if loading was successful. 6. 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 After the C8XX package is loaded, a message may appear that indicates a system reboot is necessary. 9. 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 * * * To utilize the unix.safe kernel file that was created before installing the C8XX host adapter driver, follow these steps. 1. Reboot the system. 2. Wait for the UnixWare 7 Logo screen to appear, then press the space bar to begin an interactive boot session. 3. When the interactive boot prompt appears, type: boot unix.safe The UnixWare 7 Logo screen will reappear. The system will then boot from the UNIX kernel specified above.