April 2001 1
Copyright © 2001 by LSI Logic Corporation. All rights reserved.
®
LSI40909G-S PCI to
Fibre Channel Host
Adapter for Sun Solaris
User’s Guide, V1.0
Erratum
Erratum Numbers
E000708
Product Code
LSI40909G-S
Revision
All
Date Code
Not applicable
Order Number for User’s Guide
S14062
2 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris
Problem Area (E000708)
Problem Description Release 5.01 of the Solaris driver does not
provide an automated method to create persistent bindings between
Solaris target IDs and FC target World Wide Names. Rather, the user
must edit the ssd.conf and itmpt.conf files manually.
Suggested Solution LSI Logic now provides two utilities, “lsiadm” and
“lsiprobe” which, when implemented, replace the manual editing of the
ssd.conf and itmpt.conf files, as documented in version 1.0 of the
LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris User’s
Guide. This erratum covers the installation and use of these two utilities.
Expected Resolution The next version of the LSI40909G-S PCI to
Fibre Channel Host Adapter for Sun Solaris User’s Guide will contain this
documentation, inserting a new section 3.2.2, as shown below.
3.2.2 Sun SPARC Fusion-MPT
®
Utility Installation
The LSI Logic driver, itmpt, allows the Solaris SPARC operating system
to interface with the FC devices connected to the LSI40909G-S. 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, as described in section 3.1.5 of the
LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris User’s
Guide, Version 1.0.
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
®
data storage disk arrays. To enable persistent bindings, LSI
Logic provides two utilities 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.
LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 3
3.2.2.1 Installing the Sun SPARC Fusion-MPT Utilities
These instructions provide details to install the LSI Logic/IntraServer
itmpt driver to an existing Solaris operating system installation. Execute
the pkgadd procedure to add the itmpt utilities to the operating system.
Execute pkgadd from the directory that contains the utility tar bundle.
See Figure 3.5.
Figure 3.5 Utility Installation Example
# ls -l
total 2
drwxr-xr-x 3 root other 512 Mar 28 15:13 LSIutils
# pkgadd -d .
The following packages are available:
1 LSIutils LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities
(sparc) LSIutils kit version 1.0
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: 1
Processing package instance <LSIutils> from
</export/home/itpsa/src/lsiutils/install>
LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities
(sparc) LSIutils kit version 1.0
LSI Logic / IntraServer Technology, Inc
Using </> as the package base directory.
## Processing package information.
## Processing system information.
4 package pathnames are already properly installed.
## Verifying disk space requirements.
## Checking for conflicts with packages already installed.
## Checking for setuid/setgid programs.
Installing LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities as <LSIutils>
## Installing part 1 of 1.
/usr/bin/lsiadm <symbolic link>
/usr/bin/lsiprobe <symbolic link>
/var/opt/LSIutils/bin/lsiadm
/var/opt/LSIutils/bin/lsiprobe
[ verifying class <none> ]
Installation of <LSIutils> was successful.
The following packages are available:
1 LSIutils LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities
(sparc) LSIutils kit version 1.0
Select package(s) you wish to process (or 'all' to process
all packages). (default: all) [?,??,q]: q
#
4 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris
3.2.2.2 Using the Sun SPARC Fusion-MPT lsiadm Utility
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 following options are provided:
lsiadm -p itmpt This option scans all LSI Logic FC controllers in the
system, and identifies all targets attached to each controller. The utility
returns the targets currently attached to each FC controller. For each
target ID, the target’s World Wide Name is displayed, as well as an
indication of where the target ID persistence is currently maintained
(either in NVRAM, in the Config File, or none defined). See Figure 2.
lsiadm -pa <controller list> This option adds all the targets identified
during the scan, for a selected FC controller, to the bindings maintained
in the /kernel/drv/itmpt.conf file. See Figure 2. The argument is
either “itmpt”, meaning all controllers, or is a list of individual controllers
such as “itmpt0 itmpt1”.
lsiadm -pd <controller list> This option deletes all the targets for a
selected FC controller, from the bindings maintained in the
/kernel/drv/itmpt.conf file. The argument is either “itmpt”, meaning
all controllers, or is a list of individual controllers such as “itmpt0 itmpt1”.
Figure 3.6 shows examples of the lsiadm utility operation. The command
to be entered is shown in bold print. Responses received from the
system are in italics.
LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 5
Figure 3.6 lsiadm Utility Operation Example
3.2.2.3 Using the Sun SPARC Fusion-MPT lsiprobe Utility
The lsiprobe utility is used to extend the itmpt driver to support more than
one LUN per target, which is the default for most RAID controllers such
as the LSI Logic Metastor Controller. The utility automatically adds
extended LUN support to, or deletes extended LUN support from, the
/kernel/drv/ssd.conf file, which is used by the itmpt driver.
Figure 3.7 shows examples of the lsiprobe utility operation. The
command to be entered is shown in bold print. Responses received from
the system are in italics.
The following options are provided:
lsiadm -p itmpt
Scanning system for controllers and devices, please wait...
itmpt0 found at /pci@1f,0/pci@1/IntraServer,fc@1
Binding Information for controller c1:
Target: 0 WWN: 100000a0b80403fa Persist: ConfigFile
itmpt1 found at /pci@1f,0/pci@1/IntraServer,fc@2
Binding Information for controller c6:
Target: 0 WWN: 220000203710d063 Persist: None
Target: 1 WWN: 220000203710c09b Persist: None
Target: 2 WWN: 220000203710b066 Persist: NVRAM
Target: 3 WWN: 220000203710b063 Persist: NVRAM
Target: 4 WWN: 220000203710b04f Persist: None
Target: 5 WWN: 2200002037104f73 Persist: None
Target: 6 WWN: 2200002037102d0f Persist: None
itmpt2 found at /pci@1f,0/pci@1/IntraServer,fc@2,1
Binding Information for controller c7:
Target: 0 WWN: 2100002037a70ca7 Persist: ConfigFile
Target: 1 WWN: 2100002037a70c72 Persist: None
Target: 2 WWN: 2100002037a70c44 Persist: None
Target: 3 WWN: 2100002037a70c05 Persist: None
lsiadm -pa itmpt2
Scanning system for controllers and devices, please wait...
Persistent entries for itmpt2 (c7) were
successfully added to /kernel/drv/itmpt.conf
lsiadm -pd itmpt2
Scanning system for controllers and devices, please wait...
Persistent entries for itmpt2 (c7) were
successfully deleted from /kernel/drv/itmpt.conf
6 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris
lsiprobe -a target <list> lun <list> This option adds extended LUN
support for the selected targets. Target devices may be specified
individually, or by range. LUN support for each target may be specified
individually, or by range. See Figure 3.
lsiprobe -d target <list> lun <list> This option deletes extended LUN
support for the selected targets. Target devices may be specified
individually, or by range. LUN support for each target may be specified
individually, or by range. See Figure 3.
Figure 3.7 lsiprobe Utility Operation Example
3.2.2.4 Uninstalling the Sun SPARC Fusion-MPT Utilities
These instructions provide details to uninstall the LSI Logic/IntraServer
itmpt driver to an existing Solaris operating system installation. See
Figure 3.8.
lsiprobe -a target 0-3 lun 0-31
Probe entries successfully added to /kernel/drv/ssd.conf
lsiprobe -d target 2
Done.
lsiprobe -a target 2,4 lun 0-6,8-15
Probe entries successfully added to /kernel/drv/ssd.conf
LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 7
Figure 3.8 Utility Uninstall Example
# pkginfo | grep LSIutils
system LSIutils LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities
# pkgrm LSIutils
The following package is currently installed:
LSIutils LSI Logic/IntraServer Fibrechannel/SCSI Driver Utilities
(sparc) LSIutils kit version 1.0
Do you want to remove this package? y
## Removing installed package instance <LSIutils>
## Verifying package dependencies.
## Processing package information.
## Removing pathnames in class <none>
/var/opt/LSIutils/bin/lsiprobe
/var/opt/LSIutils/bin/lsiadm
/var/opt/LSIutils/bin
/var/opt/LSIutils
/var/opt <shared pathname not removed>
/var <shared pathname not removed>
/usr/bin/lsiprobe
/usr/bin/lsiadm
/usr/bin <shared pathname not removed>
/usr <shared pathname not removed>
## Updating system information.
Removal of <LSIutils> was successful.
#
Visit us at our web site: http://www.lsilogic.com
8 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris
LSI Logic Corporation reserves the right to make changes
to any products and services herein at any time without
notice. LSI Logic does not assume any responsibility or lia-
bility arising out of the application or use of any product or
service described herein, except as expressly agreed to in
writing by LSI Logic; nor does the purchase, lease, or use
of a product or service from LSI Logic convey a license
underanypatentrights,copyrights,trademarkrights,orany
other of the intellectual property rights of LSI Logic or of
third parties.
The LSI Logic logo design, Fusion-MPT, and MetaStor are
trademarks or registered trademarks of LSI Logic Corpora-
tion. Sun and Solaris are trademarks or registered trade-
marks of Sun Microsystems, Inc. All other brand and
product names may be trademarks of their respective com-
panies.
DB
Printed in USA
Order No.S14062.E2
Doc. No. DB05-000067-00
Headquarters
LSI Logic Corporation
North American Headquarters
Milpitas CA
Tel: 408.433.8000
Fax: 408.433.8989
LSI Logic Europe Ltd
European Headquarters
Bracknell England
Tel: 44.1344.426544
Fax: 44.1344.481039
LSI Logic K.K.
Headquarters
Tokyo Japan
Tel: 81.3.5463.7821
Fax: 81.3.5463.7820
ISO 9000 Certified
Notes
  • Page 1 1
  • Page 2 2
  • Page 3 3
  • Page 4 4
  • Page 5 5
  • Page 6 6
  • Page 7 7
  • Page 8 8

Ask a question and I''ll find the answer in the document

Finding information in a document is now easier with AI