*****************************************************************************
Solinst.TXT
*****************************************************************************
Installation Guide for the LSI Logic Fusion-MPT Solaris SPARC driver
and utility package V5.04.03 that supports LSI Ultra320 SCSI and LSI
Fibre Channel host adapter products.
This file contains these sections:
Introduction for Solaris SPARC
Driver Features
Utility Features
LSI Logic Devices Supported
Installing the Host Adapter
System Requirements
Verifying Correct Installation
Identifying FC Disks
Installing the Driver(s)
Existing System Installation
Network System Installation
Troubleshooting
.........................................................................
1.0 Introduction for Solaris SPARC
The LSI Logic driver, itmpt, allows the Solaris SPARC operating system
to interface with the devices connected to the LSI Ultra320 SCSI and
LSI Fibre Channel host adapters. The LSI Logic driver is optimized for
low CPU overhead and high I/O throughput, making use of the LSI Logic
Fusion-MPT architecture. LSI Logic adapters have built-in FCode,
designed to operate in the Sun OpenBoot environment, allowing devices
to be available to the OpenBoot (ok) prompt. This driver takes
advantage of new hardware features in the LSI Ultra320 SCSI and LSI
Fibre Channel chips to minimize CPU utilization, including interrupt
coalescing, which can result in less than one interrupt per I/O.
NEW Ultra320 SCSI and Fibre Channel Utility
-------------------------------------------
In addition to the three utilities described below, a new fourth
utility has been added to the lsiutils suite of utilities. This
powerful new utility, lsiutil, provides all of the functionality
of lsiupdate as well as a wealth of additional functionality
for displaying and modifying settings for LSI MPT adapters.
Execute lsiutil with no arguments to begin an interactive session or
try "lsiutil -h" to get help with the command line options that are
available.
Fibre Channel Utilities
-----------------------
In order to preserve a consistent mapping between Solaris target IDs
and FC target devices, the driver maintains a configuration file with
entries that map each Solaris target ID to an FC target World Wide
Name. Note that this is done for all FC target devices, and is in
addition to the Root Boot persistent target ID selection, which is
configurable through the Fcode during OpenBoot. By default, the itmpt
driver does not maintain persistent bindings between targets and
WWNs. However, persistent bindings are recommended for most RAID
controllers such as the LSI Logic Metastor.
To configure persitent bindings, two utilities are provided to
configure the driver.
* The lsiadm utility is used to maintain persistent bindings between
targets and WWNs, by automatically adding bindings to, or deleting
bindings from, the /kernel/drv/itmpt.conf file, used by the itmpt
driver.
* The lsiprobe utility automatically adds extended LUN support to, or
deletes extended LUN support from, the /kernel/drv/ssd.conf file,
used by the itmpt driver.
Ultra320 SCSI and Fibre Channel Utility
---------------------------------------
A third utility is included to facilitate updates to the adapter in a
native Solaris environment.
* The lsiupdate utility allows for updating the Int13 BIOS, FCode, and
MPT firmware that reside on LSI Ultra320 SCSI and LSI Fibre Channel
controllers from a running Solaris machine. lsiupdate communicates
via ioctls to the itmpt driver to perform the updates.
.........................................................................
1.1 Driver Features
The Solaris SPARC driver supports these features:
o Uses state of the art Fusion-MPT interface, providing support for FC,
SCSI, and RAID devices with a single binary image.
o Provides highly efficient, low CPU usage architecture.
o 66 MHz/64-bit PCI interface support provides maximum I/O bandwidth.
o Supports multiple host adapters.
o Supports multiple Logical Unit Numbers (LUNs)
o Supports Scatter-Gather
o Supports disk array configurations with no LUN 0
o Supports disk array configurations with non-contiguous LUNs
o Supports multiprocessor environments.
.........................................................................
1.2 Utility Features
The Solaris SPARC utilities, lsiadm, lsiprobe, lsiupdate and lsiutil support
these features:
o The lsiutil utility provides all of the functionality
of lsiupdate as well as a wealth of additional functionality
for displaying and modifying settings for LSI MPT adapters.
o The lsiadm utility configures persistent bindings between targets and WWNs,
by automatically adding bindings to, or deleting bindings from, the
/kernel/drv/itmpt.conf file, used by the itmpt driver. Applies to
Fibre Channel adapters only.
o The lsiprobe utility configures extended LUN support, by
automatically adding or deleting extended LUN support from the
/kernel/drv/ssd.conf file, used by the itmpt driver. Applies to
Fibre Channel adapters only.
o The lsiupdate utility allows for updating the Int13 BIOS, FCode, and
MPT firmware that reside on LSI Ultra320 SCSI and LSI Fibre Channel
controllers from a running Solaris machine. lsiupdate communicates
via ioctls to the itmpt driver to perform the updates.
.........................................................................
1.3 LSI Logic Devices Supported
The LSI Solaris SPARC driver version 5.04.03 supports the following LSI
host adapters:
Fibre Channel
o LSI7102XP LSI7202XP LSI7402XP LSI7402EP
o LSI7102XLP LSI7202XLP
o LSI44929 LSI44919
SCSI
o LSI22320-R LSI21320-R LSI20320-R
The LSI Solaris SPARC driver version 5.04.03 supports the following LSI
microchip controllers:
o LSIFC929X LSIFC919X LSIFC929 LSIFC919
o LSI53C1030 LSI53C1020
............................................................................
2.0 Installing the Host Adapter
This section provides installation instructions for new and existing systems.
............................................................................
2.1 System Requirements
Your SPARC Solaris system must have the available resources as listed
below in order to install the LSI Host Adapter.
Resource Requirement
Host Bus Slot Sun Solaris system with available PCI slot
Operating System Solaris 2.6 release or later
Network Boot Server SPARC or Intel Solaris boot server *
Firmware OpenBoot PROM Version 3.0 or greater
* Only required if you will be using the LSI Logic module to support your
System disk.
After installing the module in an appropriate PCI slot and making all the
necessary internal and external connections to the module, power on the
host system.
............................................................................
2.2 Verifying Correct Installation
Use this procedure to verify installation of your LSI Logic Host Adapter
before booting your system:
Step 1. Power on the system.
Step 2. When the banner is displayed, press the Stop-A keys to
interrupt the boot process and stop at the ok prompt.
Step 3. Use the show-devs command to list the system devices. You
should see an output similar to the following example, as shown
below:
ok show-devs
/SUNW,UltraSPARC-IIi@0,0
/pci@1f,0
/virtual-memory
/memory@0,10000000
/aliases
/options
/openprom
/chosen
/packages
/pci@1f,0/pci@1
/pci@1f,0/pci@1,1
/pci@1f,0/pci@1/pci@2
/pci@1f,0/pci@1/IntraServer,Ultra2-scsi@1
/pci@1f,0/pci@1/pci@2/IntraServer,fc@4
/pci@1f,0/pci@1/pci@2/IntraServer,fc@4/disk
/pci@1f,0/pci@1/pci@2/IntraServer,fc@4/tape
/pci@1f,0/pci@1/LSILogic,scsi@1/tape
/pci@1f,0/pci@1/LSILogic,scsi@1/disk
/openprom/client-services
Note: The above is an example. The output of show-devs may vary
depending on your system and configuration. Use the corresponding
entries on your system, not those given here.
If these devices are not listed, check that the adapter is correctly
installed, and reseat the adapter if necessary.
............................................................................
2.2 Identifying the attached I/O devices
The probe-scsi-all command is used to identify the disk devices
on your LSI Logic adapter, as shown below.
ok probe-scsi-all
/pci@1f,0/pci@1/IntraServer,Ultra2-scsi@1
Target 0
Unit 0 Disk IBM DNES-309170W SA30
/pci@1f,0/pci@1/pci@2/IntraServer,fc@7
MPT Firmware Version 1.00
Target 0
Unit 0 Disk SEAGATE ST39173FC 6615
WWN 220000203710d063 ID 111d2
Target 1
Unit 0 Disk SEAGATE ST39173FC 6258
WWN 220000203710c09b ID 111d6
Target 2
Unit 0 Disk SEAGATE ST39173FC 6258
WWN 220000203710b066 ID 111d5
Target 3
Unit 0 Disk SEAGATE ST39173FC 6258
WWN 220000203710b063 ID 111d3
Target 4
Unit 0 Disk SEAGATE ST39173FC 6258
WWN 220000203710b04f ID 111d4
Target 5
Unit 0 Disk SEAGATE ST39173FC 6615
WWN 2200002037104f73 ID 111d9
Target 6
Unit 0 Disk SEAGATE ST39173FC 6615
WWN 2200002037102d0f ID 111d1
If the disks on your LSI Logic adapter are not identified by your system,
check the following:
1. Are all the cables correctly connected to the disk enclosure?
2. Is the disk enclosure powered up?
3. If the external disk enclosure required a loopback connector, is the
loopback connector correctly installed?
............................................................................
3.0 Installing the Driver
This section provides installation instructions for new and existing systems.
Note: If you plan to use an LSI Logic adapter for your system disk, you
must use the Network Installation Procedure, in order to load the
device driver during installation.
NOTE: When the itmpt driver initializes an LSI Ultra320 SCSI host
adapter's disks, it attaches under the Sun 'sd' target driver.
To alter the probing of target ID's and probing for non-zero
LUN's on devices attached to an LSI Ultra320 SCSI adapter,
modify the /kernel/drv/sd.conf file.
When the itmpt driver initializes an LSI Fibre Channel host
adapter's disks, it attaches under the Sun 'ssd' target driver.
To alter the probing of target ID's and probing for non-zero
LUN's on devices attached to an LSI Fibre Channel adapter,
modify the /kernel/drv/ssd.conf file or use the lsiprobe utility.
............................................................................
3.1 Existing System Installation
These instructions provide details to install the LSI Logic
itmpt driver to an existing Solaris operating system installation.
Note: You must be logged on as root to perform the installation.
Step 1. Uncompress and untar the itmpt_install.tar.Z file by typing the
following commands in order to create a directory named
install:
uncompress itmpt_install.tar.Z
tar -xvf itmpt_install.tar
cd install
Step 2. Execute the pkgadd procedure to add the itmpt driver to the
operating system.
Example: pkgadd -d .
You will see the display on the screen as shown below.
The following packages are available:
1 ITImpt LSI Logic FusionMPT(tm) Fibrechannel/SCSI drivers
(sparc) itmpt kit version 5.04.03
Select package(s) you wish to process (or 'all' to process all packages).
(default: all) [?,??,q]: 1
Processing package instance <ITImpt> from </floppy/intraserver>
LSI Logic FusionMPT(tm) Fibrechannel/SCSI drivers (sparc)
itmpt kit version 5.04.03
LSI Logic
Using </> as the package base directory.
## Processing package information.
## Processing system information.
2 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
This package contains scripts which will be executed with
superuser permission during the process of installing this
package.
Do you want to continue with the installation of <ITImpt>
[y,n,?] y
Installing LSI Logic FusionMPT(tm)
Fibrechannel/SCSI drivers as <ITImpt>
## Installing part 1 of 1.
/kernel/drv/itmpt
/kernel/drv/itmpt.conf
[ verifying class <none> ]
## Executing postinstall script.
installing /kernel/drv/sparcv9/itmpt
Updating /kernel/drv/ssd.conf with itmpt entries...
Entries added. For support of more than 15 targets or non-zero
LUNs it may be necessary to edit /kernel/drv/ssd.conf to add
additional entries.
Following installation, please reboot the system to properly
configure and load the drivers.
Installation of <ITImpt> was successful.
Note: Please refer to the file Errata_0708.pdf for configuration
instructions regarding non Zero LUNs.
............................................................................
3.2 Network System Installation
If you are using your LSI Logic adapter to support your SPARC Solaris system
disk, you must install the Solaris operating system using a network install.
This section describes a complete installation of Solaris to a client system
using LSI Logic adapters for the system disk. The method described in this
section allows you to install the LSI Logic itmpt driver onto a
network boot kit, making it available during the SPARC installation process.
If you are simply installing an LSI Logic adapter as an additional
storage adapter in an existing system, use the driver installation
procedure described in the previous section.
............................................................................
3.2 Setting up a Boot/Install Server
Refer to the "Preparing to Install Solaris Software Over the Network,"
section of the Solaris Advanced Installation Guide, available at
http://docs.sun.com.
The basic steps to set up a boot and install server are as follows:
Step 1. Insert your Solaris distribution CD in your boot/install server's
CD-ROM drive.
Step 2. Change your directory to the Tools area on your distribution CD:
cd /cdrom/cdrom0/Solaris_2.7/Tools
Step 3. Use the setup_install_server script to copy the boot and
installation files to your boot/install server:
./setup_install_server /export/home/install
............................................................................
3.3 Installing the itmpt Driver on the Boot/Install Server
After you have set up your network boot and install server, follow these
steps to run the install.sh script with the -n parameter to copy the driver
kit to the boot server's boot files:
Step 1. Place the diskette in the floppy drive and execute the volcheck
command to ensure the system sees the floppy.
Step 2. Change the directory to the root of the floppy:
cd /floppy/floppy0
Step 3. Execute the install.sh shell script to add the itmpt driver to
the boot installation area:
./install.sh -n /export/home/install/Solaris_2.7
Notes:
o For Solaris 2.8 boot files, the directory would be
/export/home/install/Solaris_2.8.
o The message "major number maximum based on server, not client"
can safely be ignored.
Running the install.sh script this way copies and installs the LSI
Logic drivers into the Tools/Boot/ area of the boot files and allows
LSI Logic adapters to be booted for installation using the bootserver.
............................................................................
3.4 Adding Clients to Your Boot/Install Server
For each machine that boots into the boot/install server, follow these
steps to add a client entry on the boot/install server:
Step 1. Change the directory to the boot/install kit:
cd /export/home/install/Solaris_2.7/Tools
Step 2. Use the add_install_client script to add the client machine
./add_install_client -i ipaddr
-e ethernetid client_name platform_group
Where:
ipaddr is the tcp/ip address of the client
ethernetid is the ethernet hardware (mac) address of the client
client_name is the client's system name
platform_group is the client's vendor defined hardware group
Example: ./add_install_client -i 192.168.103.124 -e
00:08:26:02:25:34 sunsys sun4u
Note: You can obtain the platform_group from a machine of the
same type as the target client using the uname -m command.
............................................................................
3.5 Booting the Client Using the itmpt Driver
Now you can begin the installation of the Solaris operating system to the
client target machine using the boot and install server. On the client
machine, boot the network install kit you created in the preceding steps
as follows:
ok boot net -v
Note: It is important to choose "Manual Reboot" rather than "Auto
Reboot" during the installation of Solaris on the target
machine. If you choose "Auto Reboot", you will not have the
opportunity to complete the installation of the LSI Logic drivers
and your system will fail to boot.
After the installation has completed and the system is waiting to be
manually rebooted, proceed to a console window and run the following
script:
/sbin/itmptinst
This copies and installs the drivers from the boot server to the newly
created Solaris installation. After this script has been run, the
LSI Logic device driver installation is complete and the system can be
rebooted.
Notes: The message "major number maximum based on server, not client"
can safely be ignored. Your Sun machine will prompt you to allow power
saving automatic shutdown. You must answer no to this question
if you are using the LSI Logic adapter to support your boot disk.
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.
............................................................................
4.0 Troubleshooting
Please refer to the User Guide for troubleshooting techniques.
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.