You are on page 1of 128

Q

Simplify

SANsurfer FC HBA CLI Application Users Guide


Command Line Interface for SANblade Fibre Channel Host Bus Adapters

SN0054614-00 B

Page i

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document. No part of this document may be copied nor reproduced by any means, nor translated nor transmitted to any magnetic medium without the express written consent of QLogic Corporation. Linux is a registered trademark of Linus Torvalds. Microsoft and Windows are registered trademarks and Windows Server is a trademark of Microsoft Corporation. QLA, QLogic, SANsurfer, and the QLogic logo are registered trademarks of QLogic Corporation. SANsurfer Manager Suite is a trademark of QLogic Corporation. Red Hat and all Red Hat-based trademarks are trademarks or registered trademarks of Red Hat, Inc. Solaris is a registered trademark of Sun Microsystems, Inc. SPARC is a registered trademark of SPARC International, Inc. Products bearing SPARC trademarks are based on an architecture developed by Sun Microsystems, Inc. SuSE is a registered trademark of SuSE Linux AG. WinZip is a registered trademark of WinZip Computing, Inc. All other brand and product names are trademarks or registered trademarks of their respective owners. Document Revision History Rev. A, 8/20/04 Rev. B, 9/28/05 Changes Product name change to SANsurfer FC HBA CLI. SANsurfer CLI support, hardware: Added QLA23xx and QLA/QLE24xx HBAs. SANsurfer CLI support, software: Red Hat Linux: added version 4.0. Solaris SPARC: removed versions 2.8 and 2.9. Added versions 8, 9, and 10. Solaris: removed v2.9. Added versions 9 and 10 MAC: added support for MAC OS X. Power PC (PPC): added support for PPC OS. Changed installation instructions for Windows 2000 and Windows Server 2003. Added installation instructions for Power PC (PPC). Added installation instructions for MAC OS X. Changed uninstall instructions for Windows 2000 and Windows Server 2003. Added uninstall instructions for PCC. Installation instructions changed/combined for Solaris SPARC and Solaris x86. Command lines are now HBA port specific (from HBA number to HBA port number). Document Sections Affected All 1 1

3.1.1 3.1.2 3.1.4 3.2.1 3.2.2 3.2.3 4, A.2

Page ii

SN0054614-00 B

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

The following options/commands have been changed: Display System Information (-G and -Z): Added/modified -Z. Display HBA Settings (-C): removed Enable LIP reset from the list of settings displayed by this option. Display HBA Information (-I): added VDP information Target Persistent Binding (-P): naming changes made to submenus in interactive mode; no technical changes. Save/Update Option ROM (-B): Name changes made to submenus in interactive mode; no technical changes. Removed RG, FW, and BOOT parameters from non-interactive mode command. Expanded explanation of diagnostics commands in interactive mode; no technical changes. The following options/commands have been added: Flash HBA beacon: added ability to flash a target device beacon (-TB). Statistics (-GS and -LS) Help (-H); feature was available previously, but not documented. 4.15, A.2 4.17, 5.4.13, 5.4.14, A.2 4.18, A.2 4.1, A.2 4.2 4.3, A.2 4.7

4.12 4.12.2, A.2 4.16.2

SN0054614-00 B

Page iii

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

20042005 QLogic Corporation. All rights reserved worldwide. First Published: March 2004 Printed in U.S.A. QLogic Corporation, 26650 Aliso Viejo Parkway, Aliso Viejo, CA 92656, (800) 662-4471 or (949) 389-6000

Page iv

SN0054614-00 B

Table of Contents
Section 1 Section 2
2.1 2.2 2.3

Introduction Getting Started


Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1 2-1 2-3

Section 3
3.1 3.1.1 3.1.1.1 3.1.1.2 3.1.2 3.1.3 3.1.4 3.2 3.2.1 3.2.1.1 3.2.1.2 3.2.2 3.2.3

Initial Installation
Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows 2000, Windows Server 2003, and Enterprise Server . . . . . . Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Line Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Red Hat/SuSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Solaris SPARC and x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . MAC OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Uninstalling SANsurfer FC HBA CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . Windows 2000, Windows Server 2003, and Enterprise Server . . . . . . Standard (GUI) Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Line Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Red Hat/SuSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Solaris SPARC and Solaris x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1 3-2 3-2 3-5 3-6 3-6 3-8 3-8 3-9 3-9 3-9 3-9 3-10

Section 4
4.1 4.1.1 4.1.1.1 4.1.1.2 4.1.2 4.1.2.1 4.1.2.2 4.2 4.2.1 4.2.2 4.3 4.3.1 4.3.2

Command Line Options


Display System Information (Command Line Options -G and -Z) . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display HBA Complete Information . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display HBA Complete Information . . . . . . . . . . . . . . . . . . . . . . . . . Display HBA Settings (Command Line Option -C) . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display HBA Information (Command Line Option -I) . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1 4-1 4-1 4-2 4-2 4-2 4-2 4-3 4-4 4-5 4-5 4-6 4-8

SN0054614-00 B

Page v

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

Q
4-9 4-9 4-12 4-12 4-13 4-16 4-16 4-17 4-19 4-20 4-21 4-21 4-22 4-23 4-24 4-24 4-26 4-27 4-27 4-28 4-29 4-29 4-29 4-31 4-31 4-31 4-33 4-33 4-34 4-34 4-37 4-37 4-37 4-41 4-42 4-42 4-43 4-44 4-44

4.4 4.4.1 4.4.2 4.5 4.5.1 4.5.2 4.6 4.6.1 4.6.2 4.7 4.7.1 4.7.1.1 4.7.1.2 4.7.2 4.7.2.1 4.7.2.1.1 4.7.2.1.2 4.7.2.2 4.7.2.2.1 4.7.2.2.2 4.7.3 4.7.3.1 4.7.3.1.1 4.7.3.1.2 4.7.3.2 4.7.3.2.1 4.7.3.2.2 4.8 4.8.1 4.8.1.1 4.8.1.2 4.8.2 4.8.2.1 4.8.2.2 4.8.3 4.8.3.1 4.8.3.2 4.9 4.9.1

Display Device List (Command Line Option -T) . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Display LUN List (Command Line Option -L) . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Configure HBA Settings (Command Line Option -N) . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Target Persistent Binding (Command Line Option -P) . . . . . . . . . . . . . . . Display Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bind Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bind a Specific Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Bind All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unbind Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unbind a Specific Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Unbind All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Selective LUNs (Command Line Option -M). . . . . . . . . . . . . . . . . . . . . . . View Selective LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable/Disable a LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Enable/Disable All LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Boot Device (Command Line Option -E) . . . . . . . . . . . . . . . . . . . . . . . . . Viewing the Boot Device Selection . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page vi

SN0054614-00 B

Q
4.9.1.1 4.9.1.2 4.9.2 4.9.2.1 4.9.2.1.1 4.9.2.1.2 4.9.2.2 4.9.2.2.1 4.9.2.2.2 4.10 4.10.1 4.10.2 4.11 4.12 4.12.1 4.12.2 4.13 4.13.1 4.13.2 4.14 4.14.1 4.14.2 4.15 4.15.1 4.15.2 4.15.2.1 4.15.2.2 4.15.2.3 4.16 4.16.1 4.16.2 4.16.2.1 4.16.2.2 4.16.2.3 4.16.2.4

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters SANsurfer FC HBA CLI

Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45 Set Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46 Enable the HBAs Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49 Disable the HBAs Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50 Driver Settings (Command Line Option -FS) . . . . . . . . . . . . . . . . . . . . . . 4-50 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53 View Driver Settings (Command Line Option -FG). . . . . . . . . . . . . . . . . . 4-54 Save/Update Option ROM (Command Line Option -B) . . . . . . . . . . . . . . 4-54 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56 Save/Update NVRAM (Command Line Option -R). . . . . . . . . . . . . . . . . . 4-56 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-58 Update Driver (Windows 2000 and Windows Server 2003) (Command Line Option -D). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60 Flash HBA Beacon (Command Line Options -A and -TB) . . . . . . . . . . . . 4-60 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 View the HBA Ports Flashing State . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Start or Stop Flashing the HBA Ports LED . . . . . . . . . . . . . . . . . . . 4-61 Start or Stop Flashing a Targets LED . . . . . . . . . . . . . . . . . . . . . . . 4-62 Diagnostics (Command Line Options -KL and -KR) . . . . . . . . . . . . . . . . . 4-62 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63 Data Pattern: DP <Parameter Value> or DataPattern < Parameter Value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64 Data Size: DS <Parameter Value> or DataSize <Parameter Value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64 Number of Tests: TC <Parameter Value> or TestCount <Parameter Value> 4-65 Test Increment: TI <Parameter Value> or Test Increment <Parameter Value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65

SN0054614-00 B

Page vii

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

Q
4-65 4-65 4-67 4-69 4-69 4-69 4-72 4-72 4-73 4-75 4-76 4-76 4-76 4-77 4-78 4-78 4-79 4-79

4.16.2.5 4.16.2.6 4.16.2.7 4.17 4.17.1 4.17.1.1 4.17.1.2 4.17.2 4.17.2.1 4.17.2.2 4.18 4.18.1 4.18.2 4.19 4.20 4.21 4.22 4.23

On Error: OE <Parameter Value> or OnError <Parameter Value> . Run a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Run a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Statistics (Command Line Options -GS and -LS) . . . . . . . . . . . . . . . . . . . HBA Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Help (Command Line Option -H) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Input From a File (Command Line Option -F). . . . . . . . . . . . . . . . . . . . . . Output to a File (Command Line Option -O). . . . . . . . . . . . . . . . . . . . . . . Silent Mode (Command Line Option -S). . . . . . . . . . . . . . . . . . . . . . . . . . Display Version (Command Line Option -V). . . . . . . . . . . . . . . . . . . . . . . Output in XML Format (Command Line Option -X) . . . . . . . . . . . . . . . . .

Section 5
5.1 5.2 5.3 5.4 5.4.1 5.4.2 5.4.3 5.4.4 5.4.5 5.4.6 5.4.7 5.4.8 5.4.9 5.4.10 5.4.11 5.4.12 5.4.13 5.4.14

XML Format
Main Tag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Utility Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 Status Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1 XML Message for Each Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2 Display System Information (Command Line Option -G) . . . . . . . . . . . 5-2 Display Adapter Settings (Command Line Option -C) . . . . . . . . . . . . . 5-3 Display HBA Information (Command Line Option -I) . . . . . . . . . . . . . . 5-4 Display Device List (Command Line Option -T) . . . . . . . . . . . . . . . . . . 5-4 Display LUN List (Command Line Option -L) . . . . . . . . . . . . . . . . . . . . 5-5 Target Persistent Binding (Command Line Option -P) . . . . . . . . . . . . . 5-5 Selective LUNs (Command Line Option -M) . . . . . . . . . . . . . . . . . . . . 5-5 Boot Device (Command Line Option -E) . . . . . . . . . . . . . . . . . . . . . . . 5-6 Diagnostics ResultsLoopback Test (Command Line Option -KL) . . 5-6 Diagnostics ResultsRead/Write Buffer Test (Command Line Option -KR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6 View Driver Settings (Command Line Option -FG) . . . . . . . . . . . . . . . 5-7 Display All Information for One or All HBAs (Command Line Option -Z) 5-7 LInk Statistics (Command Option -LS) . . . . . . . . . . . . . . . . . . . . . . . . . 5-10 HBA Statistics (Command Option -GS) . . . . . . . . . . . . . . . . . . . . . . . . 5-10

Page viii

SN0054614-00 B

Q
Appendix A
A.1 A.2 A.2.1 A.2.2

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters SANsurfer FC HBA CLI

EBNF Format of Command Line


Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Non-Interactive Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1 6-1 6-1 6-2

Figures Figure
2-1 3-1 3-2 3-3 3-4 3-5 4-1 4-2 SANsurfer FC HBA CLI Main Menu (Windows 2000/Windows Server 2003)Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Welcome Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Destination Folder Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Ready to Install DIalog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Installing SANsurfer DIalog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . InstallShield Wizard Completed DIalog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sample Loopback Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Sample Read/Write Buffer Test Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page
2-2 3-2 3-3 3-4 3-4 3-5 4-67 4-68

Tables Table
2-1 4-1 4-2 4-3 4-4 4-5 4-6 4-7 5-1 A-1 A-2 A-3 A-4 A-5 A-6 Non-Interactive Mode Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options Displayed by -Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . On Error Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Driver Versions that Do Not Require a Loopback Connector . . . . . . . . . . . . . . . . . . HBA Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Options Displayed by -Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Command Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Diagnostics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . HBA Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Page
2-3 4-2 4-19 4-54 4-65 4-66 4-72 4-76 5-7 6-2 6-3 6-6 6-7 6-8 6-9

SN0054614-00 B

Page ix

SANsurfer FC HBA CLI Application Users Guide Command Line Interface for SANblade Fibre Channel Host Bus Adapters

Notes

Page x

SN0054614-00 B

Introduction
The SANsurfer command line interface (CLI) application is a simplified, condensed version of the SANsurfer FC HBA Manager GUI. SANsurfer FC HBA CLI does not provide any features that require a GUI. SANsurfer FC HBA CLI is supported for QLA22xx, QLA/QLE23xx, and QLA/QLE24xx HBAs on the following operating systems:

Section 1

Windows 2000/SP4 Server and Advanced Server SP4: IA32 Windows 2003 Server and Enterprise Server: IA-32, IA-64, IEM64T, and AMD64 Red Hat Linux AS v2.1, 3.0, and 4.0: IA-32, IA-64, IEM64I, and AMD64 Red Hat Linux 9 Professional: IA-32 only SuSE Linux Enterprise Server (SLES) 8 and 9: IA-32, IA64, IEM64I, and AMD64 Power PC (PPC) SLES 8 and 9 Solaris SPARC v2.6, 2.7, 8, 9, and 10 Solaris 9 x86 and 10 x86 MAC OS X 10.3.x/10.4.x (Power Mac) Throughout this guide, HBA and adapter are used interchangeably. Target and device are also used interchangeably.

NOTE:

1.1

Technical Support
Customers should contact their authorized maintenance provider for technical support of their QLogic HBA products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider. Visit the QLogic support Web site at: support.qlogic.com for the latest firmware and software updates.

SN0054614-00 B

1-1

1 Introduction Technical Support

Notes

1-2

SN0054614-00 B

Getting Started
2.1

Section 2

Introduction
SANsurfer FC HBA CLI operates in one of the following modes:

Interactive mode. SANsurfer FC HBA CLI starts, then waits for and executes input commands until terminated by the user. Use this mode to perform multiple operations. Non-interactive mode. SANsurfer FC HBA CLI starts, performs functions defined by the list of parameters provided, then terminates. In this mode, the application is executed from a script file or when you want to perform a single operation.

In both modes, SANsurfer FC HBA CLI is not case sensitive. However, file names in some operating systems are case sensitive; in this case, SANsurfer FC HBA CLI is case sensitive for that particular file.
2.2

Interactive Mode
Type the following in a command window to start SANsurfer FC HBA CLI in interactive mode:
scli INT or scli

SN0054614-00 B

2-1

2 Getting Started Interactive Mode

Q
SANsurfer FC HBA CLI v1.06.16 Build 19
Main Menu 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Display System Information Display HBA Settings Display HBA Information Display Device List Display LUN List Configure HBA Settings Target Persistent Binding Selective LUNs Boot Device Driver Settings HBA Utilities Flash Beacon Diagnostics Statistics Help Quit Enter Selection:

The Main Menu (see figure 2-1) displays. For example:

Figure 2-1. SANsurfer FC HBA CLI Main Menu (Windows 2000/Windows Server 2003)Interactive Mode Depending on the menu selection, SANsurfer FC HBA CLI prompts for more input as needed. For example, if you select Configure HBA Settings, SANsurfer FC HBA CLI prompts you for the number that corresponds to the adapter port you want to configure. NOTE:

The Update Driver option under HBA Utilities (option 11) is only available on Windows 2000, Windows Server 2003, and Enterprise Server (IA32, IA64, and AMD64). In Solaris SPARC, the option to Save/Update BIOS is Save/Update FCode.

2-2

SN0054614-00 B

Q
2.3

2 Getting Started Non-interactive Mode

Non-interactive Mode
Type the following in a command window to start SANsurfer FC HBA CLI in non-interactive mode:
scli <Parameters>

SANsurfer FC HBA CLI executes the command options, then terminates. To list all of the available command line parameters and the SANsurfer FC HBA CLI version, type the following:
scli -h or scli -?

In Solaris SPARC, include double quotes around the view option (?) if the system is running with a csh or tsch shell. For example:
# scli -e 0 "?"

For world wide node name (WWNN), world wide port name (WWPN), and port ID parameter inputs, SANsurfer FC HBA CLI accepts the notation with and without the dash (-). Hexadecimal values can be uppercase or lowercase.

The following input formats are valid for the WWNN and WWPN:
20-00-00-E0-8B-01-83-C4 200000E08B0183C4

The following inputs are valid for the port ID:


68-5C-AB 685CAB

All command line options must be preceded by the dash (-) or forward slash (/) notation. Most options have a corresponding menu selection in interactive mode. The valid command line options are listed in table 2-1. Table 2-1. Non-Interactive Mode Options
Interactive Menu Selection (Red Hat/SuSE NonInteractive interactive Menu Selection Linux, Solaris SPARC) Option (Windows) -G -Z -C -I -T -L 1 1 2 3 4 5 1 1 2 3 4 5

Description Display system information Display all information for one or all HBAs Display HBA settings Display HBA information Display device list Display LUN list

Section 4.1 4.1 4.2 4.3 4.4 4.5

SN0054614-00 B

2-3

2 Getting Started Non-interactive Mode

Q
Table 2-1. Non-Interactive Mode Options (Continued)

Interactive Menu Selection (Red Hat/SuSE NonInteractive interactive Menu Selection Linux, Solaris SPARC) Option (Windows) -N -P -M -E -FS -FG -B -R -D -A -KL/-KR -GS -LS -H -? -F -O -S -V -X 6 7 8 9 10 10 11 11 11 11 12 13 14 14 15 15 16 6 7 8 9 10 10 11 11 11 12 13 14 14 15 15 16

Description Configure HBA settings Target persistent binding Selective LUNs Boot device Driver Settings View Driver Settings HBA Utilities Save/update BIOSa/FCodeb Save/update NVRAM Update driver Flash HBA beacon Diagnostics HBA Statistics Link Status Display usage Display usage Quit Input from a file Output to a file Silent mode Display version Output in XML format

Section 4.6 4.7 4.8 4.9 4.10 4.11 4.12 4.13 4.14 4.15 4.16 4.17.1 4.17.2 4.18 4.19 4.20 4.21 4.22 4.23

Table Notes aWindows 2000, Windows Server 2003, Enterprise Server, Red Hat/SuSE Linux
b

Solaris SPARC

Options that have a corresponding menu selection cannot be combined: only one option is allowed in a single command. If multiple options are specified in a command, only the first one is processed. These options, however, can be combined with one or more options that do not have a corresponding menu selection, with the exception of -F.

2-4

SN0054614-00 B

Q
Error <error message> SANsurfer FC HBA CLI v1.06.16 Build 20 Copyright 2003-2005 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters description of command entered Usage: <current command use usage>

2 Getting Started Non-interactive Mode

For all command line options, SANsurfer FC HBA CLI displays the following when there are errors in the command line input:

SN0054614-00 B

2-5

2 Getting Started Non-interactive Mode

Notes

2-6

SN0054614-00 B

Initial Installation
The following requirements must be met before you run SANsurfer FC HBA CLI:

Section 3

The HBAs must be installed. The HBA drivers must be installed. You need approximately 3 MB on the PC to install the SANsurfer FC HBA CLI application. SANsurfer FC HBA CLI is an application developed to configure QLogic HBAs. It can only configure HBAs on the local machine upon which the application is installed; it cannot configure HBAs on remote machines.

NOTE:

3.1

Installation Instructions
Perform the following steps to download the SANsurfer FC HBA CLI installation package from the QLogic Web site: 1. From the QLogic home page (www.qlogic.com), click Support. 2. Click Drivers, Software, and Manuals. 3. Select your HBA. 4. Click the appropriate operating system under the Drivers and Management Software heading. 5. In the SANblade CLI row of the table, click Download. 6. The File Download dialog box displays. Click Save. Select a directory on your system and download the file. 7. Follow the installation instructions in the section that corresponds to your operating system (OS):

Windows 2000, Windows Server 2003, and Enterprise Server (see section 3.1.1) Red Hat/SuSE Linux/PPC (see section 3.1.2) Solaris SPARC/Solaris X86 (see section 3.1.3) MAC OS X (see section 3.1.4)

SN0054614-00 B

3-1

3 Initial Installation Installation Instructions

3.1.1

Windows 2000, Windows Server 2003, and Enterprise Server


Perform the steps in one of the following sections to install SANsurfer FC HBA CLI:

Standard (GUI) installation (see section 3.1.1.1) Command line installation (see section 3.1.1.2)

3.1.1.1

Standard (GUI) Installation


Perform the following steps to install SANsurfer FC HBA CLI on a Windows 2000 or Windows Server 2003 operating system: 1. Locate and double-click the installer package. The Welcome dialog box displays (see figure 3-1).

Figure 3-1. Welcome Dialog Box 2. Read the information, then click Next.

3-2

SN0054614-00 B

3 Initial Installation Installation Instructions

3. The Destination Folder dialog box displays (see figure 3-2).

Figure 3-2. Destination Folder Dialog Box Do one of the following:

To select the destination location displayed in the dialog box, click Next (recommended). The default location for a Windows 2000/Windows Server 2003 system is: Program Files\QLogic Corporation\SANsurferCLI

To select a different location: a. Click Choose. b. Select the desired location. c. The Destination Folder dialog box redisplays. Click Next.

SN0054614-00 B

3-3

3 Initial Installation Installation Instructions

4. The Ready to Install dialog box displays (see figure 3-3).

Figure 3-3. Ready to Install DIalog Box Read the information, then click Next. 5. The Installing SANsurfer dialog box displays (see figure 3-4).

Figure 3-4. Installing SANsurfer DIalog Box If you want to stop the installation, click Cancel.

3-4

SN0054614-00 B

3 Initial Installation Installation Instructions

6. The InstallShield Wizard Completed dialog box displays (see figure 3-5).

Figure 3-5. InstallShield Wizard Completed DIalog Box Read the information. If you want to start SANsurfer FC HBA CLI, select the Launch SANsurfer check box. Click Finish.
3.1.1.2

Command Line Installation


Do one of the following:

Type the following text for a standard installation of SANsurfer FC HBA CLI on a Windows 2000 or Windows Server 2003 operating system:
msiexec /i scli-1.06.16-20.windows.msi

Type the following text to install SANsurfer FC HBA CLI in silent mode:
msiexec /i scli-1.06.16-20.windows.msi /q

NOTE:

By default, the SANsurfer FC HBA CLI application is installed in the following directory: Program files\QLogic Corporation\SANsurferCLI. If you want to change the applications location, enter the directory in the command line; for example:
msiexec /i scli-1.06.16-20.windows.msi installdir="c:\sansurfercli"

SN0054614-00 B

3-5

3 Initial Installation Installation Instructions

3.1.2

Red Hat/SuSE Linux/PPC


Perform the following steps to install SANsurfer FC HBA CLI on a Red Hat/SuSE Linux/Power PC (PPC) operating system: 1. Download the scli-x.xx.xx-xx.i386.rpm.gz file (from the QLogic Web site or the SANsurfer Management Suite CD-ROM) to your local machine. In the file name, x.xx.xx stands for the current version of SANsurfer FC HBA CLI. 2. Uncompress the file with the following command:
gwnzip <File>

3. Enter the following command to install the package:


rpm -iv scli-x.xx.xx-xx.i386.rpm

NOTE:

For SuSE SLES IA64, the command line is:

rpm --iv scli-x.xx.xx-xx.ia64.rpm --nodeps

The new package is installed in the following directory: /opt/QLogic_Corporation/SANsurferCLI. To query for the installed SANsurfer FC HBA CLI package name, enter the following text from the command line:
rpm -q scli
3.1.3

Solaris SPARC and x86


Perform the following steps to install SANsurfer FC HBA CLI on a Solaris SPARC or Solaris x86 operating system: 1. Download the scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg.Z file (from the QLogic Web site or the SANsurfer Management Suite CD-ROM) to a temporary directory on your machine. For example:
/tmp

NOTE:

In the file name, x.xx.xx-xx stands for the current version of SANsurfer FC HBA CLI. The -xx stands for the build version.

2. Type the following to uncompress the file:


# uncompress scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg.Z

3. Type the following to see the available package file:


# ls

The available packages display. For example:


#scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg

3-6

SN0054614-00 B

Q
4. Type the following to install SANsurfer FC HBA CLI: 5. You are prompted to select a package. For example:
1 QLScli

3 Initial Installation Installation Instructions

# pkgadd -d scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg

2 QLSclis

3 QLSclis

SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) 1.06.16 Build 22 (Solaris 8-10) SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) 1.06.16 Build 22 (Solaris 2.6-7) SANsurfer FC HBA CLI (HBA Configuration Utility) (x86) 1.06.16 Build 22 (Solaris 8-10)

