Beruflich Dokumente
Kultur Dokumente
Simplify
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
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
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
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
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
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
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
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:
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
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
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
SN0054614-00 B
2-3
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>
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
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.1.1
Standard (GUI) installation (see section 3.1.1.1) Command line installation (see section 3.1.1.2)
3.1.1.1
Figure 3-1. Welcome Dialog Box 2. Read the information, then click Next.
3-2
SN0054614-00 B
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
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
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
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.1.2
NOTE:
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
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.
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
# 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.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.
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
3-8
SN0054614-00 B
Q
3.2.1
Standard (GUI) uninstall (see section 3.2.1.1) Command line uninstall (see section 3.1.1.2)
3.2.1.1
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.2.3
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)
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
Section 4
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
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
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
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)
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
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 :
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
Host name
HBA model
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)
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.
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
4-12
SN0054614-00 B
4 Command Line Options Display LUN List (Command Line Option -L)
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)
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
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
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
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
NOTE:
Please refer to SANsurfer HBA Manager Index Adapter setting for parameters related to QLA200/210.
4.7
4-20
SN0054614-00 B
Q
4.7.1
4 Command Line Options Target Persistent Binding (Command Line Option -P)
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
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
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
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
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:
: 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
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.
SN0054614-00 B
4-27
4 Command Line Options Target Persistent Binding (Command Line Option -P)
- 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
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
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)
: : : : : :
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
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)
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
4-32
SN0054614-00 B
Q
Press <Enter> to continue:
4.7.3.2.2
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
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.8.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
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
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:
Main Menu World Wide Port Name -------------------21-00-00-20-37-15-97-1E LUN ID -----0 State ------Enabled
4-36
SN0054614-00 B
Q
4.8.1.2
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>
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
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
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
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
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.8.3
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
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.9
4.9.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
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
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
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
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
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:
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
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
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
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
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
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. 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
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
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
Where:
HBA Port No. = HBA port number HBA WWPN = World wide port name of the HBA
4.12
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.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
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
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. 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
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
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
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
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
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
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
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:
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
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)
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
4-64
SN0054614-00 B
Q
4.16.2.3
4 Command Line Options Diagnostics (Command Line Options -KL and -KR)
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
4.16.2.6
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
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
Diagnostics - Loopback Test Result Note: Press <Enter> to stop the test any time
HBA 0
Status Success
CRC 0
Disparity 0
FrameLength 0
Active /
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)
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)
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
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>]
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
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)
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
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>]
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
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
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
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 | ?)
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
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 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.20
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
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)
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
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
5-2
SN0054614-00 B
Q
5.4.2
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.4.3
5-4
SN0054614-00 B
Q
5.4.5
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
The <TargetBinding /> sequence is repeated for each target bound to the adapter.
5.4.7
The <EnabledLUN /> sequence is repeated for each enabled LUN under the target.
SN0054614-00 B
5-5
5.4.8
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
5-6
SN0054614-00 B
Q
5.4.11
The <Target> sequence is repeated for each device attached to the adapter.
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
SN0054614-00 B
5-7
<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
<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.4.13
5-10
SN0054614-00 B
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
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
<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 ]
A-2
SN0054614-00 B
Q
-T (<HBA Port No.> | <HBA WWPN>)
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
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 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.
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
A-4
SN0054614-00 B
SN0054614-00 B
A-5
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
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
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
-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
-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
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.
-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
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
Display version.
-H | -?
Silent mode
SN0054614-00 B
A-9
Notes
A-10
SN0054614-00 B