q Sansurf Cli App Guide
-
Upload
pravin-kamthe -
Category
Documents
-
view
219 -
download
0
Transcript of q Sansurf Cli App Guide
-
8/13/2019 q Sansurf Cli App Guide
1/128
SN0054614-00 B Page i
Q S i m p l i f y
SANsurfer FC HBA CLI ApplicationUsers Guide
Command Line Interface for SANbladeFibre Channel Host Bus Adapters
-
8/13/2019 q Sansurf Cli App Guide
2/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters Q
Page ii SN0054614-00 B
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes noresponsibility 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 describedin this document for any of these products are for illustrative purposes only. QLogic Corporationmakes no representationnor 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 magneticmedium 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 onan 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 Document Sections Affected
Product name change to SANsurfer FC HBACLI. All
SANsurfer CLI support, hardware: Added QLA23xxand QLA/QLE24xx
HBAs.
1
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 10MAC: added support for MAC OS X.Power PC (PPC): added support for PPC OS.
1
Changed installation instructions for Windows 2000 and WindowsServer 2003.
3.1.1
Added installation instructions for Power PC (PPC). 3.1.2
Added installation instructions for MAC OS X. 3.1.4
Changed uninstall instructions for Windows 2000 and WindowsServer 2003.
3.2.1
Added uninstall instructions for PCC. 3.2.2
Installation instructions changed/combined for Solaris SPARC andSolaris x86.
3.2.3
Command lines are now HBA port specific (fromHBA numberto HBAport number).
4,A.2
-
8/13/2019 q Sansurf Cli App Guide
3/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus AdaptersQ
SN0054614-00 B Page iii
The following options/commands have been changed:
Display System Information (-G and -Z): Added/modified -Z. 4.1,A.2
Display HBA Settings (-C): removed Enable LIP reset from the list of
settings displayed by this option.
4.2
Display HBA Information (-I): added VDP information 4.3,A.2
Target Persistent Binding (-P): naming changes made to submenus ininteractive mode; no technical changes.
4.7
Save/Update Option ROM (-B):Name changes made to submenus in interactive mode; no technicalchanges.Removed RG, FW, and BOOT parameters from non-interactivemode command.
4.12
4.12.2,A.2
Expanded explanation of diagnostics commands in interactive mode;no technical changes.
4.16.2
The following options/commands have been added:
Flash HBA beacon: added ability to flash a target device beacon(-TB).
4.15,A.2
Statistics (-GS and -LS) 4.17, 5.4.13, 5.4.14,A.2
Help (-H); feature was available previously, but not documented. 4.18,A.2
-
8/13/2019 q Sansurf Cli App Guide
4/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters Q
Page iv SN0054614-00 B
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
-
8/13/2019 q Sansurf Cli App Guide
5/128
SN0054614-00 B Page v
Table of Contents
Section 1 Introduction
Section 2 Getting Started
2.1 Introduction. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.2 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
2.3 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
Section 3 Initial Installation
3.1 Installation Instructions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
3.1.1 Windows 2000, Windows Server 2003, and Enterprise Server . . . . . . 3-2
3.1.1.1 Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23.1.1.2 Command Line Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
3.1.2 Red Hat/SuSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
3.1.3 Solaris SPARC and x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6
3.1.4 MAC OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
3.2 Uninstalling SANsurfer FC HBA CLI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-8
3.2.1 Windows 2000, Windows Server 2003, and Enterprise Server . . . . . . 3-9
3.2.1.1 Standard (GUI) Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
3.2.1.2 Command Line Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
3.2.2 Red Hat/SuSE Linux/PPC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-9
3.2.3 Solaris SPARC and Solaris x86 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10
Section 4 Command Line Options
4.1 Display System Information (Command Line Options -G and -Z) . . . . . . 4-1
4.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.1.1.1 Display Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1
4.1.1.2 Display HBA Complete Information . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.1.2.1 Display Host Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.1.2.2 Display HBA Complete Information . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4.2 Display HBA Settings (Command Line Option -C) . . . . . . . . . . . . . . . . . . 4-3
4.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4
4.2.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5
4.3 Display HBA Information (Command Line Option -I) . . . . . . . . . . . . . . . . 4-5
4.3.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6
4.3.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8
-
8/13/2019 q Sansurf Cli App Guide
6/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters
Page vi SN0054614-00 B
Q
4.4 Display Device List (Command Line Option -T) . . . . . . . . . . . . . . . . . . . . 4-9
4.4.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9
4.4.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12
4.5 Display LUN List (Command Line Option -L) . . . . . . . . . . . . . . . . . . . . . . 4-124.5.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13
4.5.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16
4.6 Configure HBA Settings (Command Line Option -N) . . . . . . . . . . . . . . . . 4-16
4.6.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17
4.6.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19
4.7 Target Persistent Binding (Command Line Option -P) . . . . . . . . . . . . . . . 4-20
4.7.1 Display Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
4.7.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21
4.7.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22
4.7.2 Bind Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23
4.7.2.1 Bind a Specific Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
4.7.2.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24
4.7.2.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-26
4.7.2.2 Bind All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
4.7.2.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27
4.7.2.2.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28
4.7.3 Unbind Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4.7.3.1 Unbind a Specific Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4.7.3.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29
4.7.3.1.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.7.3.2 Unbind All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
4.7.3.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31
4.7.3.2.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33
4.8 Selective LUNs (Command Line Option -M). . . . . . . . . . . . . . . . . . . . . . . 4-33
4.8.1 View Selective LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
4.8.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34
4.8.1.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
4.8.2 Enable/Disable a LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
4.8.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37
4.8.2.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-414.8.3 Enable/Disable All LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42
4.8.3.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42
4.8.3.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43
4.9 Boot Device (Command Line Option -E) . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
4.9.1 Viewing the Boot Device Selection . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
-
8/13/2019 q Sansurf Cli App Guide
7/128
SANsurfer FC HBA CLI
SN0054614-00 B Page vii
QSANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters
4.9.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44
4.9.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45
4.9.2 Set Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
4.9.2.1 Enable the HBAs Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-464.9.2.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46
4.9.2.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-49
4.9.2.2 Disable the HBAs Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
4.9.2.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
4.9.2.2.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
4.10 Driver Settings (Command Line Option -FS) . . . . . . . . . . . . . . . . . . . . . . 4-50
4.10.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50
4.10.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-53
4.11 View Driver Settings (Command Line Option -FG). . . . . . . . . . . . . . . . . . 4-54
4.12 Save/Update Option ROM (Command Line Option -B) . . . . . . . . . . . . . . 4-544.12.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54
4.12.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
4.13 Save/Update NVRAM (Command Line Option -R). . . . . . . . . . . . . . . . . . 4-56
4.13.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-56
4.13.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-58
4.14 Update Driver (Windows 2000 and Windows Server 2003)
(Command Line Option -D). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
4.14.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59
4.14.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
4.15 Flash HBA Beacon (Command Line Options -A and -TB) . . . . . . . . . . . . 4-60
4.15.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-60
4.15.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
4.15.2.1 View the HBA Ports Flashing State . . . . . . . . . . . . . . . . . . . . . . . . . 4-61
4.15.2.2 Start or Stop Flashing the HBA Ports LED . . . . . . . . . . . . . . . . . . . 4-61
4.15.2.3 Start or Stop Flashing a Targets LED . . . . . . . . . . . . . . . . . . . . . . . 4-62
4.16 Diagnostics (Command Line Options -KL and -KR) . . . . . . . . . . . . . . . . . 4-62
4.16.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-62
4.16.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-63
4.16.2.1 Data Pattern: DP or DataPattern
< Parameter Value> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
4.16.2.2 Data Size: DS or DataSize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-64
4.16.2.3 Number of Tests: TC or TestCount
4-65
4.16.2.4 Test Increment: TI or Test Increment
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
-
8/13/2019 q Sansurf Cli App Guide
8/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters
Page viii SN0054614-00 B
Q
4.16.2.5 On Error: OE or OnError . 4-65
4.16.2.6 Run a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
4.16.2.7 Run a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
4.17 Statistics (Command Line Options -GS and -LS) . . . . . . . . . . . . . . . . . . . 4-694.17.1 HBA Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-69
4.17.1.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-69
4.17.1.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
4.17.2 Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
4.17.2.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-73
4.17.2.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-75
4.18 Help (Command Line Option -H) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
4.18.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
4.18.2 Non-interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
4.19 Input From a File (Command Line Option -F). . . . . . . . . . . . . . . . . . . . . . 4-77
4.20 Output to a File (Command Line Option -O). . . . . . . . . . . . . . . . . . . . . . . 4-78
4.21 Silent Mode (Command Line Option -S). . . . . . . . . . . . . . . . . . . . . . . . . . 4-78
4.22 Display Version (Command Line Option -V). . . . . . . . . . . . . . . . . . . . . . . 4-79
4.23 Output in XML Format (Command Line Option -X) . . . . . . . . . . . . . . . . . 4-79
Section 5 XML Format
5.1 Main Tag. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.2 Utility Header . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.3 Status Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1
5.4 XML Message for Each Option. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2
5.4.1 Display System Information (Command Line Option -G) . . . . . . . . . . . 5-25.4.2 Display Adapter Settings (Command Line Option -C) . . . . . . . . . . . . . 5-3
5.4.3 Display HBA Information (Command Line Option -I) . . . . . . . . . . . . . . 5-4
5.4.4 Display Device List (Command Line Option -T) . . . . . . . . . . . . . . . . . . 5-4
5.4.5 Display LUN List (Command Line Option -L) . . . . . . . . . . . . . . . . . . . . 5-5
5.4.6 Target Persistent Binding (Command Line Option -P) . . . . . . . . . . . . . 5-5
5.4.7 Selective LUNs (Command Line Option -M) . . . . . . . . . . . . . . . . . . . . 5-5
5.4.8 Boot Device (Command Line Option -E) . . . . . . . . . . . . . . . . . . . . . . . 5-6
5.4.9 Diagnostics ResultsLoopback Test (Command Line Option -KL) . . 5-6
5.4.10 Diagnostics ResultsRead/Write Buffer Test (Command Line
Option -KR) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-65.4.11 View Driver Settings (Command Line Option -FG) . . . . . . . . . . . . . . . 5-7
5.4.12 Display All Information for One or All HBAs (Command Line Option -Z) 5-7
5.4.13 LInk Statistics (Command Option -LS) . . . . . . . . . . . . . . . . . . . . . . . . . 5-10
5.4.14 HBA Statistics (Command Option -GS) . . . . . . . . . . . . . . . . . . . . . . . . 5-10
-
8/13/2019 q Sansurf Cli App Guide
9/128
SANsurfer FC HBA CLI
SN0054614-00 B Page ix
QSANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters
Appendix A EBNF Format of Command Line
A.1 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
A.2 Non-Interactive Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1
A.2.1 Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1A.2.2 Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
Figures
Figure Page
2-1 SANsurfer FC HBA CLI Main Menu (Windows 2000/Windows
Server 2003)Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
3-1 Welcome Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
3-2 Destination Folder Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3
3-3 Ready to Install DIalog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3-4 Installing SANsurfer DIalog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4
3-5 InstallShield Wizard Completed DIalog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-5
4-1 Sample Loopback Test Results. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-67
4-2 Sample Read/Write Buffer Test Results . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-68
Tables
Table Page
2-1 Non-Interactive Mode Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
4-1 Options Displayed by -Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-2
4-2 HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-194-3 Driver Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-54
4-4 On Error Parameter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-65
4-5 Driver Versions that Do Not Require a Loopback Connector . . . . . . . . . . . . . . . . . . 4-66
4-6 HBA Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72
4-7 Link Status Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-76
5-1 Options Displayed by -Z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7
A-1 Command Variables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2
A-2 HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3
A-3 Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6
A-4 Diagnostics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7
A-5 HBA Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8
A-6 Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9
-
8/13/2019 q Sansurf Cli App Guide
10/128
SANsurfer FC HBA CLI Application Users Guide
Command Line Interface for SANblade Fibre Channel Host Bus Adapters
Page x SN0054614-00 B
Q
Notes
-
8/13/2019 q Sansurf Cli App Guide
11/128
SN0054614-00 B 1-1
Section 1
Introduction
The SANsurfercommand 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/QLE24xxHBAs on the following operating systems:
Windows2000/SP4 Server and Advanced Server SP4: IA32
Windows 2003 Serverand Enterprise Server: IA-32, IA-64, IEM64T, and
AMD64
Red HatLinuxAS v2.1, 3.0, and 4.0: IA-32, IA-64, IEM64I, and AMD64
Red Hat Linux 9 Professional: IA-32 only
SuSELinux Enterprise Server (SLES) 8 and 9: IA-32, IA64, IEM64I, and
AMD64
Power PC (PPC) SLES 8 and 9
SolarisSPARCv2.6, 2.7, 8, 9, and 10
Solaris 9 x86 and 10 x86
MAC OS X 10.3.x/10.4.x(Power Mac)
NOTE: Throughout this guide, HBAand adapterare used interchangeably. Target
and deviceare also used interchangeably.
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.comfor the latest firmware andsoftware updates.
http://www.qlogic.com/support/http://www.qlogic.com/support/ -
8/13/2019 q Sansurf Cli App Guide
12/128
-
8/13/2019 q Sansurf Cli App Guide
13/128
SN0054614-00 B 2-1
Section 2
Getting Started
2.1
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 singleoperation.
In both modes, SANsurfer FC HBA CLI is notcase sensitive. However, file names
in some operating systems are case sensitive; in this case, SANsurfer FC HBA CLI
iscase 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 orscli
-
8/13/2019 q Sansurf Cli App Guide
14/128
2 Getting Started
Interactive Mode
2-2 SN0054614-00 B
Q
The Main Menu (see figure 2-1)displays. For example:
Figure 2-1. SANsurfer FC HBA CLI Main Menu
(Windows 2000/Windows Server 2003)Interactive Mode
Depending on the menu selection, SANsurfer FC HBA CLI prompts for more input
as needed.For example, if you select Configure HBA Settings, SANsurfer FC
HBA CLI prompts you for the number that corresponds to the adapter port you want
to configure.
NOTE:
The Update Driveroption 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 BIOSis Save/UpdateFCode.
SANsurfer FC HBA CLI
v1.06.16 Build 19Main 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/13/2019 q Sansurf Cli App Guide
15/128
2 Getting Started
Non-interactive Mode
SN0054614-00 B 2-3
Q
2.3
Non-interactive Mode
Type the following in a command window to start SANsurfer FC HBA CLI in
non-interactive mode:
scli
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 orscli -?
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-C4200000E08B0183C4
The following inputs are valid for the port ID:
68-5C-AB685CAB
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
Non-
interactive
Option
Interactive
Menu Selection
(Windows)
Interactive
Menu Selection
(Red Hat/SuSE
Linux, Solaris
SPARC) Description Section
-G 1 1 Display system information 4.1
-Z 1 1 Display all information for one
or all HBAs
4.1
-C 2 2 Display HBA settings 4.2
-I 3 3 Display HBA information 4.3
-T 4 4 Display device list 4.4
-L 5 5 Display LUN list 4.5
-
8/13/2019 q Sansurf Cli App Guide
16/128
2 Getting Started
Non-interactive Mode
2-4 SN0054614-00 B
Q
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.
-N 6 6 Configure HBA settings 4.6
-P 7 7 Target persistent binding 4.7
-M 8 8 Selective LUNs 4.8
-E 9 9 Boot device 4.9
-FS 10 10 Driver Settings 4.10
-FG 10 10 View Driver Settings 4.11
11 11 HBA Utilities
-B 11 11 Save/update BIOS
a
/FCode
b
4.12-R 11 11 Save/update NVRAM 4.13
-D 11 Update driver 4.14
-A 12 12 Flash HBA beacon 4.15
-KL/-KR 13 13 Diagnostics 4.16
-GS 14 14 HBA Statistics 4.17.1
-LS 14 14 Link Status 4.17.2
-H
-?
15
15
15
15
Display usage
Display usage
4.18
16 16 Quit
-F Input from a file 4.19
-O Output to a file 4.20
-S Silent mode 4.21
-V Display version 4.22
-X Output in XML format 4.23
Table NotesaWindows 2000, Windows Server 2003, Enterprise Server, Red Hat/SuSE LinuxbSolaris SPARC
Table 2-1. Non-Interactive Mode Options (Continued)
Non-
interactiveOption
Interactive
Menu Selection(Windows)
Interactive
Menu Selection
(Red Hat/SuSE
Linux, SolarisSPARC) Description Section
http://-/?-http://-/?-http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
17/128
2 Getting Started
Non-interactive Mode
SN0054614-00 B 2-5
Q
For all command line options, SANsurfer FC HBA CLI displays the following when
there are errors in the command line input:
Error SANsurfer FC HBA CLIv1.06.16 Build 20Copyright 2003-2005 QLogic Corp.All rights reserved.Command Line QLogic FC Host Bus Adapters
description of command entered
Usage:
-
8/13/2019 q Sansurf Cli App Guide
18/128
2 Getting Started
Non-interactive Mode
2-6 SN0054614-00 B
Q
Notes
-
8/13/2019 q Sansurf Cli App Guide
19/128
SN0054614-00 B 3-1
Section 3
Initial Installation
The following requirements must be met before you run SANsurfer FC HBA CLI:
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.
NOTE: 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.
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. ClickDrivers, 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 Downloaddialog 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 (seesection 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)
http://www.qlogic.com/http://www.qlogic.com/ -
8/13/2019 q Sansurf Cli App Guide
20/128
3 Initial Installation
Installation Instructions
3-2 SN0054614-00 B
Q
3.1.1
Windows 2000, Windows Server 2003, and Enterprise Server
Perform the steps in one of the following sections to install SANsurfer FC HBA CLI:
Standard (GUI) installation (see section 3.1.1.1)
Command line installation (see section 3.1.1.2)
3.1.1.1
Standard (GUI) Installation
Perform the following steps to install SANsurfer FC HBA CLI on a Windows 2000
or Windows Server 2003 operating system:
1. Locate and double-click the installer package. The Welcomedialog box
displays (see figure 3-1).
Figure 3-1. Welcome Dialog Box
2. Read the information, then click Next.
-
8/13/2019 q Sansurf Cli App Guide
21/128
3 Initial Installation
Installation Instructions
SN0054614-00 B 3-3
Q
3. The Destination Folderdialog box displays (see figure 3-2).
Figure 3-2. Destination Folder Dialog Box
Do one of the following:
To select the destination location displayed in the dialog box, click Next
(recommended).
The default location for a Windows 2000/Windows Server 2003 system is:
Program Files\QLogic Corporation\SANsurferCLI
To select a different location:
a. Click Choose.b. Select the desired location.
c. The Destination Folder dialog box redisplays. Click Next.
-
8/13/2019 q Sansurf Cli App Guide
22/128
3 Initial Installation
Installation Instructions
3-4 SN0054614-00 B
Q
4. The Ready to Install dialog box displays (see figure 3-3).
Figure 3-3. Ready to Install DIalog Box
Read the information, then click Next.
5. The Installing SANsurferdialog box displays (see figure 3-4).
Figure 3-4. Installing SANsurfer DIalog Box
If you want to stop the installation, click Cancel.
-
8/13/2019 q Sansurf Cli App Guide
23/128
3 Initial Installation
Installation Instructions
SN0054614-00 B 3-5
Q
6. The InstallShield Wizard Completeddialog box displays (see figure 3-5).
Figure 3-5. InstallShield Wizard Completed DIalog Box
Read the information. If you want to start SANsurfer FC HBA CLI, select the
Launch SANsurfer check box.
Click Finish.
3.1.1.2
Command Line Installation
Do one of the following:
Type the following text for a standard installation of SANsurfer FC HBA CLI on
a Windows 2000 or Windows Server 2003 operating system:
msiexec /i scli-1.06.16-20.windows.msi
Type the following text to install SANsurfer FC HBA CLI in silent mode:
msiexec /i scli-1.06.16-20.windows.msi /q
NOTE: By default, the SANsurfer FC HBA CLI application is installed in the
following directory: Program files\QLogic Corporation\SANsurferCLI.
If you want to change the applications location, enter the directory in the
command line; for example:
msiexec /i scli-1.06.16-20.windows.msiinstalldir="c:\sansurfercli"
-
8/13/2019 q Sansurf Cli App Guide
24/128
3 Initial Installation
Installation Instructions
3-6 SN0054614-00 B
Q
3.1.2
Red Hat/SuSE Linux/PPC
Perform the following steps to install SANsurfer FC HBA CLI on a Red Hat/SuSE
Linux/Power PC (PPC) operating system:1. Download the scli-x.xx.xx-xx.i386.rpm.gz file (from the QLogic Web site or the
SANsurfer Management Suite CD-ROM) to your local machine. In the file name,
x.xx.xx stands for the current version of SANsurfer FC HBA CLI.
2. Uncompress the file with the following command:
gwnzip
3. Enter the following command to install the package:
rpm -iv scli-x.xx.xx-xx.i386.rpm
NOTE: For SuSE SLES IA64, the command line is:
rpm --iv scli-x.xx.xx-xx.ia64.rpm --nodepsThe new package is installed in the following directory:
/opt/QLogic_Corporation/SANsurferCLI.
To query for the installed SANsurfer FC HBA CLI package name, enter the
following text from the command line:
rpm -q scli
3.1.3
Solaris SPARC and x86
Perform the following steps to install SANsurfer FC HBA CLI on a Solaris SPARC
or Solaris x86 operating system:1. Download the scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg.Z file (from the QLogic
Web site or the SANsurfer Management Suite CD-ROM) to a temporary
directory on your machine. For example:
/tmp
NOTE: In the file name,x.xx.xx-xx stands for the current version of SANsurfer
FC HBA CLI. The -xx stands for the build version.
2. Type the following to uncompress the file:
# uncompress scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg.Z
3. Type the following to see the available package file:# ls
The available packages display. For example:
#scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg
-
8/13/2019 q Sansurf Cli App Guide
25/128
3 Initial Installation
Installation Instructions
SN0054614-00 B 3-7
Q
4. Type the following to install SANsurfer FC HBA CLI:
# pkgadd -d scli.x.xx.xx-xx.SPARC-X86.Solaris.pkg
5. You are prompted to select a package. For example:
1 QLScli SANsurfer FC HBA CLI (HBA ConfigurationUtility)(sparc) 1.06.16 Build 22 (Solaris 8-10)
2 QLSclis SANsurfer FC HBA CLI (HBA ConfigurationUtility)(sparc) 1.06.16 Build 22 (Solaris 2.6-7)
3 QLSclis SANsurfer FC HBA CLI (HBA ConfigurationUtility)(x86) 1.06.16 Build 22 (Solaris 8-10)
Select the package(s) you wish to process (or "all" to processall 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 from
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 ]## Executing postinatall script.
Installation of was successful.
-
8/13/2019 q Sansurf Cli App Guide
26/128
3 Initial Installation
Uninstalling SANsurfer FC HBA CLI
3-8 SN0054614-00 B
Q
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 .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 -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 20installer: Installing onto volume mounted at /.installer: The install was successful.
4. Type the following command to upgrade to existing package.
installer -pkg -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 20installer: Upgrading volume mounted at /.installer: The upgrade was successful.
3.2
Uninstalling SANsurfer FC HBA CLI
NOTE: Uninstalling SANsurfer FC HBA CLI is not necessary for MAC OS X; the
native installer automatically updates the application whenever it detects
a change in the application version.
-
8/13/2019 q Sansurf Cli App Guide
27/128
3 Initial Installation
Uninstalling SANsurfer FC HBA CLI
SN0054614-00 B 3-9
Q
3.2.1
Windows 2000, Windows Server 2003, and Enterprise Server
Perform the steps in one of the following sections to uninstall SANsurfer FC HBA
CLI:
Standard (GUI) uninstall (see section 3.2.1.1)
Command line uninstall (see section 3.1.1.2)
3.2.1.1
Standard (GUI) Uninstall
To uninstall SANsurfer FC HBA CLI using the GUI, perform the following steps:
1. From the Control Panel, click Add or Remove Programs.
2. Highlight the SANsurfer FC HBA CLI application.
3. Click Remove. No re-boot is required.
3.2.1.2
Command Line Uninstall
To uninstall SANsurfer FC HBA CLI using the command line, type the following:
msiexec.exe /x {D4AB108C-6B03-49A3-AC9E-1D29761300C3}
3.2.2
Red Hat/SuSE Linux/PPC
To uninstall SANsurfer FC HBA CLI, type one of the following at the command line,
wherex.xx.xx is the current version of CLI:rpm -e scli-x.xx.xx-xx
rpm -e scli
To query for the installed SANsurfer FC HBA CLI package name, enter the following
text from the command line:
rpm -q scli
-
8/13/2019 q Sansurf Cli App Guide
28/128
3 Initial Installation
Uninstalling SANsurfer FC HBA CLI
3-10 SN0054614-00 B
Q
3.2.3
Solaris SPARC and Solaris x86
Perform the following steps to uninstall SANsurfer FC HBA CLI:
1. Type the following to remove SANsurfer FC HBA CLI:
# pkgrmpackage name(QLScli, QLSclis, or QLSclix)
2. The program displays the package name and a script warning asking whether
to continue the uninstall process. For example:
The following package is currently installed:
QLScli SANsurfer FC HBA CLI (HBA Configuration Utility)(sparc) 1.06.16 Build 22 (Solaris 8-10)
Do you want to remove this package?
3. Typeyand press ENTER. The program displays a script warning asking
whether to continue the uninstall process. For example:
## Removing installed package instance
This package contains scripts which will be executed withsuper-user permission during the process of removing thispackage
Do you want to continue with the removal of this package[y,n,?,q]
4. Typeyand press ENTER. The pkgrm program notifies you when the uninstallprocess is complete. For example:
## Verifying package dependencies.
## Processing package information..../opt/QLogic_Corporation /opt ## Executing postremove script.scli removed.Menu property file removed.Adapter property file removed.SCLI property file removed.## Updating system information.
Removal of was successful.
-
8/13/2019 q Sansurf Cli App Guide
29/128
SN0054614-00 B 4-1
Section 4
Command Line Options
The following sections describe the command line options listed in table 2-1. The
options are described in both interactive and non-interactive modes.
4.1
Display System Information(Command Line Options -G and -Z)
4.1.1
Interactive ModeWhen this option is selected, the HBA General Information Menu displays. You are
prompted to select one of the following:
1. Display Host Information (see section 4.1.1.1)
2. Display HBA Complete Information (see section 4.1.1.2)
4.1.1.1
Display Host Information
When this option is selected, the application displays the following information about
the local machine:
Host name
OS type
OS version (patches where applicable)
Failover (FO) API version
SAN device management (SDM) API version
QLogic direct driver version (if installed)
List of HBAs: HBA model, port number, WWPN, serial number (SN), firmware
version (FW), and status (online/offline)
Total number of QLogic Fibre Channel HBAs detected
NOTE: The failover and SAN device management APIs are QLogic-specificlibraries required for SANsurfer FC HBA CLI. The versions of these
libraries are useful for debugging purposes.
-
8/13/2019 q Sansurf Cli App Guide
30/128
4 Command Line Options
Display System Information (Command Line Options -G and -Z)
4-2 SN0054614-00 B
Q
4.1.1.2
Display HBA Complete Information
When this option is selected, you are prompted to select either an HBA port, or all
HBAs.
The application displays the information in section 4.1.1.1, as well as the following
additional information:
HBA general information
HBA vital product data (VPD)
HBA NVRAM settings
Attached devices/LUNs
Target persistent binding
Selective LUNs
Boot device
Driver settings: persistent and binding
4.1.2
Non-interactive Mode
4.1.2.1
Display Host Information
To display the system information (see section 4.1.1.1), type the following
command:
# scli -G
4.1.2.2
Display HBA Complete InformationUse this option to display all the information for one or all of the HBA ports in the
system. This option displays all of the HBAs information in a single command. The
information displayed by the -Z option is the combination of the commands listed
in table 4-1.
Table 4-1. Options Displayed by -Z
Non-interactive
Option Description Section
-G Display system information 4.1
-C Display HBAsettings 4.2
-I Display HBAinformation 4.3
-T Display device list 4.4
-L Display LUN list 4.5
-P Configure target persistent binding 4.7
-M Configure selective LUNs 4.8
-
8/13/2019 q Sansurf Cli App Guide
31/128
4 Command Line Options
Display HBA Settings (Command Line Option -C)
SN0054614-00 B 4-3
Q
To display the information in table 4-1for a single HBA port, type the following
command:
# scli -Z ( | )
Where:
To display the information in table 4-1for all ports on all HBAs, type one of the
following commands:
# scli -Z ALL# scli -Z
4.2
Display HBA Settings
(Command Line Option -C)When this option is selected, the application displays the following HBA settings:
Connection options
Data rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx HBAs)
Frame size
Hard Loop ID
Loop reset delay (in seconds)
Enable host HBA BIOS
Enable hard loop ID
Enable FC tape support
Operation mode
Interrupt delay timers Execution throttle
Enable extended error logging
Login retry count
Port down retry count
Enable LIP full login
-E Configure boot device 4.9-KL Run loopback test 4.16
-KR Run read/write test 4.16
-GS Display and change HBA statistics 4.17
-LS Display and change link status 4.17
HBA Port No. = HBA port number
HBA WWPN= World wide port name of the HBA
Table 4-1. Options Displayed by -Z (Continued)
Non-interactive
Option Description Section
-
8/13/2019 q Sansurf Cli App Guide
32/128
4 Command Line Options
Display HBA Settings (Command Line Option -C)
4-4 SN0054614-00 B
Q
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 Settingsoption.
Main Menu
1: Display System Information2: Display HBA Settings3: Display HBA Information4: Display Device List5: Display LUN List6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities12: Flash Beacon13: Diagnostics14: Statistics
15: Help16: QuitEnter Selection: 2
SANsurfer FC HBA CLIv1.06.14 Build 24
HBA NVRAM Information Menu1: Display Specific HBA Settings2: Display All HBA Settings
Note: 0 to return to Main MenuEnter 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 PointData Rate : 2 Gbps
-
8/13/2019 q Sansurf Cli App Guide
33/128
4 Command Line Options
Display HBA Information (Command Line Option -I)
SN0054614-00 B 4-5
Q
Frame Size : 2048Loop Reset Delay (seconds) : 5Enable Host HBA BIOS : DisabledEnable FC Tape Support : Enabled
Execution Throttle : 16Enable Extended Error Logging: DisabledLogin Retry Count : 8Enable LIP Reset : DisabledPort Down Retry Count : 30Enable LIP Full Login : EnabledLink Down Timeout (seconds) : 30Enable Target Reset : EnabledLUNs Per Target : 128
Press to continue:
4.2.2
Non-interactive ModeTo 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 ( | )
Where:
4.3
Display HBA Information(Command Line Option -I)
When this option is selected, SANsurfer FC HBA CLI displays either general
information or VPD information about the selected HBAs.
General information includes:
Host name
HBAmodel
HBA port number
HBAnode name (WWNN)
HBAport name (WWPN)
HBA Port No. = HBA port numberWWPN= World wide port name of the HBA
-
8/13/2019 q Sansurf Cli App Guide
34/128
4 Command Line Options
Display HBA Information (Command Line Option -I)
4-6 SN0054614-00 B
Q
HBAport ID
Serial number
Driver version
BIOS version (Windows 2000, Windows Server 2003, Enterprise Server, and
Red Hat/SuSE Linux/PPC)
Firmware version
Actual connection mode
Actual data rate
PortType (topology)
Device target count
PCI bus number (Windows 2000, Windows Server 2003, Enterprise Server, and
Red Hat/SuSE Linux/PPC)
PCI slot number (Windows 2000, Windows Server 2003, Enterprise Server, and
Red Hat/SuSE Linux/PPC)
HBA status (online, offline)
Vital product data (VPD) information includes:
HBA port number
HBA model
HBA port name (WWPN)
HBA port ID
Product identifier
VPD-R tag (VPD ReadOnly field) (if available) Part number (HBA model)
Serial number
Misc. information (for example, PCI and PCI-X speeds)
Manufacturing ID
EFI driver version
Firmware version
BIOS version
FCode version
Asset tag
End tag
4.3.1
Interactive Mode
SANsurfer FC HBA CLI prompts you to select a display option: view the HBA general
information or view HBA VPD information. After selecting a display option, you are
prompted to select a specific HBA port or all HBA ports. If you select a specific HBA
-
8/13/2019 q Sansurf Cli App Guide
35/128
4 Command Line Options
Display HBA Information (Command Line Option -I)
SN0054614-00 B 4-7
Q
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 Informationoption.
Main Menu1: Display System Information2: Display HBA Settings3: Display HBA Information4: Display Device List5: Display LUN List6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities12: Flash Beacon13: Diagnostics14: Statistics15: Help16: Quit
Enter Selection: 3
SANsurfer FC HBA CLIv1.06.16 Build 20
HBA Information Menu1: HBA General Information
2: HBA VPD Information
Note: 0 to return to Main MenuEnter Selection: 1
SANsurfer FC HBA CLIv1.06.16 Build 20
HBA General Information Menu1: Display Specific HBA Information2: Display All HBA Information3: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 1
SANsurfer FC HBA CLIv1.06.16 Build 20
-
8/13/2019 q Sansurf Cli App Guide
36/128
4 Command Line Options
Display HBA Information (Command Line Option -I)
4-8 SN0054614-00 B
Q
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 Online3: Port 2: WWPN: 21-00-00-E0-8B-1A-BB-30 Online4: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 2
------------------------------------------------------------------Host Name : BRAGIHBA Model : QLA2362Port : 1Node Name : 20-01-00-E0-8B-3A-BB-30Port Name : 21-01-00-E0-8B-3A-BB-30
Port ID : 11-06-EFSerial Number : R16411Driver Version : SCSI Miniport 9.1.0.10 Beta 5 (w32IP)BIOS Version : 1.02Firmware Version : 3.03.13Actual Connection Mode : LoopActual Data Rate : 1 GbpsPortType (Topology) : FLPortDevice Target Count : 8PCI Bus Number : 1PCI Slot Number : 33HBA Status : Online------------------------------------------------------------------
Press 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
-
8/13/2019 q Sansurf Cli App Guide
37/128
4 Command Line Options
Display Device List (Command Line Option -T)
SN0054614-00 B 4-9
Q
To display the general information for a specific HBA port, type the following
command:
# scli -I ( | )
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 ( | ) VPD
Where:
4.4
Display Device List(Command Line Option -T)
When this option is selected, the application displays the following information about
the devices:
Path
Target
Device ID
Port ID
Product vendor
Product ID
Product revision
Node name
Port name
Product type
Number of LUNs
Status
4.4.1
Interactive Mode
To display the device list, perform the following steps:
1. Type the number for the Display Device List option, then press ENTER.2. The Device Info - HBA Selection Menu displays. Select a display option: display
the HBAs target information for all HBA ports or for a specific HBA port. If you
select a specific HBA port, continue with step 3.
HBA Port No. HBA port number
HBA WWPN= World wide port name of the HBA
http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
38/128
4 Command Line Options
Display Device List (Command Line Option -T)
4-10 SN0054614-00 B
Q
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 specificdevice, 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 Menu1: Display System Information2: Display HBA Settings3: Display HBA Information4: Display Device List5: Display LUN List
6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities12: Flash HBA Beacon13: Diagnostics14: Statistics15: Help16: Quit
Enter Selection: 4
SANsurfer FC HBA CLIv1.06.14 Build 24
Device Info - HBA Selection Menu:1: Select HBA Port2: Select All HBAs
Note: 0 to return to Main MenuEnter 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 OnlineHBA Model QLA2362:
2: HBA 1 - WWPN: xx-xx-xx-xx-xx-07-62-A0 Online
http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
39/128
4 Command Line Options
Display Device List (Command Line Option -T)
SN0054614-00 B 4-11
Q
3: HBA 2 - WWPN: xx-xx-xx-xx-xx-02-D7-23 2200 Online4: Return to Previous Menu
Note: 0 to return to Main Menu
Enter Selection: 2
SANsurfer FC HBA CLIv1.06.14 Build 24
Target Information Menu:1: Display Specific Device Information2: Display All Device Information3: Return to HBA Selection Menu
Note: 0 to return to Main MenuEnter Selection: 1
Select Device:1: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 21-00-00-20-37-15-97-3D Port ID : 11-00-E22: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : 21-00-00-20-37-15-97-0F Port ID : 11-00-E4...8: Disk Vendor : SEAGATE Product ID : ST318203FC Port Name : 21-00-00-20-37-38-73-BC Port ID : 11-01-E89: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 8------------------------------------------------------------------HBA Port 1 - QLA2362 Port Name: 21-01-00-E0-8B-3A-BB-30 Port ID:
11-06-EF------------------------------------------------------------------Path : 0Target : 7Device ID : 0x8dPort ID : 11-01-E8Product Vendor : SEAGATE
-
8/13/2019 q Sansurf Cli App Guide
40/128
4 Command Line Options
Display LUN List (Command Line Option -L)
4-12 SN0054614-00 B
Q
Product ID : ST318203FCProduct Revision : 0002Node Name : 20-00-00-20-37-38-73-BCPort Name : 21-00-00-20-37-38-73-BC
Product Type : DiskNumber of LUN(s) : 1Status : Online------------------------------------------------------------------
Press 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 ( | )
To display the device information for a specific device on an HBA port, type the
following command:
# scli -T ( | ) ( | )
Where:
4.5
Display LUN List(Command Line Option -L)
When this option is selected, SANsurfer FC HBA CLI displays the following
information about the LUNs for a specified target:
Product vendor
Product ID
Product revision
LUN
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
-
8/13/2019 q Sansurf Cli App Guide
41/128
4 Command Line Options
Display LUN List (Command Line Option -L)
SN0054614-00 B 4-13
Q
Size (in GB or MB)
WWULN (world-wide unique LUN name)
4.5.1
Interactive ModeTo display the HBAs LUN list, perform the following steps:
1. Type the number for the Display LUN Listoption, 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 Informationor 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 devicethat 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 Listoption.
Main Menu1: Display System Information2: Display HBA Settings3: Display HBA Information4: Display Device List
5: Display LUN List6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities12: Flash Beacon13: Diagnostics14: Statistics15: Help16: Quit
Enter Selection: 5
SANsurfer FC HBA CLIv1.06.16 Build 20
http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
42/128
4 Command Line Options
Display LUN List (Command Line Option -L)
4-14 SN0054614-00 B
Q
LUN List: HBA Selection Menu: 1: Select HBA port 2: Select All HBAs
Note: 0 to return to Main MenuEnter 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 OnlineHBA Model QLA2362:
2: Port 1: WWPN: xx-xx-xx-xx-xx-07-62-A0 Online3: Port 2: WWPN: xx-xx-xx-xx-xx-02-D7-23 Online4: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 2
SANsurfer FC HBA CLI v1.06.16 Build 20
LUN Information Menu:1: Display Specific LUN Information2: Display All LUN(s) Information3: Return to HBA Selection Menu
Note: 0 to return to Main MenuEnter Selection: 1
SANsurfer FC HBA CLI v1.06.16 Build 20
Select Device:
1: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E2
2: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E1
-
8/13/2019 q Sansurf Cli App Guide
43/128
4 Command Line Options
Display LUN List (Command Line Option -L)
SN0054614-00 B 4-15
Q
3: Disk Vendor : SEAGATE Product ID : ST318203FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx
Port ID : 10-02-E4 4: Disk Vendor : SEAGATE Product ID : ST318203FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E8 5: Return to Previous Menu
Note: 0 to return to Main MenuEnter 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 2: Return to LUN Information Menu
Note: 0 to return to Main MenuEnter 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 : SEAGATEProduct ID : ST318203FCProduct Revision : 0002LUN : 0Size : 16.96 GBWWULN : 20-00-00-20-37-38-73-BC
Press to continue:
-
8/13/2019 q Sansurf Cli App Guide
44/128
4 Command Line Options
Configure HBA Settings (Command Line Option -N)
4-16 SN0054614-00 B
Q
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 |
To display the LUN information for a specific device for a specific HBA port, type
the following command:
# scli -L ( | ) ( |)
To display the LUN information for a specific LUN on a specific device for a specific
HBA port, type the following command:
# scli -L ( | ) ( |)
Where:
4.6
Configure HBA Settings
(Command Line Option -N)
The following HBA parameters can be set by SANsurfer FC HBA CLI:
Connection options
Data rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xxHBAs)
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/QLE23xxand QLA/QLE24xxHBAs, Windows 2000,
Windows Server 2003, and Red Hat/SuSE Linux)
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
-
8/13/2019 q Sansurf Cli App Guide
45/128
4 Command Line Options
Configure HBA Settings (Command Line Option -N)
SN0054614-00 B 4-17
Q
Interrupt Delay Timer (100 ms) (QLA/QLE23xxand QLA/QLE24xxHBAs,
Windows 2000, Windows Server 2003, and Red Hat/SuSE Linux)
Execution throttle
Enable extended error logging
Login retry count
Enable LIP reset
Port down retry count
Enable LIP full login
Link down timeout (in seconds)
Enable target reset
LUNs per target
After changing these parameters, you can do one of the following:
Commit changes for this HBA
Abandon changes and return to the previous menu
4.6.1
Interactive Mode
Type the number corresponding to the HBA port, then press ENTER. A list of HBA
parameters is displayed. When you make a selection from the list, SANsurfer FC
HBA CLI prompts you for additional input.
The following text is an example of the Configure HBA Settings option.
Main Menu1: Display System Information2: Display HBA Settings3: Display HBA Information4: Display Device List5: Display LUN List6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities
12: Flash HBA Beacon13: Diagnostics14: Statistics15: Help16: Quit
-
8/13/2019 q Sansurf Cli App Guide
46/128
4 Command Line Options
Configure HBA Settings (Command Line Option -N)
4-18 SN0054614-00 B
Q
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 Online2: Port 1 : WWPN: 21-01-00-E0-8B-3C-A3-DE Online
Note: 0 to return to Main MenuEnter Selection: 1
SANsurfer FC HBA CLI v1.06.16 Build 20
HBA's NVRAM Settings Menu:
HBA Port 0 Model QLA2462: Online
1: Connection Options2: Data Rate3: Frame Size4: Hard Loop ID5: Loop Reset Delay (seconds)6: Enable Host HBA BIOS7: Enable HBA Hard Loop ID8: Enable Fibre Channel Tape Support9: Operation Mode10: Interrupt Delay Timer (100ms)11: Execution Throttle12: Enable Extended Error Logging13: Login Retry Count14: Enable LIP Reset15: Port Down Retry Count16: Enable LIP Full Login17: Link Down Timeout (seconds)18: Enable Target Reset19: LUNs per Target20: Commit Changes for current HBA21: Abandon Changes and Return to Previous Menu
Note: 0 to return to Main Menu
Enter Selection:
-
8/13/2019 q Sansurf Cli App Guide
47/128
4 Command Line Options
Configure HBA Settings (Command Line Option -N)
SN0054614-00 B 4-19
Q
4.6.2
Non-interactive Mode
To set a specific parameter on a specific HBA, type the following command:
# scli -N ( | ) { ( |) }
Where:
The pairs and can be repeated to set multiple parameters in a single
command.
The parameter names and aliases are defined in table 4-2.
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
Table 4-2. HBA Parameters
Parameter Description Parameter Name
Parameter
Alias Parameter Value
Data rate DataRate DR 03a
Connection options ConnectionOption CO 02 for QLA23xx;
03 for QLA22xxb
Enable Fibre Channeltape support
EnableFCTape EF 1, 0c
Maximum LUNs per
target
MaximumLUNsPerTarget ML 0, 8, 16, 32, 64, 128,
256
Enable hard loop ID EnableHardLoopID HL 1, 0c
Hard loop ID HardLoopID HD 0125
Frame size FrameSize FR 512, 1024, 2048
Enable LIP reset EnableLipReset LP 1, 0c
Enable LIP full login EnableLIPFullLogin FL 1, 0c
Enable target reset EnableTargetReset TR 1, 0c
Enable extendedlogging
EnableExtendedLogging EL 1, 0c
Enable BIOS EnableBIOS EB 1, 0c
Loop reset delay ResetDelay RD 060 seconds
Login retry count LoginReTryCount LR 0255
http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
48/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
4-20 SN0054614-00 B
Q
NOTE: Please refer to SANsurfer HBA Manager Index Adapter setting for
parameters related to QLA200/210.
4.7
Target Persistent Binding(Command Line Option -P)
The following sections describe how to view, set, and delete the HBAs target
persistent binding in interactive and non-interactive modes.
Link down timeout LinkDownTimeOut LT 0255Link down error LinkDownError LD 1, 0c,d
Port down retry count PortDownRetryCount PD 0255
Execution throttle ExecutionThrottle ET 1256
Fast error reporting FastErrorReporting FE 1, 0c,d
Operation mode
(Not supported on
Solaris)
OperationMode OM 0, 5, 6e
Interrupt delay timer
(Not supported on
Solaris)
InterruptDelayTimer ID 0255f
Table NotesaData rate (QLA23xx/QLA24xx/QLE23xx/QLE24xxHBAs): 0=1 Gbps, 1=2 Gbps, 2=Auto,
3=4 GbpsbConnection options: 0=loop only, 1=point-to-point only, 2=loop preferred, otherwise
point-to-point, 3=point-to-point, otherwise loop (QLA22xxHBAs)c1=Enable, 0=DisabledThis parameter is valid only in Solaris SPARC.eOperation mode (QLA/QLE23xxand QLA/QLE24xxHBAs): 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/Of
QLA/QLE23xxand QLA/QLE24xxHBAs
Table 4-2. HBA Parameters (Continued)
Parameter Description Parameter Name
Parameter
Alias Parameter Value
http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?-http://-/?- -
8/13/2019 q Sansurf Cli App Guide
49/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
SN0054614-00 B 4-21
Q
4.7.1
Display Target Persistent Binding
4.7.1.1
Interactive ModePerform the following steps to view target persistent binding information for a single
HBA port or for all HBA ports:
1. Type the number for theShow 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 Information2: Display HBA Settings3: Display HBA Information4: Display Device List5: Display LUN List6: Configure HBA Settings7: Target Persistent Binding8: Selective LUNs9: Boot Device10: Driver Settings11: HBA Utilities12: Flash Beacon13: Diagnostics
14: Statistics15: Help16: Quit
Enter Selection: 7
SANsurfer FC HBA CLIv1.06.16 Build 20
Target Persistent Binding Menu:
1: Show Binding Information2: Set Target Persistent Binding3: Unbind Target(s)
Note: 0 to return to Main MenuEnter Selection: 1
-
8/13/2019 q Sansurf Cli App Guide
50/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
4-22 SN0054614-00 B
Q
SANsurfer FC HBA CLIv1.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 MenuEnter 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 IDID---- ------- ----------------------- --------------------- ---------No Disk 20-00-00-20-37-15-97-1E 21-00-00-20-37-15-97-1E 10-02-E1Yes Disk 20-00-00-20-37-15-96-EC 21-00-00-20-37-15-96-EC 10-02-E20Yes Disk 20-00-00-20-37-38-66-2D 21-00-00-20-37-38-66-2D 10-02-E41Yes Disk 20-00-00-20-37-38-73-BC 21-00-00-20-37-38-73-BC 10-02-E82
Press to continue:
4.7.1.2
Non-interactive Mode
To show target persistent binding information for a specific HBA port, type the
following command:
# scli -P ( | ) (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
-
8/13/2019 q Sansurf Cli App Guide
51/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
SN0054614-00 B 4-23
Q
In Solaris SPARC, include double quotes around the question mark (?) if the system
is running with a csh or tsch shell. For example:
# scli -P "?"
SANsurfer FC HBA CLI displays all targets that are currently bound to the HBA. Forexample:
-------------------------------------------------------------------------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 IDID---- ------- ----------------------- --------------------- ---------No Disk 20-00-00-20-37-15-97-1E 21-00-00-20-37-15-97-1E 10-02-E1Yes Disk 20-00-00-20-37-15-96-EC 21-00-00-20-37-15-96-EC 10-02-E20Yes Disk 20-00-00-20-37-38-66-2D 21-00-00-20-37-38-66-2D 10-02-E4
1Yes Disk 20-00-00-20-37-38-73-BC 21-00-00-20-37-38-73-BC 10-02-E82
Press to continue:
4.7.2
Bind Targets
In interactive mode, select the Set Target Persistent Bindingoption 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 themachine 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.
TheSet Target Persistent Bindingoption 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 nis the number of targets attached to the HBA.
-
8/13/2019 q Sansurf Cli App Guide
52/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
4-24 SN0054614-00 B
Q
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 targetsare invisible to the HBA when the system reboots.
4.7.2.1
Bind a Specific Target
4.7.2.1.1
Interactive Mode
Perform the following steps to bind a specific target to an HBA port:
1. From the Target Persistent Binding Menu, type the number for the Set Target
Persistent Bindingoption, then press ENTER. The Target Persistent
Binding Bind 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 Moreoption,
then press ENTER.
If you are finished binding targets, type the number for the Commit
Changesoption, 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: Show Binding Information2: Set Target Persistent Binding3: Unbind Target(s)
Note: 0 to return to Main MenuEnter Selection: 2
SANsurfer FC HBA CLIv1.06.16 Build 20
-
8/13/2019 q Sansurf Cli App Guide
53/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
SN0054614-00 B 4-25
Q
Target Persistent BindingBind Menu
1: Bind Target(s)2: Bind All Target(s)
3: Return to Target Persistent Binding Menu
Note: 0 to return to Main MenuEnter Selection: 1
SANsurfer FC HBA CLIv1.06.16 Build 19
Select HBA Port:
HBA Model QLA2362:1: Port 1: WWPN: 21-01-00-E0-8B-3A-BB-30 Online2: Port 3: WWPN: 21-00-00-E0-8B-1A-BB-30 Online
HBA Model QLA2462:
3: Port 2: WWPN: 21-00-00-E0-8B-1F-9D-F0 Online4: Port 4: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online5: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 4
Select Device:
1: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E1 Bind : No Target ID :
2: Disk Vendor : SEAGATE Product ID : ST318453FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E2 Bind : Yes Target ID : 0 3: Disk Vendor : SEAGATE
Product ID : ST318203FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx Port ID : 10-02-E4 Bind : Yes Target ID : 1
-
8/13/2019 q Sansurf Cli App Guide
54/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
4-26 SN0054614-00 B
Q
4: Disk Vendor : SEAGATE Product ID : ST318203FC Port Name : xx-xx-xx-xx-xx-xx-xx-xx
Port ID : 10-02-E8 Bind : Yes Target ID : 2
5: Return to Previous Menu
Note: 0 to return to Main MenuEnter Selection: 1
Please Enter New Target ID : 3
SANsurfer FC HBA CLI
v1.06.16 Build 19
Target Persistent BindingFC Port Configuration
1: Select More2: Commit Changes3: Abort All Changes
Note: 0 return to Main MenuEnter Selection: 2
Configuration saved on HBA port 4. Changes have been saved topersistent storage.You must reboot in order for the saved configuration to becomeeffective.
Press 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 ( | ) ( )
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
-
8/13/2019 q Sansurf Cli App Guide
55/128
4 Command Line Options
Target Persistent Binding (Command Line Option -P)
SN0054614-00 B 4-27
Q
The group 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.9and that
target is persistently bound, thetarget ID cannot be modified.
4.7.2.2
Bind All Targets
4.7.2.2.1
Interactive Mode
Perform the following steps to bind all targets on a specific HBA:
1. From the Target Persistent Binding Menu, type the number for the Set Target
Persistent Bindingoption, then press ENTER.
2. The Target Persistent BindingBind Menu displays. Type the number for the
Bind All Target(s)option, then press ENTER.
3. A list of HBA ports is displayed. Type the number that corresponds to the HBA
port whose targets you want to bind, then press ENTER.
4. A message displays, which says that the configuration is saved, changes have
been saved to persistent storage, and a reboot is required for the changes to
take effect. Press ENTER. The Target Persistent BindingBind Menu displays.
5. Do one of the following:
To bind targets for another HBA port, type the number for the Bind All
Target(s)option, then press ENTER.
If you are finished binding targets, type 0, then press ENTER.
The following text is an example of the Bind All Target(s)option:
Target Persistent Binding Menu:
1: Show Binding Information2: Set Target Persistent Binding
3: Unbind Target(s)
Note: 0 to return to Main MenuEnter Selection: 2