Select the package(s) you wish to process (or "all" to process all packages). (default:all) [?,??,q]:

Type the number that corresponds to your operating system, then press ENTER. 6. The pkgadd program performs a series of checks, then posts a script warning and asks whether to continue the installation. For example:
Processing package instance <QLScli> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) 1.06.16 (Build 22 Solaris 8-10) QLogic Corporation ## Executing checkinstall script. ## Processing package information. ## Processing system information. 3 package pathnames are already properly installed. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. . . . [ verifying class <none>] ## Executing postinatall script. Installation of <QLScli> was successful.

SN0054614-00 B

3-7

3 Initial Installation Uninstalling SANsurfer FC HBA CLI

3.1.4

MAC OS X
Perform the following steps to install SANsurfer FC HBA CLI on a MAC OS X: 1. If you havent already, download the installation package (compressed tar file) to a local directory. 2. Type the following command to uncompress the file:
tar -zxvf <file>.tgz

For example:
qlogic:~ root#tar -zxvf scli.1.06.16-20.macos.pkg.tgz ./scli.1.06.16-20.pkg/ (directory to which the file is extracted) ./scli.1.06.16-20.pkg/Contents/ ./scli.1.06.16-20.pkg/Contents/Archive.bom ./scli.1.06.16-20.pkg/Contents/Archive.pax.gz

3. Type the following command to install the package. This command installs SANsurfer FC HBA CLI in the following directory: /var/root/Applications/QLogic_Corporation/SANsurferCLI
installer -pkg <file> -target /

For example:
qlogic:~ root# installer -pkg scli.1.06.16-20.pkg -target / installer: Package name is SANsurfer FC HBA CLI 1.06.16 Build 20 installer: Installing onto volume mounted at /. installer: The install was successful.

4. Type the following command to upgrade to existing package.


installer -pkg <file> -target /

For example:
qlogic:~ root# installer -pkg scli.1.06.16-20.pkg -target / installer: Package name is SANsurfer FC HBA CLI 1.06.16 Build 20 installer: Upgrading volume mounted at /. installer: The upgrade was successful.
3.2

Uninstalling SANsurfer FC HBA CLI


NOTE: Uninstalling SANsurfer FC HBA CLI is not necessary for MAC OS X; the native installer automatically updates the application whenever it detects a change in the application version.

3-8

SN0054614-00 B

Q
3.2.1

3 Initial Installation Uninstalling SANsurfer FC HBA CLI

Windows 2000, Windows Server 2003, and Enterprise Server


Perform the steps in one of the following sections to uninstall SANsurfer FC HBA CLI:

Standard (GUI) uninstall (see section 3.2.1.1) Command line uninstall (see section 3.1.1.2)

3.2.1.1

Standard (GUI) Uninstall


To uninstall SANsurfer FC HBA CLI using the GUI, perform the following steps: 1. From the Control Panel, click Add or Remove Programs. 2. Highlight the SANsurfer FC HBA CLI application. 3. Click Remove. No re-boot is required.
3.2.1.2

Command Line Uninstall


To uninstall SANsurfer FC HBA CLI using the command line, type the following:
msiexec.exe /x {D4AB108C-6B03-49A3-AC9E-1D29761300C3}
3.2.2

Red Hat/SuSE Linux/PPC


To uninstall SANsurfer FC HBA CLI, type one of the following at the command line, where x.xx.xx is the current version of CLI:
rpm -e scli-x.xx.xx-xx rpm -e scli

To query for the installed SANsurfer FC HBA CLI package name, enter the following text from the command line:
rpm -q scli

SN0054614-00 B

3-9

3 Initial Installation Uninstalling SANsurfer FC HBA CLI

3.2.3

Solaris SPARC and Solaris x86


Perform the following steps to uninstall SANsurfer FC HBA CLI: 1. Type the following to remove SANsurfer FC HBA CLI:
# pkgrm package name (QLScli, QLSclis, or QLSclix)

2. The program displays the package name and a script warning asking whether to continue the uninstall process. For example:
The following package is currently installed: QLScli SANsurfer FC HBA CLI (HBA Configuration Utility) (sparc) 1.06.16 Build 22 (Solaris 8-10)

Do you want to remove this package?

3. Type y and press ENTER. The program displays a script warning asking whether to continue the uninstall process. For example:
## Removing installed package instance <QLScli> This package contains scripts which will be executed with super-user permission during the process of removing this package Do you want to continue with the removal of this package [y,n,?,q]

4. Type y and press ENTER. The pkgrm program notifies you when the uninstall process is complete. For example:
## Verifying package dependencies. ## Processing package information. ... /opt/QLogic_Corporation <shared pathname not removed> /opt <shared pathname not removed> ## Executing postremove script. scli removed. Menu property file removed. Adapter property file removed. SCLI property file removed. ## Updating system information. Removal of <QLScli> was successful.

3-10

SN0054614-00 B

Command Line Options


The following sections describe the command line options listed in table 2-1. The options are described in both interactive and non-interactive modes.
4.1

Section 4

Display System Information (Command Line Options -G and -Z)


4.1.1

Interactive Mode
When this option is selected, the HBA General Information Menu displays. You are prompted to select one of the following: 1. Display Host Information (see section 4.1.1.1) 2. Display HBA Complete Information (see section 4.1.1.2)
4.1.1.1

Display Host Information


When this option is selected, the application displays the following information about the local machine:

Host name OS type OS version (patches where applicable) Failover (FO) API version SAN device management (SDM) API version QLogic direct driver version (if installed) List of HBAs: HBA model, port number, WWPN, serial number (SN), firmware version (FW), and status (online/offline) Total number of QLogic Fibre Channel HBAs detected The failover and SAN device management APIs are QLogic-specific libraries required for SANsurfer FC HBA CLI. The versions of these libraries are useful for debugging purposes.

NOTE:

SN0054614-00 B

4-1

4 Command Line Options Display System Information (Command Line Options -G and -Z)

4.1.1.2

Display HBA Complete Information


When this option is selected, you are prompted to select either an HBA port, or all HBAs. The application displays the information in section 4.1.1.1, as well as the following additional information:

HBA general information HBA vital product data (VPD) HBA NVRAM settings Attached devices/LUNs Target persistent binding Selective LUNs Boot device Driver settings: persistent and binding

4.1.2

Non-interactive Mode
4.1.2.1

Display Host Information


To display the system information (see section 4.1.1.1), type the following command:
# scli -G
4.1.2.2

Display HBA Complete Information


Use this option to display all the information for one or all of the HBA ports in the system. This option displays all of the HBAs information in a single command. The information displayed by the -Z option is the combination of the commands listed in table 4-1. Table 4-1. Options Displayed by -Z
Non-interactive Option -G -C -I -T -L -P -M Description Display system information Display HBA settings Display HBA information Display device list Display LUN list Configure target persistent binding Configure selective LUNs Section 4.1 4.2 4.3 4.4 4.5 4.7 4.8

4-2

SN0054614-00 B

Q
Non-interactive Option -E -KL -KR -GS -LS

4 Command Line Options Display HBA Settings (Command Line Option -C)

Table 4-1. Options Displayed by -Z (Continued)


Description Configure boot device Run loopback test Run read/write test Display and change HBA statistics Display and change link status Section 4.9 4.16 4.16 4.17 4.17

To display the information in table 4-1 for a single HBA port, type the following command:
# scli -Z (<HBA Port No.> | <HBA WWPN>)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA

To display the information in table 4-1 for all ports on all HBAs, type one of the following commands:
# scli -Z ALL # scli -Z
4.2

Display HBA Settings (Command Line Option -C)


When this option is selected, the application displays the following HBA settings:

Connection options Data rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx HBAs) Frame size Hard Loop ID Loop reset delay (in seconds) Enable host HBA BIOS Enable hard loop ID Enable FC tape support Operation mode Interrupt delay timers Execution throttle Enable extended error logging Login retry count Port down retry count Enable LIP full login

SN0054614-00 B

4-3

4 Command Line Options Display HBA Settings (Command Line Option -C)

Link down timeout (in seconds) Enable target reset LUNs per target

4.2.1

Interactive Mode
SANsurfer FC HBA CLI prompts you to select a display option: view these parameters for all HBAs or for a specific HBA. If you select a specific HBA, a list of HBAs is displayed. Type the number that corresponds to the HBA, then press ENTER. The following text is an example of the Display HBA Settings option.
Main Menu 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Display System Information Display HBA Settings Display HBA Information Display Device List Display LUN List Configure HBA Settings Target Persistent Binding Selective LUNs Boot Device Driver Settings HBA Utilities Flash Beacon Diagnostics Statistics Help Quit Enter Selection: 2 SANsurfer FC HBA CLI v1.06.14 Build 24 HBA NVRAM Information Menu 1: Display Specific HBA Settings 2: Display All HBA Settings Note: 0 to return to Main Menu Enter Selection: 1 -----------------------------------------------------------------HBA Port 1- QLA200 Port Name: 21-01-00-E0-8B-3A-BB-30 Port ID: 11-06-EF -----------------------------------------------------------------Connection Options : Point to Point Data Rate : 2 Gbps

4-4

SN0054614-00 B

4 Command Line Options Display HBA Information (Command Line Option -I)

Frame Size : Loop Reset Delay (seconds) : Enable Host HBA BIOS : Enable FC Tape Support : Execution Throttle : Enable Extended Error Logging: Login Retry Count : Enable LIP Reset : Port Down Retry Count : Enable LIP Full Login : Link Down Timeout (seconds) : Enable Target Reset : LUNs Per Target :

2048 5 Disabled Enabled 16 Disabled 8 Disabled 30 Enabled 30 Enabled 128

Press <Enter> to continue:


4.2.2

Non-interactive Mode
To display the parameter settings for all HBA ports in the system, type one of the following commands:
# scli -C ALL # scli -C

To display the parameter settings for a specific HBA port, type the following command:
# scli -C (<HBA Port No.> | <WWPN>)

Where:
HBA Port No. = HBA port number WWPN = World wide port name of the HBA
4.3

Display HBA Information (Command Line Option -I)


When this option is selected, SANsurfer FC HBA CLI displays either general information or VPD information about the selected HBAs. General information includes:

Host name
HBA model

HBA port number


HBA node name (WWNN) HBA port name (WWPN)

SN0054614-00 B

4-5

4 Command Line Options Display HBA Information (Command Line Option -I)

HBA port ID

Serial number Driver version BIOS version (Windows 2000, Windows Server 2003, Enterprise Server, and Red Hat/SuSE Linux/PPC) Firmware version Actual connection mode Actual data rate PortType (topology) Device target count PCI bus number (Windows 2000, Windows Server 2003, Enterprise Server, and Red Hat/SuSE Linux/PPC) PCI slot number (Windows 2000, Windows Server 2003, Enterprise Server, and Red Hat/SuSE Linux/PPC) HBA status (online, offline)

Vital product data (VPD) information includes:


HBA port number HBA model HBA port name (WWPN) HBA port ID Product identifier VPD-R tag (VPD ReadOnly field) (if available) Part number (HBA model) Serial number Misc. information (for example, PCI and PCI-X speeds) Manufacturing ID EFI driver version Firmware version BIOS version FCode version Asset tag End tag

4.3.1

Interactive Mode
SANsurfer FC HBA CLI prompts you to select a display option: view the HBA general information or view HBA VPD information. After selecting a display option, you are prompted to select a specific HBA port or all HBA ports. If you select a specific HBA

4-6

SN0054614-00 B

4 Command Line Options Display HBA Information (Command Line Option -I)

port, a list of HBA ports is displayed. Type the number that corresponds to that HBA port, then press ENTER. The following text is an example of the Display HBA Information option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 3 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA Information Menu 1: HBA General Information 2: HBA VPD Information Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA 1: 2: 3: General Information Menu Display Specific HBA Information Display All HBA Information Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20

