Summary of the content on the page No. 1
SANsurfer FC/CNA HBA CLI
User’s Guide
Command Line Interface for
QLogic FC and FCoE Adapters
SN0054614-00 K
Summary of the content on the page No. 2
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 pro
Summary of the content on the page No. 3
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- 3 Interactive Commands mands chapter. Added Flash Image Version to list of actual VPD “Generate Report (Per Adapter Port)” on information. page 3-11 Added new ENode MAC Address information for “HBA Information (Command Line Option -i)” on QLE81xx adapters. page 3-21 Added cautions about deleting the LUN persistent “Persistent Names Menu (Command Line Opti
Summary of the content on the page No. 4
SANsurfer FC/CNA HBA CLI User’s Guide Command Line Interface for QLogic FC and FCoE Adapters Notes iv SN0054614-00 K
Summary of the content on the page No. 5
Table of Contents Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv What’s in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xv Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvi Related Materials. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xvii License Agreements. . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 6
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 . . . . . . .
Summary of the content on the page No. 7
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. . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 8
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) . . . . . . . . . .
Summary of the content on the page No. 9
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
Summary of the content on the page No. 10
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. . . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 11
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
Summary of the content on the page No. 12
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) . . . . . . . . . . . . . . . . . .
Summary of the content on the page No. 13
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-1
Summary of the content on the page No. 14
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 . . . . . . . . . . . . . .
Summary of the content on the page No. 15
Preface ® The SANsurfer FC/CNA HBA CLI tool provides a command line interface (CLI) ® that lets you easily install, configure, and deploy QLogic Fibre Channel (FC) 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
Summary of the content on the page No. 16
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 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. 2 Getting Started describes the two modes used in SANsurfer FC/CNA HBA CLI: interactive and non-inter
Summary of the content on the page No. 17
Preface License Agreements Text in ALL CAPITALS indicates the name of a key that you press on the keyboard. For example: Type the number for Host Information and then press ENTER. Italicized text indicates either a document reference, glossary term, or emphasis. For example: Attached Port means a QLogic adapter.... For a complete list, see the QLogic SAN Interoperability Guide. Italicized text within angle brackets indicates user-defined variables. For example: # scli -k ( |
Summary of the content on the page No. 18
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 s
Summary of the content on the page No. 19
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 SANsurf
Summary of the content on the page No. 20
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 i
