LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris User s Guide, V1.0

Transcription

1 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris User s Guide, V1.0 Erratum Erratum Numbers E Product Code LSI40909G-S Revision All Date Code Not applicable Order Number for User s Guide S14062 April Copyright 2001 by LSI Logic Corporation. All rights reserved.

2 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 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 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. 2 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris

3 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 # LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 3

4 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. 4 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris

5 Figure 3.6 lsiadm Utility Operation Example lsiadm -p itmpt Scanning system for controllers and devices, please wait... itmpt0 found at Binding Information for controller c1: Target: 0 WWN: a0b80403fa Persist: ConfigFile itmpt1 found at /pci@1f,0/pci@1/intraserver,fc@2 Binding Information for controller c6: Target: 0 WWN: d063 Persist: None Target: 1 WWN: c09b Persist: None Target: 2 WWN: b066 Persist: NVRAM Target: 3 WWN: b063 Persist: NVRAM Target: 4 WWN: b04f Persist: None Target: 5 WWN: f73 Persist: None Target: 6 WWN: d0f Persist: None itmpt2 found at /pci@1f,0/pci@1/intraserver,fc@2,1 Binding Information for controller c7: Target: 0 WWN: a70ca7 Persist: ConfigFile Target: 1 WWN: a70c72 Persist: None Target: 2 WWN: a70c44 Persist: None Target: 3 WWN: a70c05 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 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: LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 5

6 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 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 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 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. # LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris 7

8 Notes Headquarters LSI Logic Corporation North American Headquarters Milpitas CA Tel: Fax: LSI Logic Europe Ltd European Headquarters Bracknell England Tel: Fax: LSI Logic K.K. Headquarters Tokyo Japan Tel: Fax: Visit us at our web site: ISO 9000 Certified DB Printed in USA Order No.S14062.E2 Doc. No. DB The LSI Logic logo design, Fusion-MPT, and MetaStor are trademarks or registered trademarks of LSI Logic Corporation. Sun and Solaris are trademarks or registered trademarks of Sun Microsystems, Inc. All other brand and product names may be trademarks of their respective companies. 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 liability 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 under any patent rights, copyrights, trademark rights, or any other of the intellectual property rights of LSI Logic or of third parties. 8 LSI40909G-S PCI to Fibre Channel Host Adapter for Sun Solaris