solinst.txt Driver File Contents (itmpt-5.04.03.zip)

***************************************************************************** 
                                  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

How To Update Drivers Manually

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.

server: ftp, load: 1.74