*****************************************************************************
Solinst.TXT
*****************************************************************************
Installation Guide for the LSI Logic Fusion-MPT Solaris Sparc driver and utility package V5.01.00 that supports LSI40909G-S host adapter product.
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 FC devices connected to the LSI40909G-S. 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 FC40909G-S adapters have built-in Fcode, designed to operate in the Sun OpenBoot environment, allowing FC devices to be available to the OpenBoot (ok) prompt. This driver takes advantage of new hardware features in the LSI40909G-S to minimize CPU utilization, including interrupt coalescing, which can result in less than one interrupt per I/O.
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 BIOS. 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.
.........................................................................
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 and lsiprobe, supports these features:
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.
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.
.........................................................................
1.3 LSI Logic Devices Supported
The LSI Solaris Sparc driver version 5.01 supports the following LSI host adapters:
o LSIFC909 (LSI40909G-S Host Adapter)
............................................................................
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 LSI40909G-S.
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/IntraServer FC
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/IntraServer,Ultra2-scsi@1/tape
/pci@1f,0/pci@1/IntraServer,Ultra2-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 FC Disks
The probe-scsi-all command is used to identify the FC disk devices
on your LSI Logic/IntraServer 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 FC disks on your LSI Logic adapter are not identified by your system,
check the following:
1. Are all the FC 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.
The LSI Logic LSI40909G-S uses the itmpt FC driver for Solaris. This
driver is included with your adapter kit.
Note: If you plan to use an LSI Logic FC adapter for your system disk,you
must use the Network Installation Procedure, in order to load the device driver
during installation.
............................................................................
3.1 Existing System Installation
These instructions provide details to install the LSI Logic/IntraServer
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( space)-d( space).
You will see the display on the screen as shown below.
The following packages are available:
1 TImpt LSI Logic/IntraServer FusionMPT(tm) Fibrechannel/SCSI drivers
(sparc) itmpt kit version 1.1
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/IntraServer FusionMPT(tm) Fibrechannel/SCSI drivers (sparc)
itmpt kit version 1.1
IntraServer Technology, Inc / 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/IntraServer 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 nonzero
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 FC 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 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:
· For Solaris 2.8 boot files, the directory would be
/export/home/install/Solaris_2.8.
· 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 FC 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 FC 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/IntraServer 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/IntraServer 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 file 40909G-S.pdf 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.