******************************************************************************* UNIXWARE.TXT ******************************************************************************* INSTALLATION GUIDE FOR THE SYMBIOS LOGIC SDMS UNIXWARE DRIVER Ver4.01 This file describes the features and use of the Symbios Logic SDMS Device Drivers for the Novell UnixWare 2.0x and the more recent SCO UnixWare 2.xx operating system environments. It is divided into the following sections: Introduction Features Description How to Install Your SDMS UnixWare Driver Installing the Driver During UnixWare Installation Updating UnixWare 2.xx 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.xx 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 2.xx 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 Logic SDMS C8xx driver allows SCO UnixWare (previously Novell UnixWare) operating systems to interface with SCSI devices connected to a Symbios Logic 53C8xx chipset and/or Symbios Logic 8xxxx 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 Logic SDMS C8xx driver. **** Features **** Allows easy installation using PDI - ID tools. Provides synchronous negotiation including Fast SCSI, Ultra SCSI (Fast-20) and Ultra-2 SCSI (Fast-40) Supports multiple host adapters Supports Disconnect/Reselect Allows multiple and non-contiguous LUN support Supports dynamic interrupt mapping Supports scatter/gather Wide device support Supports SCSI pass-through functionality Supports tagged command queuing Multiprocessor support **** Description **** The Symbios Logic SDMS C8xx driver for SCO UnixWare operating systems is available on a 3.5 inch floppy diskette labeled SDMS PCI UnixWare (2.x). 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. In addition, 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 Logic 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 Logic 53C8xx 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. When the driver is loaded, a message "C8xx driver is loaded" appears on the screen. If you want to install other host adapter drivers, then insert the IHV HBA diskette provided with the UnixWare distribution package and press Enter. 4. 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 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 2.xx 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 Logic 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. To do so: 1. Log on as root. 2. At the shell prompt type cp /stand/unix /stand/unix.good 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 as follows: pkgadd -d /dev/dsk/f0t 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 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 Logic 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 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. * Rebuild 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 ******************************* DRIVER INSTALLATION FAILS. 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, type: KERNEL=unix.good go d. The Operating System logo and "Booting UnixWare..." reappears. Then the system starts booting from the unix kernel you specified in the previous step.