SN0054614-00 B

4-7

4 Command Line Options Display HBA Information (Command Line Option -I)

Select HBA Port: HBA Model QLA200: 1: Port 0: WWPN: 21-00-00-E0-8B-17-D2-DF Online HBA Model QLA2362: 2: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online 3: Port 2: WWPN: 21-00-00-E0-8B-1A-BB-30 Online 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 -----------------------------------------------------------------Host Name : BRAGI HBA Model : QLA2362 Port : 1 Node Name : 20-01-00-E0-8B-3A-BB-30 Port Name : 21-01-00-E0-8B-3A-BB-30 Port ID : 11-06-EF Serial Number : R16411 Driver Version : SCSI Miniport 9.1.0.10 Beta 5 (w32 IP) BIOS Version : 1.02 Firmware Version : 3.03.13 Actual Connection Mode : Loop Actual Data Rate : 1 Gbps PortType (Topology) : FLPort Device Target Count : 8 PCI Bus Number : 1 PCI Slot Number : 33 HBA Status : Online -----------------------------------------------------------------Press <Enter> to continue:
4.3.2

Non-interactive Mode
To display the general information for all HBA ports in the system, type one of the following commands:
# scli -I ALL # scli -I

4-8

SN0054614-00 B

4 Command Line Options Display Device List (Command Line Option -T)

To display the general information for a specific HBA port, type the following command:
# scli -I (<HBA Port No.> | <HBA WWPN>)

To display VPD for all HBA ports in the system, type the following command:
# scli -I VPD # scli -I ALL VPD

To display VPD for a specific HBA port in the system, type the following command:
# scli -I (<HBA Port No.> | <HBA WWPN>) VPD

Where:
HBA Port No.

HBA port number

HBA WWPN = World wide port name of the HBA


4.4

Display Device List (Command Line Option -T)


When this option is selected, the application displays the following information about the devices:

Path Target Device ID Port ID Product vendor Product ID Product revision Node name Port name Product type Number of LUNs Status

4.4.1

Interactive Mode
To display the device list, perform the following steps: 1. Type the number for the Display Device List option, then press ENTER. 2. The Device Info - HBA Selection Menu displays. Select a display option: display the HBAs target information for all HBA ports or for a specific HBA port. If you select a specific HBA port, continue with step 3.

SN0054614-00 B

4-9

4 Command Line Options Display Device List (Command Line Option -T)

3. A list of HBA ports is displayed. Type the number that corresponds to the HBA, then press ENTER. 4. The Target Information Menu displays. Select a display option: display the information for all devices or for a specific device. If you selected a specific device, continue with step 5. 5. A list of devices is displayed. Type the number for the device, then press ENTER. The following text is an example of the Display Device List option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash HBA Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 4 SANsurfer FC HBA CLI v1.06.14 Build 24 Device Info - HBA Selection Menu: 1: Select HBA Port 2: Select All HBAs Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.14 Build 24 Select HBA Port: HBA Model QLA200: 1: HBA 0 - WWPN: xx-xx-xx-xx-xx-17-FF-74 Online HBA Model QLA2362: 2: HBA 1 - WWPN: xx-xx-xx-xx-xx-07-62-A0 Online

4-10

SN0054614-00 B

4 Command Line Options Display Device List (Command Line Option -T)

3: HBA 2 - WWPN: xx-xx-xx-xx-xx-02-D7-23 2200 Online 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.14 Build 24 Target Information Menu: 1: Display Specific Device Information 2: Display All Device Information 3: Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 1 Select Device: 1: Disk Vendor Product ID Port Name Port ID 2: Disk Vendor Product ID Port Name Port ID . . . 8: : : : : SEAGATE ST318453FC 21-00-00-20-37-15-97-0F 11-00-E4 : : : : SEAGATE ST318453FC 21-00-00-20-37-15-97-3D 11-00-E2

Disk Vendor Product ID Port Name Port ID Return to Previous Menu : : : : SEAGATE ST318203FC 21-00-00-20-37-38-73-BC 11-01-E8

9:

Note: 0 to return to Main Menu Enter Selection: 8 -----------------------------------------------------------------HBA Port 1 - QLA2362 Port Name: 21-01-00-E0-8B-3A-BB-30 Port ID: 11-06-EF -----------------------------------------------------------------Path : 0 Target : 7 Device ID : 0x8d Port ID : 11-01-E8 Product Vendor : SEAGATE

SN0054614-00 B

4-11

4 Command Line Options Display LUN List (Command Line Option -L)

Product ID : ST318203FC Product Revision : 0002 Node Name : 20-00-00-20-37-38-73-BC Port Name : 21-00-00-20-37-38-73-BC Product Type : Disk Number of LUN(s) : 1 Status : Online -----------------------------------------------------------------Press <Enter> to continue:
4.4.2

Non-interactive Mode
To display the device list for all HBA ports in the system, type one of the following commands:
# scli -T ALL # scli -T

To display the device information for a specific HBA port, type the following command:
# scli -T (<HBA Port No.> | <HBA WWPN>)

To display the device information for a specific device on an HBA port, type the following command:
# scli -T (<HBA Port No.> | <HBA WWPN>) (<Target WWPN> | <Target Port ID>)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Target WWPN = World wide port name of the target Target Port ID = Port ID of the target
4.5

Display LUN List (Command Line Option -L)


When this option is selected, SANsurfer FC HBA CLI displays the following information about the LUNs for a specified target:

Product vendor Product ID Product revision LUN

4-12

SN0054614-00 B

4 Command Line Options Display LUN List (Command Line Option -L)

Size (in GB or MB) WWULN (world-wide unique LUN name)

4.5.1

Interactive Mode
To display the HBAs LUN list, perform the following steps: 1. Type the number for the Display LUN List option, then press ENTER. 2. Select either Select HBA port or Select All HBAs. If you chose Select All HBAs, skip to step 4. 3. A list of HBA ports is displayed. Type the number that corresponds to the HBA port whose LUN list you want to view, then press ENTER. 4. Select Display Specific LUN Information or Display All LUN(s) Information. If you select a specific LUN, continue with the next step. 5. A list of devices is displayed. Type the number that corresponds to the device that contains the LUNs you want to view, then press ENTER. 6. A list of LUNs is displayed. Type the number that corresponds to the LUN you want to view, then press ENTER. The following text is an example of the Display LUN List option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 5 SANsurfer FC HBA CLI v1.06.16 Build 20

SN0054614-00 B

4-13

4 Command Line Options Display LUN List (Command Line Option -L)

LUN List: HBA Selection Menu: 1: Select HBA port 2: Select All HBAs Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Select HBA Port: HBA Model QLA200: 1: Port 0: WWPN: xx-xx-xx-xx-xx-17-FF-74 Online HBA Model QLA2362: 2: Port 1: WWPN: xx-xx-xx-xx-xx-07-62-A0 Online 3: Port 2: WWPN: xx-xx-xx-xx-xx-02-D7-23 Online 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 20 LUN 1: 2: 3: Information Menu: Display Specific LUN Information Display All LUN(s) Information Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Select Device: 1: Disk Vendor Product ID Port Name Port ID 2: Disk Vendor Product ID Port Name Port ID : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1 : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2

4-14

SN0054614-00 B

Q
3: Disk Vendor Product ID Port Name Port ID 4: Disk : : : :

4 Command Line Options Display LUN List (Command Line Option -L)

SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E4

5:

Vendor : SEAGATE Product ID : ST318203FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E8 Return to Previous Menu

Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Select LUN Number: 1: LUN 0 Vendor : SEAGATE Product ID : ST318453FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E2 Return to LUN Information Menu

2:

Note: 0 to return to Main Menu Enter Selection: 1 ----------------------------------------------------------------------------HBA Port 1 - QLA2362 Port Name: 21-01-00-E0-8B-3A-BB-30 Port ID: 11-06-EF ----------------------------------------------------------------------------Disk (21-00-00-20-37-38-73-BC) ----------------------------------------------------------------------------Product Vendor : SEAGATE Product ID : ST318203FC Product Revision : 0002 LUN : 0 Size : 16.96 GB WWULN : 20-00-00-20-37-38-73-BC Press <Enter> to continue:

SN0054614-00 B

4-15

4 Command Line Options Configure HBA Settings (Command Line Option -N)

4.5.2

Non-interactive Mode
To display the LUN information for all the devices for a specific HBA port, type the following command:
# scli -L <HBA Port No.> | <HBA WWPN>

To display the LUN information for a specific device for a specific HBA port, type the following command:
# scli -L (<HBA Port No.> | <HBA WWPN>) (<Target Port ID> | <Target WWPN>)

To display the LUN information for a specific LUN on a specific device for a specific HBA port, type the following command:
# scli -L (<HBA Port No.> | <HBA WWPN>) (<Target Port ID> | <Target WWPN>) <LUN ID>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Target Port ID = Port ID of the target Target WWPN = World wide port name of the target LUN ID = ID of the LUN
4.6

Configure HBA Settings (Command Line Option -N)


The following HBA parameters can be set by SANsurfer FC HBA CLI:

Connection options Data rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx HBAs) Frame size Hard loop ID Loop reset delay (in seconds) Enable host HBA BIOS Enable HBA hard loop ID Enable Fibre Channel tape support Operation mode (QLA/QLE23xx and QLA/QLE24xx HBAs, Windows 2000, Windows Server 2003, and Red Hat/SuSE Linux)

4-16

SN0054614-00 B

4 Command Line Options Configure HBA Settings (Command Line Option -N)

Interrupt Delay Timer (100 ms) (QLA/QLE23xx and QLA/QLE24xx HBAs, Windows 2000, Windows Server 2003, and Red Hat/SuSE Linux) Execution throttle Enable extended error logging Login retry count Enable LIP reset Port down retry count Enable LIP full login Link down timeout (in seconds) Enable target reset LUNs per target

After changing these parameters, you can do one of the following:


Commit changes for this HBA Abandon changes and return to the previous menu

4.6.1

Interactive Mode
Type the number corresponding to the HBA port, then press ENTER. A list of HBA parameters is displayed. When you make a selection from the list, SANsurfer FC HBA CLI prompts you for additional input. The following text is an example of the Configure HBA Settings option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash HBA Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit

SN0054614-00 B

4-17

4 Command Line Options Configure HBA Settings (Command Line Option -N)

Enter Selection: 6 SANsurfer FC HBA CLI v1.06.16 Build 20 Select HBA Port: HBA Model QLA2462: 1: Port 0 : WWPN: 21-00-00-E0-8B-00-00-00 Online 2: Port 1 : WWPN: 21-01-00-E0-8B-3C-A3-DE Online Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA's NVRAM Settings Menu: HBA Port 0 Model QLA2462: Online 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: 17: 18: 19: 20: 21: Connection Options Data Rate Frame Size Hard Loop ID Loop Reset Delay (seconds) Enable Host HBA BIOS Enable HBA Hard Loop ID Enable Fibre Channel Tape Support Operation Mode Interrupt Delay Timer (100ms) Execution Throttle Enable Extended Error Logging Login Retry Count Enable LIP Reset Port Down Retry Count Enable LIP Full Login Link Down Timeout (seconds) Enable Target Reset LUNs per Target Commit Changes for current HBA Abandon Changes and Return to Previous Menu Note: 0 to return to Main Menu Enter Selection:

4-18

SN0054614-00 B

Q
4.6.2

4 Command Line Options Configure HBA Settings (Command Line Option -N)

Non-interactive Mode
To set a specific parameter on a specific HBA, type the following command:
# scli -N (<HBA Port No.> | <HBA WWPN>) { (<Parameter Name> | <Parameter Alias>) <Parameter Value> }

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Parameter Name = Name of the parameters Parameter Alias = Alias of the parameters Parameter Value = New value of the parameters

The pairs <Parameter Name> <Parameter Value> and <Parameter Alias> <Parameter Value> can be repeated to set multiple parameters in a single command. The parameter names and aliases are defined in table 4-2. Table 4-2. HBA Parameters
Parameter Description Data rate Connection options Enable Fibre Channel tape support Maximum LUNs per target Enable hard loop ID Hard loop ID Frame size Enable LIP reset Enable LIP full login Enable target reset Enable extended logging Enable BIOS Loop reset delay Login retry count Parameter Name DataRate ConnectionOption EnableFCTape MaximumLUNsPerTarget EnableHardLoopID HardLoopID FrameSize EnableLipReset EnableLIPFullLogin EnableTargetReset EnableExtendedLogging EnableBIOS ResetDelay LoginReTryCount Parameter Alias DR CO EF ML HL HD FR LP FL TR EL EB RD LR Parameter Value 03a 02 for QLA23xx; 03 for QLA22xxb 1, 0c 0, 8, 16, 32, 64, 128, 256 1, 0c 0125 512, 1024, 2048 1, 0c 1, 0c 1, 0c 1, 0c 1, 0c 060 seconds 0255

SN0054614-00 B

4-19

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Q
Parameter Alias LT LD PD ET FE OM Parameter Value 0255 1, 0c, d 0255 1256 1, 0c, d 0, 5, 6e

Table 4-2. HBA Parameters (Continued)


Parameter Description Link down timeout Link down error Port down retry count Execution throttle Fast error reporting Operation mode (Not supported on Solaris) Interrupt delay timer (Not supported on Solaris) Parameter Name LinkDownTimeOut LinkDownError PortDownRetryCount ExecutionThrottle FastErrorReporting OperationMode

InterruptDelayTimer

ID

0255f

Table Notes aData rate (QLA23xx/QLA24xx/QLE23xx/QLE24xx HBAs): 0=1 Gbps, 1=2 Gbps, 2=Auto, 3=4 Gbps
b c

Connection options: 0=loop only, 1=point-to-point only, 2=loop preferred, otherwise point-to-point, 3=point-to-point, otherwise loop (QLA22xx HBAs) 1=Enable, 0=Disable This parameter is valid only in Solaris SPARC.

d e

Operation mode (QLA/QLE23xx and QLA/QLE24xx HBAs): 0=interrupt for every I/O completion, 5=interrupt when interrupt delay timer expires, 6=interrupt when interrupt delay timer expires or no active I/O
f

QLA/QLE23xx and QLA/QLE24xx HBAs

NOTE:

Please refer to SANsurfer HBA Manager Index Adapter setting for parameters related to QLA200/210.

4.7

Target Persistent Binding (Command Line Option -P)


The following sections describe how to view, set, and delete the HBAs target persistent binding in interactive and non-interactive modes.

4-20

SN0054614-00 B

Q
4.7.1

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Display Target Persistent Binding


4.7.1.1

Interactive Mode
Perform the following steps to view target persistent binding information for a single HBA port or for all HBA ports: 1. Type the number for the Show Binding Information option from the submenu, then press ENTER. A list of HBA ports is displayed. 2. Type the number that corresponds to either a HBA port or to all HBAs, then press ENTER. The following text is an example of the Target Persistent Binding option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 7 SANsurfer FC HBA CLI v1.06.16 Build 20 Target Persistent Binding Menu: 1: 2: 3: Show Binding Information Set Target Persistent Binding Unbind Target(s) Note: 0 to return to Main Menu Enter Selection: 1

SN0054614-00 B

4-21

4 Command Line Options Target Persistent Binding (Command Line Option -P)

SANsurfer FC HBA CLI v1.06.16 Build 19 Select HBA Port: HBA Model QLA2462: 1: Port 0: WWPN: 21-00-00-E0-8B-00-00-00 Online 2: Port 1: WWPN: 21-01-00-E0-8B-3C-A3-DE Online 3: All HBAs 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1
------------------------------------------------------------------------HBA Port 0 - QLA2462 Port Name: 21-00-00-E0-8B-07-62-A0 Port ID: 11-06-EF -------------------------------------------------------------------------Bind Type Device Node Name Device Port Name Port ID ID ---- ------- ------------------------------------------- --------No Disk 20-00-00-20-37-15-97-1E 21-00-00-20-37-15-97-1E 10-02-E1 Yes Disk 20-00-00-20-37-15-96-EC 21-00-00-20-37-15-96-EC 10-02-E2 0 Yes Disk 20-00-00-20-37-38-66-2D 21-00-00-20-37-38-66-2D 10-02-E4 1 Yes Disk 20-00-00-20-37-38-73-BC 21-00-00-20-37-38-73-BC 10-02-E8 2

Press <Enter> to continue:


4.7.1.2

Non-interactive Mode
To show target persistent binding information for a specific HBA port, type the following command:
# scli -P (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

To show target persistent binding information for all HBA ports, type the following command:
# scli -P ALL (VIEW | ?)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA

4-22

SN0054614-00 B

Q
# scli -P <HBA> "?"

4 Command Line Options Target Persistent Binding (Command Line Option -P)

In Solaris SPARC, include double quotes around the question mark (?) if the system is running with a csh or tsch shell. For example: SANsurfer FC HBA CLI displays all targets that are currently bound to the HBA. For example:
------------------------------------------------------------------------HBA Port 0 - QLA2462 Port Name: 21-00-00-E0-8B-07-62-A0 Port ID: 11-06-EF -------------------------------------------------------------------------Bind Type Device Node Name Device Port Name Port ID ID ---- ------- ------------------------------------------- --------No Disk 20-00-00-20-37-15-97-1E 21-00-00-20-37-15-97-1E 10-02-E1 Yes Disk 20-00-00-20-37-15-96-EC 21-00-00-20-37-15-96-EC 10-02-E2 0 Yes Disk 20-00-00-20-37-38-66-2D 21-00-00-20-37-38-66-2D 10-02-E4 1 Yes Disk 20-00-00-20-37-38-73-BC 21-00-00-20-37-38-73-BC 10-02-E8 2

Press <Enter> to continue:


4.7.2

Bind Targets
In interactive mode, select the Set Target Persistent Binding option from the submenu. The Target Persistent BindingBind Menu displays. From this menu, you can select specific devices to bind, or you can bind all devices. If target persistent binding information was saved in persistent storage and the machine is restarted, the driver reads the information saved in persistent storage during start up. SANsurfer FC HBA CLI then reads this information from the driver and sets the target IDs accordingly. The Set Target Persistent Binding option finds the devices seen by the OS. The target ID is a number between the range of 0255. In Windows, the target IDs have to be contiguous distinct numbers starting at 0. In Linux and Solaris, target IDs can be any number between 0 and 255 (256 for Linux) as long as there are no duplicate target IDs per HBA. In Solaris SPARC, target IDs can be assigned to both configured and unconfigured ports. Valid target ID values are in the range 0255. The IDs are validated before they are saved. Duplicate target IDs are not allowed. In Windows 2000, Windows Server 2003, and Enterprise Server, target IDs can be assigned only to ports that will be configured. Valid targets ID values are in the range 0(n1), where n is the number of targets attached to the HBA.

