*****************************************************************************
Solaris.txt
*****************************************************************************
Installation Guide for the LSI Logic Ultra160/Ultra2 SCSI Solaris Drivers
ITHPS (32-bit) version 5.03 for dual channel (Solaris 2.6 / 7.0 / 8.0)
ITSPS (32-bit) version 5.03 for single channel (Solaris 2.6 / 7.0 / 8.0)
ITHPS (64-bit) version 5.03 for dual channel (Solaris 7.0 / 8.0)
ITSPS (64-bit) version 5.03 for single channel (Solaris 7.0 / 8.0)
This file describes the features and use of the LSI Logic Device Drivers for
the Solaris Operating system 2.6, 7.0, and 8.0. It is divided into
the following sections:
Introduction
Features
How to Install Your LSI Logic Driver
Updating Solaris with the driver
Troubleshooting
--------------------- NEW FEATURES WITH THIS RELEASE -----------------------
5.03.00
- public release (GCA) of driver with domain validation.
- fixes for tape drives that are probed at LUN's > 8
5.02.01
- fixes to enhanced level domain validation support
5.02.00.04
- added enhanced level domain validation support
5.02
- added robustness to PPR Ultra160 negotations to work with difficult devices
- increased maximum supported req/ack offset to 62 for 53c1010 chips in
Ultra160 mode
5.01
- The ITHPS driver now has Ultra160m SCSI support!
- pkgadd format installation is now supported! See the existing
installation section for more information.
-----------------------------------------------------------------------------
******************************* Introduction ********************************
The LSI Logic driver, ITHPS, allows the Solaris operating system to
interface with SCSI devices connected to LSI Logic dual channel 6200
and 8000 series Ultra160 and Ultra2 controllers with support for Low
Voltage Differential (LVD) devices. This driver takes advantage of
new hardware features in the 6200 and 8000 series controllers to
minimize CPU utilization, including a single interrupt per I/O.
The LSI Logic driver, ITSPS, allows the Solaris operating system to
interface with SCSI devices connected to an LSI Logic single channel
6100 series Ultra2 controller with support for Low Voltage
Differential (LVD) devices.
The following sections describe the procedures to install the
drivers on Solaris.
* * * * * * * * * * * * Features * * * * * * * * * * *
o Provides synchronous negotiation (including Fast SCSI/Ultra
SCSI/Ultra2 SCSI/Ultra160 SCSI)
o Supports multiple host adapters
o Supports disconnect/reselect
o Allows multiple and non-contiguous LUN support
o Supports scatter/gather
o Supports wide devices
o Supports tagged command queuing
o Supports multiprocessors
* * * * * * * * * * * * Description * * * * * * * * * *
The LSI Logic ITHPS and ITSPS drivers are designed to Sun
Microsystems SCSA specifications' for device drivers. These drivers
allows connection of SCSI devices including disk drives, CD-ROMS, and
tape drives for PCI-based machines. To support a new SCSI device, the
Solaris architecture requires that the device complies to the SCSI
standard.
**********************Installing the SDMS Solaris Driver*********************
LSI Logic's dual channel 6200 and 8000 series adapter use the ITHPS
Ultra160/Ultra2 SCSI driver for Solaris.
The single channel 6100 series adapters use LSI Logic's ITSPS Ultra2
SCSI driver.
These drivers are included with your adapter kit.
Note: If you plan on using an LSI Logic adapter for your SYSTEM
DISK, you MUST use the NETWORK install procedure in order to load the
device driver during installation. See the LSI Logic Ultra2/LVD
manual for details on network install (the PDF of the manual is
distributed with the drivers).
----------------- Existing System Installation -----------------------------
These instructions provide details to install the LSI Logic ITHPS and
ITSPS drivers to an existing Solaris operating system installation.
NOTE: You must be logged on as root to perform the installation.
NOTE: NEW PKGADD INSTALLATION OPTION AVAILABLE WITH THIS RELEASE
pkgadd is now the only supported installation method available for local
installs.
--- Floppy Disk Install ---
If you received the drivers on a floppy diskette:
1. Place the diskette in the floppy drive and execute the "volcheck"
command to ensure the system sees the floppy.
2. Change directory to the root of the floppy (e.g. "cd
/floppy/floppy0")
3. Start the installation by invoking the pkgadd command as:
pkgadd -d .
4. The ITHPS and ITSPS device drivers are now installed. Reboot the
machine to reconfigure the system and to recognize the new devices.
--- Distribution File Install ---
If you received the drivers in an itis_install.tar.Z file:
1. Uncompress and un-tar the itis_install.tar.Z file by typing the
following commands in order to create a directory named install:
uncompress itis_install.tar.Z
tar -xvf itis_install.tar
cd install
2. Start the installation by invoking the pkgadd command as:
pkgadd -d .
3. The ITHPS and ITSPS device drivers are now installed. Reboot the
machine to reconfigure the system and to recognize the new devices.
NOTE: If you change the disk drive configuration of your machine, it
may be necessary to issue the command:
touch /reconfigure
and then reboot the system in order for the system to detect and
correctly install your new disks.
*********************************Troubleshooting*****************************
The following are some potential error messages that may be preceded
by a warning message displayed by the operating system. In the
message descriptions below; the ITHPS<n> (or ITSPS(n) in case of the
ITSPS driver) signifies that <n> can be replaced by some number
assigned to it by the operating system. That value helps to identify
the SCSI bus that is reporting the error.
ITHPS<n>: This hardware not supported by this driver
ITHPS has been told to control a 53C1010 or 53C896 (53C895 for ITSPS)
hardware which is made by a manufacturer other than LSI Logic
Technology. This adapter requires a special driver provided by
that manufacturer. Please contact the manufacturer for
assistance.
ITHPS<n>: Failed to map device registers
ITHPS was unable to access the hardware registers necessary for
operation. The operating system did not properly configure the PCI
device.
ITHPS<n>: Hardware not properly enabled by system, cmd=xxxxh
The system has not properly enabled the configuration resources that
ITHPS needs in order to use this hardware. The cmd=xxxxh value needs to
be reported to technical support.
ITHPS<n>: Ignored invalid scsi-initiator-id value = x
The ithps.conf file has an invalid scsi-initiator-id value as displayed
in the error message. The allowable values are in the range 0..15.
ITHPS<n>: 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 ithps.conf file.
ITHPS<n>: Unable to make reset notification callbacks
The ITHPS was unable to notify the target device driver of a SCSI bus
reset. The target driver may start to malfunction because of this.
ITHPS<n>: ddi_dma_numwin() failed
ITHPS<n>: ddi_dma_getwin() failed
ITHPS<n>: ddi_dma_alloc_handle: xxh unknown/impossible
ITHPS<n>: ddi_dma_buf_bind_handle: DDI_DMA_INUSE impossible
ITHPS<n>: ddi_dma_buf_bind_handle: xxh unknown/impossible
ITHPS<n>: 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.
ITHPS<n>: No KeyROM found. Hardware contains no valid license
The adapter is not a valid LSI Logic adapter licensed for use
with Solaris.
ITHPS<n>: Device in a slave-only slot and is unusable
ITHPS<n>: Hi-level interrupts not supported
The adapter is in a slot that can not be used with this driver. Please
try moving the adapter to a different PCI slot.
ITHPS<n>: Failed to attach. This adapter will not be installed.
Because of one of the previous two errors, this adapter could not be
"attached" to the I/O subsystem and will not be accessable. See
the previous error message and solve that problem.
ITHPS<n>: Unable to obtain soft state structure
The driver was unable to initialize a required data structure and
therefore did not load. Please call technical support.
ITHPS<n>: Failed to attach interrupt handler
The driver was unable to initialize the interrupt handler as required.
Please call technical support.
ITHPS<n>: The adapter is malfunctioning
ITHPS<n>: The adapter is malfunctioning or is of an unknown type
The driver is not able to communicate with the hardware. You may need to
update your driver or your hardware.
ITHPS<n>: Failed to create minor node required for DMI interface
The driver was unable to create an entry point for the DMI device driver.
If you are not using the DMI device driver then you may safely
ignore this message.
ITHPS<n>: Could not attach to the SCSI subsystem
The driver was unable to communicate with the SCSI device driver that is
part of the operating system. You may need to update your driver.
ITHPS<n>: Failed to allocate memory
The driver was unable to allocate the memory needed during
initialization. You may have run out of available memory.
ITHPS<n>: Unbind failed!
The driver had a problem when attempting to unload itself.
This is a fatal error.
Download Driver Pack
After your driver has been downloaded, follow these simple steps to install it.
Expand the archive file (if the download file is in zip or rar format).
If the expanded file has an .exe extension, double click it and follow the installation instructions.
Otherwise, open Device Manager by right-clicking the Start menu and selecting Device Manager.
Find the device and model you want to update in the device list.
Double-click on it to open the Properties dialog box.
From the Properties dialog box, select the Driver tab.
Click the Update Driver button, then follow the instructions.
Very important: You must reboot your system to ensure that any driver updates have taken effect.
For more help, visit our Driver Support section for step-by-step videos on how to install drivers for every file type.