Q-Logic FC0E, FC User Manual

Download

SANsurfer FC/CNA HBA CLI

User’s Guide

Command Line Interface for

QLogic FC and FCoE Adapters

SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties that may result from its use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no representation nor warranty that such applications are suitable for the specified use without further testing or modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.

Document Revision History

Revision A, August 20, 2004

Revision B, September 28, 2005

Revision C, June 7, 2006

Revision D, October 1, 2006

Revision E, February 1, 2007

Revision F, February 29, 2008

Revision G, June 30, 2008

Revision H, July 16, 2008

Revision J, March 11, 2009

Revision K, June 15, 2009

Changes Sections Affected

Revision K Changes:

Changed product name from “SANsurfer FC HBA CLI” to “SANsurfer FC/CNA HBA CLI.”

Added

QLE81xx and QMI81xx to the list of sup-

ported adapters.

Added Red Hat and Novell PowerPC64 to supported Linux OSs.

Added list of unsupported features for QLE81xx and QMI81xx adapters on Linux OS.

Added note recommending uninstalling older version rather than upgrading.

Added new FCoE menu option to Getting Started chapter.

All

“Supported QLogic Adapters” on page 1-2

“Supported Operating Systems” on page 1-3

“Unsupported Features” on page 1-5

“Installing SANsurfer FC/CNA HBA CLI” on page 1-7

“Starting Interactive Mode” on page 2-1

Added -cna command line option to Non-interac-

Table 2-1 on page 2-4

tive Mode Options table.

ii SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide

Command Line Interface for QLogic FC and FCoE Adapters

Added new FCoE menu option to Interactive Com- mands chapter.

Added Flash Image Version to list of actual VPD information.

Added new ENode MAC Address information for QLE81xx adapters.

Added cautions about deleting the LUN persistent name for a LUN with active I/O.

Updated the Utilities menu (renamed some options per modifications to the CLI, added new MPI config table options, and removed the FCoE Utility option).

Updated Update Flash option. “Update Flash (Per Adapter Port or All HBAs)

Added new message passing interface (MPI) options for the Utilities menu.

Updated loopback and read/write buffer test descriptions and examples.

3 Interactive Commands

“Generate Report (Per Adapter Port)” on page 3-11

“HBA Information (Command Line Option -i)” on page 3-21

“Persistent Names Menu (Command Line Option

-pl)” on page 3-39

“-pl (Show, Add, and Delete Persistent Names)” on page 4-41

“Utilities Menu” on page 3-64

“Update MPI Config Table” on page 3-71

“Save MPI Config Table” on page 3-71

(Command Line Option -b)” on page 3-65

“Update MPI Config Table” on page 3-71

“Save MPI Config Table” on page 3-71

“Diagnostics Loopback Test (Command Line Option -kl)” on page 3-77

“Diagnostics Read/Write Buffer Test” on page 3-83

Updated the transceiver details output examples. “Diagnostics Transceiver Details: DMI (Command

Line Option -dm)” on page 3-85

Updated FCoE menu section to reflect support for both QLE80xx (FCoE adapters) and QLx81xx (converged network adapters).

Added new section for converged network adapters (QLE81xx and QMI81xx).

Added new command line options for converged network adapters (QLE81xx and QMI81xx).

Renamed Interactive Exit Codes appendix and updated and added new error return codes.

Removed redundant Non-Interactive Error Codes appendix (codes are the same as in Appendix C

Error/Exit Return Codes).

Added new glossary terms.

“FCoE Menu (Command Line Option -cna)” on page 3-108

“FCoE Utilities Menu for QLx81xx Adapters (Command Line Option -cna)” on page 3-111

“-cna (FCoE Utilities Menu for QLx81xx Adapters)” on page 4-8

Appendix C Error/Exit Return Codes

—

Glossary

SN0054614-00 K iii

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

Notes

iv SN0054614-00 K

Preface

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv

Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi

Related Materials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii

Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xviii

1 Installation and Removal

Supported QLogic Adapters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Hardware Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

Software Requirements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Unsupported Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5

Downloading the Installation Package . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6

Installing SANsurfer FC/CNA HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

Command Line Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12

Linux Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-14

Solaris Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-15

Solaris SPARC 8, 9, 10 Installation . . . . . . . . . . . . . . . . . . . . . . 1-15

Solaris x86 9 and 10 Installation. . . . . . . . . . . . . . . . . . . . . . . . . 1-17

Macintosh Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18

Standard (GUI) Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-18

Command Line Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-19

VMware Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-20

SN0054614-00 K v

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

Uninstalling SANsurfer FC/CNA HBA CLI . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21

Windows Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21

Standard (GUI) Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21

Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21

Linux Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22

Solaris Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-22

Solaris SPARC 8, 9, and 10 Uninstall. . . . . . . . . . . . . . . . . . . . . 1-22

Solaris x86 8, 9, and 10 Uninstall . . . . . . . . . . . . . . . . . . . . . . . . 1-23

Macintosh Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24

VMware Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-24

2 Getting Started

Starting Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Starting Non-Interactive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-9

Advanced Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-10

3 Interactive Commands

General Information Menu (Command Line Option -g) . . . . . . . . . . . . . . . . 3-4

Host Information (Command Line Option -g). . . . . . . . . . . . . . . . . . . . 3-4

Host Topology (Command Line Option -tp | -topology) . . . . . . . . . . . . 3-5

Display (Host Topology) (Command Line Option -tp |

-topology) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-6

Save As Txt File (Command Line Option -b) . . . . . . . . . . . . . . . 3-10

Save As XML File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-10

Generate Report (Command Line Option -z) . . . . . . . . . . . . . . . . . . . 3-10

Generate Report (Per Adapter Port). . . . . . . . . . . . . . . . . . . . . . 3-11

Generate Report (All Adapters) (Command Line Option -z). . . . 3-19

Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-19

HBA Information Menu (Command Line Option -i) . . . . . . . . . . . . . . . . . . . 3-19

HBA General Information (per Adapter Port). . . . . . . . . . . . . . . . . . . . 3-20

HBA Information (Command Line Option -i). . . . . . . . . . . . . . . . 3-21

HBA Alias (Command Line Option -ha) . . . . . . . . . . . . . . . . . . . 3-21

HBA Port Alias (Command Line Option -pa) . . . . . . . . . . . . . . . 3-22