SN0054614-00 B

4-23

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Once persistent binding information for the targets is saved, the ports retain the assigned target IDs across reboots. NOTE: Be sure to set persistent binding for every target that the HBA sees; otherwise, only the persistently bound target is visible, and all other targets are invisible to the HBA when the system reboots.

4.7.2.1

Bind a Specific Target


4.7.2.1.1

Interactive Mode
Perform the following steps to bind a specific target to an HBA port: 1. From the Target Persistent Binding Menu, type the number for the Set Target Persistent Binding option, then press ENTER. The Target Persistent BindingBind Menu displays. 2. Type the number for the Bind Target(s) option, then press ENTER. 3. A list of HBA ports is displayed. Type the number that corresponds to the HBA port whose targets you want to bind, then press ENTER. 4. A list of devices attached to the HBA port are displayed. You are prompted to enter a new target ID. Type the number that corresponds to the device you want to bind, then press ENTER. 5. The Target Persistent BindingFC Configuration menu displays. Do one of the following:

To bind additional targets, type the number for the Select More option, then press ENTER. If you are finished binding targets, type the number for the Commit Changes option, then press ENTER. A message displays, indicating that a reboot is required for the changes to take effect.

The following text is an example of the Set Target Persistent Binding option.
Target Persistent Binding Menu: 1: 2: 3: Show Binding Information Set Target Persistent Binding Unbind Target(s) Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 20

4-24

SN0054614-00 B

Q
1: 2: 3:

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Target Persistent Binding Bind Menu Bind Target(s) Bind All Target(s) Return to Target Persistent Binding Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 19 Select HBA Port: HBA Model QLA2362: 1: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 2: Port 3: WWPN: 21-00-00-E0-8B-1A-BB-30 HBA Model QLA2462: 3: Port 2: WWPN: 21-00-00-E0-8B-1F-9D-F0 4: Port 4: WWPN: 21-01-00-E0-8B-3F-9D-F0 5: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 4 Select Device: 1: Disk Vendor Product ID Port Name Port ID Bind Target ID 2: Disk Vendor Product ID Port Name Port ID Bind Target ID 3: Disk Vendor Product ID Port Name Port ID Bind Target ID : : : : : : SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E4 Yes 1 : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2 Yes 0 : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1 No

Online Online Online Online

SN0054614-00 B

4-25

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Q
: : : : : : SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E8 Yes 2

4:

Disk Vendor Product ID Port Name Port ID Bind Target ID

5: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1

Please Enter New Target ID SANsurfer FC HBA CLI v1.06.16 Build 19

: 3

Target Persistent Binding FC Port Configuration 1: 2: 3: Select More Commit Changes Abort All Changes Note: 0 return to Main Menu Enter Selection: 2 Configuration saved on HBA port 4. Changes have been saved to persistent storage. You must reboot in order for the saved configuration to become effective. Press <Enter> to continue:
4.7.2.1.2

Non-interactive Mode
Type the following command to bind a target with a specific target ID:
# scli -P (<HBA Port No.> | <HBA WWPN>) (<Target WWNN> <Target WWPN> <Target Port ID> <Target ID>)

Where:
HBA Port No. = HBA number from HBA general information HBA WWNN = Word wide node name of the HBA HBA WWPN = World wide port name of the HBA Target WWNN = World wide node name of the target

4-26

SN0054614-00 B

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Target WWPN = World wide port name of the target Target Port ID = Port ID of the target Target ID = ID to which the target is bound

The group <Target WWNN> <Target WWPN> <Target Port ID> <Target ID> can be repeated to bind multiple targets in a single command. In Solaris, if a target has been designated as a boot device in section 4.9 and that target is persistently bound, the target ID cannot be modified.
4.7.2.2

Bind All Targets


4.7.2.2.1

Interactive Mode
Perform the following steps to bind all targets on a specific HBA: 1. From the Target Persistent Binding Menu, type the number for the Set Target Persistent Binding option, then press ENTER. 2. The Target Persistent BindingBind Menu displays. Type the number for the Bind All Target(s) option, then press ENTER. 3. A list of HBA ports is displayed. Type the number that corresponds to the HBA port whose targets you want to bind, then press ENTER. 4. A message displays, which says that the configuration is saved, changes have been saved to persistent storage, and a reboot is required for the changes to take effect. Press ENTER. The Target Persistent BindingBind Menu displays. 5. Do one of the following:

To bind targets for another HBA port, type the number for the Bind All Target(s) option, then press ENTER. If you are finished binding targets, type 0, then press ENTER.

The following text is an example of the Bind All Target(s) option:


Target Persistent Binding Menu: 1: 2: 3: Show Binding Information Set Target Persistent Binding Unbind Target(s) Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 22 T1

SN0054614-00 B

4-27

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Target Persistent Binding 1: 2: 3:

- Bind Menu

Bind Target(s) Bind All Target(s) Return to Target Persistent Binding Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 22 T1

Select HBA Port: HBA Model QLA2362: 1: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 2: Port 3: WWPN: 21-00-00-E0-8B-1A-BB-30 HBA Model QLA2462: 3: Port 2: WWPN: 21-00-00-E0-8B-1F-9D-F0 4: Port 4: WWPN: 21-01-00-E0-8B-3F-9D-F0 5: All HBAs 6: Return to Previous Menu

Online Online Online Online

Note: 0 to return to Main Menu Enter Selection: 4 Configuration saved on HBA port 4. Changes have been saved to persistent storage. You must reboot in order for the saved configuration to take effect. Press <Enter> to continue:
4.7.2.2.2

Non-interactive Mode
Type the following command to bind all targets on a specific HBA or to bind all targets on all HBAs:
# scli -P (<HBA Port No.> | <HBA WWPN> | ALL) Bind ALL

Where:
HBA Port No. = HBA number from HBA general information HBA WWPN = World wide port name of the HBA

4-28

SN0054614-00 B

Q
4.7.3

4 Command Line Options Target Persistent Binding (Command Line Option -P)

Unbind Targets
4.7.3.1

Unbind a Specific Target


4.7.3.1.1

Interactive Mode
Perform the following steps to remove persistent binding for a specific target: 1. From the Target Persistent Binding Menu, type the number for the Unbind Target(s) option, then press ENTER. 2. The Target Persistent BindingUnbind Menu displays. Type the number for the Unbind Specific Target(s) option, then press ENTER. 3. A list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 4. A list of devices is displayed. Type the number that corresponds to the device, then press ENTER. 5. A message is displayed, indicating that the configuration has changed, changes have been saved to persistent storage, and that a reboot is required for the changes to take effect. The following text is an example of the Target Persistent Binding option when persistent binding is removed for a specific target.
Target Persistent Binding Menu: 1: 2: 3: Show Binding Information Set Target Persistent Binding Unbind Target(s) Note: 0 to return to Main Menu Enter Selection: 3

SANsurfer FC HBA CLI v1.06.16 Build 20 Target Persistent Binding Unbind Menu 1: 2: 3: Unbind Specific Target(s) Unbind All Targets Return to Target Persistent Binding Menu Note: 0 to return to Main Menu Enter Selection: 1

SN0054614-00 B

4-29

4 Command Line Options Target Persistent Binding (Command Line Option -P)

SANsurfer FC HBA CLI v1.06.16 Build 20 Select HBA Port: HBA Model QLA2462: 1: Port 0 - WWPN: 21-00-00-E0-8B-00-00-00 Online 2: Port 1 - WWPN: 21-01-00-E0-8B-3C-A3-DE Online 3: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Select Device: 1: Disk Vendor Product ID Port Name Port ID Bind Target ID 2: Disk Vendor Product ID Port Name Port ID Bind Target ID 3: Disk Vendor Product ID Port Name Port ID Bind Target ID : : : : : : SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E4 Yes 1 : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2 Yes 0 : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1 Yes 3

4-30

SN0054614-00 B

Q
4: Disk Vendor Product ID Port Name Port ID Bind Target ID 5: Return to Previous Menu

4 Command Line Options Target Persistent Binding (Command Line Option -P)

: : : : : :

SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E8 Yes 2

Note: 0 to return to Main Menu Enter Selection: 3 Configuration changed on HBA port 1. Changes have been saved to persistent storage. You must reboot in order for the saved configuration to become effective. Press <Enter> to continue:
4.7.3.1.2

Non-Interactive Mode
Type one of the following commands to unbind a specific target:
# scli -P (<HBA Port No.> | <HBA WWPN>) (REMOVE <Target WWNN> | UNBIND <Target WWNN>)

Where:
HBA Port No. = HBA number from HBA general information HBA WWPN = World wide port name of the HBA Target WWNN = World wide node name of the target
4.7.3.2

Unbind All Targets


4.7.3.2.1

Interactive Mode
Perform the following steps to remove persistent binding for all targets on a specific HBA port or on all HBA ports: 1. From the Target Persistent Binding menu, type the number for the Unbind Target(s) option, then press ENTER. 2. The Target Persistent BindingUnbind menu displays. Type the number for the Unbind All Targets option, then press ENTER.

SN0054614-00 B

4-31

4 Command Line Options Target Persistent Binding (Command Line Option -P)

3. A list of HBA ports is displayed. Do one of the following:

Type the number that corresponds to the HBA port whose targets you want to unbind, then press ENTER. Type the number for the All HBAs option, then press ENTER.

4. A message is displayed, indicating that the configuration has changed, changes have been saved to persistent storage, and that a reboot is required for the changes to take effect. The following text is an example of the Unbind All Targets option.
Target Persistent Binding Menu: 1: 2: 3: Show Binding Information Set Target Persistent Binding Unbind Target(s) Note: 0 to return to Main Menu Enter Selection: 3 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Target Persistent Binding - Unbind Menu 1: 2: 3: Unbind Specific Target(s) Unbind All Targets Return to Target Persistent Binding Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Select HBA Port: HBA Model QLA2362: 1: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 2: Port 3: WWPN: 21-00-00-E0-8B-1A-BB-30 HBA Model QLA2462: 3: Port 2: WWPN: 21-00-00-E0-8B-1F-9D-F0 4: Port 4: WWPN: 21-01-00-E0-8B-3F-9D-F0 5: All HBAs 6: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 4

Online Online Online Online

4-32

SN0054614-00 B

Q
Press <Enter> to continue:
4.7.3.2.2

4 Command Line Options Selective LUNs (Command Line Option -M)

Configuration changed on HBA port 4. Changes have been saved to persistent storage. You must reboot in order for the saved configuration to become effective.

Non-interactive Mode
Type the following command to unbind all targets on a specific HBA port or on all HBA ports:
# scli -P (<HBA Port No.> | <HBA WWPN> | ALL) (REMOVE ALL | UNBIND ALL)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA
4.8

Selective LUNs (Command Line Option -M)


The following sections describe how to perform the following tasks for the HBAs target LUN mask in interactive and non-interactive modes:

View the selective LUN Enable/disable a LUN Enable/disable all LUNs

NOTE:

Before configuring selective LUNs, you must persistently bind the targets (see section 4.7). If the current driver setting is Bind by Port ID, this option is not available.

SN0054614-00 B

4-33

4 Command Line Options Selective LUNs (Command Line Option -M)

4.8.1

View Selective LUNs


4.8.1.1

Interactive Mode
Perform the following steps to view selective LUNs: 1. After choosing the Selective LUNs option, a list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 2. The Selective LUNs Menu displays. Type the number for the View Selective LUNs option, then press ENTER. 3. The Selective LUN(s)Display Configuration menu displays. Type the number for either the View Specific LUN or View All LUNs option, then press ENTER. 4. If you selected View Specific LUN, all the devices are displayed. Type the number that corresponds to the device you want to see, then press ENTER. 5. The Select LUN Number menu displays. Type the number that corresponds to the LUN you want to view, then press ENTER. The following text is an example of the Selective LUNs option.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 8 SANsurfer FC HBA CLI v1.06.19 Build 20

4-34

SN0054614-00 B

4 Command Line Options Selective LUNs (Command Line Option -M)

Select HBA Port: HBA Model QLA200: 1: Port 0: WWPN: 21-00-00-E0-8B-17-D2-DF Online HBA Model QLA2362: 2: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online 3: Port 2: WWPN: 21-00-00-E0-8B-1A-BB-30 Online Note: 0 to return to Main Menu Enter Selection: 2 Selective LUNs Menu: 1: 2: 3: 4: View Selective LUNs Enable/Disable a LUN Enable/Disable ALL LUNs Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Selective LUN(s) - Display Configuration 1: 2: 3: View Specific LUN View All LUNs Return to Selective LUNs Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Select Device: 1: Disk Vendor Product ID Port Name Port ID Bind Target ID 2: Disk Vendor Product ID Port Name Port ID : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2 : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1 Yes 0

SN0054614-00 B

4-35

4 Command Line Options Selective LUNs (Command Line Option -M)

Q
: Yes : 1 : : : : : : : : : : : : SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E4 No 0 SEAGATE ST318203FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E8 No 1

Bind Target ID 3: Disk Vendor Product ID Port Name Port ID Bind Target ID 4: Disk Vendor Product ID Port Name Port ID Bind Target ID Return to Previous Menu

5:

Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.19 Build 20 Select LUN Number: 1: LUN 0 Vendor Product ID Port Name Port ID Bind Target ID Return Device List : : : : : : SEAGATE ST318453FC xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1 Yes 0

2:

Note: 0 to return to Enter Selection: 1 World Wide Node Name -------------------20-00-00-20-37-15-97-1E

Main Menu World Wide Port Name -------------------21-00-00-20-37-15-97-1E LUN ID -----0 State ------Enabled

Press <Enter> to continue:

4-36

SN0054614-00 B

Q
4.8.1.2

4 Command Line Options Selective LUNs (Command Line Option -M)

Non-Interactive Mode
Type the following command to view the HBAs currently enabled LUN list:
# scli -M (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA

In Solaris SPARC, include double quotes around the question mark (?) if the system is running with a csh or tsch shell. For example:
# scli -M <HBA> "?"

The application displays the HBAs enabled LUN list in the following format:
<Target WWNN> <Target WWPN> <LUN ID>

Type the following command to view a LUNs current select state:


# scli -M (<HBA Port No.> | <HBA WWPN>) (<Target WWNN> <Target WWPN> <LUN ID>) (VIEW | ?)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Target WWNN = World wide node name of the target Target WWPN = World wide port name of the target LUN ID = ID of the LUN

If the input represents a valid LUN, SANsurfer FC HBA CLI displays its current state as selected or unselected for that HBA.
4.8.2

Enable/Disable a LUN
4.8.2.1

Interactive Mode
Perform the following steps to enable or disable a LUN: 1. After choosing the Selective LUNs option, a list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 2. The Selective LUNs Menu displays. Type the number for the Enable/Disable a LUN option, then press ENTER.

SN0054614-00 B

4-37

4 Command Line Options Selective LUNs (Command Line Option -M)

3. A list of devices is displayed. Type the number that corresponds to the device/LUN, then press ENTER. 4. A list of LUNs is displayed. Type the number that corresponds to the LUN, then press ENTER. 5. The Enable/Disable Selective LUN menu displays. Type the corresponding number to either Enable (1) or Disable (2) the selected LUN, then press ENTER. 6. The following message displays:
Enter Another LUN?

Type the number to either Select More LUNs (1) or Commit Changes (2), then press ENTER. The following text is an example of the Enable/Disable a LUN option.
SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Main Menu 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Display System Information Display HBA Settings Display HBA Information Display Device List Display LUN List Configure HBA Settings Target Persistent Binding Selective LUNs Boot Device Driver Settings HBA Utilities Flash Beacon Diagnostics Statistics Help Quit Enter Selection: 8 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Select HBA Port: HBA Model QLA2362: 1: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online 2: Port 3: WWPN: 21-00-00-E0-8B-1A-BB-30 Online

4-38

SN0054614-00 B

4 Command Line Options Selective LUNs (Command Line Option -M)

HBA Model QLA2462: 3: Port 2: WWPN: 21-00-00-E0-8B-1F-9D-F0 Online 4: Port 4: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online Note: 0 to return to Main Menu Enter Selection: 3 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Selective LUNs Menu: 1: 2: 3: 4: View Selective LUNs Enable/Disable a LUN Enable/Disable ALL LUNs Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Select Device: 1: Disk Vendor Product ID Port Name Port ID Bind Target ID 2: Disk Vendor Product ID Port Name Port ID Bind Target ID 3: Disk Vendor Product ID Port Name Port ID Bind Target ID 4: Disk Vendor Product ID : SEAGATE : ST318452FC : : : : : : SEAGATE ST336607FC 22-00-00-11-C6-2D-5A-B8 02-0A-E0 Yes 2 : : : : : : SEAGATE ST336607FC 22-00-00-11-C6-2D-5B-F9 02-0A-DC Yes 1 : : : : : : DGC 50-06-01-60-40-01-80-FD 02-09-00 Yes 0

SN0054614-00 B

4-39

4 Command Line Options Selective LUNs (Command Line Option -M)

Q
: : : : : : : : : : : : : : : : 22-00-00-04-CF-9C-24-CA 02-0A-E1 Yes 3 SEAGATE ST336607FC 22-00-00-0C-50-68-1E-9A 02-0A-E2 Yes 4 SEAGATE ST336607FC 22-00-00-11-C6-2D-5A-3F 02-0A-E4 Yes 5

Port Name Port ID Bind Target ID 5: Disk Vendor Product ID Port Name Port ID Bind Target ID 6: Disk Vendor Product ID Port Name Port ID Bind Target ID 7: Disk

8:

Vendor : DGC Product ID : Port Name : 50-06-01-69-40-01-80-FD Port ID : 02-0B-00 Bind : Yes Target ID : 6 Return to Previous Menu

Note: 0 to return to Main Menu Enter Selection: 6 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Select LUN Number: 1: LUN 0 Vendor : SEAGATE Product ID : ST336607FC Port Name : 22-00-00-11-C6-2D-5A-3F Port ID : 02-0A-E4 Return to Device List Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 22 T1

2:

4-40

SN0054614-00 B

Q
Enable/Disable Selective LUN 1: 2: 3: Enable Disable Return to LUN list

4 Command Line Options Selective LUNs (Command Line Option -M)

Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 22 T1 Enter Another LUN? 1: 2: Select More Commit Changes Note: 0 to return to Main Menu Enter Selection: 2 Configuration saved on HBA port 2. LUN persistent data saved successfully. Please reboot the system for the saved configuration to become effective.
4.8.2.2

