***************************************************************************** UNIXWARE.TXT ***************************************************************************** Installation Guide For the Symbios SDMS UnixWare Driver V4.08.00 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.08 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. For information on DMI 2.0 for UnixWare, refer to the UWDMI2_0 text file. 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 Troubleshooting ******************************* 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 (GUI), NetWare networking, application compatibility, multi-tasking 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 o Supports target-initiated negotiation o Supports NVRAM and NVS Configuration data areas o Supports Termination Control via NVRAM and NVS settings * * * * * * * * * * * * 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. ******************* Installing the SDMS UnixWare Driver **************** * * * * * Installing the c8xx Driver: New System 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. 6. 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. 7. Remove the driver diskette when prompted to do so and reboot the system. * * * * Installing the c8xx Driver: Existing System Installation * * * * 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 SYM53C8XX 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 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 the 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: more 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 appears 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 Operating System Logo to display, then press the space bar 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.