File Name: SYMMPIUW.TXT LSI Logic Fusion-MPT (TM) Driver for SCO OpenServer 5 CONTENTS --------- 1.0 Overview 2.0 Change history 3.0 Installation and setup instructions 4.0 Configuration information 5.0 Unattended mode 6.0 Web sites and support phone number 7.0 Trademarks and notices 8.0 Disclaimer 1.0 Overview: This file describes the features and use of the LSI Logic Fusion-MPT lsil device driver for the SCO OpenServer 5 operating system environment. The package name and the driver name are "lsil." The 1.02.00 driver supports all of the OpenServer 5 releases of SCO UNIX (Releases 5.0.0, 5.0.2, 5.0.4, 5.0.5 and 5.0.6). The 1.02.00 driver diskette contains the package "lsil," which is the package for all SCO OpenServer 5 releases. Within the text instructions for adding SCSI disk drives, tape drives, and CD-ROM drives, the system prompts the user to check if the driver is the default value or enter the exact driver name. The package name and the driver name are lsil. 1.1 Overview about this code: None. 1.2 Limitations: None. 1.3 Enhancements: The lsil driver supports these features: o Provides easy UNIX installation on a hard disk with the lsil Boot Time Loadable Driver (BTLD) diskette o Supports Domain Validation o Supports multiple host adapters o Provides multiprocessor support 1.4 Level of recommendations and prerequisites for the Update: None. 1.5 Dependencies: None. 2.0 Change history -------------------- New release. 3.0 Installation and Setup Instructions ----------------------------------------- 3.1.0 Introduction for SCO OpenServer 5 SCO UNIX is the first UNIX operating system licensed for IBM-compatible microcomputers. The integrated communications, file system, international application support, and documentation create an ideal platform for those requiring a full-featured, UNIX-based operating system. SCO UNIX takes full advantage of the capabilities of the 80386 and above microprocessors. To connect SCSI devices to one or more host adapters, you must place the proper host adapter driver in the SCO UNIX kernel. The lsil Boot Time Loadable Driver (BTLD) diskette contains one package: lsil contains the driver for SCO OpenServer 5 You must link-edit the proper driver into the SCO UNIX kernel. The kernel must reside on the boot drive: either an internal, non-SCSI hard drive or a SCSI hard drive attached to host adapter 0 with SCSI ID 0 and LUN 0. The BTLD permits an easy installation of SCO UNIX with the software provided by SCO. SCO OpenServer 5 provides only one installation diskette, labeled Boot Disk. This diskette, the lsil BTLD driver diskette, and other software media are used during an SCO OpenServer 5 installation. The lsil driver allows SCO OpenServer 5 operating systems to interface with SCSI devices connected to the LSI53C1030 and LSI53C1020 chipsets. The following sections provide instructions for configuring the SCO UNIX kernel with the lsil driver, installing SCO UNIX onto a hard drive, and adding SCSI peripheral devices. These instructions assume that you are familiar with UNIX system administration. 3.1.1 Features The lsil driver supports these features: o Provides easy UNIX installation on a hard disk with the lsil Boot Time Loadable Driver (BTLD) diskette o Supports Domain Validation o Supports multiple host adapters o Provides multiprocessor support 3.1.2 LSI Logic devices supported The lsil driver supports the following devices and their associated LSI Logic host adapters: o LSI53C1030 o LSI53C1020 3.2.0 Installing the mpt driver UNIX installation on a SCSI system requires creation of a SCO UNIX kernel that contains the driver to support LSI Logic SCSI devices. The two possible installation procedures are: 1. Installing UNIX and the proper lsil driver for the first time on a boot drive. 2. Loading or updating the proper lsil driver on a boot drive. To perform a new SCO UNIX installation that includes the proper lsil driver, then follow Procedure 1. This procedure uses a BTLD to provide a user-friendly method for installing SCO UNIX onto a hard disk drive. To attach devices to a LSI Logic host adapter while using a non-SCSI hard drive as the boot hard drive already containing a SCO UNIX system, follow Procedure 2. This procedure installs the lsil driver on the non-SCSI boot drive. Some of the devices supported include tape drives, CD-ROM drives, and hard disk drives used as secondary storage. Use this procedure to replace a previously installed lsil driver. Each procedure is described in detail below. You should complete the entire installation in one session. To complete this installation without interruption, you should have sufficient time (possibly over an hour). 3.2.1 Building the SCO OpenServer BTLD diskette To create a BTLD diskette for SCO OpenServer 5 installations, copy the raw dd image file onto a 1.44 Mbyte diskette. Insert a 3.5-inch blank diskette into the floppy drive. At the UNIX prompt, type: dd if=// of=/dev/fd0 The represents the directory where you copied the image file. The represents the filename of the image file. This command will dd the image to the blank diskette to create a BTLD diskette. 3.2.2 New system installation This procedure installs SCO UNIX onto a hard disk drive. This installation is necessary to build a new UNIX kernel that includes your lsil driver. During installation, you are given the option of retaining current partitions on the root hard disk. For instance, you could have a DOS partition or a user UNIX partition already established on the drive. For more details on UNIX installation, refer to the SCO OpenServer Handbook. 3.2.2.1 Insert the SCO UNIX installation diskette and reboot the system. For SCO OpenServer 5, this diskette is labeled Boot Disk. 3.2.2.2 At the "boot:" prompt, type: link Press Enter. 3.2.2.3 At the next prompt, type: lsil Do not remove the diskette. Press Enter. 3.2.2.4 When prompted during the installation, insert either the proper installation diskette or the lsil BTLD diskette, and press Enter. The system may prompt you to enter a routine: "Please enter which routine (0-40) to replace '?' to list), 'a' to add "lsilinit" at the end [default], 'n' to do nothing, or 'q' to quit" Enter the indicated routine number that proceeds this message. Then, the system may prompt with another inquiry: "Please enter which routine (0-2) to replace '?' to list), 'a' to add "lsilpoll" at the end [default], 'n' to do nothing, or 'q' to quit" Enter the indicated routine number that proceeds this message. 3.2.2.5 Continue the installation according to the SCO UNIX documentation. 3.2.2.6 The SCO OpenServer 5 system automatically creates a file, unix.safe, during installation. To access this UNIX kernel, type after the "boot:" prompt: unix.safe 3.2.2.6 Install SCSI device support by continuing from section 3.2.4 3.2.3 Existing system installation This procedure assumes SCO UNIX is already installed on a hard disk drive. This installation is necessary to build a new UNIX kernel that includes the proper LSI Logic host adapter driver. The basic steps for accomplishing this task are outlined below. For more details on UNIX installation, refer to the SCO UNIX System Administrator's Reference Manual. 3.2.3.1 The SCO OpenServer 5 system automatically creates a file, unix.safe, during installation. To access this UNIX kernel, type after the "boot:" prompt: unix.safe 3.2.3.2 Insert the lsil BTLD diskette in the drive and type: installpkg Press Enter to continue. 3.2.3.3 A prompt appears to insert the requested diskette. Since the BTLD diskette is already inserted, press Enter. 3.2.3.4 A prompt now asks for the name of the package. Type: lsil Press Enter to continue. 3.2.3.5 If a driver is already present from a previous installation, a prompt inquires about replacing it. Press "y" for yes. 3.2.3.6 Once the install package (installpkg) has completed, relink the kernel by typing: /etc/conf/cf.d/link_unix at the command prompt. 3.2.3.7 The system executes the command and then prompts for a series of responses to: 1. Do you want this kernel to boot by default (y/n)? Type: y Press Enter. The system backs up the old kernel. 2. Do you want the kernel environment rebuilt (y/n)? Type: y Press Enter. 3.2.3.8 To activate the new kernel, you must restart the system. At the command prompt, type: reboot Press Enter. 3.2.3.9 Install SCSI device support by continuing from section 3.2.4 3.2.4 Continuing installation 3.2.4.1 Adding a SCSI Disk Drive Note: If you are not adding a SCSI or Fibre Channel disk drive to this system, go to step 3.2.4.9. At the command prompt, type: mkdev hd Press Enter. 3.2.4.2 The system prompts for the identifier of the host adapter that supports this device. If the default is correct, press Enter. If the default is not correct, type: lsil Press Enter. 3.2.4.3 The system prompts for the host adapter that supports the disk drive. Type the correct host adapter number and press Enter. If an additional LSI Logic controller is being added to the SCO UNIX kernel, the system may prompt if you want to update the link-kit (add another host adapter). Type y and press Enter. If you entered the host adapter number incorrectly, type n, and press Enter. The system then prompts for the host adapter identifier of the preceding step. 3.2.4.4 With SCO OpenServer 5, the system prompts for the bus number of the disk drive. Since LSI Logic host adapters support only one bus per adapter, press Enter to get the default of zero, or type 0 (zero) and press Enter. 3.2.4.5 The system prompts for the target ID of the disk drive. Type the ID number of the disk drive and press Enter. 3.2.4.6 The system prompts for the Logical Unit Number (LUN) of the disk drive. Type the desired LUN and press Enter, or press Enter for the default value of zero. 3.2.4.7 The system prompts you to update the Configuration file. Type y and press Enter if the displayed values are correct. Type n if the values are incorrect, and retry from step 3.2.4.4. 3.2.4.8 A prompt appears to create a new kernel. Type y if this is the last device to be added, or type n if additional devices are to be added. Go to step 3.2.4.31, "Rebuilding the Kernel," if you replied y; return to step 3.2.4.1 if you replied n. 3.2.4.9 Adding a Tape Drive Note: If you are not adding a tape drive to this system, go to step 3.2.4.20. At the command prompt, type: mkdev tape Press Enter. 3.2.4.10 The Tape Drive Configuration Program menu appears. Select option 1 to install a tape drive, and press Enter. 3.2.4.11 The Tape Drive Installation Menu appears. Select option 4 to install a tape drive, and press Enter. From the next list, select the type of tape drive to install, and press Enter. 3.2.4.12 The system prompts to configure the tape drive. Type y and press Enter. 3.2.4.13 The system prompts for the identifier of the host adapter that supports this device. If the default is correct, press Enter. If the default is not correct, type: lsil Press Enter. 3.2.4.14 The system prompts for the host adapter that supports the tape drive. Type the correct host adapter number, and press Enter. If an additional LSI Logic controller is being added to the SCO UNIX kernel, the system may prompt if you want to update the link-kit (add another host adapter). Type y and press Enter. If you entered the host adapter number incorrectly, type n, and press Enter. The system then prompts for the host adapter identifier of the preceding step. 3.2.4.15 With SCO OpenServer 5, the system prompts for the bus number of the tape drive. Since LSI Logic host adapters support only one bus per adapter, press Enter to get the default of zero, or type 0 (zero) and press Enter. 3.2.4.16 The system prompts for the ID of the tape drive. Type the ID number of the tape drive and press Enter. 3.2.4.17 The system prompts for the LUN of the tape drive. Type 0 (zero) and press Enter. The system then prompts to update the Configuration file. Type y and press Enter. 3.2.4.18 A list appears that shows the special devices created. Press Enter, and another list appears that shows the links to the installed tape drive. When prompted for a boot string, type q and press Enter to return to the Tape Drive Configuration Program menu. Type q and press Enter to terminate the Tape Drive Configuration Program menu. 3.2.4.19 A prompt appears to create a new kernel. Type y if this is the last device to be added, or type n if additional devices are to be added. Go to step 3.2.4.31, "Rebuilding the Kernel," if you replied y; return to step 3.2.4.1 if you replied n. 3.2.4.20 Adding a CD-ROM Drive Note: If you are not adding a CD-ROM drive to this system, go to Step 3.2.4.31. 3.2.4.21 At the command prompt, type: mkdev cdrom Press Enter. 3.2.4.22 The CD-ROM Configuration Program menu appears. Select option 1 to install a CD-ROM drive and press Enter. 3.2.4.23 The system prompts to configure the CD-ROM Drive. Type y and press Enter. 3.2.4.24 The system prompts for the identifier of the host adapter that supports this device. If the default is correct, press Enter. If the default is not correct, type: lsil Press Enter. 3.2.4.25 The system prompts for the host adapter that supports the CD-ROM drive. Type the correct host adapter number and press Enter. If an additional LSI Logic host adapter is being added to the SCO UNIX kernel, the system may prompt if you want to update the link-kit (add another host adapter). Type y and press Enter. If you entered the host adapter number incorrectly, type n, and press Enter. The system then prompts for the host adapter identifier of the preceding step. 3.2.4.26 With SCO OpenServer 5, the system prompts for the bus number of the CD-ROM. Since LSI Logic host adapters support only one bus per adapter, press Enter to get the default of zero, or type 0 (zero) and press Enter. 3.2.4.27 The system prompts for the ID of the CD-ROM Drive. Type the ID number and press Enter. 3.2.4.28 The system prompts for the LUN of the CD-ROM drive. Type the desired LUN and press Enter, or press Enter for the default value of zero. 3.2.4.29 The system prompts to update the Configuration file. Type y and press Enter. A prompt appears to configure a CD-ROM/TAPE installation device. Unless this is desired, type n and press Enter. A prompt appears to add a High-Sierra file system. Type y and press Enter. The system displays the High Sierra/ISO9600 file system Configuration Program menu. Select option 1 to add High-Sierra and press Enter. The system updates the configuration file and returns to the CD-ROM Configuration Program menu. Type q and press Enter to terminate the CD-ROM Configuration Program menu. 3.2.4.30 A prompt appears to create a new kernel. Type y if this is the last device to be added, or type n if additional devices are to be added. Go to step 3.2.4.31, "Rebuilding the Kernel," if you replied y; return to step 3.2.4.1 if you replied n. 3.2.4.31 Rebuilding the Kernel To rebuild the kernel, type: /etc/conf/cf.d/link_unix 3.2.4.32 The system displays will prompt for responses to these messages: 1. Do you want this kernel to boot by default (y/n)? Type: y Press Enter. The system backs up the old kernel. 2. Do you want the kernel environment rebuilt (y/n)? Type: y Press Enter. 3.2.4.33 To activate the new kernel, you must restart the system. Type the command: reboot Press Enter. 3.2.4.34 After the system reboots and the "boot:" prompt appears, press Enter to load the new kernel. 3.2.4.35 Log in as usual. 3.3.0 Troubleshooting The following conditions should exist after a successful installation: The directory etc/conf/sdevice.d should contain a file named lsil. This file contains the sdevice entries. The directory etc/conf/cf.d contains files sdevice, mdevice, and mscsi. Files sdev.hdr and mdev.hdr describe the values of the possible field entries in the files sdevice and mdevice, respectively. The sdevice file should contain an lsil entry for each LSI Logic host adapter configured in the system. The second field in the sdevice file should read 'Y'. An lsil entry should appear in the mdevice file. An lsil entry for each configured device should appear in the mscsi file. Directory /etc/conf/pack.d/lsil should exist and contain the files Driver.o and space.c. Some potential problems and their suggested solutions are: 3.3.1 Difficulty loading the SCO UNIX kernel to an IDE hard drive You only need to "link" if you have a device attached to an LSI Logic controller. Follow the instructions in the SCO UNIX Installation documentation. Once the installation has completed, then go to Step 3.2.3.2 and use "installpkg" to install your lsil driver. 3.3.2 A device is not found. Reboot and press Cntl C when prompted to view the LSI Logic Configuration Utility displays. Verify the device is on the correct host adapter and ID. If the device is not shown, then it is probably turned off or a cabling problem exists. 3.3.3 UNIX system behaves unreliably after a configuration change. Whenever the hardware or software configuration is altered, you must rebuild the kernel. Use the directory /etc/conf/cf.d and type: ./link_unix to rebuild the kernel. 3.3.4 An error message occurs during the rebuild of the kernel. Reinstall the proper lsil driver using the installpkg utility. Remember to relink the kernel and then reboot the system. 3.3.5 The root disk is not found or the partitioning of the disk fails. If your boot drive is a disk, use the BIOS Configuration Utility to check that the disk is assigned ID 0 and is configured to host adapter 0, LUN 0. 4.0 Configuration Information ------------------------------- 4.1 Include any configuration installation: None. 4.2 Configuration Settings: None. 4.3 Hardware Status and Information: None. 5.0 Unattended Mode ------------------------------- 5.1 Steps for unattended mode: None. 6.0 WEB Sites and Support Phone Number ---------------- 6.1 IBM Support Web Site: http://www.ibm.com/pc/support 6.2 IBM Support Telephone Numbers: http://www.ibm.com/planetwide/ 7.0 Trademarks and Notices ---------------------------- 7.1 The following terms are trademarks of the IBM Corporation in the United States or other countries or both: IBM 7.2 Intel trademarks or registered trademarks are trademarks of Intel Corporation. Microsoft and Windows 2000 are trademarks of Microsoft Corporation in the United States, other countries, or both. 7.3 Other company, product, and service names may be trademarks or service marks of others. 8.0 Disclaimer ---------------------------- 8.1 THIS DOCUMENT IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE AND MERCHANTABILITY WITH RESPECT TO THE INFORMATION IN THIS DOCUMENT. BY FURNISHING THIS DOCUMENT, IBM GRANTS NO LICENSES TO ANY PATENTS OR COPYRIGHTS. 8.2 Note to Government Users Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule Contract with IBM Corporation.