Non-Interactive Mode
Type one of the following commands to enable (select) a LUN on a specific HBA port:
# scli -M (<HBA Port No.> | <HBA WWPN>) {<Target WWNN> <Target WWPN> <LUN ID> (1 | ENABLE)}

Type one of the following commands to disable (unselect) a LUN on a specific HBA port:
scli -M (<HBA Port No.> | <HBA WWPN>) {<Target WWNN> <Target WWPN> <LUN ID> (0 | DISABLE)}

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Target WWNN = World wide node name of the target Target WWPN = World wide port name of the target LUN ID = ID of the LUN

The sequence <Target WWNN> <Target WWPN> <LUN ID> 0 or 1 can be repeated to select multiple LUNs in the same command.

SN0054614-00 B

4-41

4 Command Line Options Selective LUNs (Command Line Option -M)

4.8.3

Enable/Disable All LUNs


4.8.3.1

Interactive Mode
Perform the following steps to enable or disable all LUNs: 1. After choosing the Selective LUNs option, a list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 2. The Selective LUNs Menu displays. Type the number for the Enable/Disable All LUNs option, then press ENTER. 3. The Selective LUNs ConfigurationHBA/Device menu displays. Type the number for either the Enable/Disable All LUNs on a Device option or the Enable/Disable All LUNS on Current HBA option, then press ENTER. 4. Do one of the following: If you selected Enable/Disable All LUNs on a Device, a list of devices is displayed. Type the number that corresponds to the device/LUN, then press ENTER. If you selected Enable/Disable All LUNS on Current HBA, the Enable/Disable Selective LUN menu displays. Type the number to either Enable (1) or Disable (2) the LUNs. The following text is an example of the Enable/Disable ALL LUNs option.
Selective LUNs Menu: 1: 2: 3: 4: View Selective LUNs Enable/Disable a LUN Enable/Disable ALL LUNs Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 3 SANsurfer FC CLI v1.06.16 Build 20 Selective LUNs Configuration - HBA/Device 1: 2: 3: Enable/Disable All LUNs on a Device Enable/Disable All LUNs on Current HBA Return to Selective LUNs Menu Note: 0 to return to Main Menu Enter Selection: 2

4-42

SN0054614-00 B

Q
SANsurfer FC CLI v1.06.16 Build 20 Enable/Disable Selective LUN 1: 2: 3: Enable Disable Return to Previous Menu

4 Command Line Options Selective LUNs (Command Line Option -M)

Note: 0 to return to Main Menu Enter Selection: 1 Configuration saved on HBA port 1. LUN persistent data saved successfully. Please reboot the system for the saved configuration to become effective. Press <Enter> to continue:
4.8.3.2

Non-Interactive Mode
Type the following command to select all LUNs for all targets on the HBA:
# scli -M (<HBA Port No.> | <HBA WWPN>) SELECT ALL

Type the following command to select all LUNs for a specific target:
# scli -M (<HBA Port No.> | <HBA WWPN>) SELECT <Target WWPN>

Type the following command to unselect all LUNs for all targets on the HBA:
# scli -M (<HBA Port No.> | <HBA WWPN>) UNSELECT ALL

Type the following command to unselect all LUNs for a specific target:
# scli -M (<HBA Port No.> | <HBA WWPN>) UNSELECT <Target WWPN>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Target WWPN = World wide port name of the target

SN0054614-00 B

4-43

4 Command Line Options Boot Device (Command Line Option -E)

4.9

Boot Device (Command Line Option -E)


The following sections describe how to perform the following tasks in interactive and non-interactive modes:

View the boot device selection Set the boot device

4.9.1

Viewing the Boot Device Selection


4.9.1.1

Interactive Mode
Perform the following steps to view a single boot device or all boot devices: 1. Type the number for the View Boot Device Selection option from the submenu, then press ENTER. 2. If there is more than one HBA in the system, the menu displays the list of HBA ports. To view all the boot devices, type the number for the All HBAs option, then press ENTER. To view a specific boot device, type the number corresponding to the HBA port whose boot device you want to view, then press ENTER. The following text is an example of the Boot Device option when viewing a single boot device or all boot devices.
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 9

4-44

SN0054614-00 B

Q
SANsurfer FC HBA CLI v1.06.19 Build 20

4 Command Line Options Boot Device (Command Line Option -E)

Select HBA Port: HBA Model QLA200: 1: Port 0: WWPN: 21-00-00-E0-8B-17-D2-DF Online HBA Model QLA2362: 2: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online 3: Port 2: WWPN: 21-00-00-E0-8B-1A-BB-30 Online 4. All HBAs 5: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2
----------------------------------------------------------------------------HBA Port 1 - QLA2362 Port Name: 21-01-00-E0-8B-3A-BB-30 Port ID: 11-06-EF ----------------------------------------------------------------------------Primary Boot Device Information: -------------------------------------Selectable Boot: Disabled -------------------------------------Device Node Name Device Port Name LUN ID ----------------------- ----------------------- -----00-00-00-00-00-00-00-00 00-00-00-00-00-00-00-00 0

Press <Enter> to continue:


4.9.1.2

Non-interactive Mode
Type one the following command to view the boot devices for all HBAs in the system:
# scli -E (VIEW | ?)

Type the following command to view the boot device for a single HBA:
# scli -E (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

Where:
HBA Port No. = HBA number from HBA general information HBA WWPN = World wide port name of the HBA

In Solaris SPARC, include double quotes around the question mark (?) if the system is running with a csh or tsch shell. For example:
# scli -E <HBA> "?"

In Windows 2000, Windows Server 2003, Enterprise Server, and Red Hat/SuSE Linux, each HBAs currently selected boot device is displayed in the following format:
<HBA Port Number> <HBA WWPN> <Target WWNN> <Target WWPN> <LUN ID>

SN0054614-00 B

4-45

4 Command Line Options Boot Device (Command Line Option -E)

In Solaris SPARC, each HBAs currently selected boot device is displayed in the following format:
<HBA Port Number> <HBA WWPN> <Target WWNN> <Target WWPN> <Target ID> <LUN ID>

If the system does not have an HBA with a boot device selected, the following message displays:
There is no boot device selected for any HBA in the system.

The following text is an example of the Boot Device option when viewing the boot device for a single HBA.
--------------------------------------------------------------HBA Port 1 - QLA2340 WWPN: 21-00-00-E0-8B-07-62-A0

--------------------------------------------------------------Primary Boot Device Information: -------------------------------------Selectable Boot: Enabled -------------------------------------Device Node Name ----------------------00-00-00-00-00-00-00-00 Device Port Name ----------------------00-00-00-00-00-00-00-00 LUN ID -----0

Press <Enter> to continue:

Selecting a boot port name of 00-00-00 will cause the OS to boot from the first target it finds with a LUN (this applies only if the boot BIOS is enabled).
4.9.2

Set Boot Device


The following sections describe how to enable and disable the HBAs boot device in interactive and non-interactive modes.
4.9.2.1

Enable the HBAs Boot Device


4.9.2.1.1

Interactive Mode
In interactive mode, type the number for the Set Boot Device option from the submenu, then press ENTER. If there is more than one HBA in the system, a list of HBA ports is displayed. Type the number for the HBA port for which you want to enable a boot device, then press ENTER.

4-46

SN0054614-00 B

Q
If the BIOS is disabled, you are prompted:

4 Command Line Options Boot Device (Command Line Option -E)

Boot device disabled. Enable boot device?

In Windows 2000, Windows Server 2003, Enterprise Server, and Solaris SPARC, if the HBA port does not have a boot device selected, a list of attached targets is displayed. The target list also includes a NULL (zero) target (default mode). In default mode, the HBA BIOS selects the first device with a LUN 0 as the boot device. If you select a non-NULL target, the menu displays the list of LUNs. After you select a LUN as the boot device, you are prompted to confirm the selection. In Solaris SPARC, a list of targets using the WWNN and WWPN is displayed. When you select a target, SANsurfer FC HBA CLI searches the persistent binding list to see if a target ID has been bound to this target. If none is found, you are prompted for a target ID. After you enter a target ID, the list of LUNs is displayed. Select one LUN as the boot device. NOTE: The LUN must always be an open Solaris boot device. The target ID is determined by the boot part name. Once selected and saved, the target ID is the value used by the OS to determine the boot device.

The following text is an example of the Boot Device option when a boot device is set.
HBA Boot Device Menu 1: 2: 3: View Boot Device Selection Set Boot Device Return to Main Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.19 Build 20 Select HBA Port: HBA Model QLA200: 1: Port 0: WWPN: 21-00-00-E0-8B-17-D2-DF Online HBA Model QLA2362: 2: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online 3: Port 2: WWPN: 21-00-00-E0-8B-1A-BB-30 Online 4: Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.14 Build 24

SN0054614-00 B

4-47

4 Command Line Options Boot Device (Command Line Option -E)

Boot Device Disabled. Enable Boot Device? 1: 2: Yes No Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.14 Build 24 Select Device: 1: Disk Port Name Node Name Port ID 2: Disk Port Name Node Name Port ID 3: Disk Port Name Node Name Port ID 4: Disk Port Name Node Name Port ID Set Default Return to Main Menu : 21-00-00-20-37-38-73-BC : 20-00-00-00-00-38-73-BC : 10-02-E8 : 21-00-00-20-37-38-66-2D : xx-xx-xx-xx-xx-38-66-2D : 10-02-E4 : 21-00-00-20-37-15-96-EC : xx-xx-xx-xx-xx-15-96-EC : 10-02-E2 : 21-00-00-20-37-15-97-1E : xx-xx-xx-xx-xx-15-97-1E : 10-02-E1

5: 6:

Note: 0 to return to Main Menu. Enter Selection: 4 Select LUN Number: 1: Device 1 Port Name : 21-00-00-20-37-38-73-BC Node Name : 20-00-00-20-37-38-73-BC Port ID : 11-01-E8 LUN ID : 0 Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20

4-48

SN0054614-00 B

Q
Warning: 1: 2: Proceed Cancel

4 Command Line Options Boot Device (Command Line Option -E)

Your selection will overwrite the existing Boot Device. Proceed or Cancel?

Note: 0 to return to Main Menu Enter Selection: 1 Boot Device Change Completed. Press Enter to continue:
4.9.2.1.2

Non-interactive Mode
Type the following command to select a boot device for the HBA:
# scli -E (<HBA Port No.> | <HBA WWPN>) <Target WWNN> <Target WWPN> <LUN ID>

Where:
HBA Port No. = HBA number from HBA general information HBA WWPN = World wide port name of the HBA Target WWNN = World wide node name of the target Target WWPN = World wide port name of the target LUN ID = ID of the LUN

SANsurfer FC HBA CLI checks all parameters to verify that the HBA, targets, and LUNs are valid. The <Target WWPN>, <Target WWNN> and <LUN ID> inputs can be all zeroes, which sets the default BIOS boot device on the specific HBA. For example:
# scli -E (<HBA Port No.> | <HBA WWPN>) (ENABLE | 0 0 0)

If you select an HBA with no target or a target with no LUN, SANsurfer FC HBA CLI displays an error message and aborts. In Solaris SPARC, assigning the target ID to the target of the boot-selected LUN is equivalent to the target persistent binding described in section 4.7. Therefore, if the target is persistently bound, its boot device entry must have the same target ID. For all operating systems, if the HBA already has boot devices defined and they are different from the ones in the command parameter or menu selection, you are prompted to confirm the boot device selection:
The HBA already has a boot device(s) selected. Do you want to replace it with the new one?

SN0054614-00 B

4-49

4 Command Line Options Driver Settings (Command Line Option -FS)

For all operating systems, if the HBA already has boot devices selected and they are the same as the ones in the command parameter or menu selection, the following message displays:
The HBA already has that device selected as boot device.
4.9.2.2

Disable the HBAs Boot Device


4.9.2.2.1

Interactive Mode
Select the Set Boot Device Setting option from the submenu. If there is more than one HBA in the system, the list of HBA ports is displayed. Select an HBA port. The system notifies you that the boot device is enabled, and prompts Disable Boot Device? Type 1 for Yes or 2 for No.
4.9.2.2.2

Non-interactive Mode
In non-interactive mode, type the following command to disable the boot device for a specific HBA:
# scli -E (<HBA Port No.> | <HBA WWPN>) DISABLE

Where:
HBA Port No. = HBA port number
4.10

Driver Settings (Command Line Option -FS)


When this option is selected, the following driver settings are available:

Present targets that are persistently bound plus any new targets (current) Present targets that are only persistently bound Bind targets by WWPN Bind targets by port ID (current)

4.10.1

Interactive Mode
Perform the following steps to modify the driver settings in interactive mode: 1. Type the number for the Driver Settings option, then press ENTER. 2. A list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 3. The Driver Settings Menu displays. Change settings as required.

4-50

SN0054614-00 B

Q
Main Menu 1: Display System Information 2: Display HBA Settings 3: Display HBA Information 4: Display Device List 5: Display LUN List 6: Configure HBA Settings 7: Target Persistent Binding 8: Selective LUNs 9: Boot Device 10: Driver Settings 11: HBA Utilities 12: Flash HBA Beacon 13: Diagnostics 14: Statistics 15: Help 16: Quit Enter Selection: 10 SANsurfer FC HBA CLI v1.06.16 Build 20

4 Command Line Options Driver Settings (Command Line Option -FS)

4. Type the number for the Commit Changes for current HBA option to save the settings, then press ENTER. The following text is an example of the Driver Settings option:

Select HBA Port: HBA Model QLA2462: 1: Port 0: WWPN: xx-xx-xx-xx-xx-17-FF-74 Online 2: Port 1: WWPN: xx-xx-xx-xx-xx-07-62-A0 Online Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 19 Driver Settings Menu 1: 2: 3: 4: 5: 6: Present targets that are persistently bound plus any new target(s) (Current) Present targets that are persistently bound Only Bind by World Wide Port Name Bind by Port ID (Current) Commit Changes for current HBA Return to HBA Selection Menu

SN0054614-00 B

4-51

4 Command Line Options Driver Settings (Command Line Option -FS)

Note: 0 to return to Main Menu Enter Selection: 4 SANsurfer FC HBA CLI v1.06.19 Build 20 Driver Settings Menu 1: 2: 3: 4: 5: 6: Present targets that are persistently bound plus any new target(s) (Current) Present targets that are persistently bound Only Bind by World Wide Port Name Bind by Port ID (Current) Commit Changes for this HBA Return to HBA Selection Menu Note: 0 to return to Main Menu Enter Selection: 5 SANsurfer FC HBA CLI v1.06.19 Build 20 Warning: You have requested to commit driver setting changes of the HBA. All HBAs dependant on the same driver will be affected by the change. Do you want to proceed with the operation? 1: Yes 2: No Enter Selection: 1 SANsurfer FC HBA CLI v1.06.14 Build 24 Warning: You have requested to change from bind by world wide port name to bind by port id. All existent persistent binding information will be deleted from the current host. Also after this option is set, Selective LUN will be disabled. Do you want to proceed with this operation? 1: Yes 2: No

4-52

SN0054614-00 B

Q
Enter Selection: 1

4 Command Line Options Driver Settings (Command Line Option -FS)

Configuration changed. Changes have been saved to persistent storage. You must reboot in order for the saved configuration to become effective. Driver Settings - The commit operation completed. Please reboot the system for the changes to take effect. Press <Enter> to continue:

NOTE:

In Windows, when switching driver settings from bind by port ID to bind by port name (no target persistent binding operation involved), then the following message displays: Driver Settings - The commit operation completed. Please reboot the system for the changes to take effect. In Solaris, the following message displays: Driver Settings - The commit operation completed. The changes should be effective immediately. In Linux, the following message displays: Driver Settings - The commit operation completed. Please reload the QLA driver module for the changes to take effect.

4.10.2

Non-interactive Mode
Type the following command to configure the driver settings:
# scli -FS (<HBA Port No.> | <HBA WWPN>) {(<Parameter Name> | <Parameter Alias>) <Param Value>}

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Parameter Name = Name of the parameters Parameter Alias = Alias of the parameters Parameter Value = New value of the parameters

The pairs <Parameter Name> <Parameter Value> and <Parameter Alias> <Parameter Value> can be repeated to set multiple parameters in a single command.

SN0054614-00 B

4-53

4 Command Line Options View Driver Settings (Command Line Option -FG)

Q
Parameter Alias PO PN BW BP Parameter Valuea 1, 0 1, 0 1, 0 1, 0

The parameter names and aliases are defined in table 4-3. Table 4-3. Driver Settings
Parameter Description Persistent only Persistent plus new Bind by WWPN Bind by port ID Table Notes a1=Enabled, 0=Disabled
4.11

Parameter Name PersistentOnly PersistentPlusNew BindWWPN BindPortID

View Driver Settings (Command Line Option -FG)


NOTE: This option is valid only in non-interactive mode. Type the following command to display the driver settings:
# scli -FG (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA
4.12

Save/Update Option ROM (Command Line Option -B)


This option allows you to update or save to a file the systems BIOS (Windows 2000, Windows Server 2003, Enterprise Server, and Red Hat/SuSE Linux) or FCode (Solaris SPARC).
4.12.1

Interactive Mode
Perform the following steps to update the BIOS/FCode: 1. Type the number for the HBA Utilities option, then press ENTER. 2. The HBA Utilities Menu displays. Type the number for the OptionROM Update/Save option, then press ENTER. 3. The HBA Option ROM Menu displays. Type the number for the Update OptionROM option, then press ENTER.

4-54

SN0054614-00 B

4 Command Line Options Save/Update Option ROM (Command Line Option -B)

4. A list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 5. The following warning displays:
Warning: The option ROM save/update operation requires that the HBA has no outstanding input and output operations. Please make sure there is no active I/O before starting the operation. Also after the update operation, the HBA will be reset. This may adversely affect your SAN. Do you want to proceed with the operation? 1. Yes 2. No

Type 1 to proceed or 2 to cancel the operation. 6. Do one of the following: a. Enter a file name or a path to a file. SANsurfer FC HBA CLI updates the BIOS/FCode. NOTE: The BIOS file has a .bin extension.

