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


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


3/128


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


4/128


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


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.3 Display HBA Information (Command Line Option -I) . . . . . . . . . . . . . . . . 4-5




6/128


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.5 Display LUN List (Command Line Option -L) . . . . . . . . . . . . . . . . . . . . . . 4-124.5.1 Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13


4.6 Configure HBA Settings (Command Line Option -N) . . . . . . . . . . . . . . . . 4-16



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.3 Unbind Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29

4.7.3.1 Unbind a Specific Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-29


4.7.3.1.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-314.7.3.2 Unbind All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31



4.8 Selective LUNs (Command Line Option -M). . . . . . . . . . . . . . . . . . . . . . . 4-33

4.8.1 View Selective LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-34


4.8.1.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37

4.8.2 Enable/Disable a LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37


4.8.2.2 Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-414.8.3 Enable/Disable All LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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


7/128

SANsurfer FC HBA CLI

SN0054614-00 B Page vii

QSANsurfer FC HBA CLI Application Users Guide




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.2 Disable the HBAs Boot Device . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-50



4.10 Driver Settings (Command Line Option -FS) . . . . . . . . . . . . . . . . . . . . . . 4-50



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.13 Save/Update NVRAM (Command Line Option -R). . . . . . . . . . . . . . . . . . 4-56



4.14 Update Driver (Windows 2000 and Windows Server 2003)

(Command Line Option -D). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-59



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



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.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/128



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.2 Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-72



4.18 Help (Command Line Option -H) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 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


9/128


SN0054614-00 B Page ix

QSANsurfer FC HBA CLI Application Users Guide


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


10/128



Page x SN0054614-00 B

Q

Notes


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/


12/128


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


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.


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:


15/128

2 Getting Started

Non-interactive Mode

SN0054614-00 B 2-3

Q

2.3


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


16/128

2 Getting Started


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://-/?-


17/128

2 Getting Started


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:


18/128

2 Getting Started


2-6 SN0054614-00 B

Q

Notes


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/


20/128

3 Initial Installation


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.


21/128



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.


22/128



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.


23/128



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"


24/128



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


25/128



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.


26/128


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


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.


27/128



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


28/128



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.


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.


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


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


31/128


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


32/128


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


33/128


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


34/128



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


PCI slot number (Windows 2000, Windows Server 2003, Enterprise Server, and


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


35/128



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


HBA Information Menu1: HBA General Information

2: HBA VPD Information



HBA General Information Menu1: Display Specific HBA Information2: Display All HBA Information3: Return to Previous Menu




36/128



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


------------------------------------------------------------------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


To display the general information for all HBA ports in the system, type one of the

following commands:

# scli -I ALL# scli -I


37/128


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

http://-/?-http://-/?-


38/128



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


Device Info - HBA Selection Menu:1: Select HBA Port2: Select All HBAs



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://-/?-


39/128



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


Target Information Menu:1: Display Specific Device Information2: Display All Device Information3: Return to HBA Selection Menu


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


40/128


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


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



Target WWPN= World wide port name of the target

Target Port ID= Port ID of the target


41/128



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

http://-/?-http://-/?-


42/128



4-14 SN0054614-00 B

Q

LUN List: HBA Selection Menu: 1: Select HBA port 2: Select All HBAs


SANsurfer FC HBA CLI v1.06.16 Build 20


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



LUN Information Menu:1: Display Specific LUN Information2: Display All LUN(s) Information3: Return to HBA Selection Menu



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


43/128



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



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


-----------------------------------------------------------------------------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:


44/128


Configure HBA Settings (Command Line Option -N)

4-16 SN0054614-00 B

Q

4.5.2


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)



Target Port ID= Port ID of the target

Target WWPN= World wide port name of the target

LUN ID= ID of the LUN


45/128



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


46/128



4-18 SN0054614-00 B

Q

Enter Selection: 6



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



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:


47/128



SN0054614-00 B 4-19

Q

4.6.2


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.



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://-/?-


48/128


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://-/?-


49/128



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


Target Persistent Binding Menu:

1: Show Binding Information2: Set Target Persistent Binding3: Unbind Target(s)



50/128



4-22 SN0054614-00 B

Q


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


-------------------------------------------------------------------------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


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:




51/128



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.


52/128



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.


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.


1: Show Binding Information2: Set Target Persistent Binding3: Unbind Target(s)




53/128



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



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


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


54/128



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


Please Enter New Target ID : 3


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


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


Target WWNN= World wide node name of the target


55/128



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.


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:


1: Show Binding Information2: Set Target Persistent Binding

3: Unbind Target(s)


Date post:	04-Jun-2018
Category:	Documents
Upload:	pravin-kamthe
View:	219 times
Download:	0 times

q Sansurf Cli App Guide

Documents