***************************************************************************** lsimptsl.txt ***************************************************************************** Installation Guide for the LSI Logic Fusion-MPT (TM) SCSI Solaris Driver, Version 5.04.00. This file describes the features and use of the Fusion-MPT device driver for the Solaris 8 Operating system. It is divided into the following sections: Introduction Features LSI Logic Controllers Supported Description Creating the LSImptsl Driver Diskette Installing the Fusion-MPT Solaris Driver New System Installation Existing System Installation Troubleshooting ******************************* Introduction ******************************** Solaris 8 for x86 is an operating system designed to run on single or multiple processors. It provides a command line interface environment and a graphical environment that incorporates many high level features. Refer to the Sun Microsystems documentation web site, http://docs.sun.com, for further details. This Fusion-MPT driver package, LSImptsl, allows the Solaris operating system to interface with Fibre Channel hard disk drives connected to LSI Logic LSIFC909 and LSIFC929 controller chips. A list of features associated with this driver along with its description are described below. The procedures to install the LSImptsl driver package during a new installation of Solaris or to update the driver package on an existing installation of Solaris are also included. These instructions assume that you have already created an LSImptsl driver diskette. =============================================================================== ******************************************************************************* IMPORTANT: This software has been tested on Solaris 8 07/01 and 10/01 releases. LSI Logic assumes no responsibility or liability when a user attempts to use this software with versions of Solaris that LSI Logic has not tested. ******************************************************************************* =============================================================================== * * * * * * * * * * * * * Features * * * * * * * * * * * The LSImptsl driver package supports these features: o 1 Gbaud Fibre Channel data transfers (100 Mbytes/s) o 2 Gbaud Fibre Channel data transfers (200 Mbytes/s; LSIFC929 only) o Ultra320 SCSI (320 Mbytes/s) o Multiple host adapters o Multiple and non-contiguous Logical Unit Number (LUN) support o Scatter/gather o Tagged command queuing o Multiprocessor safe * * * * * * * * LSI Logic Controllers Supported * * * * * * * * The LSImptsl driver package supports the following controller and LSI Logic host adapters based on those devices: o LSIFC909 single port 1 Gbaud Fibre Channel controller o LSIFC919 single port 2 Gbaud Fibre Channel controller o LSIFC929 dual port 2 Gbaud Fibre Channel controller o LSI53C1020 single channel Ultra320 SCSI controller o LSI53C1030 dual channel Ultra320 SCSI controller * * * * * * * * * * * * * Description * * * * * * * * * * The Fusion-MPT LSImptsl driver package is designed to Sun Microsystems SCSA specifications for device drivers. This driver allows connection of Fibre Channel hard disk drives to PCI-based machines. LSImptsl is a Solaris 8 32-bit driver package for the LSI Logic LSIFC909 and LSIFC929 Fibre Channel and LSI53C1020 and LSI53C1030 SCSI controller chips. *********************Installing the Fusion-MPT Solaris Driver****************** This section provides installation instructions for new and existing systems. The LSImptsl driver diskette can be used in one of two ways: 1. To use new drivers to install or upgrade the Solaris operating environment on a machine with new hardware. -OR- 2. To add new drivers to support new hardware on an already installed and booted system. * * * * * * * New System Installation for Solaris * * * * * * * To use the driver on the LSImptsl driver diskette to install Solaris (Intel Platform Edition) on a machine, follow the steps below. If you boot from a Solaris Device Configuration Assistant Diskette, make sure you use the diskette appropriate for the release of Solaris 8 that you are installing. 1. You may start your installation by booting from the Solaris Device Configuration Assistant Diskette or, if your system supports booting from CD-ROMs, the Solaris 8 Installation or Software CD-ROM. Insert the boot media into the drive appropriate for the media type and boot the machine. For network installation, verify with your system administrator that the Solaris Network Installation image is available on your network. 2. Turn on your machine if it is not already on. 3. When the Solaris Device Configuration Assistant screen appears, choose F4_Add Driver. The message Enumerating buses ... appears. Then, the Install Driver Update screen appears. 4. If you booted from the Solaris Device Configuration Assistant Diskette, remove it from the diskette drive and insert the first Solaris Driver ITU diskette you want. 5. Press F2_Continue. The Select Solaris System Version screen appears. 6. Select the appropriate Solaris operating system, and press F2_Continue. The Loading Driver Update Software screen appears, along with a progress bar that shows the percentage of drivers that have been extracted from the diskette. Drivers are read into memory and survive long enough for the system to successfully boot to its installation program. When all the new drivers on the diskette have been processed, the Continue Driver Update Installation screen appears. 7. Remove the Solaris Driver ITU diskette from the diskette drive and insert the next Solaris Driver ITU diskette you want, if any. 8. Press F2_Continue. The Loading Driver Update Software screen appears, along with a progress bar that shows the percentage of drivers that have been extracted from the diskette. Drivers are read into memory and survive long enough for the system to successfully boot to its installation program. When all the new drivers on the diskette have been processed, the Continue Driver Update Installation screen appears. 9. Repeat Step 4 through Step 8 until all the Solaris Driver ITU diskettes you want are installed. 10. When all the drivers are processed, remove the Solaris Driver ITU diskette from the diskette drive and, if you booted from the Solaris Device Configuration Assistant Diskette, reinsert it into your diskette drive. IMPORTANT: Do not remove the Solaris Device Configuration Assistant Diskette from the diskette drive until you see the following message displayed in a dialog box: "If you want to bypass the device configuration and boot screens when the system reboots, eject the Device Configuration Assistant/Boot diskette now." 11. Press F2_Continue. The Solaris Device Configuration Assistant screen appears. 12. Press F2_Continue. The "Enumerating buses" message appears. The Scanning Devices screen is then displayed. System devices are scanned. When scanning is complete, the Identified Devices screen appears. 13. Press F2_Continue. The message "Loading driver ..." appears followed by messages about the drivers that are required to boot your system. After a few seconds, the Boot Solaris screen appears. 14. At the Boot Solaris screen, select the device controller attached to the device that contains your install medium. 15. Press F2_Continue. Drivers for the device controller that you selected are displayed. Your system boots to run the install program. The install program starts and your machine begins booting the complete Solaris operating environment. The following messages appear some time later, and prompt the user to insert each of the Solaris Driver ITU diskette(s) required to install into your machine: Installing unbundled device driver support Extracting driver list from tree.. driver-name... Please insert the Driver Update diskette labeled Press when ready. 16. Remove the Solaris Device Configuration Assistant Diskette. Reinsert the LSImptsl Driver ITU diskette that you inserted earlier into the diskette drive. 17. Press Enter. Packages and/or patches that contain the new drivers are installed from the diskette onto your machine. Messages about each installation appear accordingly. o When the following prompt appears: Please insert the Driver Update diskette labeled Press when ready. Insert the LSImptsl Driver ITU diskette into the floppy drive. When the prompt asking if you wish to create a new instance of the LSImptsl package appears, respond with 'n' for NO. When the prompt asking if you wish to overwrite the existing instance of LSImptsl appears, respond with 'y' for YES. 18. If drivers on other Solaris Driver ITU diskettes are required, remove the Driver ITU diskette from the diskette drive, insert the next Driver ITU diskette when prompted to insert it, press Enter, and repeat this process until all drivers you need are installed. 19. Press Enter. When installation has completed, the message "Installation complete" appears. 20. Remove the diskette from the diskette drive. 21. Reboot your machine. When the Solaris operating environment is finished booting and running, the new devices whose drivers that you installed are available for use. * * * * * * Existing System Installation for Solaris * * * * * * * Before adding new or updated drivers, the newly supported hardware devices should be installed and configured according to the instructions in the corresponding Device Reference Page, if any. See the Device Reference Manual for Solaris (Intel Platform Edition). When the Solaris Intel Platform Edition software is already installed, the simplest way to add new or updated drivers is to install the Driver ITU diskettes as patches on your system. For more information about managing diskettes and drives, see the System Administration Guide. To add new or updated drivers, follow these steps: 1. Go to the root directory. 2. To see if the Volume Management software is running on the machine that you are updating, type at the command prompt: ps -ef | grep vold 3. To temporarily stop Volume Management if it is running, type this command at the system prompt: # /etc/init.d/volmgt stop 4. Insert the Solaris Driver ITU diskette into the diskette drive. 5. Mount the Solaris Driver ITU diskette at the /mnt mount point: # mount -F pcfs /dev/diskette /mnt Note: You must mount the Solaris Driver ITU diskette at this point in the file structure to update your system successfully. 6. Execute the install script on the diskette: # /mnt/DU/sol_28/i86pc/Tools/install.sh -i The install.sh script searches for all new or updated drivers on the diskette. When a new or updated driver is found, this prompt appears: Unconditionally installing ITUs Install patch driver-name? [y] 7. If the driver is the one that you want to install, type y for yes or press Enter. If the driver is not the one you want to install, type n for no. If you specify yes, the install.sh script installs the driver you indicated as well as bootmod and bootbin patches . 8. When the installation has completed, and the install.sh script exits, unmount the diskette by typing at the command prompt: # cd / # umount /mnt 9. Remove the Solaris Driver ITU diskette from the diskette drive. 10. Reboot your machine by typing at the command prompt: # reboot 11. If you have not already done so, turn off your system, add the new hardware, and turn on your system again. 12. At the << Current Boot Parameters >> prompt, type: b -r to force reconfiguration of the machine. When the Solaris operating environment is finished booting and running, the new devices whose drivers that you installed are available for use. ***********************************Troubleshooting***************************** The following are some informational or potential error messages that may be preceded by a warning message displayed by the operating system. In the message descriptions below; the LSIMPTSL signifies that can be replaced by a number assigned to it by the operating system. That value helps to identify the SCSI bus that is reporting the error. and are placeholders for strings and numbers that the system will display. LSIMPTSL: This hardware not supported by this driver The lsimptsl driver has been asked to control a LSIFC909, LSIFC919, LSIFC929, LSI53C1020, or LSI53C1030 controller located on an HAB which is made by a manufacturer other than LSI Logic. This adapter requires a special driver provided by that manufacturer. Please contact the manufacturer for assistance. LSIMPTSL: Failed to map device registers The lsimptsl driver was unable to access the hardware registers necessary for operation. The operating system did not properly configure the PCI device. LSIMPTSL: Hardware not properly enabled by system, cmd=xxxxh The system has not properly enabled the configuration resources that the LSImptsl driver needs in order to use this hardware. The cmd=xxxxh value needs to be reported to technical support. LSIMPTSL: Unsupported 64-bit register address. Please load 64-bit version of kernel and driver This version of the lsimptsl driver does not support physical addresses using 64-bit values. Contact LSI Logic Technical Support at 719-533-7230 if to determine if a new driver is available to support 64-bit version. LSIMPTSL: The host adapter id in the .conf file is being ignored because the SCSI BIOS Configuration Utility will override it The lsimptsl.conf file has a line (scsi-initiator-id=x) which is used to change the host adapter SCSI ID. That line is being ignored because the SCSI BIOS Configuration Utility has set the SCSI ID. Please use the SCSI BIOS Configuration Utility to change the SCSI ID. LSIMPTSL: Ignored invalid scsi-initiator-id value = The lsimptsl.conf file has an invalid scsi-initiator-id value as displayed in the error message. The allowable values are in the range 0..128. LSIMPTSL: property value is too large. Using maximum value of A property value in the lsimptsl.conf value is greater than the maximum allowed value. The driver will use the value instead. LSIMPTSL: property value is too small. Using default value of A property value in the lsimptsl.conf value is less than the minimum allowed value. The driver will use the value instead. LSIMPTSL: Could not allocate memory to read configuration data The driver was unable to allocate memory required to process the configuration data. This means that the configuration was not properly determined. To fix this you may need to manually configure the driver using the lsimptsl.conf file. LSIMPTSL: Configuration data is corrupt and will be ignored The configuration data provided by the SCSI BIOS Configuration Utility has been determined to be corrupted. Run the SCSI BIOS Configuration Utility to correct this error. LSIMPTSL: Unable to make reset notification callbacks The lsimptsl driver was unable to notify the target device driver of a SCSI bus reset. The target driver may start to malfunction because of this. LSIMPTSL: Disabling queue tags for target ID The lsimptsl driver has determined that the specified target is no longer responding to queue tagged I/O in a proper manner and has disabled queue tags for that device. This usually means that the specified device does not support queue tags. To disable this message, disable queue tags for the given device using the SCSI BIOS Configuration Utility. LSIMPTSL: Device (ID=, LUN=) not supported A Solaris target driver attempted to initialize a device whose SCSI target ID was out of the support range or whose LUN was not zero. This warning is most likely triggered by illegal entries in the target driver's conf file. LSIMPTSL: ddi_dma_sync() failed for data buffer Data corruption may occur LSIMPTSL: ddi_dma_sync() failed for I/O data at Data corruption may occur LSIMPTSL: ddi_dma_sync() failed for Adapter data Data corruption may occur A call to the operating system's ddi_sync_dma function failed. As a result, the system data caches may not be properly synchronized with system main memory. This may result in data corruption or failure of the lsimptsl driver to function properly. LSIMPTSL: ddi_dma_numwin() failed LSIMPTSL: ddi_dma_getwin() failed LSIMPTSL: ddi_dma_alloc_handle: h unknown/impossible LSIMPTSL: ddi_dma_buf_bind_handle: DDI_DMA_INUSE impossible LSIMPTSL: ddi_dma_buf_bind_handle: h unknown/impossible LSIMPTSL: ddi_dma_unbind_handle: failed The operating system failed to respond to the named routine in a known manner. This is a fatal error that is not recoverable. Please report this error to technical support. LSIMPTSL: Device in a slave-only slot and is unusable LSIMPTSL: Hi-level interrupts not supported. The adapter is in a slot that cannot be used with this driver. Please try moving the adapter to a different PCI slot. LSIMPTSL: Failed to attach. This adapter will not be installed Because of the previous error, this adapter could not be "attached" to the I/O subsystem and will not be accessible. See the previous error message and solve that problem. LSIMPTSL: Failed to allocate memory The lsimptsl driver was unable to allocate the memory needed during initialization. You may have run out of available memory. LSIMPTSL: Unbind failed! The driver had a problem when attempting to unload itself. This is a fatal error. LSIMPTSL: Unable to obtain soft state structure The lsimptsl driver was unable to initialize a required data structure and therefore did not load. Please call technical support. LSIMPTSL: Failed to attach interrupt handler The lsimptsl driver was unable to initialize the interrupt handler as required. Please call technical support. LSIMPTSL: The adapter is malfunctioning LSIMPTSL: The adapter is either malfunctioning, of an unknown type, or a revision that isn't supported The driver is not able to communicate with the hardware. You may need to update your driver or your hardware. LSIMPTSL: Could not attach to the SCSI subsystem The lsimptsl driver was unable to communicate with the Solaris SCSA subsystem. You may need to update your driver.