b. Press ENTER to abort operation and return to the previous menu. Perform the following steps to save the BIOS/FCode to a file: 1. Type the number for the HBA Utilities option, then press ENTER. 2. The HBA Utilities Menu displays. Type the number for the OptionROM Update/Save option, then press ENTER. 3. The HBA Option ROM menu displays. Type the number for the Save OptionROM option, then press ENTER. 4. A list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 5. The following warning displays:
Warning: The option ROM save/update operation requires that the HBA has no outstanding input and output operations. Please make sure there is no active I/O before starting the operation. Also after the update operation, the HBA will be reset. This may adversely affect your SAN. Do you want to proceed with the operation? 1. Yes 2. No Type 1 to proceed or 2 to cancel the operation.

6. Enter a file name or a path to a file. SANsurfer FC HBA CLI saves the BIOS/FCode to the specific file.

SN0054614-00 B

4-55

4 Command Line Options Save/Update NVRAM (Command Line Option -R)

4.12.2

Non-interactive Mode
Type the following command to update the HBAs BIOS/FCode:
# scli -B (ALL | <HBA Port No.> | <HBA WWPN>) <BIOS/FCode File Name>

Where:
ALL = All HBAs in the system will be updated with the new

BIOS/FCode

HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA BIOS/FCode File = File name or a path to a file that contains the updated Name BIOS/FCode

Type the following command to save the HBAs BIOS/FCode to a file:


# scli -B (<HBA Port No.> | <HBA WWPN>) SAVE <BIOS/FCode File Name>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA BIOS/FCode File = File name or a path to a file to save BIOS/FCode Name
4.13

Save/Update NVRAM (Command Line Option -R)


This option allows you to update the HBAs NVRAM or save the HBAs NVRAM to a file.
4.13.1

Interactive Mode
Perform the following steps to update the HBAs NVRAM: 1. Type the number for the HBA Utilities option, then press ENTER. 2. The HBA Utilities Menu displays. Type the number for the NVRAM Update/Save option, then press ENTER. 3. The Adapter NVRAM Menu displays. Type the number for the Update NVRAM option, then press ENTER.

4-56

SN0054614-00 B

4 Command Line Options Save/Update NVRAM (Command Line Option -R)

4. The NVRAM UpdateHBA Port Selection Menu displays. Type the number for either Select HBA Port or Select ALL HBAs, then press ENTER. If you chose Select ALL HBAs, skip to step 6. 5. A list of HBA ports is displayed. Type the number that corresponds to the HBA port, then press ENTER. 6. The following warning displays:
Warning: Please update the NVRAM with extreme care. Incorrectly updating the NVRAM may render the HBA inoperable. If you currently have boot device information set up in the NVRAM, updating the NVRAM from a file may result in changing that information. If you wish to preserve the boot device information, please either update the file with the correct boot device settings before the NVRAM update or re-configure the boot settings after the update. Do you want to proceed with the operation? 1. Yes 2. No

Type 1 to proceed or 2 to cancel the operation. 7. Do one of the following: a. Enter a file name or a path to a file. SANsurfer FC HBA CLI updates the NVRAM. NOTE: NVRAM file has a .dat extension.

b. Press ENTER to abort operation and return to the previous menu. Perform the following steps to save the HBAs NVRAM to a file: 1. Type the number for the HBA Utilities option, then press ENTER. 2. The HBA Utilities Menu displays. Type the number for the NVRAM Update/Save option, then press ENTER. 3. The Adapter NVRAM Menu displays. Type the number for the Save NVRAM option, then press ENTER. 4. A list of HBA ports is displayed. Type the number that corresponds to an HBA port, then press ENTER. 5. The following warning displays:
Warning: The save NVRAM operation requires that the HBA has no outstanding input and output operations. Please make sure there is no active I/O before starting the operation.

SN0054614-00 B

4-57

4 Command Line Options Save/Update NVRAM (Command Line Option -R)

Do you want to proceed with the operation? 1. Yes 2. No

Type 1 to proceed or 2 to cancel the operation. 6. Do one of the following: a. Enter a file name or a path to a file. SANsurfer FC HBA CLI saves the NVRAM. b. Press ENTER to abort operation and return to the previous menu.
4.13.2

Non-interactive Mode
Type the following command to update the HBAs NVRAM:
# scli -R (<HBA Port No.> | <HBA WWPN> | ALL) <NVRAM File Name>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA ALL = All HBA ports in the system will be updated with the new

NVRAM NVRAM

NVRAM File Name = File name or a path to a file that contains the updated

Type the following command to save the HBAs NVRAM to a file:


# scli -R (<HBA Port No.> | <HBA WWPN>) SAVE <NVRAM File Name>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA NVRAM File Name = File name or a path to a file to save the NVRAM

4-58

SN0054614-00 B

Q
4.14

4 Command Line Options Update Driver (Windows 2000 and Windows Server 2003) (Command Line Option -D)

Update Driver (Windows 2000 and Windows Server 2003) (Command Line Option -D)
This option allows you to update the HBAs device driver.
4.14.1

Interactive Mode
Perform the following steps to update the driver: 1. Type the number for the HBA Utilities option, then press ENTER. 2. Type the number for the Update Driver option, then press ENTER. 3. A list of HBA ports is displayed. Type the number that corresponds to an HBA port, then press ENTER. 4. Do one of the following: a. Enter a file name or a path to a file. SANsurfer FC HBA CLI updates the driver. b. Press ENTER to abort the operation and return to the previous menu. 5. When a file name is entered, the following confirmation message displays:
This option will install version SCSIport x.x.x.xx.xx. The current version is SCSIport x.x.x.xx <xxx IP>. Do you want to perform the operation? 1. Yes 2. No

Type 1 to proceed or 2 to cancel the operation. 6. The Hardware Installation dialog box displays with a warning message. Select Continue Anyway if you want to update the driver. 7. The following message displays:
The driver update operation completed, reboot not needed.

SN0054614-00 B

4-59

4 Command Line Options Flash HBA Beacon (Command Line Options -A and -TB)

4.14.2

Non-interactive Mode
Type the following command to update the HBAs device driver:
scli -D <Device Driver INF File Name>

Where:
Device Driver INF = Absolute, full path name of the setup INF file or the File Name compressed driver file in ZIP or EXE format. The binary

image of the device driver must reside in the same absolute path location. For example: scli -d c:\temp\ql2300\qlxxx.inf

4.15

Flash HBA Beacon (Command Line Options -A and -TB)


This option allows you to stop and start flashing the LED for an HBA port or target.
4.15.1

Interactive Mode
Perform the following steps to stop and start flashing an HBAs LED: 1. Select the number for the Flash Beacon option, then press ENTER. 2. The Flash Beacon Menu displays. Select the number for either the HBA Port Beacon or Target Beacon, then press ENTER. 3. A list of HBA ports is displayed, indicating the status for each ports LED (ON, OFF, Unsupported). Type the number that corresponds to the HBA port, then press ENTER. 4. If you selected HBA Port Beacon in step 2, the list of HBA ports is displayed; the status of the selected HBA ports LED is changed. If you selected Target Beacon in step 2, a list of devices for the HBA port is displayed. Type the number that corresponds to the device, then press ENTER. The device lists is re-displayed; the status of the Flash LED option is changed (No/Yes). Type the number for the option to Flash Selected Target(s) LED, then press ENTER.

4-60

SN0054614-00 B

Q
4.15.2

4 Command Line Options Flash HBA Beacon (Command Line Options -A and -TB)

Non-interactive Mode
4.15.2.1

View the HBA Ports Flashing State


To view the HBAs flashing state, type the following command:
# scli -A (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA

When the HBAs LED is in flashing state, the following message is displayed:
HBA Port x - LED Flashing is ON.

When the HBAs LED is not in flashing state, the following message is displayed:
HBA Port x - LED Flashing is OFF.

In Solaris SPARC, include double quotes around the question mark (?) if the system is running with a csh or tsch shell. For example:
# scli -A <HBA> "?"

When the HBAs LED is in flashing state, the following message is displayed:
LED Flashing is ON.

When the HBAs LED is not in flashing state, the following message is displayed:
LED Flashing is OFF.
4.15.2.2

Start or Stop Flashing the HBA Ports LED


To start or stop flashing the HBAs LED, type the following command:
# scli -A (<HBA Port No.> | <HBA WWPN>)

SANsurfer FC HBA CLI toggles the HBAs LED flashing state. If the LED is flashing, the flashing stops. If the LED is not flashing, the flashing starts. If SANsurfer FC HBA CLI is not in silent mode (see section 4.21), one of the following messages is displayed to indicate the HBAs current flashing state:
The LED Flashing for <HBA Port No.> <HBA WWPN> has been turned ON The LED Flashing for <HBA Port No.> <HBA WWPN> has been turned OFF

The <HBA Port No.> or <HBA WWPN> must match the command input parameter.

SN0054614-00 B

4-61

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

4.15.2.3

Start or Stop Flashing a Targets LED


To start or stop flashing a target devices LED, type the following command:
# scli -TB (<HBA Port No.> | <HBA WWPN>) (<Target WWPN>) (<0 | ON> | <1 | PRESET>)

NOTE:

The <0 | ON> option flashes the LED until interrupted. The <1 | PRESET> option flashes the LED 12 times, and is supported only on JBOD devices.

4.16

Diagnostics (Command Line Options -KL and -KR)


This option allows you to run a loopback test or a read/write buffer test.
4.16.1

Interactive Mode
Perform the following steps to run a loopback test or a read/write buffer test: 1. Select the number for the Diagnostics option, then press ENTER. 2. From the Diagnostics Tests Menu, type the number that corresponds to the test you want to run, then press ENTER:

1 = loopback test 2 = read/write buffer test

3. The Select HBA Port menu displays. Type the number that corresponds to the HBA port you want to test, then press ENTER. 4. The Configure Diagnostic Loopback Test Parameters or Configure Diagnostic Read/Write Buffer Test Parameters submenu displays. Select one of the following options: 1: Display Test Configuration. Type 1 to display the current parameter values. See figure 4-1 for an example; the top of the figure displays the test configuration. 2: Restore Test Configuration to Default. Type 2 to return all parameters to their default values. 3: Customize Test Configuration. Type 3 to customize any or all of the parameter values. Continue with step 5. 4: Run Diagnostic Test with Current Configuration. Type 4 to run the loopback or read/write buffer test with the current parameter values. To see these values, type 1 (Display Test Configuration).

4-62

SN0054614-00 B

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

See figure 4-1 for an example of loopback test results. See figure 4-2 for an example of read/write buffer test results. 5: Return to the Diagnostics Test Menu. Type 5 to go back to the Diagnostics Test Menu. 5. If you selected Customize Test Configuration in step 4, the Diagnostic Test Configuration Menu displays. See sections 4.16.2.1 through 4.16.2.5 for a description of the parameters and their values. Perform the following steps for each parameter you want to change: a. Type the number associated with the parameter you want to change. b. Enter the parameter value. c. To return to the previous menu, type 7 from the Read/Write area, or type 7 from the Loopback area. 6. Type 4 to run the loopback or read/write buffer test. 7. The following warning message displays:
Warning: The Diagnostic Loopback and Read/Write Buffer tests require that the HBA has no outstanding input and output operations. Please make sure there is no active I/O before starting the test(s). Do you want to perform the test(s)? 1. Yes 2. No

Type 1 to proceed or 2 to cancel the operation.


4.16.2

Non-interactive Mode
The -KL command performs the loopback test; the -KR command performs the read/write buffer test. To perform a loopback test with the default parameters, type the following command:
# scli -KL (<HBA Port No.> | <HBA WWPN>)

To perform a loopback test with customized parameters, type the following command:
# scli -KL (<HBA Port No.> | <HBA WWPN>) [(<Parameter Name> | <Parameter Alias>) <Parameter Value>]

To perform a read/write test using the default parameters, type the following command:
# scli -KR (<HBA Port No.> | <HBA WWPN>)

SN0054614-00 B

4-63

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

To perform a read/write test with customized parameters, type the following command:
# scli -KR (<HBA Port No.> | <HBA WWPN>) [(-EX | -EXCLUDE) <Target WWPN>] (<Parameter Name> | <Parameter Alias>) <Parameter Value>

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA -EX or -EXCLUDE = World wide port name of the target device that is Target WWPN excluded from the read/write test Parameter Name = One of the following:

DataPattern (see section 4.16.2.1) DataSize (see section 4.16.2.2) TestCount (see section 4.16.2.3) TestIncrement (see section 4.16.2.4) OnError (see section 4.16.2.5) DP (see section 4.16.2.1) DS (see section 4.16.2.2) TC (see section 4.16.2.3) TI (see section 4.16.2.4) OE (see section 4.16.2.5)

Parameter Alias = One of the following:

Parameter Value = Value for selected parameter

Sections 4.16.2.1 through 4.16.2.5 describe how to change the default parameters for both of these tests. Section 4.16.2.6 contains command line examples and test results for a loopback test. Section 4.16.2.7 contains command line examples and test results for a read/write buffer test.
4.16.2.1

Data Pattern: DP <Parameter Value> or DataPattern < Parameter Value>


The data pattern must be in a two-character hexadecimal pattern in the range of 00FF. The hex letters can be uppercase or lowercase. The default pattern is random, for example:
# scli -KL (<HBA Port No.> | <HBA WWPN>) DP Random

To enter a customized value, type the following command:


# scli -KL (<HBA Port No.> | <HBA WWPN>) DP <Parameter Value>
4.16.2.2

Data Size: DS <Parameter Value> or DataSize <Parameter Value>


The data size can be 8, 16, 32, or 64 bytes. The default value is 8 bytes.

4-64

SN0054614-00 B

Q
4.16.2.3

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

Number of Tests: TC <Parameter Value> or TestCount <Parameter Value>


The number of tests run must be in the range 010000. A value of 0 indicates that the test will be continuous (it will stop when you press ENTER). The default number of tests run is 500.
4.16.2.4

Test Increment: TI <Parameter Value> or Test Increment <Parameter Value>


The test increment must be in the range 110000. If the number of tests is continuous (see section 4.16.2.3), the test increment is automatically set to one of the following:

12 (Windows 2000, Windows Server 2003, Enterprise Server) 25 (Solaris SPARC) 2 (Linux and MAC OS X)

The default test increment is 1. The test increment cannot be larger than the number of tests run (TestCount; see section 4.16.2.3).
4.16.2.5

On Error: OE <Parameter Value> or OnError <Parameter Value>


This parameter determines how errors are handled. The valid values are listed in table 4-4. Table 4-4. On Error Parameter
Value 0 1 2 Meaning The error is ignored. This is the default value. If an error occurs, the test is stopped. If an error occurs, the same data pattern and test is used until the error is cleared.

4.16.2.6

Run a Loopback Test


This test sends and receives messages through a loopback or through an echo command to the switch.

SN0054614-00 B

4-65

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

NOTE:

An echo test is run instead of a loopback test under the following conditions:

You have a QLA23xx, QLA24xx, QLE23xx, or QLE24xx HBA that is connected to the fabric through a point-to-point connection (F-port). Your operating system has one of the driver versions listed in table 4-5.
Driver Versiona 9.0.0.12 9.0.0.12 4.12

Table 4-5. Driver Versions that Do Not Require a Loopback Connector


Operating System Windows 2000 or Windows Server 2003 with SCSI miniport driver Windows Server 2003 with STORport miniport driver Solaris SPARC Table Notes a All subsequent versions also apply.

To perform a loopback test using the current parameters, type the following command:
# scli -KL (<HBA Port No.> | <HBA WWPN>)

To perform a loopback test with custom parameters, type the following command:
# scli -KL (<HBA Port No.> | <HBA WWPN>) [(<Parameter Name> | <Parameter Alias>) <Parameter Value>]

Sections 4.16.2.1 through 4.16.2.5 describe the parameters and their default values. The following examples perform 500 loopback tests with a test increment of 10, a data pattern of FFh, and a data size of 8 bytes. The test will stop if an error occurs.
# scli -KL <HBA WWPN> DP FF DS 8 TC 500 TI 10 OE 1 # scli -KL <HBA Port No.> DP FF DS 8 TC 500 TI 10 OE 1

You do not have to set each parameter for the loopback test. If you do not specify a parameter in the command line, the current parameter value is used. For example, the following command sets the data pattern to FFh and uses the current values for the other parameters:
# scli -KL <HBA Port No.> DP FF

4-66

SN0054614-00 B

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

The following example sets the data size to 16 bytes and has the test loop if an error occurs. The other parameters use the current values:
# scli -KL <HBA WWPN> DS 16 OE 2

Figure 4-1 shows the results for a successful loopback test.


Test Configuration Data Pattern Data Size (Bytes) Number of test(s) (1-10,000) Test Increment (1-10,000) On Error Test Continuous = = = = = = Random 8 N/A 125 Ignore ON

Diagnostics - Loopback Test Result Note: Press <Enter> to stop the test any time

HBA 0

Test Data Pattern B1-3B-6A-A5-11-28-C1-8C

Status Success

CRC 0

Disparity 0

FrameLength 0

Active /

Figure 4-1. Sample Loopback Test Results


4.16.2.7

Run a Read/Write Buffer Test


This test runs on all or selected devices on the selected HBA. This test sends the SCSI Write Buffer command to the devices and uses the SCSI Read Buffer command to read the data back and perform a data comparison. NOTE: All devices attached to the HBA must support SCSI Read/Write Buffer commands.

To perform a read/write buffer test using the current parameters, type the following command:
# scli -KR (<HBA Port No.> | <HBA WWPN>)

To exclude a device or devices on the selected HBA port, type the following command:
# scli -KR (<HBA Port No.>|<HBA-WWPN>) [(-EX | -EXCLUDE) <Target WWPN>] [(<Parameter Name> | <Parameter Alias>) <Parameter Value>]

Sections 4.16.2.1 through 4.16.2.5 describe the parameters and their default values.

SN0054614-00 B

4-67

4 Command Line Options Diagnostics (Command Line Options -KL and -KR)

The following examples perform 500 read/write buffer tests with a test increment of 10, a data pattern of FFh, and a data size of 8 bytes. The test will stop if an error occurs.
# scli -KR <HBA Port No.> DP FF DS 8 TC 500 TI 10 OE 1 # scli -KR <HBA WWPN> DP FF DS 8 TC 500 TI 10 OE 1

You do not have to set each parameter for the read/write buffer test. If you do not specify a parameter in the command line, the current parameter value is used. For example, the following command sets the data pattern to FFh and uses the current values for the other parameters:
# scli -KR <HBA Port No.> DP FF

The following example sets the data size to 16 bytes and has the test loop if an error occurs. The other parameters use the current values.
# scli -KR <HBA WWPN> DS 16 OE 2