HBA VPD Information (Command Line Option -l and

Reserved Word “vpd”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-23

HBA Information (All HBAs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24

Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24

vi SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide

Command Line Interface for QLogic FC and FCoE Adapters

HBA Parameters Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24

HBA Parameters (Per Adapter Port) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-25

Display HBA Parameters (Command Line Option -c#). . . . . . . . 3-26

Configure HBA Parameters (Command Line Option -n). . . . . . . 3-26

Restore Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-32

HBA Parameters (Per FCoE Engine) . . . . . . . . . . . . . . . . . . . . . . . . . 3-33

Display FCoE Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33

Configure FCoE Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-33

HBA Parameters (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-36

Target/LUN List Menu (Command Line Options -t and -l) . . . . . . . . . . . . . . 3-36

Target/LUN List (Per Adapter Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-37

Per Target/LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-38

Per Target/All LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-38

All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-41

Target/LUN List (All Adapters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-42

Individual Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-42

Individual LUN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43

All Targets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-43

All Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-44

All LUN(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-45

Target Link Speed or iiDMA Settings Menu (Command Line

Option -q) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-47

Configuring the iiDMA Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-48

HBA Port Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-49

HBA Port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-50

Advanced Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-51

Target Link Speed: All HBAs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-51

Target Link Speed: All HBAs, Basic Configuration . . . . . . . . . . . 3-52

Target Link Speed: All HBAs, Advanced Configuration . . . . . . . 3-52

iiDMA Settings: Disk . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-54

iiDMA: All HBAs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-54

Target Persistent Bindings Menu (Command Line Option -p) . . . . . . . . . . . 3-54

Target Persistent Bindings (Per Adapter Port) (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55

Display Target Persistent Binding (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55

Target Persistent Bindings: Bind Target(s) (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-55

Target Persistent Binding: Unbind Targets (Command Line

Option -p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57

SN0054614-00 K vii

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

Target Persistent Binding (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-57

Display Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . 3-57

Target Persistent Binding: Bind Targets . . . . . . . . . . . . . . . . . . . 3-57

Target Persistent Binding: Unbind Targets . . . . . . . . . . . . . . . . . 3-57

Selective LUNs Menu (Command Line Option -m) . . . . . . . . . . . . . . . . . . . 3-58

Selective LUNs (Per Adapter Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58

Selective LUNs (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58

Display LUN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-58

Manual Configure LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59

Auto Configure LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-59

Boot Device Menu (Command Line Option -e) . . . . . . . . . . . . . . . . . . . . . . 3-60

HBA Port Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-60

Boot Device(s) (Per Adapter Port) . . . . . . . . . . . . . . . . . . . . . . . 3-60

Configure Boot Device(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-61

Boot Device(s) (All HBAs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-62

Driver Settings Menu (Command Line Option -fg) . . . . . . . . . . . . . . . . . . . . 3-62

Utilities Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-64

Update Flash (Per Adapter Port or All HBAs) (Command Line

Option -b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65

Save Flash (Per Adapter Port) (Command Line Option -b and

Reserved Word “save”) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65

Update HBA Parameters (Per Adapter Port or All HBAs)

(Command Line Option -r) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-65

Save HBA Parameters (Per Adapter Port) (Command Line

Option -r and Reserved Word “save”). . . . . . . . . . . . . . . . . . . . . . . . 3-66

HBA Parameters Template (Per Adapter or All HBAs)

(Command Line Option -n and OEM Name). . . . . . . . . . . . . . . . . . . 3-66

Update Driver (Command Line Option -d). . . . . . . . . . . . . . . . . . . . . . 3-69

Update Firmware Preload Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-69

Save Firmware Preload Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-70

Update MPI Config Table. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-71

Save MPI Config Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-71

Driver Rescan (Command Line Option -rs) . . . . . . . . . . . . . . . . . . . . . 3-72

Firmware Area Update (Command Line Option -u). . . . . . . . . . . . . . . 3-72

Firmware Area Save (Command Line Option -u) . . . . . . . . . . . . . . . . 3-74

Beacon Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-75

Locate HBA: HBA Beacon (Command Line Option -a) . . . . . . . . . . . . 3-75

Locate Target(s): Target Beacon (Command Line Option -tb). . . . . . . 3-75

Beacon Selected Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-76

viii SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide

Command Line Interface for QLogic FC and FCoE Adapters

Diagnostics Menu (Command Line Options -kl, -kr, and -dm) . . . . . . . . . . . 3-76

Diagnostics Loopback Test (Command Line Option -kl) . . . . . . . . . . . 3-77

Display Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . . . 3-79

Reset Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . . . . 3-80

Configure Test Parameters (Loopback) . . . . . . . . . . . . . . . . . . . 3-80

Start Diagnostic Test (Loopback) . . . . . . . . . . . . . . . . . . . . . . . . 3-82

Diagnostics Read/Write Buffer Test. . . . . . . . . . . . . . . . . . . . . . . . . . . 3-83

Configure Test Parameters (Read/Write) . . . . . . . . . . . . . . . . . . 3-83

Start Diagnostic Test (Read/Write Buffer) . . . . . . . . . . . . . . . . . . 3-84

Diagnostics Transceiver Details: DMI (Command Line

Option -dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-85

Transceiver Details: General . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-86

Transceiver Details: Details . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-86

Statistics Menu (Command Line Options -gs and -ls) . . . . . . . . . . . . . . . . . 3-89

HBA Statistics: Monitoring (Command Line Option -gs) . . . . . . . . . . . 3-90

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-90

Show HBA Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-93

Link Status (Command Line Option -ls). . . . . . . . . . . . . . . . . . . . . . . . 3-93

Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-94

Show Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-96

Virtual Menu (Command Line Option -vp) . . . . . . . . . . . . . . . . . . . . . . . . . . 3-97

Virtual Menu for Adapter Instance. . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-98

List Virtual Port(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-99

Delete Virtual Port(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-99

Create Virtual Port(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-100

QoS Menu (Command Line Option -qos). . . . . . . . . . . . . . . . . . . . . . . . . . . 3-101

QoS Priority Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-103

QoS Bandwidth Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-104

QoS Bandwidth Speed Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-105

QoS Bandwidth Percentage Menu . . . . . . . . . . . . . . . . . . . . . . . 3-107

FCoE Menu (Command Line Option -cna). . . . . . . . . . . . . . . . . . . . . . . . . . 3-108

FCoE Utilities Menu for QLE80xx Adapters . . . . . . . . . . . . . . . . . . . . 3-108

Update Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109

Stats Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109

Logs Menu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-110

SN0054614-00 K ix

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

FCoE Utilities Menu for QLx81xx Adapters (Command Line

Option -cna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-111

Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112

Data Center Bridging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-112

DCE Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-114

TLV . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-118

Help Menu (Command Line Option -h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-120

Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-121

Exit Codes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-121

About . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-121

4 Non-Interactive Commands

Display System Information (Command Line Options -g, -z, and -tp) . . . . . 4-1

Host Information (Command Line Option -g). . . . . . . . . . . . . . . . . . . . 4-1

Host Configuration (Command Line Option -z) . . . . . . . . . . . . . . . . . . 4-2

Host Topology (Command Line Option -tp) . . . . . . . . . . . . . . . . . . . . . 4-3

Host Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-5

-a (View or Toggle Beacon Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

-b (Save or Update the Flash BIOS or FCode) . . . . . . . . . . . . . . . . . . 4-7

-c (Show Parameter Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8

-cna (FCoE Utilities Menu for QLx81xx Adapters). . . . . . . . . . . . . . . . 4-8

-d (Update Device Driver) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10

-dm (Display Diagnostics Monitoring Info). . . . . . . . . . . . . . . . . . . . . . 4-10

-e (Boot Device View | Select | Disable) . . . . . . . . . . . . . . . . . . . . . . . 4-11

-ei (List SANsurfer FC/CNA HBA CLI Error Codes) . . . . . . . . . . . . . . 4-13

-f (Input Parameter Options from a Text File) . . . . . . . . . . . . . . . . . . . 4-13

-fcoe (Display and Configure FCoE Engine Parameters) . . . . . . . . . . 4-14

-fg (Show Driver Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16

-fs (Configure Driver Settings). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16

-g (Display System Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

-gs (Show HBA Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

-h (Help). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-ha (Set | Delete HBA Alias) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-i (Display HBA General Information or VPD Information for

One or All HBAs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20

-kl (Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20

DataPattern (DP) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21

DataSize (DS). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

TestCount (TC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

x SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide

Command Line Interface for QLogic FC and FCoE Adapters

TestIncrement (TI) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

OnError (OE) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

LoopbackType (LT) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

Run a Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

-kl (Run HBA Diagnostics Loopback Test). . . . . . . . . . . . . . . . . . . . . . 4-27

-kr (Run Read/Write Buffer Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-27

Run a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-28

Run Adapter Diagnostics Read-write Buffer Test . . . . . . . . . . . . 4-30

-l (Display LUN Info) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32

-ls (Display Link Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-32

-m (View, Enable, or Disable LUNs) . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33

-n (Set Selected HBA Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-35

-o (Output to a File) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-37

-p (Display Persistent Target Binding Info) . . . . . . . . . . . . . . . . . . . . . 4-38

-pa (Define Port Alias) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-40

-pl (Show, Add, and Delete Persistent Names) . . . . . . . . . . . . . . . . . . 4-41

-q (View or Set Target Link Speed) . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-42

-qos (QoS Menu). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-43

-r (Update HBA Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-44

-s (Silent Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45

-t (Display Target Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-45

-tb (Target Beacon On/Off) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

-tp (Display Host Topology) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

-u (Firmware Area Update/Save). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-46

-v (Display Version) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47

-vp (Virtual Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-47

-x (Output in XML Format 1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48

-x2 (Output in XML Format 2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-48

-z (Display All HBA information for One or All HBAs) . . . . . . . . . . . . . 4-49

AXML Format 1

Output Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Main Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Utility Header. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-1

Status Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

Reboot Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

Error Message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

XML Format 1 Tags for Each Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

Display System Information (Command Line Option -g) . . . . . . . . . . . A-3

Display Adapter Settings (Command Line Option -c) . . . . . . . . . . . . . A-4

SN0054614-00 K xi

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

Display HBA Information (Command Line Option -i) . . . . . . . . . . . . . . A-5

Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . A-7

Display LUN List (Command Line Option -l) . . . . . . . . . . . . . . . . . . . . A-7

Target Persistent Binding (Command Line Option -p) . . . . . . . . . . . . . A-8

Selective LUNs (Command Line Option -m) . . . . . . . . . . . . . . . . . . . . A-8

Boot Device (Command Line Option -e) . . . . . . . . . . . . . . . . . . . . . . . A-9

Diagnostics Results—Loopback Test (Command Line

Option -kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-9

Diagnostics Results—Read/Write Buffer Test (Command Line

Option -kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-10

View Driver Settings (Command Line Option -fg) . . . . . . . . . . . . . . . . A-10

Display All Information for One or All Adapters (Command Line

Option -z) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11

Link Statistics (Command Line Option -ls). . . . . . . . . . . . . . . . . . . . . . A-14

HBA Statistics (Command Line Option -gs). . . . . . . . . . . . . . . . . . . . . A-14

HBA Alias (Command Line Option -ha). . . . . . . . . . . . . . . . . . . . . . . . A-15

HBA Port Alias (Command Line Option -pa) . . . . . . . . . . . . . . . . . . . . A-15

HBA Transceiver Details (Command Line Option -dm) . . . . . . . . . . . . A-16

Host Topology (Command Line Option -tp) . . . . . . . . . . . . . . . . . . . . . A-20

Display FCoE Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-22

Display FCoE Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23

Display FCoE Link Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-23

Display FCoE DCBX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-25

Display FCoE Network Interface Statistics . . . . . . . . . . . . . . . . . . . . . A-26

BXML Format 2

Output Parts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Main Tag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-1

Utility Header. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Status Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Reboot Message . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

Error Message. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-2

XML Format 2 Tags for Each Option . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-3

Display System Information (Command Line Option -g) . . . . . . . . . . . B-4

Display Adapter Settings (Command Line Option -c) . . . . . . . . . . . . . B-4

Display HBA Information (Command Line Option -I). . . . . . . . . . . . . . B-5

Display Device List (Command Line Option -t) . . . . . . . . . . . . . . . . . . B-7

Display LUN List (Command Line Option -l) . . . . . . . . . . . . . . . . . . . . B-8

Target Persistent Binding (Command Line Option -p) . . . . . . . . . . . . . B-9

Selective LUNs (Command Line Option -m) . . . . . . . . . . . . . . . . . . . . B-9

xii SN0054614-00 K

SANsurfer FC/CNA HBA CLI User’s Guide

Command Line Interface for QLogic FC and FCoE Adapters

Boot Device (Command Line Option -e) . . . . . . . . . . . . . . . . . . . . . . . B-10

Diagnostics Results—Loopback Test (Command Line

Option -kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-11

Diagnostics Results—Read/Write Buffer Test (Command Line

Option -kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-12

View Driver Settings (Command Line Option -fg) . . . . . . . . . . . . . . . . B-12

Display All Information for One or All Adapters (Command Line

Option -z) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13

Link Statistics (Command Line Option -ls). . . . . . . . . . . . . . . . . . . . . . B-16

HBA Statistics (Command Line Option -gs). . . . . . . . . . . . . . . . . . . . . B-17

HBA Alias (Command Line Option -ha). . . . . . . . . . . . . . . . . . . . . . . . B-18

HBA Port Alias (Command Line Option -pa) . . . . . . . . . . . . . . . . . . . . B-18

HBA Transceiver Details (Command Line Option -dm) . . . . . . . . . . . . B-20

Host Topology (Command Line Option -tp) . . . . . . . . . . . . . . . . . . . . . B-25

Display FCoE Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-27

Display FCoE Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-27

Display FCoE Link Events . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-27

Display FCoE DCBX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-29

Display FCoE Network Interface Statistics . . . . . . . . . . . . . . . . . . . . . B-30

C Error/Exit Return Codes

D Help Commands

Glossary

Index

List of Figures

Figure Page

1-1 Selecting Adapter Model (Example). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-7

1-2 Preparing to Install Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-8

1-3 Welcome Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-9

1-4 Choose Destination Location Dialog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-10

1-5 Ready to Install the Program Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11

1-6 Setup Status Dialog Box . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-11

1-7 InstallShield Wizard Complete DIalog Box. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-12

SN0054614-00 K xiii

SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters

List of Tables

1-1 Windows Command Line Installation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . 1-13

2-1 Non-interactive Mode Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

3-1 Adapter Parameters Settings (NVRAM). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-27

3-2 Target/LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-37

3-3 Target Link Speed Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-47

3-4 Driver Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-63

3-5 Template Supported Parameter Settings for QLA24xx/QLE24xx and

QLE256x Adapters (ISP2422). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-67

3-6 Template Supported Parameter Settings for QLA24xx/QLE24xx and

QLE256x Adapters (ISP2432). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-67

3-7 Template Supported Parameter Settings for QLA23xx Adapters

(ISP2300/2310). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-68

3-8 Template Supported Parameter Settings for QLA23xx Adapters (ISP2312) . . . . . . 3-68

3-9 Template Supported Parameter Settings for QLA23xx Adapters (ISP2322) . . . . . . 3-68

3-10 Adapter Diagnostics Configuration Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-81

3-11 Adapter Port Statistics Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-91

3-12 Statistics/Link Status Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-94

3-13 DCBX and ETS Configuration Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-113

4-1 Options Shown by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

4-2 Command Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6

4-3 DCE™ Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10

4-4 FCoE Engine Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-15

4-5 Driver Settings Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

4-6 Adapter Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

4-7 Data Pattern Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22

4-8 OnError Values. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

4-9 LoopbackType Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

4-10 Driver Versions Not Requiring a Loopback Connector. . . . . . . . . . . . . . . . . . . . . . . 4-25

4-11 Diagnostics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30

4-12 Data Pattern (DP) Test Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31

4-13 Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33

4-14 Adapter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-36

A-1 Options Shown by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11

B-1 Options Shown by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B-13

C-1 Error/Exit Return Codes. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-1

D-1 Variables Used in Arguments. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-1

D-2 Help Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . D-2

xiv SN0054614-00 K

Preface

The SANsurfer® FC/CNA HBA CLI tool provides a command line interface (CLI) that lets you easily install, configure, and deploy QLogic

adapters, as well as QLogic Fibre Channel over Ethernet (FCoE) converged network adapters (CNAs). It also provides robust diagnostic and troubleshooting capabilities and useful statistical information to optimize SAN performance. This tool only configures adapters on the local machine (where SANsurfer FC/CNA HBA CLI is installed.)

SANsurfer FC/CNA HBA CLI is a simplified, condensed version of the SANsurfer FC HBA Manager graphical user interface (GUI), which manages both local and remote hosts.

SANsurfer FC/CNA HBA CLI can be operated in two modes:

 Interactive mode (menu-driven interface). This mode requires user

intervention.

 Non-interactive mode (command line interface). Use this mode for

scripting or when you want to do a single operation.

NOTE:

This guide uses interchangeably the terms HBA, CNA, and adapter.

Fibre Channel (FC)

Intended Audience

This guide is intended for end users responsible for administration of QLogic FC adapters.

What’s in This Guide

This preface provides a general overview of the product and covers the intended audience, related materials, document conventions, and contact information for technical support.

SN0054614-00 K xv

Preface What’s in This Guide

The remainder of this guide is organized into the following chapters and appendices:

 1 Installation and Removal lists the supported QLogic adapters and

 2 Getting Started describes the two modes used in SANsurfer FC/CNA HBA

 3 Interactive Commands provides detailed explanations and examples of

 4 Non-Interactive Commands provides detailed explanations and examples

 Appendix A XML Format 1 provides explanations and examples of XML files

operating systems, lists the system hardware and software requirements, and provides step-by-step instructions for installing and uninstalling SANsurfer FC/CNA HBA CLI on Windows, Linux, Solaris, and Macintosh.

CLI: interactive and non-interactive. It also explains some special terms used in this guide.

the command line options used in interactive mode.

of the command line options used in non-interactive mode.

created with the -x1 command line option.

 Appendix B XML Format 2 provides explanations and examples of XML files

created with the -x2 command line option.

 Appendix C Error/Exit Return Codes lists the error return codes that can

occur while running SANsurfer FC/CNA HBA CLI in interactive and non-interactive modes. For each return code number, it provides the name and description.

 Appendix D Help Commands provides an alphabetical list of the command

line actions, arguments, and functions of the help commands.

Following the appendices are a glossary of terms used and an index that will help you quickly find the information you need.

Documentation Conventions

This guide uses the following typographic conventions:

 Te x t i n bold font indicates a menu or menu item. For example:

From the General Information Menu, type the number for Host Topology.

 Text in a monospace font (Courier New) indicates CLI window text output.

For example:

The HBA already has the device selected as boot device.

 Text in a bold sans serif font (Courier New) indicates user input (what you

type). For example:

# scli -z

xvi SN0054614-00 K

Preface

License Agreements

 Te x t i n

keyboard. For example:

 Italicized text indicates either a document reference, glossary term, or

emphasis. For example:

 Italicized text within angle brackets indicates user-defined variables. For

example:

 Text shown in blue indicates a cross-reference hyperlink to a Web site or to

another section of this guide. Click the hyperlink to jump to that site or section. For example:

 In 3 Interactive Commands, a “breadcrumbs” line follows most command

headings to show you how to access that option; that is, it shows the hierarchical path from the top level to the command under discussion. For example, to reach the Save to Text File options from the main SANsurfer FC/CNA HBA CLI menu, you would select option 1 to open the General Information menu, 2 to open the Host Topology menu, and 2 again to see the Save to Text File options.

ALL CAPITALS

Type the number for Host Information and then press

Attached Port means a QLogic adapter....

For a complete list, see the QLogic SAN Interoperability Guide.

# scli -k (<hba instance> | <hba wwpn>)

Visit the QLogic support Web site at support.qlogic.com firmware and product updates.

For information on the Virtual Menu, see “Virtual Menu for Adapter

Instance” on page 3-98.

indicates the name of a key that you press on the

ENTER

for the latest

The following shows a breadcrumbs example:

1: General Information 2: Host Topology 2: Save to Text File

Related Materials

For additional information, refer to the SANsurfer FC/CNA HBA CLI ReadMe file and release notes.

License Agreements

Refer to the QLogic Software End User License Agreement for a complete listing of all license agreements affecting this product.

SN0054614-00 K xvii

Preface Technical Support

Technical Support

Customers should contact their authorized maintenance provider for technical support of their QLogic switch products. QLogic-direct customers may contact QLogic Technical Support; others will be redirected to their authorized maintenance provider.

Visit the QLogic support Web site listed in Contact Information for the latest firmware and software updates.

Availability

QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays.

Training

QLogic offers training for technical professionals for all iSCSI, InfiniBand, and Fibre Channel products. From the main QLogic Web page, www.qlogic.com the Education and Resources tab at the top, and then click the Education & Training tab at the left. The QLogic Global Training Portal offers online courses, certification exams, and scheduling of in-person training.

, click

Technical certification courses include installation, maintenance, and troubleshooting QLogic products. Upon demonstrating knowledge using live equipment, QLogic awards a certificate identifying the student as a Certified Professional. The training professionals at QLogic may be reached by e-mail at

training@qlogic.com

Contact Information

Please feel free to contact your QLogic approved reseller or QLogic Technical Support at any phase of integration for assistance. QLogic Technical Support can be reached by the following methods:

Web http://support.qlogic.com

E-mail support@qlogic.com

The QLogic knowledge database contains troubleshooting information for the QLogic adapters. Access the database from the QLogic Support Web page,

http://support.qlogic.com

specific troubleshooting information.

. Use the Support Center search engine to look for

xviii SN0054614-00 K

1 Installation and Removal

This chapter lists the supported QLogic adapters and system requirements, provides procedures for downloading and installing SANsurfer FC/CNA HBA CLI, and instructions for removing the product. Refer to the following sections:

 “Supported QLogic Adapters” on page 1-2  “Supported Operating Systems” on page 1-3  “System Requirements” on page 1-4  “Downloading the Installation Package” on page 1-6  “Installing SANsurfer FC/CNA HBA CLI” on page 1-7  “Uninstalling SANsurfer FC/CNA HBA CLI” on page 1-21

Prerequisites

Before you run SANsurfer FC/CNA HBA CLI, ensure that the following requirements are met:

 The adapters must be installed.

 The adapter drivers must be installed.

 For QLE81xx and QMI81xx adapters, a QLogic-specific small form factor

pluggable (SFP) must be installed.

NOTE:

Some SANsurfer FC/CNA HBA CLI features are not available when:

 You have a Solaris system that is running with the driver distributed with

the OS installation CDs (QLC driver).

 You have a Linux system that is running with the IOCTL or sysfs (inbox)

driver.

 You have a Linux system that is running with a VMware driver.

SN0054614-00 K 1-1

1–Installation and Removal Supported QLogic Adapters

Supported QLogic Adapters

SANsurfer FC/CNA HBA CLI is supported for the following QLogic adapters:

 QLA2xx  QLA234x  QLE2xx  QLA246x  QLE246x  QLE256x  QLE8042  QLE81xx  QMI81xx

Not all SANsurfer FC/CNA HBA CLI features are available on every supported adapter. For more information, see “Unsupported Features” on page 1-5.

NOTE:

If SANsurfer FC/CNA HBA CLI detects an unsupported adapter, the following message appears, where X is the adapter instance number and YYYYYYY is the adapter model:

Unsupported HBA (Instance X – YYYYYYY)

If SANsurfer FC/CNA HBA CLI detects an adapter for which no information is known, the following message appears, where X is the adapter instance number, 0xYYYY is the subsystem vendor ID, and 0xZZZZ is subsystem device ID of the adapter:

Unknown HBA type (Instance X SSVID=0xYYYY SSDID=0xZZZZ)!

1-2 SN0054614-00 K

Supported Operating Systems

SANsurfer FC/CNA HBA CLI is supported on the following operating systems:

 Microsoft

 Windows 2000, 32-bit, Intel x86 Intel 64, AMD64  Windows Server 2003, 32-bit Intel x86, Intel 64, AMD64  Windows Server 2008, 32-bit Intel x86, Intel 64, AMD64  Windows XP Professional, 32-bit Intel x86, Intel 64, AMD64  Windows XP Professional, x64-bit Intel 64, AMD64  Windows Vista, 32-bit Intel x86  Windows Vista x64

 Linux

 Red Hat  Red Hat RHEL AS/ES 4.5 32-bit, 64-bit Intel IA64, Intel 64, AMD64  Red Hat RHEL AS/ES 4.0 32-bit, 64-bit Intel IA64, Intel 64, AMD64  Red Hat RHEL AS/ES 3.0 32-bit, 64-bit Intel x86, Intel 64, AMD64  Red Hat PowerPC64

 Novell  Novell SLES 9 32-bit, 64-bit Intel IA64, Intel 64, AMD64  Novell SLES 8 32-bit, 64-bit Intel x86, AMD64  Novell PowerPC64

Windows®:

RHEL AS/ES 5.0 32-bit, 64-bit Intel IA64, Intel 64, AMD64

SLES 10 32-bit, 64-bit Intel IA64, Intel 64, AMD64

1–Installation and Removal

Supported Operating Systems

NOTE:

RHEL 3.0 and SLES 8 do not support 8Gb adapters.

 Solaris

 Solaris 9, 10 x86 32-bit, 64-bit Intel x86, Intel 64, AMD64  Solaris 2.6, 7, 8, 9, and 10 SPARC 32-bit, 64-bit SPARC

 Apple

Macintosh®:

 Mac OS X (Panther/Tiger), 32-bit, 64-bit PowerPC/Intel

 NetWare

 NetWare 6.5 32-bit Intel x86, Intel 64, AMD64

 VMware

ESX:

 ESX 3.5 32-bit, Intel 64, AMD64

SN0054614-00 K 1-3

1–Installation and Removal System Requirements

NOTES:

 Throughout this guide, the terms Windows, Linux, Solaris, and

Macintosh refer to all the respective supported operating systems unless

otherwise noted.

 For specific service packs (SPs) and OS updates, refer to the

descriptions where this software version is posted on the QLogic Web site: http://support.qlogic.com

System Requirements

The system requirements for SANsurfer FC/CNA HBA CLI are described in the following sections:

 “Hardware Requirements” on page 1-4  “Software Requirements” on page 1-5

Hardware Requirements

The minimum hardware requirements are as follows:

 QLogic adapters (see “Supported QLogic Adapters” on page 1-2).

 Single- or multiprocessor server or workstation:

 Pentium

Server 2003, Windows XP Professional, Linux, and Solaris.

 Windows Vista and Windows Server 2008—Use the minimum

requirements from Microsoft.

 Power Mac

 FC devices, such as disks and RAID subsystems.

 QLogic FC adapters.

SANsurfer FC/CNA HBA CLI supports most FC devices. For a complete list of devices that support failover, see the QLogic SAN Interoperability Guide, which you can download from the QLogic Web site:

http://connect.qlogic.com/interopguide/Interoperability.asp

NOTE:

Tape devices are shown as part of the configuration, but are not fully supported by SANsurfer FC/CNA HBA CLI. Only persistent binding and LUN masking are available.

III with 450 MHz or greater for Windows 2000, Windows

G5 1.8 MHz or greater with 512 MB of memory.

1-4 SN0054614-00 K

 256 MB physical RAM are required to run SANsurfer FC/CNA HBA CLI;

running with less memory can cause disk swapping (“paging” or “paging out”), which severely affects performance.

 Video card capable of 256 colors and a screen resolution of 800x600 pixels.

 About 7 MB of disk space.

Software Requirements

The minimum software requirements are as follows:

 QLogic drivers for your OS platform.  Administrative privileges to perform management functions.  One of the operating systems listed in “Supported Operating Systems” on

page 1-3.

Unsupported Features

Depending on your system, not all SANsurfer FC adapter features are available.

Features Not Available When Running Windows Driver with NPIV Enabled

When running the driver with NPIV enabled on Windows, the following features are not available with virtual ports:

1–Installation and Removal

System Requirements

 Adapter parameters settings  Adapter parameters restore default  Flash update from file  Flash save to file  Adapter parameters update from file  Adapter parameters save to file  Adapter parameters update from templates  Target link speed  Boot device settings  Driver settings  Adapter beacon  Target/LUN list

Features Not Available When Running IOCTL Module Driver

When running the input/output control (IOCTL) module driver on a Linux OS, the following features are not available:

 Persistent binding  Selective LUN  Adapter port statistics  Driver settings  Host topology

SN0054614-00 K 1-5

1–Installation and Removal Downloading the Installation Package

Features Not Available When Running Linux with Converged Network Adapters

When running Linux OS with converged network adapters (QLE81xx and QMI81xx), the following features are not available:

 Support for inbox driver only; no driver update support  Persistent binding  Adapter port statistics  iiDMA support  Loopback test

Features Not Available When Running Sysfs Inbox Driver

When running the Sysfs Inbox driver on a Linux OS, the following features are not available:

 Persistent binding  Selective LUN  Adapter port statistics  Driver settings  Host topology  Link status  Loopback test

Features Not Available When Running VMware Driver

When running the VMware driver on a Linux OS, the following features are not available with virtual ports:

Downloading the Installation Package

Follow these steps to download the SANsurfer FC/CNA HBA CLI installation package from the QLogic Web site.

To download the installation package:

1. From the QLogic home page (www.qlogic.com

2. On the Driver Downloads / Manuals page, select Fibre Channel HBAs, your adapter model, and operating system, and then click Go!

), click the Downloads tab.

1-6 SN0054614-00 K

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

Figure 1-1 shows an example.

Figure 1-1 Selecting Adapter Model (Example)

The resources page for the selected model appears.

3. Under Management Tools, click SANsurfer CLI....

The End User Software License Agreement page appears.

4. Scroll to the bottom and click Agree.

5. On the File Download dialog box, click Save. Select a directory on your system and download the file.

Installing SANsurfer FC/CNA HBA CLI

NOTE:

If you have a previous version of SANsurfer FC HBA CLI already installed, the installation program (except on Solaris) provides the option to upgrade the previous version to this latest version. However, QLogic recommends

that you always uninstall any older version of SANsurfer before installing the new version.

Follow the installation instructions in the section that corresponds to your operating system (OS):

 “Windows Installation” on page 1-8  “Linux Installation” on page 1-14  “Solaris Installation” on page 1-15  “Macintosh Installation” on page 1-18  “VMware Installation” on page 1-20

SN0054614-00 K 1-7

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

Windows Installation

To install SANsurfer FC/CNA HBA CLI on Windows, follow either the GUI or command line installation steps:

 “Standard (GUI) Installation” on page 1-8  “Command Line Installation” on page 1-12

Standard (GUI) Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a Windows operating system using the standard (GUI) method.

To install SANsurfer FC/CNA HBA CLI on Windows (GUI):

1. Locate and double-click the installer package.

The Preparing to Install dialog box appears, as shown in Figure 1-2. The status bar indicates that the installation package is loading.

Figure 1-2 Preparing to Install Dialog Box

1-8 SN0054614-00 K

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

After the install package is loaded, the Welcome dialog box appears as shown in Figure 1-3.

Figure 1-3 Welcome Dialog Box

2. Read the information, and then click Next.

SN0054614-00 K 1-9

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

The Choose Destination Location dialog box appears as shown in

Figure 1-4.

Figure 1-4 Choose Destination Location Dialog Box

3. In the Choose Destination Location dialog box, do one of the following:

 To select the destination location in the dialog box, click Next

(recommended). The default location for a Windows system is:

Program Files\QLogic Corporation\SANsurferCLI

 To select a different location:

a. Click Browse.

b. Select an installation location.

c. The Choose Destination Location dialog box reappears. Click

Next.

1-10 SN0054614-00 K

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

The Ready to Install the Program dialog box appears as shown in

Figure 1-5.

Figure 1-5 Ready to Install the Program Dialog Box

4. Read the information, and then click Install.

The Setup Status dialog box appears as shown in Figure 1-6.

Figure 1-6 Setup Status Dialog Box

SN0054614-00 K 1-11

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

If you want to stop the installation, click Cancel.

The InstallShield Wizard Complete dialog box appears as shown in

Figure 1-7.

Figure 1-7 InstallShield Wizard Complete DIalog Box

5. (Optional.) Select one of the following:

 If you want to see more information about SANsurfer FC/CNA HBA

CLI, select the I would like to view the README file check box.

 If you want to start SANsurfer FC/CNA HBA CLI, select the I would

like to launch SANsurfer FC CLI check box.

6. Click Finish.

Command Line Installation

To install SANsurfer FC/CNA HBA CLI using the command line installation, follow the steps for either standard or silent installation:

 “Standard Command Line Installation” on page 1-13  “Silent Command Line Installation” on page 1-13

1-12 SN0054614-00 K

Standard Command Line Installation

Type the following text for a standard installation of SANsurfer FC/CNA HBA CLI on a Windows operating system, where xx indicates the version of SANsurfer FC/CNA HBA CLI:

scli-1.x.x.xx.windows.exe

By default, SANsurfer FC/CNA HBA CLI is installed in the following directory:

Program files\QLogic Corporation\SANsurferCLI

If you want to change the default location, enter the directory in the command line; for example:

scli-1.x.x-xx.windows.exe installdir="c:\sansurfercli"

Silent Command Line Installation

The command for a silent installation is the same as for a standard installation (see “Standard Command Line Installation” on page 1-13), with the addition of the command parameters listed in Table 1-1. Examples using these parameters follow the table.

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

Table 1-1. Windows Command Line Installation Parameters

Parameter Meaning Description

/s Silent mode For an InstallScript MSI or InstallScript project, the command

/f1 Specify alternative

Record mode

response file name

To run the SANsurfer FC/CNA HBA CLI installation package in silent mode, first run scli-1.x.x-xx.windows.exe with the /r parameter to generate a response file, which stores information about the data entered and options selected at run time. By default, the response file is created inside the system's Windows folder. To specify an alternative response file name and location, use the /f1 parameter.

scli-1.x.x-xx.windows.exe /s runs the installation in silent mode, based on the responses contained in the Setup.iss file, located in the same directory. (Response files are created by running Setup.exe with the /r option). To specify an alternative file name or location of the response file, use the /f1 parameter.

This parameter allows you to specify the name and location of the response file.

The /f1 parameter is available when creating a response file (with the /r option) and when using a response file (with the /s option).

SN0054614-00 K 1-13

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

Table 1-1. Windows Command Line Installation Parameters (Continued)

Parameter Meaning Description

/f2 Specify alternative log

file name

Table Notes

InstallScript and InstallScript MSI projects only.

To create a response file for a silent installation of SANsurfer FC/CNA HBA CLI, enter the following:

scli-1.x.x-xx.windows.exe /r /f1"C:\Temp\install_1.iss"

To run the installation in silent mode with a log file, enter the following:

scli-1.x.x-xx.windows.exe /s /f1"C:\Temp\install_2.iss"

To run the installation in silent mode with an alternate file in a temporary directory, enter the following:

scli-1.x.x-xx.windows.exe /s /f1"C:\Temp\install_1.iss" /f2"C:\Temp\install_3.log"

When running an InstallScript MSI or InstallScript installation in silent mode (using the /s parameter), the log file Setup.log is created in the same directory and with the same name (except for the extension) as the response file. The /f2 parameter allows you to specify an alternative log file location and file name.

NOTE:

After installing SANsurfer FC/CNA HBA CLI, you can create an uninstallation script for future use by creating a response file with a different name. For example:

scli-1.x.x-xx.windows.exe /r /f1"C:\Temp\uninstall.iss"

Linux Installation

To install SANsurfer FC/CNA HBA CLI on a Red Hat/SUSE Linux operating system, follow these steps:

To install SANsurfer FC/CNA HBA CLI on Linux:

1. From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to your local machine following file:

scli-x.xx.xx-xx.i386.rpm.gz

Where x.xx.xx-xx specifies the current version of SANsurfer FC/CNA HBA CLI.

1-14 SN0054614-00 K

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

2. Decompress the file with the following command:

gunzip <file name>

3. Enter the following command to install the package:

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

NOTE:

For SUSE SLES IA64, the command line is:

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

The new package is installed in the following directory:

/opt/QLogic_Corporation/SANsurferCLI

To query for the installed SANsurfer FC/CNA HBA CLI package name, enter the following text from the command line:

rpm -q scli

Solaris Installation

To install SANsurfer FC/CNA HBA CLI on Solaris, follow the steps in one of these sections:

 “Solaris SPARC 8, 9, 10 Installation” on page 1-15  “Solaris x86 9 and 10 Installation” on page 1-17

Solaris SPARC 8, 9, 10 Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a Solaris SPARC 8, 9, or 10 operating system.

To install SANsurfer FC/CNA HBA CLI on Solaris 8, 9, or 10:

1. From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to a temporary directory (for example, /tmp) on your machine the following file:

scli-x.xx.xx-xx.sparc.Solaris.pkg

NOTE:

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

SN0054614-00 K 1-15

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

2. To see the available package file, type the following:

# ls

The available packages appear. For example:

# scli-x.xx.xx-xx.sparc.Solaris.pkg

3. To install SANsurfer FC/CNA HBA CLI, type the following:

# pkgadd -d scli-x.xx.xx-xx.sparc.Solaris.pkg

4. You are prompted to select a package. For example:

The following packages are available: 1 QLScli QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility)

(sparc) x.xx.xx Build xx Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]: Enter 1 to proceed with the installation.

5. The pkgadd program does a series of checks, and then posts a script warning and asks whether to continue the installation. For example:

Processing package instance <QLScli> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc) x.xx.xx Build xx QLogic Corporation ## Executing checkinstall script. Using </> as the package base directory. ## Processing package information. ## Processing system information. 39 package pathnames are already properly installed. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of <QLScli> [y,n,?] To continue, type y, then press

ENTER

6. Messages appear showing what files have been installed. The system shows a final message when installation is complete. For example:

Installing QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) as <QLScli> ## Installing part 1 of 1. /opt/QLogic_Corporation/SANsurferCLI/adapters.properties

1-16 SN0054614-00 K

/opt/QLogic_Corporation/SANsurferCLI/libs/libqlsdm.so /opt/QLogic_Corporation/SANsurferCLI/menu.properties /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2

2.dat /opt/QLogic_Corporation/SANsurferCLI/nvramdefs/default/nvram2

3.dat . . . Installation of <QLScli> was successful.

Solaris x86 9 and 10 Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a Solaris x86 9 or 10 operating system.

To install SANsurfer FC/CNA HBA CLI on Solaris x86 9 or 10:

1. From the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to a temporary directory (for example, /tmp) on your machine the following file:

scli-x.xx.xx-xx.x86.Solaris.pkg

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

NOTE:

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

2. To decompress the file, type the following:

# uncompress scli-x.xx.xx-xx.x86.Solaris.pkg

3. To see the available package file, type the following:

# ls

The available packages appear. For example:

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

4. To install SANsurfer FC/CNA HBA CLI, type the following:

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

5. You are prompted to select a package. For example:

The following packages are available: 1 QLSclix QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility)

(i386) x.xx.xx Build xx

SN0054614-00 K 1-17

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

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

Enter 1 to proceed the installation.

6. Type the number that corresponds to your operating system, and then press ENTER

The pkgadd program does a series of checks, posts a script warning, and asks whether to continue the installation. For example:

Processing package instance <QLSclix> from </space/chuynh/scli/qlogic/Solaris/pkgs/x> SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc)

1.xx.xx (Build xx Solaris 8-10) QLogic Corporation ## Executing checkinstall script. ## Processing package information. ## Processing system information. 3 package pathnames are already properly installed. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. . . . [ verifying class <none>] ## Executing postinatall script. Installation of <QLSclix> was successful.

Macintosh Installation

To install SANsurfer FC/CNA HBA CLI on a Macintosh system, follow either the standard GUI or command line installation method:

 “Standard (GUI) Installation” on page 1-18  “Command Line Installation” on page 1-19

Standard (GUI) Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a Macintosh using the standard GUI method.

To install SANsurfer FC/CNA HBA CLI on Macintosh (GUI):

1. You must have Admin privileges to install SANsurfer FC/CNA HBA CLI. To verify/enable Admin privileges, go to System Preferences, select Account, and then Security Tab. Make sure the Allow user to administer this computer check box is selected.

2. Download the SCLI zip file with Safari™ or other browser.

1-18 SN0054614-00 K

3. When the download has finished, StuffIt® expands the zip file to a tar file onto the desktop.

4. Double-click the SCLI tar file icon to create the SCLI pkg file.

5. Double-click the SCLI pkg file icon.

6. Follow the Installer menu.

The installation directory is:

$HOME/Applications/QLogic_Corporation/SANsurferCLI

where $HOME is root.

7. After the installation process has finished, you can delete the SCLI pkg and tar files.

Command Line Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a Macintosh using the command line method.

1–Installation and Removal

Installing SANsurfer FC/CNA HBA CLI

To install SANsurfer FC/CNA HBA CLI on Macintosh (command line):

1. Download the SCLI install package for Mac OS x (compressed tar file) to a local directory.

2. Decompress the file by typing the following command:

tar -zxvf <file>.tgz

For example:

qlogic:~ root#tar -zxvf scli-x.x.x-x.macos.pkg.tgz ./scli-x.x.x-x.pkg/ ./scli-x.x.x-x.pkg/Contents/ ./scli-x.x.x-x.pkg/Contents/Archive.bom ./scli-x.x.x-x.pkg/Contents/Archive.pax.gz ... ...

This command extracts the compressed file to a directory named scli-x.x.x-x.pkg.

3. Install the package to the default directory. For example:

installer -pkg scli-x.x.x-x.pkg -target /

This command installs the product in the default Applications directory:

/var/root/Applications/QLogic_Corporation/SANsurferCLI

SN0054614-00 K 1-19

1–Installation and Removal Installing SANsurfer FC/CNA HBA CLI

If this is the first time you are installing SANsurfer FC/CNA HBA CLI, the system shows the following messages:

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

If there is a previous version of SANsurfer FC/CNA HBA CLI on the system, the installer automatically runs an update operation. For example:

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

VMware Installation

Follow these steps to install SANsurfer FC/CNA HBA CLI on a system running VMware ESX 3.5.

To install SANsurfer FC/CNA HBA CLI on VMware ESX 3.5:

1. From either the QLogic Web site or the SANsurfer for FC and FCoE Adapters CD-ROM, download to your local machine the following file:

scli-x.xx.xx-xx.i386.rpm.gz

Where x.xx.xx stands for the current version of SANsurfer FC/CNA HBA CLI.

2. Decompress the file using the following command:

gunzip <file name>

3. Install the package using the following command:

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

The new package is installed in the following directory:

/opt/QLogic_Corporation/SANsurferCLI

4. (Optional) To query for the installed SANsurfer FC/CNA HBA CLI package name, enter the following from the command line:

1-20 SN0054614-00 K

rpm -q scli

1–Installation and Removal

Uninstalling SANsurfer FC/CNA HBA CLI

Refer to the following sections for the appropriate procedure to uninstall SANsurfer FC/CNA HBA CLI from your system:

 “Windows Uninstall” on page 1-21  “Linux Uninstall” on page 1-22  “Solaris Uninstall” on page 1-22  “Macintosh Uninstall” on page 1-24  “VMware Uninstall” on page 1-24

Windows Uninstall

To uninstall SANsurfer FC/CNA HBA CLI, use either the standard GUI or command line method:

 “Standard (GUI) Uninstall” on page 1-21  “Command Line Uninstall” on page 1-21

Standard (GUI) Uninstall

Follow these steps to uninstall SANsurfer FC/CNA HBA CLI on Windows using the GUI method.

To uninstall SANsurfer FC/CNA HBA CLI on Windows (GUI):

1. From the Control Panel, click Add or Remove Programs.

2. Highlight SANsurfer FC/CNA HBA CLI.

3. Click Remove. No re-boot is required.

Alternately, invoke scli-1.x.x-xx.windows.exe and select the option to

Remove all installed features.

Command Line Uninstall

Follow these steps to uninstall SANsurfer FC/CNA HBA CLI on Windows using the command line method.

To uninstall SANsurfer FC/CNA HBA CLI on Windows (command line):

1. At a command line prompt, type the following:

scli-1.x.x-x.windows.exe /uninst /s

2. If you created an uninstall script in “Silent Command Line Installation” on

page 1-13, you can uninstall SANsurfer FC/CNA HBA CLI in silent mode by

type the following:

scli-1.x.x-x.windows.exe /s /f1”C:\Temp\uninstall.iss"

SN0054614-00 K 1-21

1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI

Linux Uninstall

To uninstall SANsurfer FC/CNA HBA CLI on a Linux system, go to the command line and type one of the following commands, where x.xx.xx is the current version of CLI:

rpm -e scli-x.xx.xx-xx rpm -e scli

To query for the installed SANsurfer FC/CNA HBA CLI package name, type the following text from the command line:

rpm -q scli

Solaris Uninstall

To uninstall SANsurfer FC/CNA HBA CLI on a Solaris system, follow one of these procedures:

 “Solaris SPARC 8, 9, and 10 Uninstall” on page 1-22  “Solaris x86 8, 9, and 10 Uninstall” on page 1-23

Solaris SPARC 8, 9, and 10 Uninstall

Follow these steps to uninstall SANsurfer FC/CNA HBA CLI.

To uninstall SANsurfer FC/CNA HBA CLI on Solaris SPARC 8, 9, and 10:

1. Type the following:

# pkgrm QLScli

2. The program shows the package name and a script warning asking whether to continue the uninstall process. For example:

The following package is currently installed: QLScli QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (sparc) 1.x.x Build xx Do you want to remove this package?

3. Type y and then press asking whether to continue the uninstall process. For example:

## Removing installed package instance <QLScli> This package contains scripts which will be executed with super-user permission during the process of removing this package Do you want to continue with the removal of this package [y,n,?,q]

ENTER

. The program shows a script warning

4. Type y and then press

ENTER

. The pkgrm program notifies you when the

uninstall process is complete. For example:

1-22 SN0054614-00 K

## Verifying package dependencies.

## Processing package information. ...

/opt/QLogic_Corporation/SANsurferCLI/adapters.properties /opt/QLogic_Corporation/SANsurferCLI ## Executing postremove script. scli removed. Menu property file removed. Adapter property file removed. SCLI property file removed. ## Updating system information. Removal of <QLScli> was successful.

Solaris x86 8, 9, and 10 Uninstall

Follow these steps to uninstall SANsurfer FC/CNA HBA CLI on a Solaris system.

To uninstall SANsurfer FC/CNA HBA CLI on Solaris x86 8, 9, and 10:

1. Type the following to remove SANsurfer FC/CNA HBA CLI:

# pkgrm QLSclix

1–Installation and Removal

Uninstalling SANsurfer FC/CNA HBA CLI

2. The program shows the package name and a script warning asking whether to continue the uninstall process. For example:

The following package is currently installed: QLSclix QLogic SANsurfer FC/CNA HBA CLI (HBA Configuration Utility) (x86) 1.x.x Build xx Do you want to remove this package?

3. Type y and then press

ENTER

. The program shows a script warning

asking whether to continue the uninstall process. For example:

## Removing installed package instance <QLSclix> This package contains scripts which will be executed with super-user permission during the process of removing this package Do you want to continue with the removal of this package [y,n,?,q]

4. Type y and then press

ENTER

. The pkgrm program notifies you when the

uninstall process is complete. For example:

## Verifying package dependencies. ## Processing package information. ... /opt/QLogic_Corporation <shared pathname not removed> /opt <shared pathname not removed> ## Executing postremove script. scli removed. Menu property file removed. Adapter property file removed.

SN0054614-00 K 1-23

1–Installation and Removal Uninstalling SANsurfer FC/CNA HBA CLI

SCLI property file removed. ## Updating system information. Removal of <QLSclix> was successful.

Macintosh Uninstall

Uninstalling SANsurfer FC/CNA HBA CLI is not necessary for Mac OS X; the native installer automatically updates the product whenever it detects a change in the product version.

To manually uninstall SANsurfer FC/CNA HBA CLI, delete its folder and any references to the SANsurfer installer package(s) in the /Library/Receipts directory. For example:

rm -rf /Library/Receipts/scli-x.x.x-x.pkg

NOTE:

You must be in the root directory or have root/admin privileges to do this operation.

VMware Uninstall

To uninstall SANsurfer FC/CNA HBA CLI on a VMware ESX 3.5 system, go to the command line and type one of the following commands, where x.xx.xx is the current version of the CLI:

rpm -e scli-x.xx.xx-xx

rpm -e scli

To query for the installed SANsurfer FC/CNA HBA CLI package name, enter the following command:

rpm -q scli

1-24 SN0054614-00 K

2 Getting Started

This chapter provides the following sections to help you get started using SANsurfer FC/CNA HBA CLI:

 “Starting Interactive Mode” on page 2-1  “Starting Non-Interactive Mode” on page 2-4  “Terminology” on page 2-9  “Advanced Features” on page 2-10

SANsurfer FC/CNA HBA CLI Modes

SANsurfer FC/CNA HBA CLI operates in two modes:

 Interactive (menu-driven). The CLI starts and prompts for user input. Based

on the input, the CLI executes the specified commands until terminated by the user. Use this mode to do multiple operations. 3 Interactive Commands covers this interface.

 Non-interactive (command line). The CLI starts, executes the functions

defined by the list of parameters provided, and then terminates. Use this mode to run SANsurfer FC/CNA HBA CLI from a script file or when you want to do a single operation. 4 Non-Interactive Commands covers this interface.

SANsurfer FC/CNA HBA CLI is not case sensitive in either mode. However, file names in some operating systems are case sensitive; in this case, SANsurfer FC/CNA HBA CLI is case sensitive for that specific file.

Starting Interactive Mode

To start SANsurfer FC/CNA HBA CLI in interactive mode, use one of these methods:

 For Windows, click the SANsurfer FC/CNA HBA CLI icon on the desktop.

 For Linux or Solaris, open a command window and type one of the following:

scli INT scli

SN0054614-00 K 2-1

2–Getting Started Starting Interactive Mode

NOTE:

When starting SANsurfer FC/CNA HBA CLI from a Solaris console serial port connection, the CLI may take a long time to come up. To resolve this issue, specify the INT flag, as shown in the preceding bullet.

 For Mac OS X, follow these steps:

1. Double-click the SANsurfer FC/CNA HBA CLI (SCLI) icon.

2. A terminal window opens. SCLI (interactive mode) scans the host for

3. Run SCLI commands as required.

4. When finished, return to the main menu, and type the indicated

5. Close the terminal window.

QLogic adapters and SAN storage.

number to exit SANsurfer FC/CNA HBA CLI.

The Main Menu appears as shown in the following:

SANsurfer FC/CNA HBA CLI v1.x.x Build xx

Main Menu

1: General Information 2: HBA Information 3: HBA Parameters 4: Target/LUN List 5: Target Link Speed or 5: iiDMA Settings 6: Target Persistent Bindings 7: Selective LUNs 8: Boot Device 9: Driver Settings 10: Utilities 11: Beacon 12: Diagnostics 13: Statistics 14: Help or 14: Virtual 15: Exit or 15: QoS (if supported by adapter)

or 16: FCoE (if supported by adapter) or 17: Help or 18: Exit

(if supported by adapter)

2-2 SN0054614-00 K

2–Getting Started

Starting Interactive Mode

NOTE:

Selections on the Main Menu are dynamic, and what you see depends on your system’s operating system, drivers, and adapter type. Based on your specific system, this menu may contain different items. For example:

 Selection 5: may be either Target Link Speed or iiDMA Settings.

 The Virtual menu selection is available only on Windows systems

running with a driver that supports NPIV (N_Port ID virtualization).

 The QoS menu selection is available only on Windows systems with an

8Gb adapter.

 The FCoE menu selection is available only if an FCoE or converged

network adapter is present.

 For a converged network adapter with an inbox driver, the Main Menu

contains only these options:

Main Menu

1: General Information 2: HBA Information 3: HBA Parameters 4: Target/LUN List 5: Boot Device 6: Utilities 7: Beacon 8: Diagnostics

9: FCoE 10: Help 11: Exit

Depending on which menu you select, may prompt you for more input. For example, if you select HBA Parameters, SANsurfer FC/CNA HBA CLI prompts you for the port number that corresponds to the adapter model you want to view.

NOTE:

 The Driver Update option under Utilities (option 10) is only available on

Windows.

 In Solaris SPARC, the option to Save/Update BIOS is Save/Update

FCode.

SN0054614-00 K 2-3

2–Getting Started Starting Non-Interactive Mode

Starting Non-Interactive Mode

To start SANsurfer FC/CNA HBA CLI in non-interactive mode, type the following in a command window:

scli <parameters>

SANsurfer FC/CNA HBA CLI executes the command options, and then terminates.

To list all of the available command line parameters and the SANsurfer FC/CNA HBA CLI version, type one of the following:

scli -h scli -?

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

# scli -e 0 "?"

CLI

Option

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

The following input formats are both valid for the WWNN and WWPN:

20-00-00-E0-8B-01-83-C4 200000E08B0183C4

The following inputs are valid for the port ID:

68-5C-AB 685CAB

All command line options must be preceded by the dash (–) or forward slash (/) notation. Most options have a corresponding menu selection in interactive mode.

Table 2-1 lists all valid command line options, shows the corresponding menu

selection by OS, and provides a description and cross-reference.

Table 2-1. Non-interactive Mode Options

Interactive

(Windows)

Menu (Red

Hat/SUSE

Linux,

Solaris

Interactive

(Macintosh)

Description

See User Guide

Section

SPARC)

-a 11 11 11 Flash adapter beacon “-a (View or Tog-

gle Beacon Status)” on page 4-6

2-4 SN0054614-00 K

CLI

Option

Table 2-1. Non-interactive Mode Options (Continued)

Interactive

(Windows)

Interactive Menu (Red

Hat/SUSE

Linux,

Solaris

SPARC)

Interactive

(Macintosh)

Starting Non-Interactive Mode

Description

2–Getting Started

See User Guide

Section

-b 10 10 — Save/update

BIOS/FCode

-c 2 2 2 Show adapter set-

tings

-cna 16 16 16 View and modify con- verged network adapters

-d 10 — 10 Update driver “-d (Update Device

-dm 12 12 12 Transceiver details “-dm (Display Diag-

-e 8 8 8 Boot device settings “-e (Boot Device

a b

“-b (Save or Update the Flash BIOS or FCode)” on page 4-7

“-c (Show Parameter Settings)” on page 4-8

“-cna (FCoE Utilities Menu for QLx81xx Adapters)” on page 4-8

Driver)” on page 4-10

nostics Monitoring Info)” on page 4-10

View | Select | Disable)” on page 4-11

-f — — — Input from a file “-f (Input Parame-

ter Options from a Text File)” on page 4-13

-fg 9 9 9 View driver settings “-fg (Show Driver

Settings)” on page 4-16

-fs 99 9Driver settings“-fs (Configure

Driver Settings)” on page 4-16

— 10 10 10 Adapter utilities —

SN0054614-00 K 2-5

2–Getting Started Starting Non-Interactive Mode

Table 2-1. Non-interactive Mode Options (Continued)

CLI

Option

Interactive

(Windows)

Interactive Menu (Red

Hat/SUSE

Linux,

Solaris

SPARC)

Interactive

(Macintosh)

Description

See User Guide

Section

-g 1 1 1 Show system infor- mation

-gs 13 13 13 Adapter statistics “-gs (Show HBA

-h

-ha 2 2 2 Adapter alias “-ha (Set | Delete

-i 2 2 2 Show adapter infor-

-kl 12 12 12 Loopback test “-kl (Loopback

Show usage

mation

“-g (Display System Information)” on page 4-18

Statistics)” on page 4-18

“-h (Help)” on page 4-19

HBA Alias)” on page 4-19

“-i (Display HBA General Information or VPD Information for One or All HBAs)” on page 4-20

Tes t ) ” o n page 4-20

-kr 12 12 12 Read/write buffer test “-kr (Run

Read/Write Buffer Tes t ) ” o n page 4-27

-l 4 4 4 Show LUN list “-l (Display LUN

Info)” on page 4-32

-ls 13 13 13 Show Link status “-ls (Display Link

Status)” on page 4-32

-m 7 7 7 Selective LUNs “-m (View, Enable,

or Disable LUNs)” on page 4-33

2-6 SN0054614-00 K

CLI

Option

Table 2-1. Non-interactive Mode Options (Continued)

Interactive

(Windows)

Interactive Menu (Red

Hat/SUSE

Linux,

Solaris

SPARC)

Interactive

(Macintosh)

Starting Non-Interactive Mode

Description

2–Getting Started

See User Guide

Section

-n 3 3 3 Configure adapter

settings

-o 1 1 1 Output to a file “-o (Output to a

-p 6 6 6 Target persistent

binding

-pa 2 2 2 Adapter port alias “-pa (Define Port

-pl — 6 — Persistent device

names

-q 5 5 5 Target link speed “-q (View or Set

-qos 15 — — Quality of service “-qos (QoS Menu)”

“-n (Set Selected HBA Parameter)” on page 4-35

File)” on page 4-37

“-p (Display Persistent Target Binding Info)” on page 4-38

Alias)” on page 4-40

“-pl (Show, Add, and Delete Persistent Names)” on page 4-41

Target Link Speed)” on page 4-42

on page 4-43

-r — — — Save/update NVRAM “-r (Update HBA

Parameters)” on page 4-44

—1 1 1Refresh —

— 15 (16) 15 (16) 15 (16) Quit —

-s — — — Silent mode “-s (Silent Mode)”

on page 4-45

-t 4 4 4 Show device list “-t (Display Target

Information)” on page 4-45

SN0054614-00 K 2-7

2–Getting Started Starting Non-Interactive Mode

Table 2-1. Non-interactive Mode Options (Continued)

Interactive Menu (Red

Hat/SUSE

Linux,

Solaris

Interactive

(Macintosh)

Description

See User Guide

Section

CLI

Option

Interactive

(Windows)

SPARC)

-tb 11 11 11 Flash target beacon “-tb (Target Bea-

con On/Off)” on page 4-46

-tp 1 1 1 Show host topology “-tp (Display Host

Topology)” on page 4-46

-u 10 10 10 Update or save firm- ware preload area

“-u (Firmware Area Update/Save)” on page 4-46

-v — — — Show version “-v (Display Ver-

sion)” on page 4-47

-vp 14 14 —

Virtual ports

“-vp (Virtual Port)” on page 4-47

-x 1 1 1 Output in XML format “-x (Output in XML

Format 1)” on page 4-48

-z 2 2 2 Show all information for one or all adapters

“-z (Display All HBA information for One or All HBAs)” on page 4-49

Table Notes

Windows, Linux, Solaris x86

Solaris SPARC

Windows or Solaris systems running driver that supports NPIV (excluding QLE8042 adapter)

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

2-8 SN0054614-00 K

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

description of command entered Usage: <current command use usage>

Terminology

Some of the terms used in this guide are similar and some have changed slightly as technology changes. The following definitions apply:

adapter port

Adapter port refers to the actual physical port on an adapter. For example, a QLA2462 has two ports called HBA port 1 and HBA port 2.

2–Getting Started

Terminology

adapter instance, adapter instance number, or adapter port instance

When you install adapter in a system with other adapters, each adapter port gets assigned a number by the driver or API so it knows which adapter to communicate with. This assigned number might be called adapter instance, adapter instance number, or adapter port instance.

adapter alias

When an alias is assigned to a physical adapter, no matter how many ports that adapter has, the adapter alias refers to the adapter, not one of its ports.

port alias

You can also assign an alias to an individual port on an adapter. This port alias refers to only that port and none other.

Thus, an adapter can only have one adapter alias, but each port on that adapter must have a unique port alias.

SN0054614-00 K 2-9

2–Getting Started Advanced Features

Advanced Features

SANsurfer FC/CNA HBA CLI adds the following advanced features to its toolset:

N_Port ID virtualization (NPIV). NPIV (N_Port ID virtualization) allows you

to make the most of your server and Fibre Channel fabric. For instance, you can partition your server to support multiple operating systems at the same time, maximizing server utilization. By creating virtual ports from a single physical adapter port, you allow multiple initiators. SANsurfer FC/CNA HBA CLIfacilitates creating multiple virtual ports from a single physical adapter port.

NOTE:

NPIV is available only for Windows and Solaris operating systems and 4Gb and greater adapters.

Quality of service (QoS). QoS refers to service level agreement (SLA) to

ensure business continuity when transmitting data over virtual ports by either setting priorities or allocating bandwidth. SANsurfer FC/CNA HBA CLI provides an easy-to-use interface that lets you either assign QoS to virtual ports by setting priorities (which eventually translates to IOPS) or allocating bandwidth to them.

 Setting the QoS by bandwidth lets you allocate up to 80% of the number of

gigabits per second (Gbps) transmission speed of the physical port's capacity to its defined virtual ports (NPIV). Using this feature lets you guarantee a transmission rate for each virtual port that requires a specific bandwidth to run mission-critical applications for business continuity using virtual ports. The setting for a given QoS can resolve bottlenecks that exist when virtual machines contend for port bandwidth on the same server.

 Setting the QoS by priority lets you set the priority level for the defined

virtual ports. This enables to you give preference to data transmissions for one virtual port over others by giving it a higher priority than the others. You can set the priority level on any virtual port, regardless of the settings applied to other virtual ports.

NOTE:

QoS is available only for Windows operating systems and 8Gb adapters. On Windows Server 2008, MSI-X must be enabled.

2-10 SN0054614-00 K

3 Interactive Commands

This chapter describes the interactive mode command line options for specific QLogic FC adapters. The interactive mode uses a series of menus from which you select the option you want and enter the number for that option. (For information on non-interactive mode operation—in which you simply enter a one- or two-letter code to perform operations on the adapter—refer to 4 Non-Interactive

Commands.)

This chapter covers the following options available (depending on your system setup) on the main menu:

 “General Information Menu (Command Line Option -g)” on page 3-4

 “HBA Information Menu (Command Line Option -i)” on page 3-19

 “HBA Parameters Menu” on page 3-24

 “Target/LUN List Menu (Command Line Options -t and -l)” on page 3-36

 “Target Link Speed or iiDMA Settings Menu (Command Line Option -q)” on

page 3-47

 “Target Persistent Bindings Menu (Command Line Option -p)” on page 3-54

 “Selective LUNs Menu (Command Line Option -m)” on page 3-58

 “Boot Device Menu (Command Line Option -e)” on page 3-60

 “Driver Settings Menu (Command Line Option -fg)” on page 3-62

 “Utilities Menu” on page 3-64

 “Beacon Menu” on page 3-75

 “Diagnostics Menu (Command Line Options -kl, -kr, and -dm)” on page 3-76

 “Statistics Menu (Command Line Options -gs and -ls)” on page 3-89

 “Virtual Menu (Command Line Option -vp)” on page 3-97

 “QoS Menu (Command Line Option -qos)” on page 3-101

 “FCoE Menu (Command Line Option -cna)” on page 3-108

 “Help Menu (Command Line Option -h)” on page 3-120

SN0054614-00 K 3-1

3–Interactive Commands

Starting Interactive Mode

To start the interactive mode, type one of the following:

[ scli ]

[ scli int]

(on some Solaris installations)

When you start SANsurfer FC/CNA HBA CLI in interactive mode, the Main Menu appears as follows:

Main Menu

or 16: FCoE (if supported by adapter) or 17: Help or 18: Exit

(if supported by adapter)

3-2 SN0054614-00 K

3–Interactive Commands

NOTES:

 Selection 5: may be either Target Link Speed or iiDMA Settings.

 The Virtual menu selection is available only on Windows systems

running with a driver that supports NPIV (N_Port ID virtualization).

 The QoS menu selection is available only on Windows systems with an

8Gb adapter.

 The FCoE menu selection is available only if an FCoE or converged

network adapter is present.

 For a converged network adapter with an inbox driver, the Main Menu

contains only these options:

Main Menu

1: General Information 2: HBA Information 3: HBA Parameters 4: Target/LUN List 5: Boot Device 6: Utilities 7: Beacon 8: Diagnostics

9: FCoE 10: Help 11: Exit

Selections from the Main Menu open new menus. For example, if you enter option 1 (General Information) on the main interactive menu, the system shows a new menu, the General Information Menu. From this menu you have several choices including 1: Host Information, 2: Host Topology, and so forth. On every menu you can type the number for Return to Previous Menu and move to the next higher level (parent) menu.

In the remainder of this chapter, you will see a “breadcrumbs” line following most subsection headings. The breadcrumbs line shows you how to access that option; that is, it shows the hierarchical path from the top level to the command under discussion. For example, to reach the Save to Txt File options from the main SANsurfer FC/CNA HBA CLI menu, you would select option 1 to open the General Information menu, 2 to open the Host Topology menu, and then 2 again to see the Save As Txt File options. The following shows the breadcrumbs example:

SN0054614-00 K 3-3

3–Interactive Commands General Information Menu (Command Line Option -g)

1: General Information 2: Host Topology 2: Save As Txt File

General Information Menu

(Command Line Option -g)

1: General Information

This option shows you general information for the adapter.

To see the HBA General Information menu, from the Main Menu, type the number for the General Information option, and then press

The General Information menu contains the following options:

 Host Information (see “Host Information (Command Line Option -g)” on

page 3-4)

 Host Topology (see “Host Topology (Command Line Option -tp |

-topology)” on page 3-5)

 Report (see “Generate Report (Command Line Option -z)” on page 3-10)

ENTER

 Refresh (see “Refresh” on page 3-19)

Host Information

(Command Line Option -g)

1: General Information 1: Host Information

This option shows you host information.

From the Main Menu, type the number for General Information, and then press ENTER

From the General Information Menu, type the number for Host Information, and then press

 Host name

 OS type

 OS version (patches where applicable)

 SDM API version

 A list of adapters including, for each adapter:

ENTER

 Adapter model and serial number (SN)

 Port number  WWPN  Adapter instance number  Status (online/offline)

. Host information includes the following data:

 (Repeats for each adapter)

3-4 SN0054614-00 K

3–Interactive Commands

General Information Menu (Command Line Option -g)

 Total number of QLogic adapters detected

NOTE:

The SAN Device Management (SDM) API is a QLogic-specific library required for SANsurfer FC/CNA HBA CLI. The version number of this library is useful in debugging.

-----------------------------------------------------------------------------Host Name : BRAGI OS Type : Microsoft Windows Svr 2003 Enterprise Ed. x86 OS Version : Service Pack 1 (Build 3790 SDM API Uersion : 1.28.0.50 QLSDM.DLL

-----------------------------------------------------------------------------HBA Model QLA2342 (SN C28750):

Port 1 WWPN 21-00-00-E0-8B-01-43-9B SN B05283 (HBA Instance 0) Online Port 2 WWPN 21-01-00-E0-8B-21-43-9B SN B05283 (HBA Instance 1) Online

HBA Model QLA2300 (SN D825408):

Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 SN D83179 (HBA Instance 2) Loop down Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 SN D83179 (HBA Instance 3) Online

HBA Model QLA2462 (SN FFC0551C34679):

Port 1 WWPN 21-00-00-E0-8B-1F-9D-F0 SN FFC0519U93213 (HBA Instance 4)

Online

Port 2 WWPN 21-01-00-E0-8B-3F-9D-P0 SN FFC0519U93213 (HBA Instance 5) down HBA Model QLA21O (SN C655417):

Port 1 WWPN 21—00—00—E0—8B—1A—3F—E0 SN R61343 (HBA Instance 6) Online

----------------------------------------------------------------------------Total QLogic HBA(s) : 4

Loop

Host Topology

(Command Line Option -tp | -topology)

1: General Information 2: Host Topology

This option shows you the HBA Host Topology menu.

NOTE:

Under Linux, host topology (-tp) is disabled if you are using the IOCTL or sysfs (inbox) driver.

From the General Information Menu, type the number for Host Topology, and then press

 Display

SN0054614-00 K 3-5

ENTER

. When you select this option, the following options appear:

3–Interactive Commands General Information Menu (Command Line Option -g)

 Save As Txt file  Save As XML File

Display (Host Topology) (Command Line Option -tp | -topology)

1: General Information2: Host Topology1: Display

The host topology option shows information about interconnect elements (switches or adapters) and switch ports.

NOTE:

Attached Port means a QLogic adapter, a tape or disk target device, or GBIC connected to a physical port on a switch.

If the interconnect element is a switch:

 Interconnect element (switch)

 Type (Switch or adapter)  World wide name  Domain ID  Management ID  IP address  Model  Symbolic name  Serial number  MAC address  Firmware version  Port count  Beacon status

If the interconnect element is an adapter:

 Interconnect element (adapter)

 Type  World wide node name  World wide port name  Vendor ID  Adapter Model  Adapter Serial Number  Adapter Alias  Port Alias  Driver Version  Firmware Version  Total Number of Devices  Host

3-6 SN0054614-00 K

3–Interactive Commands

General Information Menu (Command Line Option -g)

 Number of Port  Beacon Status  Port Type  Port State

 Port Information (repeats for each port) (Every port may not use all items):

 Physical Port Number (switch or adapter port number), including:

 Port Name (WWPN)  Port State (Online or Loop Down)  Port Type  TX Port Type  Port Module Type

 Attached Port (Repeats for every target/initiator that functions as an

attached port). (Not all items may appear for every port):

 Target/Initiator  Node Name  Port Name  Vendor ID  Product ID (if applicable)  Product Revision (if applicable)  Product Serial Number (if applicable)  Adapter Model (if applicable)  Adapter Serial Number (if applicable)  Adapter Alias (if applicable)  Port Alias (if applicable)  Driver Version (if applicable)  Firmware version (if applicable)  Total number of devices (targets, if applicable)  Host (if applicable)

Here is an example:

================================= = InterConnect Element = ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-03-55-7C World Wide Port Name : 21-00-00-E0-8B-03-55-7C Vendor Id : QLogic Corporation HBA Model : 2200 HBA Serial Number : C28437 HBA Alias : Port Alias : Driver Version : SCSI Miniport 8.1.5.15 (W2K IP) Firmware Version : 2.02.03 Total Number of Devices : 0

SN0054614-00 K 3-7

3–Interactive Commands General Information Menu (Command Line Option -g)

Host : BRAGI Number of Port : 1 Beacon status : Unsupported Port Type : L_Port Port State : Online ================================= = InterConnect Element = ================================= Type : Switch World Wide Name : 10-00-00-C0-DD-00-6A-9F Domain ID : 4 (0x4) Management ID : 0 IP Address : 10.3.10.178 Model : Symbolic Name : Serial Number : MAC Address : Firmware Version : Port Count : 8 Beacon Status : Unsupported ============================= = Port Information = ============================= ============================= Physical Port Number : 1 ============================= Port Name : 20-00-00-C0-DD-00-6A-9F Port state : Offline Port Type : F_Port TX Port Type : Electrical - EL Port Module Type : GBIC ============================= Physical Port Number : 2 ============================= Port Name : 20-01-00-C0-DD-00-6A-9F Port state : Offline Port Type : Vendor Specific/Reserved Port Type. TX Port Type : Electrical - EL Port Module Type : GBIC ======================== = Attached Port = ======================== Target/Initiator : Target Node Name : 20-00-00-20-37-1A-6B-CF Port Name : 21-00-00-20-37-1A-6B-CF Vendor Id : SEAGATE Product Id : ST136403FC Product Revision : FF5F

3-8 SN0054614-00 K

3–Interactive Commands

General Information Menu (Command Line Option -g)

Product Serial Number : LT06464600001011HGGH

Target/Initiator : Target Node Name : 20-00-00-20-37-11-FF-EF Port Name : 21-00-00-20-37-11-FF-EF Vendor Id : SEAGATE Product Id : ST118273 CLAR18 Product Revision : SG1D Product Serial Number : LP60266900001919HQ1K . . . ============================= Physical Port Number : 8 ============================= Port Name : 20-07-00-C0-DD-00-6A-9F Port state : Offline Port Type : Vendor Specific/Reserved Port Type. TX Port Type : Short wave laser - SN (850nm) Port Module Type : GBIC ======================== = Attached Port = ======================== Target/Initiator : ISL Node Name : 20-00-00-E0-8B-03-55-7C Port Name : 21-00-00-E0-8B-03-55-7C Vendor Id : QLogic Corporation HBA Model : 2200 HBA Serial Number : C28437 HBA Alias : Port Alias : Driver Version : SCSI Miniport 8.1.5.15 (W2K IP) Firmware Version : 2.02.03 Total Number of Devices: 0 Host : BRAGI ================================= = InterConnect Element = ================================= Type : HBA World Wide Node Name : 20-00-00-E0-8B-85-8C-7C World Wide Port Name : 21-00-00-E0-8B-85-8C-7C Vendor Id : QLogic Corporation HBA Model : QLA2462 HBA Serial Number : FFC0551D59564 HBA Alias : Port Alias : Driver Version : STOR Miniport 9.1.0.18 (w32) Firmware Version : 4.00.12 Total Number of Devices : 0 Host : BRAGI Number of Port : 1

SN0054614-00 K 3-9

3–Interactive Commands General Information Menu (Command Line Option -g)

Beacon status : Off Port Type : Unknown Port State : LinkDown

Hit <RETURN> to continue:

Save As Txt File

(Command Line Option -b)

1. General Information 2: Host Topology 2: Save As Txt File

When you save the host topology to a text file, the system responds with the file name. For example:

Topology has been successfully saved to file BRAGI_topology_06152009_093855.txt

Save As XML File

1: General Information 2: Host Topology 3: Save As XML File

When you choose to save the host topology to an XML file, the system responds with the Host Topology Menu with options to:

 Save as XML Format 1  Save as XML Format 2

Save As XML File: Format 1

(Command Line Option -x)

1: General Information

2: Host Topology 3: Save As XML File 1: Save As XML File format 1

The system responds with the name of the XML Format 1 file; for example:

Topology has been successfully saved to file BRAGI_topology_06152009_093855.xml

Save to XML File: Format 2

(Command Line Option -x2)

1: General Information 2: Host Topology 3: Save As XML File 2: Save As XML File format 2

The system responds with the name of the XML Format 2 file; for example:

Topology has been successfully saved to file BRAGI_topology_06152009_093855.xml

Generate Report

(Command Line Option -z)

1: General Information 3: Report

The Report Menu provides the option to select an individual port instance from a list of all adapters or to select All HBAs.

3-10 SN0054614-00 K

 Adapter Model

 Port Number  Port WWPN  Port Status

Generate Report (Per Adapter Port)

1: General Information3: Report1 - n: Port Number

If you enter the number for an adapter port instance from the list, the system shows a variety of adapter and system information including:

 SANsurfer FC/CNA HBA CLI header

 Version and build

 Adapter header

 Host name  OS type  OS version  SDM API version  Adapter Model (Serial Number)

3–Interactive Commands

General Information Menu (Command Line Option -g)

 Port number  Port WWPN  Adapter instance  Status (online/offline

 Adapter General Information

 Host Name 

Adapter Instance



Adapter Model Adapter Description



Adapter ID

  Adapter Alias  Adapter Port  Port Alias 

Node Name (WWNN)



Port Name (WWPN)

 Port ID  Serial Number  Driver Version  BIOS Version (Windows and Linux)  Firmware Version  Flash BIOS Version  Flash FCode Version  Flash EFI Version  Flash Firmware Version

SN0054614-00 K 3-11

3–Interactive Commands General Information Menu (Command Line Option -g)

 Actual Connection Mode  Actual Data Rate  PortType (Topology)  Target Count  PCI Bus Number (Windows and Linux)  PCI Device Number (Windows and Linux)  Adapter Status (online, offline)

 Adapter VPD Header (Vital Product Data) Information (for QLA/QLE24xx

and QLE81xx only)

 Adapter Instance  Adapter Type  Port Number  WWPN  Port ID

 The actual VPD information:

 Product Identifier  Part Number  Serial Number  Misc. Information (for example, PCI and PCI-X speeds)  Manufacturing ID  EFI Driver Version  Firmware Version  BIOS Version (Windows and Linux)  FCode Version (Solaris)  Flash Image Version

 Adapter Parameters Settings Header (Command Line Options -c)

 Adapter Instance  Adapter Part Number  Port Number  WWPN  Port ID

 Adapter Parameter Settings

 Connection Options  Data Rate (QLA23xx, QLA24xx, QLE23xx, and QLE24xx adapters)  Frame Size  Hard Loop ID  Loop Reset Delay (in seconds)  Enable Host Adapter BIOS  Enable Hard Loop ID  Enable FC Tape Support  Operation Mode

3-12 SN0054614-00 K

General Information Menu (Command Line Option -g)

 Interrupt Delay Timer  Execution Throttle  Login Retry Count  Port Down Retry Count  Enable LIP Full Login  Link Down Timeout (in seconds)  Enable Target Reset  LUNs Per Target  Enable Receive Out Of Order Frame

3–Interactive Commands

 Driver Settings Information Header (Command Line Options -fg)

 Adapter Instance  Adapter Part Number  Port Number  WWPN  Port ID

 Driver Settings (repeats for each adapter instance)

 Driver Settings - Group: Persistent

 Persistently bound Plus New targets  Persistently bound targets only

 Driver Settings - Group: Binding

 Bind by WWPN  Bind by Port ID

 Device/LUNs Information Header (Repeats for each adapter instance)

 Adapter Instance  Adapter Part Number  Port Number  WWPN  PORT ID

 Device/LUNs Information (Repeats for each LUN)

 Path  Target  Device ID  Product Vendor  Product ID  Product Revision  Serial number  Node name  Port Name  Port ID  Product Type  LUN count(s)

SN0054614-00 K 3-13

3–Interactive Commands General Information Menu (Command Line Option -g)

 Status

 LUN N (Repeats for each LUN)

 Product Vendor  Product ID  Product revision  LUN  Size  Type  WWULN

 Selective LUN Information Header (repeats for each selective LUN)

 Adapter Instance  Adapter Part Number  Port Number  WWPN  Port ID

 Selective LUN Information

 Device Vendor ID  Device Product ID  Serial Number  Device Port Name  Device Port ID

 Boot Device Settings

 Selectable Boot  Primary Boot Port Name  Primary Boot Port Address  Alternate 1 Boot Port Name  Alternate 1 Boot Port Address  Alternate 2 Boot Port Name  Alternate 2 Boot Port Address  Alternate 3 Boot Port Name  Alternate 3 Boot Port Address

An example follows:

------------------------------------------------------------------------------

3-14 SN0054614-00 K

3–Interactive Commands

General Information Menu (Command Line Option -g)

Host Name : BRAGI OS Type : Microsoft Windows Server 2003 Enterprise Edition x86 OS Version : Service Pack 1 (Build 3790) SDM API Version : 1.28.0.50 QLSDM.DLL

-----------------------------------------------------------------------------HBA Model 2200 (SN C28437): Port 1 WWPN 21-00-00-E0-8B-03-55-7C (HBA instance 0) Online Port 2 WWPN 21-01-00-E0-8B-23-55-7C (HBA instance 1) Online HBA Model QLA2300 (SN D83179): Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 (HBA instance 2) Online Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 (HBA instance 3) Online HBA Model QLA2462 (SN FFC0551D59564): Port 1 WWPN 21-00-00-E0-8B-85-8C-7C (HBA instance 4) Loop down Port 2 WWPN 21-01-00-E0-8B-A5-8C-7C (HBA instance 5) Online

-----------------------------------------------------------------------------Total QLogic HBA(s) : 3

Time and date: Tue Nov 20 16:11:43 2009

------------------------------------------------------------------------------

HBA General Information

------------------------------------------------------------------------------

-----------------------------------------------------------------------------Host Name : BRAGI HBA Instance : 1 HBA Model : 2200 HBA Description : QLA2200 /02/12/04 QLA2202FS QCP2202 HBA ID : 1-2200 HBA Alias : HBA Port : 2 Port Alias : Node Name : 20-00-00-E0-8B-03-55-7C Port Name : 21-01-00-E0-8B-23-55-7C Port ID : 11-06-00 Serial Number : C28437 Driver Version : SCSI Miniport 8.1.5.15 (W2K IP) BIOS Version : 1.83 Firmware Version : 2.02.03 Actual Connection Mode : Point to Point Actual Data Rate : 1 Gbps PortType (Topology) : NPort Target Count : 2 PCI Bus Number : 1 PCI Device Number : 5 HBA Status : Online

------------------------------------------------------------------------------

SN0054614-00 K 3-15

3–Interactive Commands General Information Menu (Command Line Option -g)

HBA VPD Information

-----------------------------------------------------------------------------Feature is not supported with selected HBA (Instance 1 - 2200)!

------------------------------------------------------------------------------

HBA Parameters Settings

------------------------------------------------------------------------------

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

-----------------------------------------------------------------------------Connection Options : 3 - Point-to-Point, Otherwise Loop Frame Size : 1024 Hard Loop ID : 0 Loop Reset Delay (seconds) : 5 Enable Host HBA BIOS : Disabled Enable Hard Loop ID : Disabled Enable FC Tape Support : Enabled Execution Throttle : 16 Login Retry Count : 8 Enable LIP Reset : Disabled Port Down Retry Count : 30 Enable LIP Full Login : Enabled Link Down Timeout (seconds) : 0 Enable Target Reset : Enabled LUNs Per Target : 8

------------------------------------------------------------------------------

Driver Settings Information

------------------------------------------------------------------------------

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

------------------------------------------------------------------------------

----------------------------------Driver Settings - Group: Persistent

----------------------------------Present targets that are persistently bound plus any new target(s) : Enable Present targets that are persistently bound Only : Disable

-------------------------------Driver Settings - Group: Binding

-------------------------------Bind by World Wide Port Name : Enable Bind by Port ID : Disable

------------------------------------------------------------------------------

Devices/LUNs Information

------------------------------------------------------------------------------

3-16 SN0054614-00 K

3–Interactive Commands

General Information Menu (Command Line Option -g)

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

-----------------------------------------------------------------------------Path : 0 Target : 0 Device ID : 0x82 Product Vendor : SEAGATE Product ID : ST136403FC Product Revision : FF5F Serial Number : LT06464600001011HGGH Node Name : 20-00-00-20-37-1A-6B-CF Port Name : 21-00-00-20-37-1A-6B-CF Port ID : 11-01-E4 Product Type : Disk LUN Count(s) : 1 Status : Online

------------------------------------------------------------

--------------------------------------LUN 0

--------------------------------------Product Vendor : SEAGATE Product ID : ST136403FC Product Revision : FF5F LUN : 0 Size : 33.92 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-20-37-1A-6B-CF

------------------------------------------------------------

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

-----------------------------------------------------------------------------Path : 0 Target : 1 Device ID : 0x83 Product Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Revision : SG1D Serial Number : LP60266900001919HQ1K Node Name : 20-00-00-20-37-11-FF-EF Port Name : 21-00-00-20-37-11-FF-EF Port ID : 11-01-E8 Product Type : Disk LUN Count(s) : 1 Status : Online

------------------------------------------------------------

--------------------------------------LUN 0

---------------------------------------

SN0054614-00 K 3-17

3–Interactive Commands General Information Menu (Command Line Option -g)

Product Vendor : SEAGATE Product ID : ST118273 CLAR18 Product Revision : SG1D LUN : 0 Size : 16.95 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 20-00-00-20-37-11-FF-EF

------------------------------------------------------------

------------------------------------------------------------------------------

Target Persistent Binding Information

No target persistent binding configuration on HBA instance 1 (WWPN 21-01-00-E0-8 B-23-55-7C).

------------------------------------------------------------------------------

Selective LUNs Information

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

----------------------------------------------------------------------------- Device Vendor ID : SEAGATE Device Product ID: ST136403FC Serial Number : LT06464600001011HGGH Device Port Name : 21-00-00-20-37-1A-6B-CF Device Port ID : 11-01-E4

-----------------------------------------------------------------------------Enable Type Target/LUN Info Port Name LUN ID

------ -------- ----------------------- ----------------------- ------

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

----------------------------------------------------------------------------- Device Vendor ID : SEAGATE Device Product ID: ST118273 CLAR18 Serial Number : LP60266900001919HQ1K Device Port Name : 21-00-00-20-37-11-FF-EF Device Port ID : 11-01-E8

-----------------------------------------------------------------------------Enable Type Target/LUN Info Port Name LUN ID

------ -------- ----------------------- ----------------------- ------

-----------------------------------------------------------------------------HBA Instance 1: 2200 Port 2 WWPN 21-01-00-E0-8B-23-55-7C PortID 11-06-00

-----------------------------------------------------------------------------Boot Device Settings:

--------------------------------------Selectable Boot: Disabled

--------------------------------------(Primary ) Boot Port Name LUN

3-18 SN0054614-00 K

---------------------------- -----00-00-00-00-00-00-00-00 0

---------------------------- -----(Alternate 1) Boot Port Name LUN

---------------------------- -----00-00-00-00-00-00-00-00 0

---------------------------- -----(Alternate 2) Boot Port Name LUN

---------------------------- -----00-00-00-00-00-00-00-00 0

---------------------------- -----(Alternate 3) Boot Port Name LUN

---------------------------- -----00-00-00-00-00-00-00-00 0 Finish in 1 second(s)...

Hit <RETURN> to continue:

Generate Report (All Adapters)

(Command Line Option -z)

1: General Information 3: Report 4_N: All HBAs

3–Interactive Commands

HBA Information Menu (Command Line Option -i)

The system shows the report information for all adapters. See “Generate Report

(Per Adapter Port)” on page 3-11, in which data repeats for every adapter.

Refresh

1: General Information 4: Refresh

This selection returns the option to refresh the configuration for the current host.

HBA Information Menu

(Command Line Option -i)

2: HBA Information

This command shows the HBA Information Menu that includes list of all detected adapters and their ports, as well as the options to view all adapters and to return to the previous menu.

 Adapter Model QLxnnnn

 1. Port information

 Port number  WWPN  Status

 [additional port(s) or FCoE engines, as appropriate]

SN0054614-00 K 3-19

3–Interactive Commands HBA Information Menu (Command Line Option -i)

 Additional adapters (as appropriate)

 All adapters

Here is an example of a typical HBA Information Menu. In this example, the host includes three adapters with two ports each:

HBA Information Menu

HBA Model 2200:

1: Port 1: WWPN: 21-00-00-E0-8B-03-55-7C Online 2: Port 2: WWPN: 21-01-00-E0-8B-23-55-7C Online

HBA Model QLA2300:

3: Port 1: WWPN: 21-00-00-E0-8B-05-CB-D8 Online 4: Port 2: WWPN: 21-01-00-E0-8B-25-CB-D8 Online

HBA Model QLA2462:

5: Port 1: WWPN: 21-00-00-E0-8B-85-8C-7C Loop down 6: Port 2: WWPN: 21-01-00-E0-8B-A5-8C-7C Online 7: All HBAs 8: Return to Previous Menu

In the following example, the QLE8042 adapter includes an FCoE engine:

HBA Information Menu

HBA Model QLE2562 1: Port 1: WWPN: 21-00-00-1B-32-16-C3-EE Online 2: Port 2: WWPN: 21-01-00-1B-32-36-C3-EE SFP not installed HBA Model QLE8042 3: Port 1: WWPN: 21-00-00-E0-8B-80-5F-0F Link Down 4: FCoE Engine 5: Port 2: WWPN: 21-01-00-E0-8B-A0-5F-0F Link Down HBA Model QLE220 6: Port 1: WWPN: 21-00-00-E0-8B-91-A4-26 Loop Down HBA Model QLE2462 7: Port 1: WWPN: 21-01-00-1B-32-20-27-CE Loop Down 8: All HBAs 9: Return to Previous Menu

HBA General Information (per Adapter Port)

2: HBA Information 1 - n: Port Number

When you select one of the adapter ports by number, this option shows the HBA Information Menu for that adapter port. The menu includes options for:

 Information  HBA Alias  HBA Port Alias  VPD

3-20 SN0054614-00 K

If you select a number corresponding to an FCoE engine rather than a port, the following general information is shown:

-----------------------------------------------------------------

Host Name : TARGET3 HBA Model : QLE8042 HBA Description : QLE8042 Mercury CNA Firmware Version : 1.1.0 (Operational)

-----------------------------------------------------------------

Where Firmware Version is the version of FCoE firmware installed on the adapter, along with one of the following descriptions:

 Operational indicates you are using an installed version of the

application.

 Golden indicates you are running from the ROM version.

HBA Information

(Command Line Option -i)

2: HBA Information n: Port Number 1: HBA Information

3–Interactive Commands

HBA Information Menu (Command Line Option -i)

This option produces the same HBA Information Menu available from the General Information, Report menu. See “Generate Report (Per Adapter Port)”

on page 3-11.

To view FCoE information, enter the following command line option:

scli -fcoe ( <hba instance> | <hba wwpn> ) --info

For the QLx81xx adapters only, additional information includes the ENode MAC Address, which is that adapter’s FC node MAC address.

HBA Alias

(Command Line Option -ha)

2: HBA Information  n: Port Number  2: HBA Alias

When you select this option, SANsurfer FC/CNA HBA CLI shows the following information about the adapter:

 Adapter Model  WWNN  Serial number  Alias

With this option you can create, modify, or delete the symbolic name or alias, for an adapter.

SN0054614-00 K 3-21

3–Interactive Commands HBA Information Menu (Command Line Option -i)

To create, modify, or delete an adapter alias:

1. From the Main Menu, type the number for the HBA Information option, and

then press

ENTER

2. Type the number for the adapter you want to configure, and then press ENTER

3. Type the number for the HBA Alias option, and then press

ENTER

The HBA Alias menu appears:

N: HBA Model: QLnnnn

Port n WWPN: nn-nn-nn-nn-nn-nn-nn-nn Serial Number: XXXXnnnnnnnnn Port Alias:

(If the adapter already has an alias, it appears; otherwise,

blank.)

4. Type the number for the adapter model, and then press

ENTER

5. Create, modify, or delete the adapter alias as follows:

a. To create or modify an the adapter alias, type a symbolic name

(maximum 100 characters) at the HBA Alias prompt, and then press ENTER

b. To delete an existing adapter alias, leave the HBA Alias field empty,

and then press

ENTER

Here is an example of the HBA Alias option.

HBA Alias Menu 1: HBA Model: QLA2462

WWNN: xx-xx-xx-xx-xx-xx-xx-xx Serial Number: FFC0519U93213 HBA Alias: 4G Dual Port HBA

2: Cancel

Note: 0 to return to the Main Menu Enter Selection: 1 HBA Alias:

HBA Port Alias

(Command Line Option -pa)

2: HBA Information n: Port Number 3: HBA Port Alias

The HBA Port Alias option allows you to create, modify, or delete a symbolic name (Alias) for the specified adapter port.

3-22 SN0054614-00 K

3–Interactive Commands

HBA Information Menu (Command Line Option -i)

To create, modify, or delete an adapter port alias:

1. From the Main Menu, type the number for the HBA Information option, and

then press

ENTER

2. Type the number for the HBA Port for which you want to change the Port

Alias, and then press

ENTER

3. Type the number for the HBA Port Alias option, and then press

4. The Port Alias Menu appears. Here is an example:

Port Alias Menu 1: HBA Model: QLA2462 WWNN: xx-xx-xx-xx-xx-xx-xx-xx Serial Number: FFC0519U93213 Port Alias: 4G Port 1 2: Cancel Enter 0 to return to the Main Menu Enter Selection:

If you select a port number from the Port Alias Menu, the CLI prompts you to enter a Port Alias as follows:

Port Alias: _

 To keep the current port alias, enter the number for Cancel, and then

press

ENTER

 To change the port alias, type a new name, and then press

 To delete an existing port alias, leave the field blank, and then press

ENTER

HBA VPD Information

(Command Line Option -l and Reserved Word “vpd”)

2: HBA Information  n: Port Number  4: VPD

ENTER

With QLA/QLE24xx and QLE81xx adapters only, if you select option 4, the Vital Product Data (VPD) information appears:

 Adapter instance number, model, port number, adapter port name (WWPN),

and port ID

 Product Identifier  VPD-R tag (VPD ReadOnly field) (if available)  Part Number (adapter model)  Serial Number  Misc. Information (for example, PCI and PCI-X speeds)  Manufacturing ID  EFI Driver Version  Firmware Version

SN0054614-00 K 3-23

3–Interactive Commands HBA Parameters Menu

 BIOS Version (Windows and Linux)  FCode Version (Solaris)  Flash Image Version (QLE81xx adapters only)

If the adapter does not support VPD, the following message appears:

VPD not supported on current HBA x!

HBA Information (All HBAs)

2: HBA Information n: All HBAs

Depending on how many adapters are in the host, the number to select this option varies. When you select that option, the All HBAs menu shows the HBA Information and VPD (Vital Product Data) options.

 Information  VPD

Information

2: HBA Information n: All HBAs 3: Information

The Information menu shows the same adapter Information available from the General Information Menu. See “Generate Report (Per Adapter Port)” on

page 3-11.

2: HBA Information n: All HBAs 3: VPD

The VPD menu shows the same Vital Product Data available from the HBA Information Menu. See “HBA VPD Information (Command Line Option -l and

Reserved Word “vpd”)” on page 3-23.

HBA Parameters Menu

3: HBA Parameters

The HBA Parameters command shows the HBA Parameters Menu, which is similar to the HBA Information Menu. It also includes list of all detected adapters and their ports, as well as the options to view all adapters and to return to the previous menu.

 Adapter Model QLxnnnn

 Port information  Port number  WWPN  Status  [additional port(s) or FCoE engines, as appropriate]

 Additional adapters (as appropriate)

3-24 SN0054614-00 K

3–Interactive Commands

HBA Parameters Menu

 All adapters

Here is an example of an HBA Parameters Menu. In this example, the host includes three adapters with two ports each and one adapter with a single port (see HBA Parameters (Per Adapter Port) and HBA Parameters (All HBAs)):

HBA Model QLA2342:

1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online

2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online

HBA Model QLA2300:

3. Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 Loop down

4. Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 Online

HBA Model QLA2462:

5. Port 1 WWPN 21-00-00-E0-8B-1P-9D-P0 Online

6. Port 2 WWPN 21-01-00-E0-8B-3P-9D-P0 Loop down

HBA Model QLA21O:

7. Port 1 WiIPN 21-00-00-E0-8B-1A-3F-E0 Online

8. All HBAs

9. Return to Previous Menu

The following example of an HBA Parameters Menu includes adapter QLE8042 with an FCoE engine (see HBA Parameters (Per FCoE Engine):

HBA Model QLE2562

1: Port 1: WWPN: 21-00-00-1B-32-16-C3-EE Online 2: Port 2: WWPN: 21-01-00-1B-32-36-C3-EE SFP not installed

HBA Model QLE8042

3: Port 1: WWPN: 21-00-00-E0-8B-80-5F-0F Link Down 4: FCoE Engine 5: Port 2: WWPN: 21-01-00-E0-8B-A0-5F-0F Link Down

HBA Model QLE220

6: Port 1: WWPN: 21-00-00-E0-8B-91-A4-26 Loop Down

HBA Model QLE2462

7: Port 1: WWPN: 21-01-00-1B-32-20-27-CE Loop Down 8: All HBAs 9: Return to Previous Menu

Enter the number to select the adapter you want to configure or All HBAs.

HBA Parameters (Per Adapter Port)

3: HBA Parameters  n: Port Instance

The HBA Instance menu has the following options:

 Display HBA Parameters  Configure HBA Parameters  Restore Defaults (4Gb and above adapters only)  Return to Previous Menu

SN0054614-00 K 3-25

3–Interactive Commands HBA Parameters Menu

Display HBA Parameters

(Command Line Option -c#)

3: HBA Parameters n: Port Instance 1: Display HBA Parameters

When you select this option, the following parameters appear:

 Connection Options  Data Rate (4Gb and above adapters)  Frame Size  Hard Loop ID  Loop Reset Delay (seconds)  Enable Host Adapter BIOS  Enable Hard Loop ID  Enable FC Tape Support  Operation Mode  Interrupt Delay Timer (100 ms)  Execution Throttle  Login Retry Count  Enable LIP Reset  Port Down Retry Count  Enable LIP Full Login  Link Down Timeout (seconds)  Enable Target Reset  LUNs Per Target  Enable Receive Out Of Order Frame

Configure HBA Parameters

(Command Line Option -n)

3: HBA Parameters n: Port Number 2: Configure HBA Parameters

From the Configure HBA Parameters menu, you can configure the following adapter parameters:

 Connection Options  Data Rate  Frame Size  Hard Loop ID  Loop Reset Delay (seconds)  Enable Adapter Port BIOS  Enable Adapter Hard Loop ID  Enable Fibre Channel Tape Support  Operation Mode  Interrupt Delay Timer  Execution Throttle  Login Retry Count  Enable LIP Reset  Port Down Retry Count

3-26 SN0054614-00 K

3–Interactive Commands

HBA Parameters Menu

 Enable LIP Full Login (QLA/QLE23xx adapters)  Link Down Timeout (seconds)  Enable Target Reset  LUNs per Target  Enable Receive Out Of Order Frame  Commit Changes  Abort Changes

Table 3-1 lists the configurable adapter parameters alphabetically by name and

alias, and provides values and descriptions of each.

Table 3-1. Adapter Parameters Settings (NVRAM)

Parameter Name Alias Value Description

ConnectionOption CO 0–3 See table note 1.

DataRate DR 0–4 See table note 2.

EnableBIOS EB 0, 1 See table notes 3, 4.

EnableExtendedLogging EL 0, 1 See table notes 3, 4.

EnableFCTape EF 0, 1 See table note 3.

EnableHardLooplD HL 0, 1 See table note 3.

EnableLIPFullLogin FL 0, 1 See table note 3.

EnableLipReset LP 0, 1 See table note 3.

EnableReceiveOutOfOrderFrame EO 0, 1 See table notes 3, 5.

EnableTargetReset TR 0, 1 See table note 3.

ExecutionThrottle ET 1–65535

FrameSize FR 512, 1024, 2048

HardLoopID HD 0–125

InterruptDelayTimer ID 0–255

LinkDownTimeOut LT 0–240

LoginReTryCount LR 0–255

MaximumLUNsPerTarget ML 0, 8, 16, 32, 64,

128, 256

OperationMode OM 0, 5, 6 See table note 6.

PortDownRetryCount PD 0–255

SN0054614-00 K 3-27

3–Interactive Commands HBA Parameters Menu

Table 3-1. Adapter Parameters Settings (NVRAM) (Continued)

Parameter Name Alias Value Description

ResetDelay RD 0–255

Table Notes

1. Connection Options (read-only on QLE8042, QLE/QMI81xx, and SMB adapters): 0 = Loop Only 1 = Point-to-point Only 2 = Loop preferred, otherwise Point-to-Point 3 = Point-to-Point, otherwise Loop (QLA22xx Only)

2. Data Rate (read only on QLE8042 and SMB adapters): 0 = 1 Gbs 1 = 2 Gbs 2 = Auto 3 = 4 Gbs 4 = 8 Gbs

3. Others: 0 = Disable 1 = Enable

4. Option is not available on 4Gb or latest adapters.

5. Option is available on 4Gb or latest adapters.

6. Operation Modes: 0 = Interrupt for every I/O completion 5 = Interrupt when Interrupt Delay Timer expires. 6 = Interrupt when Interrupt Delay Timer expires or no active I/O.

Connection Options

3: HBA Parameters 1: Port Number 2: Configure HBA Parameters n. Connection Options

From this menu, you can configure the connection options:

 0—Loop Only  1—Point to Point Only  2—Loop Preferred, Otherwise Point-to-Point  3—Point-to-Point, Otherwise Loop (QLA22xx adapter only)

Type the number for the connection type you want, and then press

NOTE:

 Connection options are read-only on QLE8042, QLE/QMI81xx, and SMB

adapters.

 QLE/QMI81xx adapters support only the Point to Point Only option.

ENTER

3-28 SN0054614-00 K

3–Interactive Commands

HBA Parameters Menu

Data Rate

3: HBA Parameters  N: Port Number  2: Configure HBA Parameters  n. Data Rate

This option shows the Data Rate menu. (Note that data rate configuration is not available for all adapter port instances.) From this menu you can select:

 Auto  1 Gbps  2 Gbps  4 Gbps  8 Gbps

NOTE:

 The 1 Gbps data rate is not supported with 8G adapters.

 QLE/QMI81xx adapters support 10Gbps only and cannot be modified.

Type the number for the data rate you want, and then press

ENTER

Frame Size

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Frame Size

This option shows the Frame Size menu. From it you can select:

 Frame Size: 512  Frame Size: 1024  Frame Size: 2048

Type the number for the frame size you want, and then press

ENTER

Hard Loop ID

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Hard Loop ID

This option prompts you to enter a valid Hard Loop ID from 0 to 125. Type the number you want, and then press

ENTER

Loop Reset Delay

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Loop Reset Delay

This option prompts you to enter a Reset Delay from 0 to 255 seconds. Type the number you want for the loop reset delay, and then press

ENTER

SN0054614-00 K 3-29

3–Interactive Commands HBA Parameters Menu

Enable HBA Port BIOS

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable HBA Port BIOS

This option allows you to enable or disable the BIOS boot setting. When this setting is disabled, the ROM BIOS on the adapter is disabled. If you are booting from a FC hard disk attached to the adapter, you must enable this setting. The default is disabled.

Enable HBA Hard Loop ID

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable HBA Hard Loop ID

This choice gives you the option to enable or disable the Hard Loop ID. Type the number you want, and then press

Enable Fibre Channel Tape Support

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable Fibre Channel Tape Support

This choice gives you the option to enable or disable Fibre-Channel Tape support. Type the number you want, and then press

ENTER

Operation Mode

3: HBA Parameters  N: Port Number  2: Configure HBA Parameters n. Operation Mode

This option shows the Operation Mode Menu. From it you can select:

 Interrupt for every I/O Completion  Interrupt when Interrupt Delay Timer expires  Interrupt when Interrupt Delay Timer expires or no active I/O

Type the number for the Operation Mode you want, and then press

ENTER

Interrupt Delay Timer

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Interrupt Delay Timer

This choice gives you the option to set the Interrupt Delay timer to 0 to 255 seconds.

You cannot set the Interrupt Delay timer when the Operation Mode (blue) is set to Interrupt for Every I/O Completion.

Execution Throttle

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Execution throttle_

This choice gives you the option to set the Execution Throttle to a value from 1 to

65535. This value specifies the delay in seconds between the execution of each line of code.

3-30 SN0054614-00 K

3–Interactive Commands

HBA Parameters Menu

3: HBA Parameters N: Port Number 2: Configure HB\A Parameters n. Login Retry Count

This choice gives you the option to set the Login Retry Count to a value from 0 to

255.

Enable LIP Reset

3: HBA Parameters  N: Port Number 2: Configure HBA Parameters n. Enable LIP Reset

This choice gives you the option to Enable or Disable LIP Reset.

Port Down Retry Count

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Port Down Retry Count

This choice gives you the option to set the Port Down Retry Count to a value from 0 to 255.

Enable LIP Full Login

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable LIP Full Login

This choice gives you the option to enable or disable LIP Full Login.

Link Down Timeout

3: HBA Parameters N: Port Number  2: Configure HBA Parameters n. Link Down Timeout

This choice gives you the option to set the Link Down timeout to a value from 0 to

240.

Enable Target Reset

3: HBA Parameters N: Port Number 2: Configure HBA Parameters n. Enable Target Reset

This choice gives you the option to Enable or Disable Target Reset.

LUNs per Target

3: HBA Parameters  N: Port Number  2: Configure HBA Parameters n. LUNs per Target

This option shows the LUNs per Target menu. From it you can select:

 0 LUN per Target  8 LUNs per Target  16 LUNs per Target  32 LUNs per Target  64 LUNs per Target  128 LUNs per Target  256 LUNs per Target

SN0054614-00 K 3-31

3–Interactive Commands HBA Parameters Menu

Commit Changes

3: HBA Parameters  N: Port Number 2: Configure HBA Parameters n. Commit changes

Choose this option to make the changes permanent.

CAUTION!

There is undo after you commit to making changes to the adapter parameters.

Abort Changes

3: HBA Parameters  N: Port Number2: Configure HBA Parameters n: Abort changes

Choose this option to stop without making any changes.

Restore Defaults

3: HBA Parameters n: Port Number 3: Restore Defaults

This option is for 4Gb and 8Gb adapters only. Selecting the Restore Defaults option causes the following warning to appear:

Warning: Please update the HBA parameters with extreme care. Incorrectly updating the HBA parameters may render the HBA inoperable. If you currently have boot device information set up in the HBA parameters, updating the HBA parameters from a file may result in changing that information. If you wish to preserve the boot device information, please either update the file with the correct boot device settings before the HBA parameters update or re-configure the boot settings after the update.

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

If you enter 1 to proceed, the system returns a message similar to the following:

Restoring default settings on HBA instance 5 - QLA2462. Please wait... HBA Parameters restore completed. Changes has been saved to HBA instance 5. You must reboot in order for the changes to become effective.

3-32 SN0054614-00 K

HBA Parameters (Per FCoE Engine)

3: HBA Parameters  n: FCoE Engine

The FCoE Parameters menu appears only for the QLE8042 adapter and has the following options:

 Display FCoE Parameters  Configure FCoE Parameters  Return to Previous Menu

Display FCoE Parameters

3: HBA Parameters n: FCoE Engine1: Display FCoE Parameters

When you select this option, the FCoE Port Selection menu appears. Select a port number and then press instance, as shown in the following example:

FCoE Port Selection Menu

ENTER

to show the FCoE parameters for that

3–Interactive Commands

HBA Parameters Menu

FCoE Engine (QLE8042)

Desc: QLE8042 Mercury CNA 1: Port 0 2: Port 1 3: Return to Previous Menu

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

-----------------------------------------------------FCoE Parameters Port 0

-----------------------------------------------------Host Name : TARGET3 HBA Instance : 3 HBA Model : QLE8042 HBA Description : QLE8042 Mercury CNA Port Type : Access Pause Type : Priority Flow Control Priority Pause Mask : 0[ ] 1[ ] 2[ ] 3[x] 4[ ] 5[ ]

FCoE Config : T11 Rev 0 Frame Format FCoE COS : 3

Configure FCoE Parameters

3: HBA Parameters n: FCoE Engine2: Configure FCoE Parameters

6[ ] 7[ ]

When you select this option, the FCoE Port Selection menu appears. Select a port number and then press

ENTER

to list the configurable FCoE parameters for

that instance. For example:

SN0054614-00 K 3-33

3–Interactive Commands HBA Parameters Menu

FCoE Parameters Menu

FCoE Engine (QLE8042) Port 0

Desc: QLE8042 Mercury CNA

1: Port Type 2: Pause Type 3: FCoE COS 4: Save Changes 5: Return to Previous Menu

If you make any changes to the configuration of the FCoE engine, select the Save Changes option before you leave the FCoE Parameters menu.

Port Type

3: HBA Parameters  N: FCoE Engine  2: Configure FCoE Parameters  n. Port Type

This option shows the Port Type menu. From this menu you can select one of the following port types; the current type is indicated:

 Access (default; does not carry the VLAN tag)  Trunk (carries the VLAN tag)

Type the number for the port type you want, and then press

ENTER

Port Type must be set to Trunk to configure Pause Type and FCoE CoS (see the following sections).

When the network (Ethernet) port is configured as a trunk port, packets are tagged. When the port is configured as an access port, packets are untagged and do not contain a VLAN tag.

Pause Type

3: HBA Parameters  n: FCoE Engine  2: Configure FCoE Parameters  n. Pause Type

This option shows the Pause Type menu. Pause types include Standard Pause and Priority Flow Control (per-priority pause). Pause is a frame that controls the flow between transmitter and receiver if the transmitter sends data at a higher rate than the receiver. In that situation, the receiver sends a PAUSE frame to the transmitter and the transmitter suspends transmission for the specified time.

From the Pause Type menu you can select one of the following pause types; the current type is indicated:

 Standard Pause (default)  Priority Flow Control

Type the number for the pause type you want, and then press

ENTER

Standard Pause applies to all the frames. By default, Standard Pause is enabled on the server-facing Ethernet ports, as well as on the network-facing Ethernet ports.This setting affects the connection only when connected to a peer that is not configured with data center bridging capability exchange protocol (DCBX).

. Note that the

3-34 SN0054614-00 K

3–Interactive Commands

HBA Parameters Menu

Priority Flow Control enables you to manage pauses in traffic according to assigned priorities to class of service (CoS) frames; that is, on per-flow basis. CoS is a way of managing traffic in a network by grouping similar types of traffic (for example, e-mail, streaming video, voice, large document file transfer) together and treating each type as a class with its own level of service priority.

Priority Flow Control applies to servers with a single adapter interface, which could carry traffic for LAN, SAN, and IPC. In this case, SAN traffic is marked with a specific CoS to identify it as a distinct flow among other flows (LAN, IPC), and pause can be applied to this specific CoS to assure lossless SAN frames. When connected to a DCBX-enabled peer, the pause type is automatically set with priority flow control (per-priority pause) when the peer sends a priority flow control time length value, regardless of this parameter setting.

The pause type will be reconfigured based on the setting of this parameter whenever the following occurs:

 The network link goes down.  The system is reset.

DCBX: When connected to a data center bridging exchange protocol (DCBX) enabled peer, the pause type is automatically configured to be Priority Flow Control (per-priority pause) when the peer sends a Priority Flow Control type-length-value (TLV), this parameter is configured on the adapter. When not connected to a DCBX-enabled peer, or before receipt of a Priority Flow Control TLV, on setting of this parameter on the adapter.

FCoE COS

3: HBA Parameters  N: FCoE Engine  2: Configure FCoE Parameters  n. FCoE COS

This option prompts you to configure a persistent value for the FCoE class of service (CoS) for priority encoded FCoE packets. Type a numeric value in the range of 0 through 7, and then press

ENTER

. The current value is indicated in

brackets; the default value is 3.

FCoE packets must carry a CoS value and must be tagged, meaning that the port must be configured as a trunk port. This setting affects the connection when connected to a peer with DCBX protocol and a matching CoS setting. If the DCBX peer CoS setting does not match, the connection is not affected by this setting. When not connected to a DCBX-enabled peer, or before receiving an FCoE CoS value, the FCoE CoS type length value is based on this parameter setting. In this case, the FCoE packets will only be priority encoded if the network port is configured as a trunk port (see “Port Type” on page 3-34).

When connected to a DCBX-enabled peer, the FCoE CoS value is automatically set to value specified in the FCoE CoS type length value, regardless of this parameter setting. When connected to a switch that supports DCBX (for example, the Cisco Nexus™ 5020 switch), the port type is implicitly changed by FCoE engine firmware to be a trunk port, regardless of the persistent settings.

SN0054614-00 K 3-35

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

The priority pause mask is a bitmap of CoS values for which pause is being enabled. SANsurfer FC/CNA HBA CLI allows you to select or clear boxes from 0 to 7, representing the different CoS values for which pause is being enabled (or disabled). Because FCoE uses CoS 3 and because FC is lossless, you must enable pause for CoS 3.

If you need to change the FCoE CoS value, you should also enable pause for the new CoS value.

These values need not be modified when talking to a switch that supports DCBX (for example, the Cisco Nexus 5020 switch). The values are valid only when talking to a switch that does not support DCBX.

HBA Parameters (All HBAs)

3: HBA Parameters n: All HBAs

When you select this option, the parameters listed in “HBA Parameters (Per

Adapter Port)” on page 3-25 appear for every adapter.

Target/LUN List Menu

(Command Line Options -t and -l)

4: Target/LUN List

This option shows the main Target List Menu, which includes a list of all adapters and port instances detected on the host. You have the option to select:

 Each adapter port individually  All adapters

Here is an example of the Target List Menu:

HBA Model QLA2462

1: Port 1: WWPN: 21-00-00-E0-8B-1F-9D-F0 Online 2: Port 2: WWPN: 21-01-00-E0-8B-3F-9D-F0 Online

HBA Model QLE2562

3: Port 1: WWPN: 21-00-00-1B-32-1B-4E-4C Online 4: Port 2: WWPN: 21-01-00-1B-32-3B-4E-4C Online 5: All HBAs 6: Return to Previous Menu

Table 3-2 lists the variables and their descriptions for target/LUN information.

3-36 SN0054614-00 K

3–Interactive Commands

Target/LUN List Menu (Command Line Options -t and -l)

Table 3-2. Target/LUN Information

Variable Description

<address> IP address.

<hba instance> Adapter number (adapter instance number).

<hba wwpn> Adapter world wide port name, format xx-xx-xx-xx-xx-xx-xx-xx

or xxxxxxxx.

<lun id> Logical unit number (0–255).

<target id> Target ID.

<target portid> Target world wide port name, format xx-xx-xx or xxxxxx.

<target wwnn> Target world wide node name, format xx-xx-xx-xx-xx-xx-xx-xx

or xxxxxxxx.

<target wwpn> Target world wide port name, format xx-xx-xx-xx-xx-xx-xx-xx or

xxxxxxxx.

Target/LUN List (Per Adapter Port)

4: Target/LUN List 1 - n Target List Menu - Port n

When you select an HBA port instance from the Target/LUN List, a list of LUNs (disks) attached to that port instance appears. Technical information for each LUN appears, including:

 Vendor  Product ID  Product Revision  Serial Number  Node Name  Port Name  Port ID

Here is an example of a typical menu item:

1: Disk(Online)

Vendor : SEAGATE

Product ID : ST318453FC

Product Rev : 0006

Serial Number : 3JA9TN7600007517T6P1

Node Name : 20-00-00-11-C6-2D-5B-F9

Port Name : 22-00-00-11-C6-2D-5B-F9

Port ID : 02-0A-DC

2: Disk (Online)

SN0054614-00 K 3-37

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

Vendor : SEAGATE

Product ID : ST318453FC

Product Rev : 0006

Serial Number : 3JA9TN7600007523T6P1

Node Name : 20-00-00-11-C6-2D-5B-FA

Portname : 22-00-00-11-C6-2D-5B-FA

Port ID : 02-0A-DE

And so on.

You can select any LUN and view additional information by entering its number at the prompt and then pressing

ENTER

Per Target/LUN

4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target

When you enter the number for an individual target, the LUN List Menu for that target appears. It includes a list of all LUNs on that target and the following information for each LUN:

 LUN Number

 Vendor  Product ID  Port Name  Port ID

 All LUN(s)

Here is an example of the LUN List Menu:

1: LUN 0

Vendor : SEAGATE Product ID : ST318453FC Port Name : 22-00-00-11-C6-2D-5B-F9 Port ID : 02-0A-DC

And so on.

n: All LUN(s) n: Return to Previous Menu

Per Target/All LUNs

4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target 1 - n: LUN (Number)

When you select a specific LUN from the LUN list, information for the selected LUN appears, as well as options to view additional information and access persistent names. For example:

HBA Instance 2 (QLE2462 Port 1) : Online WWPN: 21-00-00-E0-8B-86-E5-D0

3-38 SN0054614-00 K

3–Interactive Commands

Target/LUN List Menu (Command Line Options -t and -l)

Desc: QLE2462 PCI Express to 4Gb FC Dual Channel

1: Information 2: Persistent Names 3: Return to Previous Menu

Information

4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target 1 - n: LUN (Number) 1: Information

When you select Information from the previous menu, the following information for that LUN appears:

 Product Vendor  Product ID  Product Revision  LUN  Size  Type  WWULN  OS LUN Name (on Solaris and Linux)

For example:

Product Vendor : HP Product ID : MSA VOLUME Product Revision : 6.68 LUN : 8 Size : 4.88 GB Type : SBC-2 Direct access block device (e.g., magnetic disk) WWULN : 60-05-08-B3-00-90-8D-B0-AF-57-A1-B0-88-40-00-20 OS LUN Name : /dev/sdh;

Persistent Names Menu (Command Line Option -pl)

4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target 1 - n: LUN (Number) 2: Persistent Names

NOTE:

The Persistent Names Menu is available only on Linux Red Hat 5 (2.6 kernel) systems; it is not available for Novell SLES.

In large SAN configurations, the udev mechanism eases storage device management by enabling intuitive device file names to help manage LUNs.

SN0054614-00 K 3-39

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

When you select Persistent Names from the previous menu, the following Persistent Names Menu for that LUN appears. This menu provides options to view, add, and delete persistent names for the LUN. For example:

Persistent Names Menu

HBA Instance 2 (QLE2462 Port 1) : Online WWPN: 21-00-00-E0-8B-86-E5-D0 Desc: QLE2462 PCI Express to 4Gb FC Dual Channel

1: Info 2: Add 3: Delete 4: Return to Previous Menu

1. Info To view information about the selected LUN’s persistent binding, select

1 on the Persistent Names Menu. The following shows an example of the

information that appears:

Product Vendor : HP Product ID : MSA VOLUME Product Revision : 6.68 LUN : 8 WWULN : OS LUN Name : /dev/sdh; Persistent LUN Name :

60-05-08-B3-00-90-8D-B0-AF-57-A1-B0-88-40-00-20

2. Add To add persistent binding for the LUN, select 2 on the Persistent

Names Menu. The following device information is shown and you are prompted to

enter a new persistent device name. For example:

-----------------------------------------------------------Product Vendor : HP Product ID : MSA VOLUME Product Revision : 6.68 LUN : 8 WWULN : OS LUN Name : /dev/sdh;

-----------------------------------------------------------Persistent LUN Name : Enter new persistent device names: MSA_UDEV New persistent device name has been added to LUN 8 (TID 4). Please reboot or run 'udevtrigger' command for the changes to take effect

Hit <RETURN> to continue:

For the persistent device name change to take effect and show in the Persistent Names Info output, you must either reboot the system or run the

-udevtrigger command.

60-05-08-B3-00-90-8D-B0-AF-57-A1-B0-88-40-00-20

3-40 SN0054614-00 K

3–Interactive Commands

Target/LUN List Menu (Command Line Options -t and -l)

3. Delete To delete persistent binding for the LUN, select 3 on the Persistent

Names Menu. SANsurfer FC/CNA HBA CLI lists the existing LUN persistent

binding names, prompts you to select one for deletion, and then immediately deletes the persistent LUN name. For example:

1: test1

2: Return to Previous Menu

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

-----------------------------------------------------------Product Vendor : SANBlaze Product ID : VLUN FC RAMDisk Product Revision : 3.1. LUN : 28 WWULN : OS LUN Name : /dev/sdbh;/dev/sg59;

-----------------------------------------------------------Persistent LUN Name : test1 Persistent device name of LUN 28 (TID 1) has been deleted. Please reboot or run 'udevtrigger' command for the changes to take effect

60-00-62-B0-00-0F-53-50-00-00-00-00-00-00-00-1C

Hit <RETURN> to continue:

CAUTION!

Do not delete a LUN’s persistent device name if there is any active I/O on the LUN.

For the persistent device name deletion to take effect, you must either reboot the system or run the -udevtrigger command.

All Targets

4: Target/LUN List 1 - n Target List Menu Port n 1 - n: Target m: All LUNs

When you select a specific LUN from the LUN list, the following information for all LUNs appears:

 Product Vendor  Product ID  Product Revision  LUN  Size  Type  WWULN  OS LUN Name (on Solaris and Linux)

(Repeats for each LUN)

SN0054614-00 K 3-41

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

Here is an example of the LUN information.

Product Vendor : SEAGATE Product ID : ST318453FC Product Revision : 0006 LUN : 0 Size : SBC-2 Direct Access block device

(e.g. magnetic disk)

WWULN : 20-00-00-11-C6-2D-5A-3F

-----------------------------------------------------------------Hit <Return> to continue:

And so on. Repeats for each LUN.

Target/LUN List (All Adapters)

4: Target/LUN List  N: All HBAs

This choice shows the Target List Menu for All HBAs:

 Individual Target  Individual LUN  All Target(s)  All LUN(s)

Individual Target

4: Target/LUN List  N: All HBAs  1: Individual Target

This choice shows the Target List Menu for All HBAs. Information for each individual target includes:

 (Target type) on QLAxxxx (adapter instance n)

 Vendor  Product ID  Product Revision  Serial Number  Port Name  Port ID

 Repeats for each target

Here is an example of the Target List Menu for All HBAs:

1: Disk 0 on QLA2462 (HBA Instance 0)

Vendor : SEAGATE Product ID : ST336607FC Product Rev : 0006 Serial Number : 3JA9TN7600007517T6P1 Port Name : 22-00-00-11-C6-2D-5B-F9 Port ID : 02-0A-DC

3-42 SN0054614-00 K

Target/LUN List Menu (Command Line Options -t and -l)

1: Disk 1 on QLA2462 (HBA Instance 0)

Vendor : SEAGATE Product ID : ST336607FC Product Rev : 0006 Serial Number : 3JA9TN7600007517FK7W Port Name : 22-00-00-11-C6-2D-5A-B8 Port ID : 02-0A-EO

And so on.

Individual LUN

4: Target/LUN List  n: Port Number  1: Individual LUN  1 - n: Target

When you select an individual target, the following target information appears:

 Path  Target  Device ID  Product Vendor  Product ID  Product Revision  Node Name  Port Name  Product Type  LUN Count(s)  Status

3–Interactive Commands

Here is an example of the Target information:

Path : 0 Target : 3 Device ID : 0x87 Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 Serial Number : 3JA9TN7600007517T6P1 Node Name : 20-00-00-11-C6-2D-5B-F9 Port Name : 22-00-00-11-C6-2D-5B-F9 Port ID : 02-0A-DC Product Type : Disk LUN Count(s) : 1 Status : Online

All Targets

4: Target/LUN List n: Port Number 1: Individual LUNs

When you select this option, SANsurfer FC/CNA HBA CLI shows the LUN List Menu containing:

SN0054614-00 K 3-43

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

 Product Vendor  Product ID  Port Name  Port ID  LUN ID  OS LUN Name (on Solaris and Linux)

NOTE:

 In the Solaris OS, the QLA adapter driver supports a maximum of 256

LUNs.

 In the Solaris OS, the QLC adapter driver supports a maximum of 16K

LUNs.

Here is an example of the LUN information:

Product Vendor : SEAGATE Product ID : ST336607FC Product Revision : 0006 LUN : 0 Size : 34.18 GB Type : SBC-2 Direct access block device

(e.g., magnetic disk)

WWULN : 20-00-00-0C-50-68-1E-9A

-----------------------------------------------Hit (RETURN) to continue:

All Target(s)

4: Target/LUN List n: Port Number 3: All Target(s)

This choice shows information for all targets connected to the system, including:

 Path  Target  Device ID  Product Vendor  Product ID  Product Revision  Serial Number  Node Name  Port Name  Port ID  Product Type  LUN Count(s)  Status

3-44 SN0054614-00 K

3–Interactive Commands

Target/LUN List Menu (Command Line Options -t and -l)

Here is an example of the All Targets option.

Note: 0 to return to Main Menu Enter Selection: 3

-----------------------------------------------------------------HBA Instance 5: QLA2300 Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 PortID 11-05-EF

-----------------------------------------------------------------Path : 0 Target : 0 Device ID : 0x85 Product Vendor : SEAGATE Product ID : ST136403FC Product Revision : FF5F Serial Number : LT06464600001011HGGH Node Name : 20-00-00-20-37-1A-6B-CF Port Name : 21-00-00-20-37-1A-6B-CF Port ID : 11-01-E4 Product Type : Disk LUN Count(s) : 1 Status : Online

---------------------------------------------------------------

And so forth.

All LUN(s)

4: Target/LUN List n: Port Number 3: All LUN(s)

When you select this option, SANsurfer FC/CNA HBA CLI shows the following information about all LUNs for all adapter port instances:

 Product Vendor  Product ID  Product Revision  LUN  Size (in GB or MB)  Type (for example, magnetic disk)  WWULN (world-wide unique LUN name)  OS LUN Name (on Solaris and Linux)

NOTE:

 In the Solaris OS, the QLA adapter driver supports a maximum of 256

LUNs.

 In the Solaris OS, the QLC adapter driver supports a maximum of 16K

LUNs.

Here is an example of the All LUNs information:

SN0054614-00 K 3-45

3–Interactive Commands Target/LUN List Menu (Command Line Options -t and -l)

------------------------------------------------------------HBA Instance 0: QLA2462 Port 1 WWPN 21-00-00-E0-8B-1F-9D-F0 Port ID 02-00-00

------------------------------------------------------------Target WWPN (22-00-00-04-CF-9C-24-CA)

------------------------------------------------------------Product Vendor : SEAGATE Product ID : ST318203FC Product Revision : 0006 LUN : 0 Size : 34.18 GB Type : SBC-2 Direct access block device

(e.g., magnetic disk)

WWULN : 20-00-00-20-37-38-73-BC

Press <Enter> to continue:

Target information repeats for each target.

Here is an example of the All LUNs information for Linux:

Product Vendor : HITACHI Product ID : HUS103073FLF210 Product Revision : FA16 LUN : 0 Size : 68.37 GB Type : SBC-2 Direct access block device

(e.g., magnetic disk) WWULN : 20-00-00-00-87-72-85-B2 OS LUN Name : /dev/sda

Here is an example of the All LUNs information on Solaris with a QLA driver:

Product Vendor : SUN Product ID : StorEdge 3510 Product Revision : 415F LUN : 15 Size : 4.88 GB Type : SBC-2 Direct access block device

(e.g., magnetic disk) WWULN : 60-0C-0F-F0-00-00-00-00-09-8B-68-37-E0-B19B-04 OS LUN Name : /dev/rdsk/c1t0d0s15

3-46 SN0054614-00 K

3–Interactive Commands

Target Link Speed or iiDMA Settings Menu (Command Line Option -q)

Target Link Speed or iiDMA Settings Menu

(Command Line Option -q)

5: Target Link Speed or 5: iiDMA Settings

NOTE:

Depending on your system, the SANsurfer FC/CNA HBA CLI Main Menu may show either the Target Link Speed option or the iiDMA Settings option.

This option shows the Target Link Speed Menu or iiDMA Menu that includes a list of all adapters and port instances detected, including the options to select:

 Each adapter port instance, individually  All adapters

Here is an example of the Target Link Speed Menu or iiDMA Settings Menu:

HBA Model QLA2342:

1. Port 1 WWPN 21-00-00-EO-8B-01-43-9B Online

2. Port 2 WWPN 21-01-00-E0-8B-21-43-9B Online

HBA Model QLA2300:

3. Port 1 WWPN 21-00-00-E0-8B-05-CB-D8 Loop down

4. Port 2 WWPN 21-01-00-E0-8B-25-CB-D8 Online

HBA Model QLA2462:

5. Port 1 WWPN 21-00-00-E0-8B-1P-9D-P0 Online

6. Port 2 WWPN 21-01-00-E0-8B-3P-9D-P0 Loop down

HBA Model QLA21O:

7. Port 1 WiIPN 21-00-00-E0-8B-1A-3F-E0 Online

8. All HBAs

9. Return to Previous Menu

Table 3-3 lists the target link speed settings and descriptions.

Table 3-3. Target Link Speed Settings

Target Link Speed Settings Description

<address> IP address.

<hba instance> Adapter number (adapter instance number).

<hba wwnn> Adapter world wide port name, format

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.

<lun id> Logical unit number (0–255).

<speed> Target Link Speed (iiDMA) - (1, 2, or 4 Gbs).

SN0054614-00 K 3-47

3–Interactive Commands Target Link Speed or iiDMA Settings Menu (Command Line Option -q)

Table 3-3. Target Link Speed Settings (Continued)

Target Link Speed Settings Description

<target id> Tar g e t I D .

<target portid> Target world wide port name, format xx-xx-xx or

xxxxxx.

<target wwnn> Target World Wide Node Name, format

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.

<target wwpn> Target world wide port name, format

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxx.

-targets | -t All targets.

Configuring the iiDMA Settings

Use the intelligent interleaved direct memory access (iiDMA) menu to select the intelligent interleave factor settings per adapter type and device.

NOTE:

The iiDMA options are not available for the QLE8042 adapter with FCoE engine.

To configure iiDMA settings:

1. From the SANsurfer FC/CNA HBA CLI main menu, select iiDMA Settings.

2. Select the adapter that you want to apply the iiDMA update.

3. Select one of the following options:

 Basic Configuration if you want to apply the iiDMA update to all

devices attached to this adapter.

 Advanced Configuration if you want to select an apply different

iiDMA update to each device attached to this adapter.

4. To use Basic Configuration:

a. Select the adapter.

b. Select the iiDMA from the intelligent interleave factor speed list (1

Gbps, 2 Gbps, 4 Gbps, or 8 Gbps) to all attached devices.

c. Choose one of the following options:

 To apply the new settings to all attached devices, select Yes.

The following is returned:

3-48 SN0054614-00 K

Q-Logic FC0E, FC User Manual

Specifications and Main Features

Frequently Asked Questions

User Manual

Table of Contents

Preface

Intended Audience

What’s in This Guide

Documentation Conventions

License Agreements

Related Materials

Technical Support

Availability

Training

Contact Information

1 Installation and Removal

Supported QLogic Adapters

Supported Operating Systems

System Requirements

Hardware Requirements

Software Requirements

Unsupported Features

Downloading the Installation Package

Installing SANsurfer FC/CNA HBA CLI

Windows Installation

Standard (GUI) Installation

Command Line Installation

Linux Installation

Solaris Installation

Solaris SPARC 8, 9, 10 Installation

Solaris x86 9 and 10 Installation

Macintosh Installation

Standard (GUI) Installation

Command Line Installation

VMware Installation

Uninstalling SANsurfer FC/CNA HBA CLI

Windows Uninstall

Standard (GUI) Uninstall

Command Line Uninstall

Linux Uninstall

Solaris Uninstall

Solaris SPARC 8, 9, and 10 Uninstall

Solaris x86 8, 9, and 10 Uninstall

Macintosh Uninstall

VMware Uninstall

2 Getting Started

Starting Interactive Mode

Starting Non-Interactive Mode

Terminology

Advanced Features

3 Interactive Commands

Display (Host Topology) (Command Line Option -tp | -topology)

Save As XML File

Generate Report (Per Adapter Port)

HBA Information Menu (Command Line Option -i)

Refresh

HBA General Information (per Adapter Port)

HBA Information (All HBAs)

Information

HBA Parameters Menu

HBA Parameters (Per Adapter Port)

Restore Defaults

HBA Parameters (Per FCoE Engine)

Display FCoE Parameters

Configure FCoE Parameters

HBA Parameters (All HBAs)

Target/LUN List (Per Adapter Port)

Per Target/LUN

Per Target/All LUNs

All Targets

Target/LUN List (All Adapters)

Individual Target

Individual LUN

All Targets

All Target(s)

All LUN(s)

Target Link Speed or iiDMA Settings Menu (Command Line Option -q)

Configuring the iiDMA Settings