Figure 4-2 shows the results for a successful read/write buffer test.
Test Configuration Data Pattern Data Size (Bytes) Number of test(s) (1-10,000) Test Increment (1-10,000) On Error Test Continuous = Random = 8 = N/A = 125 = Ignore = ON

Diagnostics - Read/Write Buffer Test Result Note: Press <Enter> to stop the test any time

Item No

Data Pattern

Status Success

32 79-FE-52-DB-25-43-E5-3C

Figure 4-2. Sample Read/Write Buffer Test Results If the read/write buffer test fails, the following information is displayed:

Loop/port ID Status Data miscompare Link failure Loss of sync Loss of signal Invalid CRC

4-68

SN0054614-00 B

Q
4.17

4 Command Line Options Statistics (Command Line Options -GS and -LS)

Statistics (Command Line Options -GS and -LS)


This option allows you to view and reset HBA and link statistics.
4.17.1

HBA Statistics
4.17.1.1

Interactive Mode
Perform the following steps to view the HBA statistics: 1. Type the number for the Statistics option, then press ENTER. 2. The Statistics Menu displays. Type the number for the HBA Statistics option, then press ENTER. 3. The HBA Statistics Menu displays. Type the number for the Show Statistics option, then press ENTER. 4. The HBA View Statistics Menu displays. Type the number for the Display HBA Statistics option, then press ENTER. 5. You are prompted to select an HBA port. Type the number for the port, then press ENTER. The HBA statistics for that port are displayed, followed by the HBA View Statistics Menu. Perform the following steps to change or reset the HBA statistics: 1. Type the number for the Statistics option, then press ENTER. 2. The Statistics Menu displays. Type the number for the HBA Statistics option, then press ENTER. 3. The HBA Statistics Menu displays. Do one of the following: a. To change the HBA statistics, type the number for the Show Statistics option, then press ENTER. Continue with step 4. b. To reset the HBA statistics, type the number for the Reset Statistics option, then press ENTER. 4. The HBA View Statistics Menu displays. Type the number for the Display Options option, then press ENTER.

SN0054614-00 B

4-69

4 Command Line Options Statistics (Command Line Options -GS and -LS)

5. The Statistics Display Settings menu displays. From this menu, you can do one of the following:

Show the current display settings. Restore the display settings to their default values. Set one of the display settings: Auto Poll, Set Rate, or Log to File (see table 4-6).

The following text is an example of enabling the Auto Poll option for an HBA port.
Main Menu 1: 2: 3: 4: 5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16: Display System Information Display HBA Settings Display HBA Information Display Device List Display LUN List Configure HBA Settings Target Persistent Binding Selective LUNs Boot Device Driver Settings HBA Utilities Flash Beacon Diagnostics Statistics Help Quit Enter Selection: 14 SANsurfer FC HBA CLI v1.06.16 Build 20 Statistics Menu 1: 2: HBA Statistics Link Status Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA Statistics Menu 1: 2: Show Statistics Reset Statistics

4-70

SN0054614-00 B

Q
3: SANsurfer FC HBA CLI v1.06.16 Build 20 HBA View Statistics Menu 1: 2: 3:

4 Command Line Options Statistics (Command Line Options -GS and -LS)

Return to Statistics Menu Note: 0 to return to Main Menu Enter Selection: 1

Display Options Display HBA Statistics Return to HBA Statistics Menu

Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 Statistics Display Settings 1: 2: 3: 4: 5: 6: Show Display Settings Restore Display Settings to Default Auto Poll Set Rate Log to File Return to HBA View Statistics Menu Note: 0 to return to Main Menu Enter Selection: 3 SANsurfer FC HBA CLI v1.06.16 Build 20 Diagnostics Configuration: Enable/Disable Test Continuous Mode 1: 2: 3: Enable Auto Poll Set Sampling Run Return to Statistics Display Settings

Note: 0 to return to Main Menu Enter Selection: 1 Auto Poll enabled.

SN0054614-00 B

4-71

4 Command Line Options Statistics (Command Line Options -GS and -LS)

4.17.1.2

Non-interactive Mode
To view the HBA statistics, type the following command:
# scli -GS (<HBA Port No.> | <HBA WWPN>) [(<Parameter Name> | <Parameter Alias>) <Parameter Value>]

To reset the HBA statistics, type the following command:


# scli -GS (<HBA Port No.> | <HBA WWPN>) RESET

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Parameter Name = Name of the parameter (see table 4-6). Parameter Alias = Alias of the parameter (see table 4-6). Parameter Value = New value of the parameter (see table 4-6).

The parameter names, aliases, and values are defined in table 4-6. Table 4-6. HBA Statistics Parameters
Parameter Description Sets how often statistics are retrieved Set the polling interval when retrieving statistics (seconds) Saves the HBAs statistics to a CVS log file Parameter Name AutoPoll PollRate Parameter Alias AP SR Parameter Value 0256a 530

LogToFile

LF

Log file name

Table Notes a When the AutoPoll parameter is 0, statistics are retrieved automatically until the user aborts the operation. When the AutoPoll parameter is in the range of 1256, statistics are retrieved for the number of cycles specified by this value.
4.17.2

Link Status
The following sections describe how to view and change the HBAs link status.

4-72

SN0054614-00 B

Q
4.17.2.1

4 Command Line Options Statistics (Command Line Options -GS and -LS)

Interactive Mode
Perform the following steps to view the link status: 1. Type the number for the Statistics option, then press ENTER. 2. The Statistics Menu displays. Type the number for the Link Status option, then press ENTER. 3. The HBA Link Status Menu displays. Type the number for the Show Link Status option, then press ENTER. 4. The HBA View Link Status Menu displays. Type the number for the Display Link Status option, then press ENTER. 5. You are prompted to select an HBA port. Type the number for the port, then press ENTER. The HBA link status for that port is displayed, followed by the HBA View Link Status Menu. Perform the following steps to change or reset the link status: 1. Type the number for the Statistics option, then press ENTER. 2. The Statistics Menu displays. Type the number for the Link Status option, then press ENTER. 3. The HBA Link Status Menu displays. Do one of the following:

To reset the link status options to their default values, type the number for the Reset Link Status option. To change the link status options, type the number for the Show Link Status option, then press ENTER. Continue with step 4.

4. If you selected the Show Link Status option, the HBA View Link Status Menu displays. Type the number for the Display Options option, then press ENTER. 5. The LINK_STATUS Display Settings menu displays. From this menu, you can do one of the following:

Show the current display settings. Restore the display settings to their default values. Set one of the display settings: Auto Poll or Rate. Save the statistics to a log file.

The following text is an example of setting the Auto Poll option for a link:
Main Menu 1: 2: 3: 4: Display Display Display Display System Information HBA Settings HBA Information Device List

SN0054614-00 B

4-73

4 Command Line Options Statistics (Command Line Options -GS and -LS)

5: 6: 7: 8: 9: 10: 11: 12: 13: 14: 15: 16:

Display LUN List Configure HBA Settings Target Persistent Binding Selective LUNs Boot Device Driver Settings HBA Utilities Flash Beacon Diagnostics Statistics Help Quit Enter Selection: 14 SANsurfer FC HBA CLI v1.06.16 Build 20

Statistics Menu 1: 2: HBA Statistics Link Status Note: 0 to return to Main Menu Enter Selection: 2 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA Link Status Menu 1: 2: 3: Show Link Status Reset Link Status Return to Statistics Menu Note: 0 to return to Main Menu Enter Selection: 1 SANsurfer FC HBA CLI v1.06.16 Build 20 HBA View Link Status Menu 1: 2: 3: Display Options Display Link Status Return to Link Status Menu Note: 0 to return to Main Menu Enter Selection: 1

4-74

SN0054614-00 B

Q
SANsurfer FC HBA CLI v1.06.16 Build 20 LINK_STATUS Display Settings 1: 2: 3: 4: 5: 6:

4 Command Line Options Statistics (Command Line Options -GS and -LS)

Show Display Settings Restore Display Settings to Default Auto Poll Set Rate Log to File Return to Previous Menu Note: 0 to return to Main Menu Enter Selection: 3

SANsurfer FC HBA CLI v1.06.16 Build 20 Diagnostics Configuration: Enable/Disable Test Continuous Mode 1: 2: 3: Enable Auto Poll Set Sampling Run Return to LINK_STATUS Display Settings

Note: 0 to return to Main Menu Enter Selection: 1 Auto Poll enabled.


4.17.2.2

Non-interactive Mode
To view the link status, type the following command:
# scli -LS (<HBA Port No.> | <HBA WWPN>) [(<Parameter Name> | <Parameter Alias>) <Parameter Value>]

To reset the link status, type the following command:


# scli -LS (<HBA Port No.> | <HBA WWPN>) RESET

Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA Parameter Name = Name of the parameter (see table 4-7) Parameter Alias = Alias of the parameter (see table 4-7) Parameter Value = New value of the parameter (see table 4-7)

SN0054614-00 B

4-75

4 Command Line Options Help (Command Line Option -H)

Q
Table 4-7. Link Status Parameters
Parameter Name AutoPoll PollRate Parameter Alias AP SR Parameter Value 0256a 530

The parameter names, aliases, and values are defined in table 4-7.

Parameter Description Sets how often link status is retrieved Set the polling interval when retrieving link status (seconds). Saves the link status to a CVS log file.

LogToFile

LF

Log file name

Table Notes a When the AutoPoll parameter is 0, the link status is retrieved automatically until the user aborts the operation. When the AutoPoll parameter is in the range of 1256, the link status is retrieved for the number of cycles specified by this value.
4.18

Help (Command Line Option -H)


This command displays information about the available command line options.
4.18.1

Interactive Mode
Perform the following steps to view the help file: 1. From the Main Menu, type the number for the Help option, then press ENTER. 2. The Help Menu displays. Do one of the following:

Type 1 to view the help file. Type 2 to view the current version information for SANsurfer FC HBA CLI.

4.18.2

Non-interactive Mode
Type the following text to view the help file:
# scli (-H | ?)

Type the following text to view help information for an individual command:
# scli <Command Line Parameter> (-H | ?)

For example, typing scli -L -H displays:


SANsurfer FC HBA CLI v1.06.16 Build 20

4-76

SN0054614-00 B

4 Command Line Options Input From a File (Command Line Option -F)

Copyright 2003-2005 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters scli -l (<hba portno> | <hba wwpn>) - Displays LUN information for all HBAs. scli -l (<hba portno> | <hba wwpn>) (<target wwpn>| <target portid>) - Displays LUN information for a specific target scli -l (<hba portno> | <hba wwpn>) (<target wwpn>| <target portid>) <lun id>] - Displays LUN information for a specific LUN on a specific target

NOTE:

To view the current version information for SANsurfer FC HBA CLI, use the -V option (see section 4.22).

4.19

Input From a File (Command Line Option -F)


NOTE: This option is valid only in non-interactive mode, and cannot be combined with any other options. Only one command line parameter per file is valid. This option is used when it is run as a script file.

To input parameter options to SANsurfer FC HBA CLI through a text file, type -F, followed by the file name. For example:
# scli -F command.txt

The text file must be formatted as follows:


The file must contain a single line. The file must contain only parameters. The file cannot contain another -F option.

The following example shows how to set the connection option of a HBA to default (loop preferred, otherwise point-to-point) and the data rate to auto through a command file that is invoked by the -F option: 1. Create a text file (for example, sethba0.txt) and enter the following command in the text file:
-n 0 co 2 dr 2

2. Save and close the file. 3. Issue the scli command with the -F option (input from command file):
# scli -F sethba0.txt

SN0054614-00 B

4-77

4 Command Line Options Output to a File (Command Line Option -O)

4.20

Output to a File (Command Line Option -O)


NOTE:

This option is valid only in non-interactive mode. This option can be used with all non-interactive mode options that have a corresponding interactive mode option (see table 2-1). The option must be the first or last command in the command line.

To output result and status messages into a file, type -O, followed by the file name. For example:
# scli -L 2 -S -O system

If the file name is system, then all of the messages are locked in the following locations:

Windows OS: syslog.log in the current directory Red Hat/SuSE Linux/PPC/MAC OS X: /var/log/messages Solaris SPARC: /var/adm/messages

If the file already exists, the new messages are appended to the current file.
4.21

Silent Mode (Command Line Option -S)


NOTE:

This option is valid only in non-interactive mode. This option can be used with all non-interactive mode options that have a corresponding interactive mode option (see table 2-1). The option must be the first or last command in the command line.

In non-interactive mode, result and status messages generated by the application are displayed by default unless suppressed by silent mode. This option is usually combined with the -O option (see section 4.20) so that the output is saved in a file and not displayed on screen. For example:
# scli -I ALL -S -O output.txt

4-78

SN0054614-00 B

Q
4.22

4 Command Line Options Output in XML Format (Command Line Option -X)

Display Version (Command Line Option -V)


NOTE: This option is valid only in non-interactive mode. To display the version number of the SANsurfer FC HBA CLI application, type -V. For example:
# scli -V

The following information is displayed:


SANsurfer FC HBA CLI v1.06.16 Build 20 Copyright 2003-2005 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters. Build Type: Release Build Date: 06/24/2005 11:46:54 AM
4.23

Output in XML Format (Command Line Option -X)


NOTE:

This option is valid only in non-interactive mode. This option can be used with all non-interactive mode options that have a corresponding interactive mode option (see table 2-1). The option must be the first or last command in the command line.

When this option is used, all result and status messages are displayed in XML formats. These formats are described in section 5. This option is usually combined with the -O option (see section 4.20) to create a text file with XML output so that it can be parsed by an XML-compliant utility. For example:
# scli -I ALL -X -O output.xml

SN0054614-00 B

4-79

4 Command Line Options Output in XML Format (Command Line Option -X)

Notes

4-80

SN0054614-00 B

XML Format
The -X command line option (see section 4.23) displays all output in XML format. This section defines the XML output format, which consists of the following parts:

Section 5

Main tag Utility header Status message XML message (one for each option)

5.1

Main Tag
When SANsurfer FC HBA CLI is in XML mode, all outputs are contained within the following main tag:
<QLogic> ... </QLogic>
5.2

Utility Header
The following header information is displayed after the main tag:
<AppName> SANsurfer Command Line Utility </AppName> <AppVersion> X.YY.ZZ Build XX</AppVersion>
5.3

Status Message
Before the closing main tag </QLogic>, SANsurfer FC HBA CLI displays any returning status from the execution of the command line parameters and the error messages. When the execution of the command line parameters is successful, the following status is displayed:
<Status> 0 </Status>

When the execution of the command line parameters fails, the following status is displayed, followed by an error message that provides additional details:
<Status> 1 </Status> <ErrorMsg> Details of the failure </ErrorMsg>

SN0054614-00 B

5-1

5 XML Format XML Message for Each Option

When the execution of the command line parameters is successful and the system must be restarted for the change to take effect, the following message is displayed:
<Reboot> 1 </Reboot>

When the execution of the command line parameters is successful and the system does not need to be restarted, the following message is displayed:
<Reboot> 0 </Reboot>
5.4

XML Message for Each Option


The following sections describe the XML format for each command line option. In these sections, the term number refers to the adapter number displayed with the HBA general information (command line option -I).
5.4.1

Display System Information (Command Line Option -G)


The XML format for system information output is as follows:
<Host> <Name> Host Name </Name> <OSType> OS Type </OSType> <OSVersion> OS Version (and patches where applicable) </OSVersion> <HBA Number="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of QLogic Fibre Channel HBA(s) detected </NumOfHBA> </Host>

The parameter <HBA/> is repeated for each HBA in the system.

5-2

SN0054614-00 B

Q
5.4.2

5 XML Format XML Message for Each Option

Display Adapter Settings (Command Line Option -C)


The XML format for adapter settings information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Param ConnectionOption="value" DataRate="value" FrameSize="value" HardLoopID="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value" OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" EnableExtendedLogging="value" LoginRetryCount="value" EnableLipReset="value" PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" /> </HBA>

Each parameter is listed on a separate line for clarity; however, multiple parameters can be on the same line. For multiple adapters, repeat the above sequence with the ID number (ID Number="value") of the next adapter.

SN0054614-00 B

5-3

5 XML Format XML Message for Each Option

5.4.3

Display HBA Information (Command Line Option -I)


The XML format for adapter general information is as follows:
<HBA> <GeneralInfo Number ="value" Model="value" WWNN="value" WWPN="value" PortID="value" SerialNumber="value" DriverVersion="value" BIOSVersion="value" FcodeVersion="value" FirmwareVersion="value" TargetCount="value" PCIBus="value" PCIDevice="value" ActualConnectionMode="value" ActualDataRate="value" Configuration="value" PortType="value" Status="value" </HBA>
5.4.4

Display Device List (Command Line Option -T)


The XML format for adapter device information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Info Path="value" ID="value" Vendor= "value" ProductID= "value" Revision= "value" PortID= "value" LunCount= "value" Type= "value" DeviceStatus= "value" /> </Target> </HBA>

The <Target></Target> sequence is repeated for each HBA target.

5-4

SN0054614-00 B

Q
5.4.5

5 XML Format XML Message for Each Option

Display LUN List (Command Line Option -L)


The XML format for the adapter LUN list information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <LUN ID="value" WWULN="value" Vendor ="value" Product ="value" Revision ="value" Size="value" /> </Target> </HBA>

The <LUN /> sequence is repeated for each LUN attached to the target. The LUN list is listed under the target, not the adapter.
5.4.6

Target Persistent Binding (Command Line Option -P)


The XML format for the adapter target persistent binding information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <TargetBinding TargetWWNN="value" TargetWWPN="value" TargetPortID="value" TargetID="value" /> </HBA>

The <TargetBinding /> sequence is repeated for each target bound to the adapter.
5.4.7

Selective LUNs (Command Line Option -M)


The XML format for the selective LUNs information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <EnabledLUN ID="value" LUNWWN="value" /> </Target> </HBA>

The <EnabledLUN /> sequence is repeated for each enabled LUN under the target.

SN0054614-00 B

5-5

5 XML Format XML Message for Each Option

5.4.8

Boot Device (Command Line Option -E)


The XML format for the boot device information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <BootDevice TargetWWNN="value" TargetWWPN="value" TargetID="value" LUNID="value" /> </HBA>

The <BootDevice/> sequence is repeated for each boot device of the adapter. In Windows 2000/Windows Server 2003 and Red Hat/SuSE Linux, the TargetID="value" field is not present.
5.4.9

Diagnostics ResultsLoopback Test (Command Line Option -KL)


The XML format for the loopback test results is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Port ID="value" CRCError="value" DisparityError="value" FrameLengthError="value" Result="Success"/> </HBA>
5.4.10

Diagnostics ResultsRead/Write Buffer Test (Command Line Option -KR)


The XML format for the read/write buffer test results is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Port ID ="value" DataMiscompare="value" LinkFailure= "value" LossOfSync="value" LossOfSignal="value" InvalidCRC="value" Result="value" /> </Target> </HBA>

5-6

SN0054614-00 B

Q
5.4.11

5 XML Format XML Message for Each Option

The <Target> sequence is repeated for each device attached to the adapter.

View Driver Settings (Command Line Option -FG)


The XML format for the current driver settings information is as follows:
<HBA> <ID Number="value" WWNN="value" WWPN="value" /> <DriverSettings> <Info PersistentPlusNew="value" PersistentOnly="value" BindbyWWPN="value" BindbyPortID="value" /> </DriverSettings> </HBA>
5.4.12

Display All Information for One or All HBAs (Command Line Option -Z)
The XML format for all adapter information is more complicated than its non-XML counterpart because the tags cannot be repeated. In non-XML mode, SANsurfer FC HBA CLI sequentially calls all the options in table 5-1, and each option is displayed in its standard output format. If each option displays its own XML output, the resulting display would have multiple duplicate tags. Table 5-1. Options Displayed by -Z
Non-interactive Option -G -C -I -T -L -P -M -E Description Display system information Display HBA settings Display HBA information Display device list Display LUN list Target persistent binding Selective LUNs Boot device Section 4.1 4.2 4.3 4.4 4.5 4.7 4.8 4.9

The XML format for all adapter information is as follows:


<Host> <Name> Host Name </Name> <OSType> OS Type </OSType>

SN0054614-00 B

5-7

5 XML Format XML Message for Each Option

<OSVersion> OS Version (and patches where applicable) </OSVersion> <HBA Number="value" WWNN="value" WWPN="value" /> <NumOfHBA> Number of QLogic Fibre Channel HBA(s) detected </NumOfHBA> </Host> <HBA> <ID Number="value" WWNN="value" WWPN="value" /> <GeneralInfo Number ="value" Model="value" WWNN="value" WWPN="value" PortID="value" SerialNumber="value" DriverVersion="value" BIOSVersion="value" FirmwareVersion="value" TargetCount="value" PCIBus="value" PCIDevice="value" ActualConnectionMode="value" ActualDataRate="value" PortType="value" Status="value" /> <Param ConnectionOption="value" FrameSize="value" HardLoopID="value" LoopResetDelay="value" EnableHostAdapterBIOS="value" EnableHardLoopId="value" FibreChannelTapeSupport="value" OperationMode="value" IntDelayTimer="value" ExecutionThrottle="value" EnableExtendedLogging="value" LoginRetryCount="value" EnableLipReset="value" PortDownRetryCount="value" EnableLipFulllogin="value" LinkDownTimeout="value" EnableTargetReset="value" LUNsPerTarget="value" />

5-8

SN0054614-00 B

5 XML Format XML Message for Each Option

<Target> <WWNN> Target WWNN </WWNN> <WWPN> Target WWPN </WWPN> <Info Path= "value" Vendor ="value" ProductID= "value" Revision= "value" PortID= "value" LunCount= "value" Type= "value" DeviceStatus= "value" /> <LUN ID="value" WWULN="value" Vendor ="value" Product= "value" Revision= "value" Size= "value" /> <EnabledLUN ID="value" LUNWWNN="value"LUNWWPN="value" /> </Target> <TargetBinding TargetWWNN="value" TargetWWPN="value" TargetPortID="value" TargetID="value" /> <BootDevice TargetWWNN="value" TargetWWPN="value" LUNID="value" /> <DriverSettings> <Info PersistentPlusNew="value" PersistentOnly="value" BindbyWWPN="value" BindbyPortID="value" /> </DriverSettings> </HBA>

NOTE:

The <HBA></HBA> sequence is repeated for each HBA. The <Target></Target> sequence is repeated for each target. The <LUN /> parameter is repeated for each LUN. The <EnabledLUN ID. /> parameter is repeated for each enabled LUN. The <TargetBinding/> parameter is repeated for each target persistent binding entry. The <BootDevice/> parameter is repeated for each boot device selection entry.

SN0054614-00 B

5-9

5 XML Format XML Message for Each Option

5.4.13

LInk Statistics (Command Option -LS)


The XML format for the link statistics option is as follows:
<HBA> <HBA Port="value" WWPN="value" WWNN="value" /> <LinkStatus PortName="value" LinkFailure="value" SyncLoss="value" SignalLoss="value" InvalidCRC="value" TimeStamp="value" /> ... <LinkStatus PortName="value" LinkFailure="value" SyncLoss="value" SignalLoss="value" InvalidCRC="value" TimeStamp="value" />
5.4.14

HBA Statistics (Command Option -GS)


The XML format for the HBA statistics option is as follows:
<HBA> <HBA Port="value" WWPN="value" WWNN="value" /> <Statistics PortID="value" PortError="value" DeviceError="value" Reset="value" IOCount="value" IOPS="value" BPS="value" TimeStamp="value" /> </HBA>

5-10

SN0054614-00 B

EBNF Format of Command Line


A.1

Appendix A

Example
The following text is an example of the Extended Backus Normal Form (EBNF) command line format.
SANsurfer FC HBA CLI v1.06.14 Build 24 Copyright 2003-2005 QLogic Corp. All rights reserved. Command Line QLogic FC Host Bus Adapters Usage: scli [-x -s -o ] [-g -c -i -t -l -z -n -p -b -r -d -m -e -a -kl -kr -fg -fs -v] [-h -?] [-f] [ int ]

NOTE:

Options -x,-s,-o can be combined with other options. However, they must be at the beginning or at the end of the command line. Option -f cannot be combined with any other options. The dash (-) character can be replaced with a slash (/) character, i.e. scli -g and scli /g are both valid commands.

A.2

Non-Interactive Commands
A.2.1

Introduction
This section contains the same information as the help text file, sclihelp.txt. Each command line option is listed, followed by a command description. NOTE:

Options -X,-S,-O can be combined with other options. However, they must be at the beginning or at the end of the command line. Option -F cannot be combined with any other options.

SN0054614-00 B

A-1

A EBNF Format of Command Line Non-Interactive Commands

Only one command line option per input file is valid. The - character can be replaced by the / character. For example, SCLI -G and SCLI /G are both valid commands.

Table A-1 defines the command variables. Table A-1. Command Variables
Variable <HBA Port No.> HBA port number <HBA WWPN> HBA world wide port name in the following format: Definition

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx

<Target WWNN> Target world wide node name in the following format: <Target WWPN> Target World Wide Port Name in the following format: <Target Port ID> Target port ID in the following format: xx-xx-xx or xxxxxx <Target ID> Target ID <LUN ID> Logical unit number (0255)
A.2.2

Command Summary
[ int ]

Starts interactive mode.


-G

Displays the system information.


-C [<ALL>]

Displays parameter settings for all HBAs.


-C (<HBA Port No.> | <HBA WWPN>)

Displays parameter settings for a specific HBA


-I [<ALL>] [VPD]

Displays all HBAs general information or VPD information.


-I (<HBA Port No.> | <HBA WWPN>) [VPD]

Displays a specific HBA general information or VPD information.


-T [<ALL>]

Displays the target information on all HBAs.

A-2

SN0054614-00 B

Q
-T (<HBA Port No.> | <HBA WWPN>)

A EBNF Format of Command Line Non-Interactive Commands

Displays the target information on a specific HBA.


-T (<HBA Port No.> | <HBA WWPN>) (<Target WWPN> | <Target Port ID>)

Displays specific target information on a specific HBA.


-L (<HBA Port No.> | <HBA WWPN>)

Displays LUN information for all HBAs


-L (<HBA Port No.> | <HBA WWPN>) (<Target WWPN> | <Target Port ID>)

Displays LUN information for a specific target.


-L (<HBA Port No.> | <HBA WWPN>) (<Target WWPN> | <Target Port ID>) <LUN ID>

Displays LUN information for a specific LUN on a specific target.


-N (<HBA Port No.> | <HBA WWPN>) {(<Parameter Name> | <Parameter Alias>) <Parameter Value>}

HBA port settings (NVRAM). The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are described in table A-2. Table A-2. HBA Parameters
Parameter Name DataRate ConnectionOption EnableFCTape MaximumLUNsPerTarget EnableHardLoopID HardLoopID FrameSize EnableLipReset EnableLIPFullLogin EnableTargetReset EnableExtendedLogging EnableBIOS ResetDelay Parameter Alias DR CO EF ML HL HD FR LP FL TR EL EB RD Parameter Value 03
a

Parameter Description Data rate Connection options Enable Fibre Channel tape support Maximum LUNs per target Enable hard loop ID Hard loop ID Frame size Enable LIP reset Enable LIP full login Enable target reset Enable extended logging Enable BIOS Loop reset delay

02 for QLA23xx; 03 for QLA22xxb 1, 0c 0, 8, 16, 32, 64, 128, 256 1, 0c 0125 512, 1024, 2048 1, 0c 1, 0 1, 1, 0
c

0c
c

1, 0c 060 seconds

SN0054614-00 B

A-3

A EBNF Format of Command Line Non-Interactive Commands

Q
Table A-2. HBA Parameters (Continued)
Parameter Alias LR LT LD PD ET FE OM Parameter Value 0255 0255 1, 0
c, d

Parameter Name LoginReTryCount LinkDownTimeOut LinkDownError PortDownRetryCount ExecutionThrottle FastErrorReporting OperationMode

Parameter Description Login retry count Link down timeout Link down error Port down retry count Execution throttle Fast error reporting Operation mode (Not supported on Solaris) Interrupt delay timer (Not supported on Solaris)

0255 1256 1, 0 c, d
e

0, 5, 6

InterruptDelayTimer

ID

0255f

Table Notes a Data rate (QLA23xx/QLE24xx, QLA24xx HBAs): 0=1 Gbps, 1=2 Gbps, 2=Auto, 3=4 Gbps
b

Connection options: 0=loop only, 1=point-to-point only, 2=loop preferred, otherwise point-to-point, 3=point-to-point, otherwise loop (QLA22xx HBAs) 0=Disable parameter is valid only in Solaris SPARC.

c1=Enable, dThis eOperation

mode (QLA/QLE23xx and QLA/QLE24xx HBAs): 0=interrupt for every I/O completion, 5=interrupt when interrupt delay timer expires, 6=interrupt when interrupt delay timer expires or no active I/O
f

QLA/QLE23xx and QLA/QLE24xx HBAs

-P (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

Shows persistent binding information on a specific HBA.


-P (<HBA Port No.> | <HBA WWPN>) {<Target WWNN> <Target WWPN> <Target Port ID> <Target ID>}

Bind selected targets on a specific HBA.


-P (<HBA Port No.> | <HBA WWPN> | <ALL>) BIND ALL

Bind all targets on a specific HBA or all HBAs.


-P (<HBA No.> | <HBA WWPN> | <ALL>) REMOVE ALL | UNBIND ALL

Unbind all targets on a specific HBA or on all HBAs.


-P (<HBA No.> | <HBA WWPN>) Remove <Target WWNN> | UNBIND <Target WWNN>

Unbind a specific target.

A-4

SN0054614-00 B

A EBNF Format of Command Line Non-Interactive Commands

-M (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

View the HBAs selective LUN list.


-M (<HBA Port No.> | <HBA WWPN>) <Target WWNN> <Target WWPN> <LUN ID> (VIEW | ?)

View a LUNs selective state of a specific device.


-M (<HBA Port No.> | <HBA WWPN>) {<Target WWNN> <Target WWPN> <LUN ID> (0 | 1 | ENABLE | DISABLE)}

Select/unselect a LUN of a specific target on a specific HBA.


-M (<HBA Port No.> | <HBA WWPN>) SELECT ALL

Select all LUNs for all targets on the HBA.


-M (<HBA Port No.> | <HBA WWPN>) SELECT <Target WWPN>

Select all LUNs for a specific target.


-M (<HBA Port No.> | <HBA WWPN>) UNSELECT ALL

Unselect all LUNs for all targets on the HBA.


-M (<HBA Port No.> | <HBA WWPN>) UNSELECT <Target WWPN>

Unselect all LUNs for a specific target.


-E (VIEW | ?)

View the boot device of all HBAs.


-E (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

View the boot device of a specific HBA.


-E (<HBA Port No.> | <HBA WWPN>) <Target WWNN> <Target WWPN> <LUN ID>

Set a target as boot device on a specific HBA.


-E (<HBA Port No.> | <HBA WWPN>) (ENABLE | 0 0 0)

Set a default BIOS boot device on a specific HBA.


-E (<HBA Port No> | <HBA WWPN>) DISABLE

Clear the boot device on a specific HBA.


-FG (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

View driver settings.


-FS (<HBA Port No.> | <HBA WWPN>) {(<Parameter Name> | <Parameter Alias>) <Parameter Value>}

Configure driver settings.

SN0054614-00 B

A-5

A EBNF Format of Command Line Non-Interactive Commands

Q
Table A-3. Driver Settings
Parameter Alias PO PN BW BP Parameter Valuea 1, 0 1, 0 1, 0 1, 0

The <Parameter Name> | <Parameter Alias>) <Parameter Value> options are defined in table A-3.

Parameter Name PersistentOnly PersistentPlusNew BindWWPN BindPortID Table Notes a 1=Enabled, 0=Disabled

Parameter Description Persistent only Persistent plus new Bind by WWPN Bind by port ID

-B (<ALL> | <HBA Port No.> | <HBA WWPN>) <File Name>

Updates the HBAs Option ROM.


ALL = All HBAs in the system will be updated with the new

BIOS/FCode

HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA File Name = File name or a path to a file that contains the updated

BIOS/FCode

-B (<HBA Port No.> | <HBA WWPN>) SAVE <File Name>

Saves the HBAs Option ROM to a file.


-R (<HBA Port No.> | <HBA WWPN> | <ALL>) <File Name>

Update the HBAs NVRAM.


-R (<HBA Port No.> | <HBA WWPN>) SAVE <File Name>

Saves the HBAs NVRAM to a file.


-D <File Name>

Update driver to HBAs where <File Name> is the full path of the driver oemsetup.inf file or driver zip/exe file.
-a (<HBA Port No.> | <HBA WWPN>) (VIEW | ?)

View HBAs LED flashing status. -A (<HBA Port No.> | <HBA WWPN>) Toggle the HBAs LED flashing state.

A-6

SN0054614-00 B

A EBNF Format of Command Line Non-Interactive Commands

-TB (<HBA Port No.> | <HBA WWPN>) {(<Target WWPN>)} <Beacon Mode>

Target beacon: Flash the disk drives LED to locate the drive in a JBOD. The <Beacon Mode> options are as follows:
0| ON = Flashes the LED until interrupted 1 | PRESET = Flashes the LED 12 times, and is supported only

on JBOD devices.

-KL (<HBA Port No.> | <HBA WWPN>) [{(<Parameter Name> | <Parameter Alias>) <Parameter Value>}]

Run HBA diagnostics loopback test. The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are described in table A-4. The following information is displayed after a loopback test completes: test status, CRC error, disparity error, frame length error.
-KR (<HBA Port No.> | <HBA WWPN>) [{(-EX | -EXCLUDE) <Target WWPN>}] [(<Parameter Name>| <Parameter Alias>) <Parameter Value>]

Run HBA diagnostics read-write buffer test. The {(-EX | EXCLUDE) <Target WWPN>} parameters specifies a device that will be excluded from the read/write buffer test. The following information is displayed after a read/write buffer test completes: loop ID/status, Data miscompare, link failure, loss of sync, loss of signal, invalid CRC. The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are described in table A-4. Table A-4. Diagnostics Parameters
Parameter Name DataPattern DataSize TestCount TestIncrement OnError Parameter Alias DP DS TC TI OE Parameter Value 00FF Description Two-character hexadecimal pattern. The hex letters can be uppercase or lowercase.

8, 16, 32, 64 Actual data that is transferred during any given pass of the test. 010,000 110,000 02 0=test continuously; 110,000=total number of tests that will be executed. Must be less than the TestCount value. 0=ignore;1=stop, 2=loop on error

SN0054614-00 B

A-7

A EBNF Format of Command Line Non-Interactive Commands

-GS (<HBA Port No.> | <HBA WWPN>) {(<Parameter Name> | <Parameter Alias>) <Parameter Value>}

View statistics The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are described in table A-5 Table A-5. HBA Statistics Parameters
Parameter Name AutoPoll PollRate Parameter Alias AP SR Parameter Value 0256 530
a

Parameter Description Sets how often statistics are retrieved Set the polling interval when retrieving statistics (seconds) Saves the HBAs statistics to a CVS log file

LogToFile

LF

Log file name

Table Notes aWhen the AutoPoll parameter is 0, statistics are retrieved automatically until the user aborts the operation. When the AutoPoll parameter is in the range of 1256, statistics are retrieved for the number of cycles specified by this value. -GS (<HBA Port No.> | <HBA WWPN>) RESET

Reset statistics.

A-8

SN0054614-00 B

Q
View link status.

A EBNF Format of Command Line Non-Interactive Commands

-LS (<HBA Port No.> | <HBA WWPN>) {(<Parameter Name> | <Parameter Alias>) <Parameter Value>}

The <Parameter Name>, <Parameter Alias>, and <Parameter Value> options are described in table A-6. Table A-6. Link Status Parameters
Parameter Name AutoPoll PollRate Parameter Alias AP SR Parameter Value 0256a 530 Parameter Description Sets how often link status is retrieved Set the polling interval when retrieving link status (seconds). Saves the link status to a CVS log file.

LogToFile

LF

Log file name

Table Notes aWhen the AutoPoll parameter is 0, the link status is retrieved automatically until the user aborts the operation. When the AutoPoll parameter is in the range of 1256, the link status is retrieved for the number of cycles specified by this value. -LS (<HBA Port No.> | <HBA WWPN>) RESET

Reset link status.


-Z (<HBA Port No.> | <HBA WWPN> | <ALL>)

Display all information for a specific HBA or all HBAs.


-V

Display version.
-H | -?

Display help text.


-O <File Name>

Specifies the output to a log file.


-F <File Name>

Specifies command line input from file.


-X

Specifies the output in XML format.


-S

Silent mode

SN0054614-00 B

A-9

A EBNF Format of Command Line Non-Interactive Commands

Notes

A-10

SN0054614-00 B