Qlogic 2400 Series, 2500 Series, 3200 Series, 2600 Series, 8200 Series User Manual

...

Download

Page 1

User’s Guide

QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

SN0054667-00 G

Page 2

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

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

Document Revision History

Revision A, December 13, 2010

Revision B, March 31, 2011

Revision C, October 19, 2011

Revision D, September 12, 2012

Revision E, November 12, 2012

Revision F, March 19, 2013

Revision G, May 6, 2013

Changes Sections Affected

Modified note explaining requirement for tape devices and backup software

Added “all” parameter to command line definition for -z option

Added footnote explaining requirement for tape devices and backup software

Changed command name from “FC Adapter Information” to “All Information”

“Hardware Requirements” on page 1-1

“Host Configuration (Command Line Option -z)” on page 6-2

“Adapter Parameters” on page 6-28

“-z (All Information)” on page 6-41

ii SN0054667-00 G

Page 3

Table of Contents

Preface

What Is in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xix

What Is in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xx

Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

Downloading Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiii

Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

Contact Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

Knowledge Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

1 System Requirements

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

Software Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Operating System Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2

Supported QLogic Adapters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4

2 Installing and Uninstalling QConvergeConsole CLI

Downloading QConvergeConsole CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1

Installing QConvergeConsole CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2

Installing QConvergeConsole CLI in a Windows Environment . . . . . . 2-2

Standard Windows Interactive (CLI) Installation. . . . . . . . . . . . . 2-2

Quiet or Silent Windows Installation . . . . . . . . . . . . . . . . . . . . . . 2-3

Passive Windows Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3

Installing QConvergeConsole CLI in a Linux Environment . . . . . . . . . 2-3

Installing QConvergeConsole CLI in a Solaris Environment . . . . . . . . 2-3

Installation using Package Files (Solaris 10 or 11) . . . . . . . . . . . 2-4

Installation using p5p Files (Solaris 11 only). . . . . . . . . . . . . . . . 2-5

Uninstalling QConvergeConsole CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Uninstalling QConvergeConsole CLI in a Windows Environment . . . . 2-6

Start Menu Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Control Panel Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

SN0054667-00 G iii

Page 4

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-6

Uninstalling QConvergeConsole CLI in a Linux Environment . . . . . . . 2-7

Uninstalling QConvergeConsole CLI in a Solaris Environment. . . . . . 2-7

Uninstalling a Package Installation (Solaris 10 or 11). . . . . . . . . 2-7

Uninstalling a p5p Installation (Solaris 11 only) . . . . . . . . . . . . . 2-8

3 Getting Started

Using Noninteractive Mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1

Using Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

Starting QConvergeConsole CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2

Starting QConvergeConsole CLI in Windows. . . . . . . . . . . . . . . 3-2

Starting QConvergeConsole CLI in Linux. . . . . . . . . . . . . . . . . . 3-2

Starting QConvergeConsole CLI in Solaris. . . . . . . . . . . . . . . . . 3-3

Main Menu. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Menu Navigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-3

Getting Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-4

4 General Noninteractive Commands

Viewing General Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Viewing All Inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

Viewing All Flash Image Versions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4

Viewing All Matching Flash Image Versions. . . . . . . . . . . . . . . . . . . . . . . . . 4-5

Viewing All Flash Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10

5 NIC Noninteractive Commands

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

-beacon . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

-c (NIC Port Setting Configuration). . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

-cardreset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

-ch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

-d . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

-ei. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

-extloopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

-flashsupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

-g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

-h (Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

-i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

-icna (CNA Adapter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

-idcbx. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

-intloopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-9

iv SN0054667-00 G

Page 5

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

-iset (Display Configured Port Settings) . . . . . . . . . . . . . . . . . . . . . . . 5-9

-link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

-minidump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-10

-n (Change Port Alias Name [NIC Configuration]) . . . . . . . . . . . . . . . 5-10

-nh (Adapter Alias [NIC Configuration]) . . . . . . . . . . . . . . . . . . . . . . . 5-11

-pinfo (CNA Port Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

-ping. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

-rc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

-sreset (Reset NIC Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

-statport (Display NIC Port Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

-sunreset (Undo Reset NIC Statistics) . . . . . . . . . . . . . . . . . . . . . . . . 5-14

-team_allowCNAsIn8023adTeam (LACP Override) . . . . . . . . . . . . . . 5-15

-teamdel (Delete Team) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15

-teaminfo (Display Team Information). . . . . . . . . . . . . . . . . . . . . . . . . 5-15

-teamlist (Display Teams List). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

-teamnew (Configure New Team). . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

-teamnew_portspreview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

-testflash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

-testhw (Hardware Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

-testinterrupt (Interrupt Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

-testled (Beacon/LED Test). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

-testlink (Link Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

-testregister (Register Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

-trans (Transceiver Monitoring Interface [DMI]) . . . . . . . . . . . . . . . . . 5-19

-updimages (Flash Update) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

-updimages_viewver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-19

-v, -ver (Display Program Version Information). . . . . . . . . . . . . . . . . . 5-20

-vlanadd (Add VLAN to Port or Team) . . . . . . . . . . . . . . . . . . . . . . . . 5-20

-vlanadd_preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21

-vlandel (Remove VLAN from Port or Team) . . . . . . . . . . . . . . . . . . . 5-21

-vlandel_preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21

-vlaninfo (Display VLAN Information) . . . . . . . . . . . . . . . . . . . . . . . . . 5-22

-vlanlist (Display VLAN List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22

-vpd (CNA VPD Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22

-vtcfgview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22

-vtrestore (Restore VLAN & Teaming Configuration) . . . . . . . . . . . . . 5-24

-vtsave (Save VLAN & Teaming Configuration) . . . . . . . . . . . . . . . . . 5-26

-zvt (Display Teams List; Display VLAN List; Display VLAN

Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-27

SN0054667-00 G v

Page 6

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

6 Fibre Channel Noninteractive Commands

Displaying System Information (Command Line Options -g, -z, and -tp) . . . 6-1

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

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

Host Port Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

-a . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

-b (Flash Update; Save Flash) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

-c (Display HBA Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

-cna (CNA FCoE Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

-dm (Transceiver Diagnostics Monitoring Interface [DMI]) . . . . . . . . . 6-10

-e (Boot Devices Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

-ei. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

-f . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

-fg . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

-fs (Driver Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

-fwdump (Firmware Dump). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-g (Generate Reports) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-gs (Configure Parameters [FC Port Statistics]) . . . . . . . . . . . . . . . . . 6-15

-h (Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

-ha (Adapter Alias [FCoE Configuration]) . . . . . . . . . . . . . . . . . . . . . . 6-17

-i (FC Adapter Information; FC VPD Information). . . . . . . . . . . . . . . . 6-17

-kl (Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18

-kr (Read Write Buffer Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

Running a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . 6-20

Running an Adapter Diagnostics Read/write Buffer Test . . . . . . 6-21

-l (FC Target/LUN Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23

-ls (Display Parameters [HBA Statistics]) . . . . . . . . . . . . . . . . . . . . . . 6-24

-m (Selective LUNs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25

-n (Configure HBA Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27

-o . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-29

-p (Target Persistent Bindings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-30

-pa (Adapter Port Alias [FCoE Configuration]) . . . . . . . . . . . . . . . . . . 6-32

-pc (Adapter Personality Change) . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-33

-pl (Persistent Names (udev) – Linux only) . . . . . . . . . . . . . . . . . . . . 6-33

-q (Target Link Speed [iiDMA]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-34

-r (Parameters Update; Save HBA Parameters) . . . . . . . . . . . . . . . . 6-35

-s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36

vi SN0054667-00 G

Page 7

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

-sp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-36

-t (FC Target/LUN Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-37

-tb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38

-tp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38

-trace . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38

-u . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-38

-v . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-39

-vp (Virtual Ports [NPIV]) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-39

-x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-40

-x2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-40

-z (All Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-41

7 iSCSI Noninteractive Commands

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

-acb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-addchap (Add a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-arp (Display ARP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-b (Save Changes and Reset HBA) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-binfo (Display BIOS/UEFI Information) . . . . . . . . . . . . . . . . . . . . . . . 7-5

-bootcode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-c (CNA Port Information—iSCSI) . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6

-ch (CNA Adapter Information—iSCSI) . . . . . . . . . . . . . . . . . . . . . . . 7-6

-chapmap (Display Targets Using CHAP Entries) . . . . . . . . . . . . . . . 7-6

-cpbootcode (Clear Primary Boot Target Information) . . . . . . . . . . . . 7-6

-csbootcode (Clear Secondary Boot Target Information) . . . . . . . . . . 7-6

-d (Drivers Update) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

-dc (Display Destination Cache [IPv6]). . . . . . . . . . . . . . . . . . . . . . . . 7-7

-dce (Display Connection Error Log) . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

-defbidi (Add a Default BIDI CHAP) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

-delchap (Delete a CHAP Entry). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-7

-df . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

-dp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-8

-dr (Display Default Router List [IPv6]) . . . . . . . . . . . . . . . . . . . . . . . . 7-8

-dspchap (Display CHAP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

-dtdsp (Display Discovered Targets). . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

-dtdspa (List Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-9

-dtdupd (Duplicate a Discovered Target) . . . . . . . . . . . . . . . . . . . . . . 7-9

-dtdupd (Duplicate a Persistent Target) . . . . . . . . . . . . . . . . . . . . . . . 7-9

-dtli (Login and Persist a Discovered Target) . . . . . . . . . . . . . . . . . . . 7-9

User’s Guide—QConvergeConsole CLI

SN0054667-00 G vii

Page 8

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

-dtlia (Login and Persist a Discovered Target) . . . . . . . . . . . . . . . . . . 7-10

-dtrem (Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

-dtrema (Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . 7-10

-dumpcore . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

-dumpnvram (Retrieve FW Flash & NVRAM Record) . . . . . . . . . . . . 7-10

-dv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

-edchap (Edit a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-10

-ei. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

-f . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

-g . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

-gcr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

-h (Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

-i. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-12

-import (Import HBA Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13

-ipdhcp (Configure IP Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

-l (List LUN Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-14

-lcd (Display Configured Link Configuration) . . . . . . . . . . . . . . . . . . . 7-15

-linkchap (Assign a CHAP Entry to a Target) . . . . . . . . . . . . . . . . . . . 7-15

-lp (Display Local Prefix List [IPv6]) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-15

-model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-15

-n (Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16

-nc (Display Neighbor Cache [IPv6]) . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

-netconf (Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-17

-netconf6 (Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-18

-nh (Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

-pa (Add a Target). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

-pad (CNA Port Target/LUN Information–iSCSI) . . . . . . . . . . . . . . . . 7-19

-pb (Bind Target). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-19

-pbootcode (Set Primary Boot Target Information) . . . . . . . . . . . . . . . 7-19

-pdt (Disable a Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

-pet (Enable a Target). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

-pinfo (CNA Port Information—iSCSI) . . . . . . . . . . . . . . . . . . . . . . . . 7-20

-ping (Ping Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

-ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-20

-pu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

-px . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

-r . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-21

-rdf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

-rdh (Port Restore Factory Defaults) . . . . . . . . . . . . . . . . . . . . . . . . . 7-22

viii SN0054667-00 G

Page 9

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

-rwt (Read Write Buffer Test—iSCSI) . . . . . . . . . . . . . . . . . . . . . . . . . 7-23

-save (Save Host Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24

-sbootcode (Set Secondary Boot Target Information) . . . . . . . . . . . . 7-24

-sbootcodecid (Set Alternative Client ID) . . . . . . . . . . . . . . . . . . . . . . 7-24

-sdmrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24

-stadd (Add a Send Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-24

-statport (Display iSCSI Port Statistics) . . . . . . . . . . . . . . . . . . . . . . . 7-25

-stathba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25

-stdsp (Display Send Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-25

-strd (Mark Send Target for re-discovery). . . . . . . . . . . . . . . . . . . . . . 7-26

-strem (Remove a Send Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

-strema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

-t (Display Target Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

-tc (Configure Target Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-26

-tp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

-ts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

-ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

-vpd (CNA VPD Information—iSCSI) . . . . . . . . . . . . . . . . . . . . . . . . . 7-27

8 NIC Partitioning (NPAR) Noninteractive Commands

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-1

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

-ainfo (NPAR Adapter Information). . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

-changepersonality (Change PCI Function Personality). . . . . . . . . . . 8-2

-ei. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

-eswitchinfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

-eswitchstats (General eSwitch Statistics) . . . . . . . . . . . . . . . . . . . . . 8-3

-eswitchvportstats (View All eSwitch Statistics) . . . . . . . . . . . . . . . . . 8-3

-feswitchcfg (Function x ESwitch Configuration) . . . . . . . . . . . . . . . . 8-3

-finfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

-h (Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

-ia. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

-if . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

-ip. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

-peswitchcfg. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

-pinfo (NPAR Port Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

-restoreeswitchcfg (Restore eSwitch Configuration) . . . . . . . . . . . . . 8-5

-setmaxbw (Modify Maximum Bandwidth) . . . . . . . . . . . . . . . . . . . . . 8-6

-setminbw (Modify Minimum Bandwidth) . . . . . . . . . . . . . . . . . . . . . . 8-6

SN0054667-00 G ix

Page 10

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

9 NIC Interactive Commands

Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

CNA Adapter Information (-icna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-2

CNA Port Information (-pinfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

CNA VPD Information (-vpd) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5

Adapter Alias (-nh) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5

NIC Port Setting Configuration (-c). . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6

Display Configured Port Settings (-iset). . . . . . . . . . . . . . . . . . . 9-7

Configure Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

Change Port Alias Name (-n) . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

Change MAC Alias Name (-n) . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

Save Port Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

Adapter Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

Flash Update (-updimages) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9

Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-9

Hardware Test (-testhw) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-10

Interrupt Test (-testinterrupt). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

Link Test (-testlink) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

Beacon/LED Test (-testled). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Display NIC Port Statistics (-statport) . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Reset NIC Statistics (-sreset) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14

Undo Reset NIC Statistics (-sunreset) . . . . . . . . . . . . . . . . . . . . . . . . 9-14

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

10 Fibre Channel Interactive Commands

Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

FC Adapter Information (-i). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-2

FC Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

FC VPD Information (-i) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4

FC Target/LUN Information (-t). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

Adapter Alias (-ha) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

Adapter Port Alias (-pa) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8

HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8

x SN0054667-00 G

Page 11

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Display HBA Parameters (-c). . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9

Configure HBA Parameters (-n) . . . . . . . . . . . . . . . . . . . . . . . . 10-10

Restore Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11

Target Persistent Binding (-p). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12

Persistent Names (-pl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12

Display Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20

Bind Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20

Unbind Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-21

Boot Devices Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-22

Display Boot Device(s) (-e) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-23

Configure Boot Device(s) (-e) . . . . . . . . . . . . . . . . . . . . . . . . . . 10-24

Virtual Ports (NPIV) (-vp) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-25

Target Link Speed (iiDMA) (-q) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-26

Basic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-27

Advanced Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-27

Driver Parameters (-fs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-28

Selective LUNs (-m) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-29

Display LUN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-30

Manual Configure LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-32

Auto Configure LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-32

Quality of Service (QoS) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-33

Export (Save) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-34

Save Flash (-b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-34

Save HBA Parameters (-r). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-34

Generate Reports (-g) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-35

Personality (-pc) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-35

Adapter Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-37

Flash Update (-b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-37

Driver Update (-d). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-38

Parameters Update (-r). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-39

Parameters Template Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-39

Firmware Preload Table Update (-u) . . . . . . . . . . . . . . . . . . . . . . . . . 10-40

Firmware Serdes Table Update (-sp) . . . . . . . . . . . . . . . . . . . . . . . . . 10-40

Fibre Channel Dump (-fwdump) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-41

Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-41

Loopback Test (-kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-42

Display Test Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-43

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-43

Configure Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-43

SN0054667-00 G xi

Page 12

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Start Diagnostics Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-44

Read Write Buffer Test (-kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-45

Display Test Parameters (-kr) . . . . . . . . . . . . . . . . . . . . . . . . . . 10-45

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-46

Configure Test Parameters (-kr) . . . . . . . . . . . . . . . . . . . . . . . . 10-46

Start Diagnostics Test (-kr). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-46

Transceiver Diagnostics Monitoring Interface (DMI) . . . . . . . . . . . . . . 10-47

General (-dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-47

Details (-dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-48

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-49

Display FC Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-49

Display Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-50

Reset Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-50

Configure Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-50

Display HBA Statistics (-gs). . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-51

Display FC Port Link Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-51

Display Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-52

Reset Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-52

Configure Parameters (-ls) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-53

Display Link Statistics (-ls). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-53

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-54

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-55

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-55

11 Converged Network Adapter Interactive Commands

Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2

CNA Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 3

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4

iSCSI (-ch) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4

CNA Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 5

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-5

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-6

iSCSI (-c; -pinfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 7

CNA VPD Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-8

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-9

CNA VLAN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-10

Teaming Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-10

xii SN0054667-00 G

Page 13

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

CNA FCoE Information (-cna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-11

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -12

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-12

CNA iSCSI Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -16

CNA Port Target/LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-17

iSCSI (-pad) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-17

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-19

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-21

CNA FCoE Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-21

Adapter Alias (-ha). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-22

Adapter Port Alias (-pa) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-23

HBA Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -24

Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-27

Boot Devices Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 30

Virtual Ports (NPIV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-33

Target Link Speed (iiDMA) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-37

Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-4 1

Selective LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-43

QoS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -47

Export (Save) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-49

Generate Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-50

Personality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-52

CNA iSCSI Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-53

HBA Level Parameter Configuration . . . . . . . . . . . . . . . . . . . . . 11-53

Port Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -55

Port IP Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-65

Target Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-67

Boot Devices Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 78

Export (Save) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-81

CNA NIC Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-83

Adapter Alias (-nh). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-83

NIC Port Setting Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 11-84

VLAN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-87

Team Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-91

Export (Save) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 1 0 0

Adapter Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 0 1

Flash Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 102

Parameters Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 0 2

Drivers Update (-d) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 0 3

SN0054667-00 G xiii

Page 14

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Firmware Preload Table Update (-u) . . . . . . . . . . . . . . . . . . . . . . . . . 11-103

Firmware Serdes Table Update (-sp) . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 0 4

Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 0 4

Hardware Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-106

Flash Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 106

Interrupt Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-107

Link Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-108

Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-108

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-109

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 109

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-111

Read Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 11 2

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-112

iSCSI (-rwt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-114

Beacon/LED Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-115

Transceiver Diagnostics Monitoring Interface (DMI) (-dmi) . . . . . . . . 11 - 115

General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-116

Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-117

iSCSI Adapter Diagnostics (-dumpnvram) . . . . . . . . . . . . . . . . . . . . . 11 - 11 8

iSCSI Port Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-119

Ping Target (-ping) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-119

Perform Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . 11-120

iSCSI Port Logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-120

Display ARP Table (-arp) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-121

Display Connection Error Log (-dce) . . . . . . . . . . . . . . . . . . . . . 11 - 1 22

Export Connection Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 22

Display Neighbor Cache (IPv6) (-nc) . . . . . . . . . . . . . . . . . . . . . 11-123

Display Destination Cache (IPv6) (-dc) . . . . . . . . . . . . . . . . . . . 11-1 2 3

Display Default Router List (IPv6) (-dr) . . . . . . . . . . . . . . . . . . . 11-123

Display Local Prefix List (IPv6) (-lp). . . . . . . . . . . . . . . . . . . . . . 11- 123

Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -123

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 2 4

Display NIC Port Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -124

Reset NIC Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -125

Undo Reset NIC Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-126

Display FCoE Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 2 6

Display Test Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . 11-127

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 1 28

xiv SN0054667-00 G

Page 15

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Configure Test Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . 11-128

Display HBA Statistics (-gs). . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 2 8

Display FCoE Port Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-129

Display Test Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-130

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 1 30

Configure Test Parameters (-ls). . . . . . . . . . . . . . . . . . . . . . . . . 11- 130

Display Link Statistics (-ls). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 3 1

Display iSCSI Port Statistics (-stat) . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 3 2

Reset iSCSI Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-133

NIC Partitioning (NPAR) Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 134

NPAR Adapter Information (-ainfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 1 3 4

NPAR Port Information (-pinfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11- 135

NIC Partitioning (NPAR) Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-136

Bandwidth Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 137

Modify Minimum Bandwidth (-setminbw) . . . . . . . . . . . . . . . . . . 11-137

Modify Maximum Bandwidth (-setmaxbw) . . . . . . . . . . . . . . . . . 11-138

Change PCI Function Personality (-changepersonality). . . . . . . . . . . 11-1 3 8

ESwitch Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 39

Function 1 ESwitch Configuration (-feswitchcfg) . . . . . . . . . . . . 11-139

Function 3 ESwitch Configuration (-feswitchcfg) . . . . . . . . . . . . 11-139

Restore ESwitch Configuration (-restoreeswitchcfg) . . . . . . . . . 11-139

NIC Partitioning (NPAR) Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-139

General ESwitch Statistics (-eswitchstats) . . . . . . . . . . . . . . . . . . . . . 11-140

View All ESwitch Statistics (-eswitchvportstats) . . . . . . . . . . . . . . . . . 11-141

Function x ESwitch Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-142

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-142

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-143

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 - 1 43

12 Setting Up NIC Partitioning (NPAR) Using Interactive Commands

Setting Up NIC Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-1

A NIC Partitioning (NPAR) Overview

What Is NPAR? . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

QLogic Adapters That Support NPAR . . . . . . . . . . . . . . . . . . . . . . . . . A-3

NIC Partitioning Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-3

Function Type Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

Quality of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-6

eSwitch. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-7

NPAR Setup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

SN0054667-00 G xv

Page 16

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

Default Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

NPAR Configuration Parameters and Setup Tools . . . . . . . . . . . . . . . A-9

Interoperation of Bandwidth Settings for DCBX and NPAR . . . . . . . . . . . . . A-10

Using DCBX and NPAR to Set Bandwidth . . . . . . . . . . . . . . . . . . . . . A-10

Glossary

Index

List of Figures

Figure Page

7-1 Adapter Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-13

12-1 Selecting Option 6 to View NPAR Information Options . . . . . . . . . . . . . . . . . . . . . . 12-2

12-2 Selecting Option 2 to View NPAR Port Information . . . . . . . . . . . . . . . . . . . . . . . . . 12-2

12-3 Viewing NPAR Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3

12-4 Selecting NPAR Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-3

12-5 Selecting to Modify Minimum Bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-4

12-6 Setting Bandwidth Changes to Persist. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-5

12-7 Selecting Function Type on Linux System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12-6

List of Tables

Table Page

6-1 Options Shown by -z . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

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

6-3 DCE Statistics Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

6-4 Driver Settings Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

6-5 Adapter Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

6-6 Diagnostics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22

6-7 Data Pattern (DP) Test Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23

6-8 Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24

6-9 Adapter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-28

7-1 Noninteractive Command Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-1

7-2 CHAP Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-11

7-3 Adapter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-16

8-1 eSwitch Physical Function Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

8-2 eSwitch Physical Port Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

11-1 Default Loopback Test Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-110

11-2 Default Read Write Buffer Test Parameter

Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-113

A-1 Ports and NPAR Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

A-2 Default NPAR Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

A-3 NPAR Configuration Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-8

A-4 NPAR Configuration Parameters and Setup Tools. . . . . . . . . . . . . . . . . . . . . . . . . . A-9

xvi SN0054667-00 G

Page 17

User’s Guide—QConvergeConsole CLI

2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

A-5 NPAR Wake on LAN (WoL) and PXE Boot Support . . . . . . . . . . . . . . . . . . . . . . . . A-9

A-6 Using DCBX and NPAR for Bandwidth Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . A-11

SN0054667-00 G xvii

Page 18

User’s Guide—QConvergeConsole CLI 2400, 2500, 2600, 3200, 8100, 8200, 8300 Series

xviii SN0054667-00 G

Page 19

Preface

This guide describes QConvergeConsole® CLI, which is used to configure and manage QLogic Fibre Channel Adapters, Intelligent Ethernet Adapters, and Converged Network Adapters within SANs.

What Is in This Guide

This guide contains the basic information you need to get started with QConvergeConsole CLI.

This preface explains the QConvergeConsole CLI help system, describes the typographic conventions used in this guide, lists related documents, specifies the intended audience, refers you to the QLogic license agreements, and provides technical support and contact information.

The remainder of the user’s guide is organized into the following chapters:

 Chapter 1 System Requirements lists the hardware, software, and operating

system requirements needed for the successful operation of the QConvergeConsole CLI.

 Chapter 2 Installing and Uninstalling QConvergeConsole CLI describes how

to download, install, and uninstall the utility.

 Chapter 3 Getting Started describes how to start QConvergeConsole CLI on

Windows to view detailed information about command parameters and options.

 Chapter 4 General Noninteractive Commands describes and shows

examples of the general noninteractive commands that apply to all QConvergeConsole CLI supported protocols: NIC, Fibre Channel, and iSCSI.

 Chapter 5 NIC Noninteractive Commands describes the noninteractive NIC

command syntax and parameters.

 Chapter 6 Fibre Channel Noninteractive Commands describes the

noninteractive Fibre Channel command syntax and parameters.

 Chapter 7 iSCSI Noninteractive Commands describes the noninteractive

iSCSI command syntax and parameters.

 Chapter 8 NIC Partitioning (NPAR) Noninteractive Commands describes the

noninteractive NIC Partitioning (NPAR) command syntax and parameters.

, Linux®, and Solaris® platforms. This chapter also describes how

SN0054667-00 G xix

Page 20

Preface What Is in the Help System

 Chapter 9 NIC Interactive Commands contains a description of the

QConvergeConsole CLI NIC interactive mode menus.

 Chapter 10 Fibre Channel Interactive Commands contains a description of

the QConvergeConsole CLI Fibre Channel interactive mode menus.

 Chapter 11 Converged Network Adapter Interactive Commands contains a

description of the QConvergeConsole CLI Converged Network Adapter interactive mode menus for the NIC, iSCSI, Fibre Channel, and NPAR functions.

 Chapter 12 Setting Up NIC Partitioning (NPAR) Using Interactive

Commands contains steps for setting up NIC Partitioning (NPAR) using the

interactive mode menus of QConvergeConsole CLI.

 Appendix A NIC Partitioning (NPAR) Overview provides an overview of NIC

partitioning.

Following these chapters is a glossary of terms and an index to help you quickly locate the information you need.

What Is in the Help System

The QConvergeConsole CLI help system (qaucli -h) contains a condensed version of the NIC, Fibre Channel, iSCSI, and NPAR noninteractive commands described in Chapters 5 through 8.

Intended Audience

This guide is for system administrators who are responsible for installing, configuring, and managing QLogic adapters using QConvergeConsole CLI.

Related Materials

For additional help installing or using QConvergeConsole CLI, refer to the following related documents posted on the QLogic Web site

http://driverdownloads.qlogic.com

 QConvergeConsole CLI Readme

For information about the QConvergeConsole GUI utility, refer to the following document:

 QConvergeConsole User’s Guide (part number SN0054669-00)

xx SN0054667-00 G

Page 21

Documentation Conventions

NOTE

CAUTION

This guide uses the following documentation conventions:

 provides additional information.

 without an alert symbol indicates the presence of a hazard

that could cause damage to equipment or loss of data.

 Tex t i n blue font indicates a hyperlink (jump) to a figure, table, or section in

this guide, and links to Web sites are shown in underlined blue example:

 Table 9-2 lists problems related to the user interface and remote agent.  See “Installation Checklist” on page 3-6.  For more information, visit www.qlogic.com

 Tex t i n bold font indicates user interface elements such as a menu items,

buttons, check boxes, or column headings. For example:

Preface

Documentation Conventions

. For

 Click the Start button, point to Programs, point to Accessories, and

then click Command Prompt.

 Under Notification Options, select the Warning Alarms check box.

 Tex t i n Courier font indicates a file name, directory path, or command line

text. For example:

 To return to the root directory from anywhere in the file structure:

cd /root and press ENTER.

Type

 Enter the following command: sh ./install.bin

 Key names and key strokes are indicated with UPPERCASE:

 Press CTRL+P.  Press the UP ARROW key.

 Tex t i n italics indicates terms, emphasis, variables, or document titles. For

example:

 For a complete listing of license agreements, refer to the QLogic

Software End User License Agreement.

SN0054667-00 G xxi

Page 22

Preface

NOTE

Documentation Conventions

 What are shortcut keys?

 To enter the date type mm/dd/yyyy (where mm is the month, dd is the

 Topic titles between quotation marks identify related topics either within this

manual or in the online help, which is also referred to as the help system throughout this document.

 Command line interface (CLI) command syntax conventions include the

following:

 Plain text indicates items that you must type as shown. For example:

 < > (angle brackets) indicate a variable whose value you must specify.

day, and yyyy is the year).

 qaucli -pr nic -ei

For example:

 <serial_number>

For CLI commands only, variable names are always indicated using angle brackets instead of italics.

 [ ] (square brackets) indicate an optional parameter. For example:

 [<file_name>] means specify a file name, or omit it to select

the default file name.

 | (vertical bar) indicates mutually exclusive options; select one option

only. For example:

 on|off  1|2|3|4

 ... (ellipsis) indicates that the preceding item may be repeated. For

example:

 x... means one or more instances of x.  [x...] means zero or more instances of x.

 { } (braces) denote a parameter group that you can specify one or

more times:

 When used together, ( ) (parentheses) and { } (braces) indicate

grouping of parameters to avoid logical ambiguity. For example:

 a|b c is ambiguous

{(a|b) c} means a or b, followed by c {a|(b c)} means either a, or b c

xxii SN0054667-00 G

Page 23

License Agreements

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

Technical Support

Customers should contact their authorized maintenance provider for technical support of their QLogic 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.

For details about available service plans, or for information about renewing and extending your service, visit the Service Program Web page at

http://www.qlogic.com/Support/Pages/ServicePrograms.aspx

Downloading Updates

Preface

License Agreements

The QLogic Web site provides periodic updates to product firmware, software, and documentation.

To download firmware, software, and documentation:

1. Go to the QLogic Downloads and Documentation page:

http://driverdownloads.qlogic.com

2. Under QLogic Products, type the QLogic model name in the search box.

3. In the search results list, locate and select the firmware, software, or documentation for your product.

4. View the product details Web page to ensure that you have the correct firmware, software, or documentation. For additional information, click the Read Me and Release Notes icons under Support Files.

5. Click Download Now.

6. Save the file to your computer.

7. If you have downloaded firmware, software, drivers, or boot code, follow the installation instructions in the Readme file.

Instead of typing a model name in the search box, you can perform a guided search as follows:

1. Click the product type tab: Adapters, Switches, Routers, or ASICs.

2. Click the corresponding button to search by model or operating system.

SN0054667-00 G xxiii

Page 24

Preface Technical Support

3. Click an item in each selection column to define the search, and then click Go.

4. Locate the firmware, software, or document you need, and then click the icon to download or open the item.

Training

QLogic Global Training maintains a Web site at www.qlogictraining.com offering online and instructor-led training for all QLogic products. In addition, sales and technical professionals may obtain Associate and Specialist-level certifications to qualify for additional benefits from QLogic.

Contact Information

QLogic Technical Support for products under warranty is available during local standard working hours excluding QLogic Observed Holidays. For customers with extended service, consult your plan for available hours. For Support phone numbers, see the Contact Support link at support.qlogic.com.

Support Headquarters

QLogic Web Site

Technical Support Web Site

QLogic Corporation 4601 Dean Lakes Blvd. Shakopee, MN 55379 USA

www.qlogic.com

http://support.qlogic.com

Technical Support E-mail

Technical Training E-mail

Knowledge Database

The QLogic knowledge database is an extensive collection of QLogic product information that you can search for specific solutions. QLogic is constantly adding to the collection of information in the database to provide answers to your most urgent questions. Access the database from the QLogic Support Center:

http://support.qlogic.com

support@qlogic.com

training@qlogic.com

xxiv SN0054667-00 G

Page 25

1 System Requirements

NOTE

QConvergeConsole CLI is a management utility that centralizes management and configuration of QLogic adapters within the entire network (LAN and SAN). For optimum performance, QConvergeConsole CLI requires the hardware, software, and operating systems listed in this chapter:

 Hardware Requirements

 Software Requirements

 Operating System Requirements

 Supported QLogic Adapters

Hardware Requirements

For the latest information on supported hardware, refer to the QConvergeConsole CLI Readme and Release Notes.

QConvergeConsole CLI requires the following minimum hardware for the workstation server:

 Server.

“Operating System Requirements” on page 1-2

systems.

 Processor. Pentium® II processor, 300MHz.  Memory. 64MB of physical RAM to run QConvergeConsole CLI.  Hard disk space. About 26MB disk space.

The minimum hardware requirements for the adapter are as follows:

 Adapters. One or more of the QLogic adapters listed under “Supported

QLogic Adapters” on page 1-4.

SN0054667-00 G 1-1

Single-processor or multiprocessor server or workstation. See

for a list of operating

Page 26

1–System Requirements

NOTE

Software Requirements

The minimum requirements for a SAN environment are as follows:

 Storage. Fibre Channel or iSCSI devices, such as disks and RAID

subsystems. QConvergeConsole CLI supports most Fibre Channel and iSCSI devices. For details, see the QLogic Storage Networking Interoperability Guide, which you can download from the following QLogic Web page: http://connect.qlogic.com/interopguide/info.asp

Tape devices and Backup Protection Software must support persistent binding.

Software Requirements

For the latest information on supported software, refer to the QConvergeConsole CLI Readme and Release Notes.

QConvergeConsole CLI requires the following software for the server on which your adapter is physically installed:

 Administrative privileges to perform management functions

 QLogic adapter drivers for your operating system

Refer to the QLogic Web site for QLogic adapter drivers and agents:

http://driverdownloads.qlogic.com

Operating System Requirements

QConvergeConsole CLI runs on the following platforms:

 Microsoft

 Red Hat

 Novell

 Oracle

 Solaris

Windows Server®

Linux® Advance Server/Enterprise Server

SUSE

Linux Unbreakable Enterprise Kernel (UEK) R2 (2.6.39-400 kernel)

Linux Enterprise Server (SLES®)

SPARC® and Solaris x86

1-2 SN0054667-00 G

Page 27

NOTE

1–System Requirements

Operating System Requirements

For an up-to-date list of supported operating system versions, refer to the QConvergeConsole CLI Readme, which can be downloaded where QConvergeConsole CLI is posted on the QLogic Web site:

http://driverdownloads.qlogic.com

SN0054667-00 G 1-3

Page 28

1–System Requirements

NOTE

Supported QLogic Adapters

QConvergeConsole CLI supports the following QLogic-branded adapters:

 2400/2500/2600 Series Fibre Channel Adapters

 3200 Series Intelligent Ethernet Adapters

 8100/8200/8300 Series Converged Network Adapters

For information about QLogic adapters, refer to the QLogic Web site at

http://www.qlogic.com/Products/adapters

To determine support for OEM-branded adapters, please contact your OEM.

1-4 SN0054667-00 G

Page 29

2 Installing and Uninstalling

NOTE

QConvergeConsole CLI

This chapter describes how to download, install, and uninstall QConvergeConsole CLI.

 Downloading QConvergeConsole CLI  “Installing QConvergeConsole CLI” on page 2-2  “Uninstalling QConvergeConsole CLI” on page 2-6

QConvergeConsole CLI is designed to configure QLogic adapters on the local machine (where it is installed). It cannot configure adapters on remote machines.

Downloading QConvergeConsole CLI

Follow this procedure to download the QConvergeConsole CLI package file from the QLogic Web site to your computer.

To download QConvergeConsole CLI from the QLogic Web site:

1. Go to the QLogic Downloads and Documentation page:

http://driverdownloads.qlogic.com

2. Under QLogic Products, type the QLogic model name in the search box.

Alternatively, you can click Guided Search to obtain assistance in locating the QConvergeConsole CLI version to download.

3. In the search results list, locate and select the QConvergeConsole CLI version for your operating system.

4. View the product details Web page to ensure that you have the correct QConvergeConsole CLI.

Click the Read Me and Release Notes icons under Support Files for additional information.

5. Click Download Now.

6. Save the file to your computer.

SN0054667-00 G 2-1

Page 30

2–Installing and Uninstalling QConvergeConsole CLI

NOTE

Installing QConvergeConsole CLI

The installation procedures differ depending on the operating system:

 “Installing QConvergeConsole CLI in a Windows Environment” on page 2-2  “Installing QConvergeConsole CLI in a Linux Environment” on page 2-3  “Installing QConvergeConsole CLI in a Solaris Environment” on page 2-3

Installing QConvergeConsole CLI in a Windows Environment

You can install QConvergeConsole CLI from the command prompt using the Microsoft

 Standard Windows Interactive (CLI) Installation  Quiet or Silent Windows Installation  Passive Windows Installation  Installing QConvergeConsole CLI in a Linux Environment

Windows Installer (MSI). Use one of the following methods:

You can also configure the installation using MSI commands. To see a summary of MSI commands, type msiexec at the command prompt.

To obtain more information about MSI, visit the Microsoft Web site.

Standard Windows Interactive (CLI) Installation

To begin a standard installation of QConvergeConsole CLI on a Microsoft Windows operating system, unzip the file that you saved in Step 6 of

“Downloading QConvergeConsole CLI” on page 2-1. Then, issue one of the

following commands on a command line:

QConvergeConsoleCLI-<version>_win.msi

QConvergeConsoleCLI-<version>_win_x64.msi

where <version> is the version number of the QConvergeConsole CLI.

The default directory for the QConvergeConsole CLI utility is:

Program Files\QLogic Corporation\QConvergeConsoleCLI

If you want to install QConvergeConsole CLI in a different directory, enter it in the command line. For example:

QConvergeConsoleCLI-<version>_win.msi installdir=<directory>

or:

QConvergeConsoleCLI-<version>_win_x64.msi installdir=<directory>

where <directory> is the full path name of the installation directory.

2-2 SN0054667-00 G

Page 31

2–Installing and Uninstalling QConvergeConsole CLI

Installing QConvergeConsole CLI in a Linux Environment

Quiet or Silent Windows Installation

A quiet or silent installation installs using defaults. This mode requires no user intervention. Issue the following command for a quiet (silent) installation:

Windows 64-bit:

msiexec.exe /qn /package QConvergeConsoleCLI-<version>-win_x64.msi

Windows 32-bit:

msiexec.exe /qn /package QConvergeConsoleCLI-<version>-win.msi

Passive Windows Installation

A passive installation installs using default settings and displays a progress indication only. This is an unattended mode installation. Issue the following command for a passive installation:

Windows 64-bit:

msiexec.exe /passive /package QConvergeConsoleCLI-<version>-win_x64.msi

Windows 32-bit:

msiexec.exe /passive /package QConvergeConsoleCLI-<version>-win.msi

Installing QConvergeConsole CLI in a Linux Environment

To install QConvergeConsole CLI on a Linux platform, issue the following from the command line:

Linux 32-bit (i386/i686):

# rpm -ivh QConvergeConsoleCLI-<version>.i386.rpm

Linux 64-bit (x64):

# rpm -ivh QConvergeConsoleCLI-<version>.x86_64.rpm

The default installation directory on Linux is:

/opt/QLogic_Corporation/QConvergeConsoleCLI

Red Hat and SUSE Linux also create a soft link from the /usr/local/bin directory to the executable, qaucli.

By default, the /usr/local/bin directory is in the execution path; you need not add it.

QConvergeConsole CLI does not support PowerPC

(PPC).

Installing QConvergeConsole CLI in a Solaris Environment

You can install QConvergeConsole CLI on Solaris using package files or p5p files, Refer to the appropriate following section for instructions.

SN0054667-00 G 2-3

Page 32

2–Installing and Uninstalling QConvergeConsole CLI Installing QConvergeConsole CLI in a Solaris Environment

Installation using Package Files (Solaris 10 or 11)

The following sample output illustrates how to install QConvergeConsole CLI on a Solaris SPARC or Solaris x86 environment using package files:

#gunzip QConvergeConsoleCLI-1.0.03-23-sol8-sol11-x86.pkg.Z #pkgadd -d QConvergeConsoleCLI-1.0.03-23-sol8-sol11-x86.pkg The following packages are available: 1 QCCLI QLogic QConvergeConsole CLI (CNA Configuration Utility) (i386) 1.00.03 Build 23 (Solaris 8-11)

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

Processing package instance <QCCLI> from </qlogic/QConvergeConsoleCLI-1.0.03-23-sol8-sol11-x86.pkg>

QLogic QConvergeConsole CLI (CNA Configuration Utility)(i386) 1.00.03 Build 23 (Solaris 8-11)

QLogic Corporation ## Executing checkinstall script. ## Processing package information. ## Processing system information. 2 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 <QCCLI> [y,n,?] y

Installing QLogic QConvergeConsole CLI (CNA Configuration Utility) as <QCCLI>

## Installing part 1 of 1. /opt/QLogic_Corporation/QConvergeConsoleCLI/adapters.properties /opt/QLogic_Corporation/QConvergeConsoleCLI/agent.properties /opt/QLogic_Corporation/QConvergeConsoleCLI/fc_contents.dat /opt/QLogic_Corporation/QConvergeConsoleCLI/fcscli-exitcodes.txt /opt/QLogic_Corporation/QConvergeConsoleCLI/flashcfg.properties /opt/QLogic_Corporation/QConvergeConsoleCLI/iscli /opt/QLogic_Corporation/QConvergeConsoleCLI/iscli.cfg /opt/QLogic_Corporation/QConvergeConsoleCLI/iscsi_contents.dat /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libHBAAPI.so /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libfcapi.so /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libfcapi2.so /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libncli2.so /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libqlsdm.so /opt/QLogic_Corporation/QConvergeConsoleCLI/libs/libscixicli2.so

2-4 SN0054667-00 G

Page 33

2–Installing and Uninstalling QConvergeConsole CLI

Installing QConvergeConsole CLI in a Solaris Environment

/opt/QLogic_Corporation/QConvergeConsoleCLI/menu.properties .

. . /opt/QLogic_Corporation/QConvergeConsoleCLI/nvramdefs/x8086x34ba/nvram23.dat

/opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli.cfg /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli_contents.dat /opt/QLogic_Corporation/QConvergeConsoleCLI/scli /opt/QLogic_Corporation/QConvergeConsoleCLI/sfcli.properties /opt/QLogic_Corporation/QConvergeConsoleCLI/ucli.sig [ verifying class <none> ] ## Executing postinstall script.

Installation of <QCCLI> was successful.

Installation using p5p Files (Solaris 11 only)

The following sample output illustrates how to install QConvergeConsole CLI on a Solaris 11 SPARC or Solaris 11 x86 environment using p5p files:

# export PKGREPO=/pkgrepo # pkgrepo create $PKGREPO # pkgrecv -s /qlogic/QConvergeConsoleCLI-1.0.03-23-solaris-i386.p5p -d

$PKGREPO qaucli

Processing packages for publisher qlogic ... Retrieving and evaluating 1 package(s)... PROCESS ITEMS GET (MB) SEND (MB) Completed 1/1 4.1/4.1 19.3/19.3

# pfexec pkg set-publisher -p $PKGREPO pkg set-publisher: Updated publisher(s): qlogic # pkg install qaucli Packages to install: 1 Create boot environment: No Create backup boot environment: No Services to change: 1

DOWNLOAD PKGS FILES XFER (MB) SPEED Completed 1/1 285/285 4.1/4.1 0B/s

PHASE ITEMS Installing new actions 503/503 Updating package state database Done Updating image state Done Creating fast lookup database Done

SN0054667-00 G 2-5

Page 34

2–Installing and Uninstalling QConvergeConsole CLI Uninstalling QConvergeConsole CLI

Uninstalling QConvergeConsole CLI

To remove QConvergeConsole CLI from your system, follow the instructions for your operating system:

 Uninstalling QConvergeConsole CLI in a Windows Environment  Uninstalling QConvergeConsole CLI in a Linux Environment  Uninstalling QConvergeConsole CLI in a Solaris Environment

Uninstalling QConvergeConsole CLI in a Windows Environment

The Windows operating system (OS) offers the following methods of uninstalling QConvergeConsole CLI:

 Start Menu Uninstall  Control Panel Uninstall  Command Line Uninstall

Start Menu Uninstall

To uninstall from the Windows Start menu:

1. Go to Start.

2. Point to All Programs, point to QLogic Management Suite, and then click

Uninstall QConvergeConsole CLI.

Control Panel Uninstall

To uninstall from the Control Panel:

1. Go to Start, and then click Control Panel.

2. Double-click Add/Remove Programs.

3. Select QConvergeConsole CLI.

4. Click Change/Remove.

Command Line Uninstall

You can uninstall QConvergeConsole CLI from the command line in interactive, passive, or silent (quiet) mode.

To uninstall interactively from the command line:

Issue one of the following commands from a command prompt:

QConvergeConsoleCLI-<version>-win_x64.msi

QConvergeConsoleCLI-<version>-win.msi

2-6 SN0054667-00 G

Page 35

2–Installing and Uninstalling QConvergeConsole CLI

Uninstalling QConvergeConsole CLI in a Linux Environment

To uninstall in unattended mode from the command line:

Issue the following command from a command prompt:

msiexec /passive /x QConvergeConsoleCLI-<version>-win_x64.msi

msiexec /passive /x QConvergeConsoleCLI-<version>-win.msi

To uninstall in silent mode from the command line:

Issue the following command from a command prompt:

msiexec /q /x QConvergeConsoleCLI-<version>-win_x64.msi

msiexec /q /x QConvergeConsoleCLI-<version>-win.msi

Uninstalling QConvergeConsole CLI in a Linux Environment

To uninstall QConvergeConsole CLI on a Red Hat or SUSE Linux operating system, issue the following command:

# rpm -e QConvergeConsoleCLI

Uninstalling QConvergeConsole CLI in a Solaris Environment

If QConvergeConsole CLI was installed using p5p files, refer to “Uninstalling a p5p

Installation (Solaris 11 only)” on page 2-8. Otherwise, refer to Uninstalling a Package Installation (Solaris 10 or 11).

Uninstalling a Package Installation (Solaris 10 or 11)

If package files were used to install QConvergeConsole CLI in a Solaris 10 SPARC/x86 environment or a Solaris 11 SPARC/x86 environment, follow the steps in the following sample output to uninstall QConvergeConsole CLI:

G13457-T9x6275M2N1# pkgrm QCCLI The following package is currently installed: QCCLI QLogic QConvergeConsole CLI (CNA Configuration Utility) (i386) 1.00.03 Build 23 (Solaris 8-11)

Do you want to remove this package? [y,n,?,q] y

## Removing installed package instance <QCCLI>

This package contains scripts which will be executed with super-user permission during the process of removing this package.

SN0054667-00 G 2-7

Page 36

2–Installing and Uninstalling QConvergeConsole CLI Uninstalling QConvergeConsole CLI in a Solaris Environment

Do you want to continue with the removal of this package [y,n,?,q] y ## Verifying package <QCCLI> dependencies in global zone ## Processing package information. ## Executing preremove script. ## Removing pathnames in class <none> /opt/QLogic_Corporation/QConvergeConsoleCLI/ucli.sig /opt/QLogic_Corporation/QConvergeConsoleCLI/sfcli.properties /opt/QLogic_Corporation/QConvergeConsoleCLI/scli /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli_contents.dat /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli.cfg /opt/QLogic_Corporation/QConvergeConsoleCLI/qaucli /opt/QLogic_Corporation/QConvergeConsoleCLI/nvramdefs/x8086x34ba/nvram23.dat /opt/QLogic_Corporation/QConvergeConsoleCLI/nvramdefs/x8086x34ba /opt/QLogic_Corporation/QConvergeConsoleCLI/nvramdefs/x8086x34a0/nvram23.dat .

. . /opt/QLogic_Corporation/QConvergeConsoleCLI/agent.properties

/opt/QLogic_Corporation/QConvergeConsoleCLI/adapters.properties /opt/QLogic_Corporation/QConvergeConsoleCLI /opt/QLogic_Corporation <shared pathname not removed> /opt <shared pathname not removed> ## Executing postremove script. ## Updating system information.

Removal of <QCCLI> was successful.

Uninstalling a p5p Installation (Solaris 11 only)

If p5p files were used to install QConvergeConsole CLI in a Solaris 11 SPARC/x86 environment, use the pkg uninstall command to uninstall QConvergeConsole CLI, as shown in the following sample output:

solaris-13609# pkg uninstall qaucli Packages to remove: 1 Create boot environment: No Create backup boot environment: No Services to change: 1

PHASE ITEMS Removing old actions 709/709 Updating package state database Done Updating package cache 1/1 Updating image state Done Creating fast lookup database Done

2-8 SN0054667-00 G

Page 37

## Executing postremove script. ## Updating system information.

Removal of <QCCLI> was successful.

2–Installing and Uninstalling QConvergeConsole CLI

Uninstalling QConvergeConsole CLI in a Solaris Environment

SN0054667-00 G 2-9

Page 38

2–Installing and Uninstalling QConvergeConsole CLI Uninstalling QConvergeConsole CLI in a Solaris Environment

2-10 SN0054667-00 G

Page 39

3 Getting Started

QConvergeConsole CLI manages iSCSI, Ethernet, and Fibre Channel functions on QLogic Fibre Channel Adapters, Intelligent Ethernet Adapters, and Converged Network Adapters. This chapter describes how to start the QConvergeConsole CLI using the noninteractive mode (command line interface) and the interactive mode (menu-driven interface), as well as how to get help.

 Using Noninteractive Mode

 “Using Interactive Mode” on page 3-2

 “Getting Help” on page 3-4

Using Noninteractive Mode

Noninteractive mode is a command line interface that executes a command and its parameters, and then terminates. Use the noninteractive mode to run QConvergeConsole CLI from a script file or when you want to perform a single operation. This guide describes the noninteractive mode commands by function in the following chapters:

 Chapter 5 NIC Noninteractive Commands

 Chapter 6 Fibre Channel Noninteractive Commands

 Chapter 7 iSCSI Noninteractive Commands

 Chapter 8 NIC Partitioning (NPAR) Noninteractive Commands

To start the noninteractive QConvergeConsole CLI in Windows operating system shell, and then type a command with one or more command line switches. For specific command formats, refer to the chapter for the corresponding adapter function. For example, to discover iSCSI ports on a Converged Network Adapter, issue the following command:

qaucli -pr iscsi -i

QConvergeConsole CLI is case-sensitive. In addition, file names in some operating systems are case-sensitive; in this case, QConvergeConsole CLI is case-sensitive for that specific file.

For Windows 2008 or later, use administrator mode.

SN0054667-00 G 3-1

or Linux, open an

Page 40

3–Getting Started Using Interactive Mode

Using Interactive Mode

Interactive mode is a menu-driven interface that manages QLogic Ethernet Adapters, QLogic Fibre Channel Adapters, and all functions of QLogic Converged Network Adapters, including NIC, Fibre Channel, iSCSI and NPAR. The interface for each adapter type is described in its own separate chapter:

 Chapter 9 NIC Interactive Commands

 Chapter 10 Fibre Channel Interactive Commands

 Chapter 11 Converged Network Adapter Interactive Commands

 Chapter 12 Setting Up NIC Partitioning (NPAR) Using Interactive

Commands

Starting QConvergeConsole CLI

Start the CLI using the method specified for your operating system: Windows, Linux, or Solaris.

Starting QConvergeConsole CLI in Windows

To start QConvergeConsole CLI in interactive mode in Windows, do one of the following:

 Double-click the QConvergeConsole CLI icon on the desktop.

 Click Start, point to All Programs, point to QLogic Management Suite,

and then click QConvergeConsole CLI.

 Open a command prompt in the installation directory (the default is

C:\Program Files\QLogic Corporation\QConvergeConsoleCLI), and then issue the following command:

qaucli

Starting QConvergeConsole CLI in Linux

To start QConvergeConsole CLI in interactive mode in Linux, issue the following command:

qaucli

3-2 SN0054667-00 G

Page 41

Starting QConvergeConsole CLI in Solaris

To start QConvergeConsole CLI in interactive mode in Solaris, issue the following command:

#qaucli

Main Menu

When you start QConvergeConsole CLI in interactive mode, the Main Menu appears as follows:

Main Menu

1: Adapter Information

2: Adapter Configuration

3: Adapter Updates

4: Adapter Diagnostics

5: Adapter Statistics

6: Refresh

7: Help

8: Exit

3–Getting Started

Main Menu

Please Enter Selection:

After you select an option from the Main Menu, the CLI prompts you to choose an adapter type:

 To manage an Intelligent Ethernet adapter or a Converged Network Adapter,

select the Converged Network Adapter option to open additional menus.

 To manage a Fibre Channel adapter, select the Fibre Channel Adapter

option to open additional menus.

For example:

Adapter Type Selection

1: Converged Network Adapter

2: Fibre Channel Adapter

(p or 0: Previous Menu; m or 98: Main Menu; ex or 99: Quit)

Please Enter Selection:

Menu Navigation

From any menu, type:

 p or 0 (zero) to return to the previous menu  m or 98 to return to the Main Menu  ex or 99 to end the QConvergeConsole CLI session

SN0054667-00 G 3-3

Page 42

3–Getting Started Getting Help

Getting Help

To view help in interactive mode:

Select the 7. Help option.

To view help in noninteractive mode:

Use the -h switch. For example, to list all of the available command line parameters, issue the following command:

qaucli -h

To list available online switches, issue the following commands for their respective adapter types:

qaucli -pr iscsi -h

qaucli -pr nic -h

qaucli -pr fc -h

To list available legacy switches, issue the following commands for their respective adapter types:

qaucli -pr -iscsi -h

qaucli -pr -nic -h

qaucli -pr -fc -h

An example of noninteractive help output is as follows.

QConvergeConsole

Version 1.0.1 (Build 28)

Build Type: Release

Build Date: Jan 26 2012 17:58:07

NAME: qaucli

SYNOSYS:

qaucli [ -pr <nic|iscsi|fc> ] [options]

qaucli [ -nic | -fc | -iscsi ] [options]

DESCRIPTION:

qaucli is a unified command line application, which can be

used to manage all QLogic adapter models.

The overall option (i.e: -pr <protocol> allows user to start

the application with a specific protocol type (NIC/iSCSI/FC)

If no protocol is specified, then all protocols will be enabled

3-4 SN0054667-00 G

Page 43

3–Getting Started

Getting Help

by default.

OPTIONS:

Menu Mode

qaucli - Start in interactive mode

qaucli -pr nic [options] - Launch application with NIC discovery only

qaucli -pr iscsi [options] - Launch application with iSCSI discovery only

qaucli -pr fc [options] - Launch application with FC discovery only

Command Line Mode

qaucli [options] - Execute command line options

qaucli -npar [options] - Execute NPAR command line options

Legacy Modes (Command line mode only):

qaucli -nic [options] - Use NIC legacy command line

netscli [options] - Use NIC legacy command line

qaucli -iscsi [options] - Use iSCSI legacy command line

iscli [options] - Use iSCSI legacy command line

qaucli -fc [options] - Use FC legacy command line

scli [options] - Use FC legacy command line

Additional options:

-h - Display built-in command line syntax

Help about commands, and command options available for each specific

protocol are available by specifying "-h" to the protocol of interest:

qaucli -pr nic | -nic -h - Display NIC protocol usage

qaucli -pr fc | -fc -h - Display FC/FCoE protocol usage

qaucli -pr iscsi | -iscsi -h - Display iSCSI protocol usage

qaucli -pr all -h - Display non-interactive command usage

for all protocols

qaucli -npar -h - Display NPAR commands usage

qaucli -h - Display this usage

Miscelaneous options:

qaucli -v - Display application version

SN0054667-00 G 3-5

Page 44

3–Getting Started Getting Help

An example of noninteractive help output in debug mode is as follows.

D:\BUILD\WINDOWS\unified-release-AUTO\uclibuild\ucli\src\windows_x64\Debug_x64 >

"When the following command is executed: qaucli.exe -pr all -h, the help is printed below

.\qaucli.exe -pr all -h

Usage: qaucli [options]

The following is a simplified help for extension of non-interactive commands for all protocols (NIC/FC/iSCSI).

Non-interactive mode syntax:

qaucli -pr all -switch [options]

where switch is one of the following command line switches:

-help // Display help info

-h // Same as -help

-? // Same as -help

? // Same as -help

-ei // List errors codes for -pr all switches

-svmtool [svm-options] // SVM FW Update Tool

where [svm-options] are:

mode=[version|ver|inventory|update]

// mode of execution

fwup=fw_file_name

output=[stdout|stderr|output_file_name]

// output in xml format; can be repeated

mac=[11:22:33:44:55:66|11-22-33-44-55-66] //limit update to device with physical mac

3-6 SN0054667-00 G

Page 45

NOTE: mac,wwnn and wwpn switches are exclusive

wwpn=[11-22-33-44-55-66-77-88] //limit update to device with WWN NOTE: mac,wwnn and wwpn switches are exclusive

fwdump=fwdump_file_name // NOT implemented yet

comment=[on|true|yes|y|1] // inserts comments into xml output // on mac of the device // and other info if available

discoverall=[on|true|yes|y|1] // discover all adapters; if not set, // only adapters specified in svmtool.cfg // will be discovered. NOTE: discoverall is applicable only for mode=inventory and mode=update

3–Getting Started

Getting Help

-all // same as discoverall=[on|true|yes|y|1] all // same as discoverall=[on|true|yes|y|1]

-suppress_version_match // suppress match check // for version of flash file // and version in svmtool.cfg

-supvermatch // same as -suppress_version_match

Example 1 - Display vesion only

qaucli -pr all -svmtool mode=version

Example 2 - Update FW from file and produce xml output to stdout and to a file; add comments to xml on mac of the device

qaucli -pr all -svmtool mode=update fwup=c:/fw/fw1.bin output=stdout output=c:/xmloutput/1.xml comment=on

Example 3 - Inventory

qaucli -pr all -svmtool mode=update output=stdout

-updimages_viewver <flash_file> // Displays list of IDs that // the flash file supports

-updimages_matcher <flash_file> // Displays matches between // flash file and discovered devices

SN0054667-00 G 3-7

Page 46

3–Getting Started Getting Help

3-8 SN0054667-00 G

Page 47

4 General Noninteractive

Commands

This chapter describes and shows examples of the general noninteractive commands that apply to all QConvergeConsole CLI supported protocols: NIC, Fibre Channel, and iSCSI. The general commands include the all switch.

Use the general interactive commands for:

 Viewing General Help

 “Viewing All Inventory” on page 4-3

 “Viewing All Flash Image Versions” on page 4-4

 “Viewing All Matching Flash Image Versions” on page 4-5

 “Viewing All Flash Updates” on page 4-10

Viewing General Help

To view the general help for all protocols, issue the -pr all -h command as follows:

.\qaucli.exe -pr all -h

QConvergeConsole

Version 1.0.1 (Build 28)

Build Type: Release

Build Date: Jan 26 2012 17:58:07

Usage: qaucli [options]

The following is a simplified help for extension

of non-interactive commands for all protocols (NIC/FC/iSCSI).

Non-interactive mode syntax:

qaucli -pr all -switch [options]

SN0054667-00 G 4-1

Page 48

4–General Noninteractive Commands Viewing General Help

where switch is one of the following command line switches:

-help // Display help info

-h // Same as -help

-? // Same as -help

? // Same as -help

-ei // List errors codes for -pr all switches

-svmtool [svm-options] // SVM FW Update Tool

where [svm-options] are:

mode=[version|ver|inventory|update]

// mode of execution

fwup=fw_file_name

output=[stdout|stderr|output_file_name]

// output in xml format; can be repeated

mac=[11:22:33:44:55:66|11-22-33-44-55-66]

//limit update to device with physical mac

NOTE: mac,wwnn and wwpn switches are exclusive

wwpn=[11-22-33-44-55-66-77-88]

//limit update to device with WWN

NOTE: mac,wwnn and wwpn switches are exclusive

fwdump=fwdump_file_name // NOT implemented yet

comment=[on|true|yes|y|1]

// inserts comments into xml output

// on mac of the device

// and other info if available

discoverall=[on|true|yes|y|1]

// discover all adapters; if not set,

// only adapters specified in svmtool.cfg

// will be discovered.

NOTE: discoverall is applicable only for mode=inventory

and mode=update

-all // same as discoverall=[on|true|yes|y|1]

4-2 SN0054667-00 G

Page 49

4–General Noninteractive Commands

all // same as discoverall=[on|true|yes|y|1]

-suppress_version_match // suppress match check

// for version of flash file

// and version in svmtool.cfg

-supvermatch // same as -suppress_version_match

Example 1 - Display vesion only

qaucli -pr all -svmtool mode=version

Example 2 - Update FW from file and produce xml

output to stdout and to a file;

add comments to xml on mac of the device

qaucli -pr all -svmtool mode=update

fwup=c:/fw/fw1.bin

output=stdout output=c:/xmloutput/1.xml

comment=on

Viewing All Inventory

Example 3 - Inventory

qaucli -pr all -svmtool mode=update output=stdout

-updimages_viewver <flash_file> // Displays list of IDs that

// the flash file supports

-updimages_matcher <flash_file> // Displays matches between

// flash file and discovered devices

Viewing All Inventory

To view the inventory for all protocols, issue the -pr all -svmtool command as follows:

.\qaucli.exe -pr all -svmtool mode=inventory output=stdout fwup=.\p3p10929.bin comment=on

<?xml version="1.0" encoding="UTF-8"?>

SN0054667-00 G 4-3

Page 50

4–General Noninteractive Commands Viewing All Flash Image Versions

</Device>

</Device>

</Device>

</Device>

</SVMInventory>

Viewing All Flash Image Versions

To view the Flash image versions for all protocols, issue the -pr all

-updimages_viewver command as follows:

.\qaucli.exe -pr all -updimages_viewver p3p10929.bin

Using File : p3p10929.bin

Flash Image Version : 1.9.29

4-4 SN0054667-00 G

Page 51

4–General Noninteractive Commands

Viewing All Matching Flash Image Versions

Supported ChipIDs: B0, C0

Found 13 entries for supported card types in file: p3p10929.bin

00 - venid=1077 subvenid=ffff devid=0001 subdevid=ffff

01 - venid=1077 subvenid=1077 devid=8020 subdevid=0233

02 - venid=1077 subvenid=1077 devid=8021 subdevid=0234

03 - venid=1077 subvenid=1077 devid=8022 subdevid=0235

04 - venid=1077 subvenid=1077 devid=8020 subdevid=0210

05 - venid=1077 subvenid=1077 devid=8021 subdevid=0211

06 - venid=1077 subvenid=1077 devid=8022 subdevid=0212

07 - venid=1077 subvenid=1028 devid=8020 subdevid=1f64

08 - venid=1077 subvenid=1028 devid=8021 subdevid=1f64

09 - venid=1077 subvenid=1028 devid=8022 subdevid=1f64

10 - venid=1077 subvenid=1077 devid=8020 subdevid=0228

11 - venid=1077 subvenid=1077 devid=8021 subdevid=0229

12 - venid=1077 subvenid=1077 devid=8022 subdevid=0230

Matching svmtool.cfg with p3p10929.bin

1077 1077 8020 0210 = 1.9.29 - IDs: MATCH (04); Versions: MATCH Overall: MATCH

=====================

MATCH FOUND

=====================

Viewing All Matching Flash Image Versions

To view the Flash image versions that match all protocols, issue the -pr all

-updimages_matcher command as follows:

.\qaucli.exe -pr all -updimages_matcher p3p10929.bin

Loading CNA Data ...

Loading: 1. CNA ... adapters, please wait...

Loading: 1. CNA Physical Port : 1 (Index : 1) ...

Loading: 2. CNA ... adapters, please wait...

Loading: 2. CNA Physical Port : 2 (Index : 1) ...

Loading: 2. CNA Physical Port : 2 (Index : 2) ...

Loading: 2. CNA Physical Port : 1 (Index : 3) ...

Loading: 2. CNA Physical Port : 1 (Index : 4) ...

Loading: 3. CNA ... adapters, please wait...

Loading: 3. CNA Physical Port : 1 (Index : 1) ...

Loading: 3. CNA Physical Port : 2 (Index : 2) ...

SN0054667-00 G 4-5

Page 52

4–General Noninteractive Commands Viewing All Matching Flash Image Versions

Refreshing interfaces ... Please wait ......

Scanning for QLogic adapters, please wait...

Using config file: D:\dan\BUILD\WINDOWS\unified-release-AUTO\uclibuild\ucli\src\windows_x64\Debug _x64\iscli.cfg

Loading iSCSI Data ...

Loading iSCSI Instance: 1 HBA: 1 Physical Port: 1 (CN1000Q , 78-E7-D1-F4-E8-4E) ...

Loading iSCSI Instance: 2 HBA: 1 Physical Port: 2 (CN1000Q , 78-E7-D1-F4-E8-4A) ...

Loading iSCSI Instance: 3 HBA: 2 Physical Port: 1 (QME8242 , 00-0E-1E-04-88-5D) ...

Loading iSCSI Instance: 4 HBA: 2 Physical Port: 2 (QME8242 , 00-0E-1E-04-88-5C) ...

Scanning for QLogic adapters, please wait...

Using File : p3p10929.bin

Flash Image Version : 1.9.29

Supported ChipIDs: B0, C0

Found 13 entries for supported card types in file: p3p10929.bin

00 - venid=1077 subvenid=ffff devid=0001 subdevid=ffff

01 - venid=1077 subvenid=1077 devid=8020 subdevid=0233

02 - venid=1077 subvenid=1077 devid=8021 subdevid=0234

03 - venid=1077 subvenid=1077 devid=8022 subdevid=0235

04 - venid=1077 subvenid=1077 devid=8020 subdevid=0210

05 - venid=1077 subvenid=1077 devid=8021 subdevid=0211

06 - venid=1077 subvenid=1077 devid=8022 subdevid=0212

07 - venid=1077 subvenid=1028 devid=8020 subdevid=1f64

08 - venid=1077 subvenid=1028 devid=8021 subdevid=1f64

09 - venid=1077 subvenid=1028 devid=8022 subdevid=1f64

10 - venid=1077 subvenid=1077 devid=8020 subdevid=0228

11 - venid=1077 subvenid=1077 devid=8021 subdevid=0229

12 - venid=1077 subvenid=1077 devid=8022 subdevid=0230

Searching for match between image file and detected devices ...

==============================================================================

Adapter: SerialNumber=3U702950ET ProtocolType=nic/fcoe/iscsi IsNPARAdapter=0

==============================================================================

NO MATCH Device: vendorID="1077" subVendorID="103c" deviceID="8020" subDeviceID="3346" (ln:-1;chipMatch:1)

bus="0" device="0" function="0" ISP=19 (CNA NIC) display="QLogic CN1000Q Adapter"

4-6 SN0054667-00 G

Page 53

4–General Noninteractive Commands

Viewing All Matching Flash Image Versions

ChipVersion="B0" versionFlashInBinFile=""

MAC="78:e7:d1:f4:e8:48" WWPN="NA" WWNN="NA"

NO MATCH Device: vendorID="103c" subVendorID="103c" deviceID="8021" subDeviceID="3348" (ln:-1;chipMatch:1)

bus="0" device="0" function="0" ISP=20 (CNA FCoE) display="QLogic CN1000Q Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="78:e7:d1:f4:e8:4b" WWPN="21-00-78-E7-D1-F4-E8-4B" WWNN="20-00-78-E7-D1-F4-E8-4B"

NO MATCH Device: vendorID="1077" subVendorID="103c" deviceID="8022" subDeviceID="3347" (ln:-1;chipMatch:1)

bus="0" device="0" function="0" ISP=21 (CNA iSCSI) display="QLogic CN1000Q Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="78:e7:d1:f4:e8:4a" WWPN="NA" WWNN="NA"

NO MATCH Device: vendorID="103c" subVendorID="103c" deviceID="8021" subDeviceID="3348" (ln:-1;chipMatch:1)

bus="0" device="0" function="0" ISP=20 (CNA FCoE) display="QLogic CN1000Q Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="78:e7:d1:f4:e8:4f" WWPN="21-00-78-E7-D1-F4-E8-4F" WWNN="20-00-78-E7-D1-F4-E8-4F"

NO MATCH Device: vendorID="1077" subVendorID="103c" deviceID="8022" subDeviceID="3347" (ln:-1;chipMatch:1)

bus="0" device="0" function="0" ISP=21 (CNA iSCSI) display="QLogic CN1000Q Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="78:e7:d1:f4:e8:4e" WWPN="NA" WWNN="NA"

==============================================================================

Adapter: SerialNumber=AFE1020C03193 ProtocolType=nic IsNPARAdapter=1

==============================================================================

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8020" subDeviceID="0210" (ln:04;chipMatch:1)

bus="0" device="0" function="1" ISP=19 (CNA NIC) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:59" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8020" subDeviceID="0210" (ln:04;chipMatch:1)

bus="0" device="0" function="3" ISP=19 (CNA NIC) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

SN0054667-00 G 4-7

Page 54

4–General Noninteractive Commands Viewing All Matching Flash Image Versions

MAC="00:0e:1e:04:88:5b" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8022" subDeviceID="0212" (ln:06;chipMatch:1)

bus="0" device="0" function="0" ISP=21 (CNA iSCSI) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:5d" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8021" subDeviceID="0211" (ln:05;chipMatch:1)

bus="0" device="0" function="0" ISP=20 (CNA FCoE) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:5f" WWPN="20-01-00-0E-1E-04-88-5F" WWNN="20-00-00-0E-1E-04-88-5F"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8020" subDeviceID="0210" (ln:04;chipMatch:1)

bus="0" device="0" function="0" ISP=19 (CNA NIC) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:58" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8020" subDeviceID="0210" (ln:04;chipMatch:1)

bus="0" device="0" function="2" ISP=19 (CNA NIC) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:5a" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8022" subDeviceID="0212" (ln:06;chipMatch:1)

bus="0" device="0" function="0" ISP=21 (CNA iSCSI) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:5c" WWPN="NA" WWNN="NA"

MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8021" subDeviceID="0211" (ln:05;chipMatch:1)

bus="0" device="0" function="0" ISP=20 (CNA FCoE) display="QLogic QME8242 Adapter"

ChipVersion="B0" versionFlashInBinFile=""

MAC="00:0e:1e:04:88:5e" WWPN="20-01-00-0E-1E-04-88-5E" WWNN="20-00-00-0E-1E-04-88-5E"

==============================================================================

Adapter: SerialNumber=AFC0902A04501 ProtocolType=nic/fcoe IsNPARAdapter=0

==============================================================================

4-8 SN0054667-00 G

Page 55

4–General Noninteractive Commands

Viewing All Matching Flash Image Versions

NO MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8000" subDeviceID="0179" (ln:-1;chipMatch:0)

bus="0" device="0" function="0" ISP=17 (CNA NIC) display="QLogic QLE8142 Adapter"

ChipVersion="A0" versionFlashInBinFile=""

MAC="00:c0:dd:0a:b4:78" WWPN="NA" WWNN="NA"

NO MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8001" subDeviceID="0179" (ln:-1;chipMatch:0)

bus="0" device="0" function="0" ISP=18 (CNA FCoE) display="QLogic QLE8142 Adapter"

ChipVersion="A0" versionFlashInBinFile=""

MAC="00:c0:dd:0a:b4:7a" WWPN="21-00-00-C0-DD-0A-B4-7A" WWNN="20-00-00-C0-DD-0A-B4-7A"

NO MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8000" subDeviceID="0179" (ln:-1;chipMatch:0)

bus="0" device="0" function="1" ISP=17 (CNA NIC) display="QLogic QLE8142 Adapter"

ChipVersion="A0" versionFlashInBinFile=""

MAC="00:c0:dd:0a:b4:79" WWPN="NA" WWNN="NA"

NO MATCH Device: vendorID="1077" subVendorID="1077" deviceID="8001" subDeviceID="0179" (ln:-1;chipMatch:0)

bus="0" device="0" function="0" ISP=18 (CNA FCoE) display="QLogic QLE8142 Adapter"

ChipVersion="A0" versionFlashInBinFile=""

MAC="00:c0:dd:0a:b4:7b" WWPN="21-00-00-C0-DD-0A-B4-7B" WWNN="20-00-00-C0-DD-0A-B4-7B"

=====================

MATCH FOUND

=====================

Matching svmtool.cfg with p3p10929.bin

1077 1077 8020 0210 = 1.9.29 - IDs: MATCH (04); Versions: MATCH Overall: MATCH

=====================

MATCH FOUND

=====================

SN0054667-00 G 4-9

Page 56

4–General Noninteractive Commands Viewing All Flash Updates

Viewing All Flash Updates

To view the Flash update for all protocols, issue the -pr all -svmtool command as follows:

.\qaucli.exe -pr all -svmtool mode=update output=stdout fwup=.\p3p10929.bin comment=on

<?xml version="1.0" encoding="UTF-8"?>

<Message id="0">Update success.</Message>

</SPStatus>

</Application>

</Device>

<Message id="0">Update success.</Message>

</SPStatus>

</Application>

</Device>

4-10 SN0054667-00 G

Page 57

4–General Noninteractive Commands

Viewing All Flash Updates

<Message id="0">Update success.</Message>

</SPStatus>

</Application>

</Device>

<Message id="0">Update success.</Message>

</SPStatus>

</Application>

</Device>

</SVMExecution>

SN0054667-00 G 4-11

Page 58

4–General Noninteractive Commands Viewing All Flash Updates

4-12 SN0054667-00 G

Page 59

5 NIC Noninteractive

NOTE

Commands

This chapter describes the noninteractive NIC command format and parameters of QConvergeConsole CLI.

To view the help, issue the -h command.

Command Format

NIC noninteractive commands have the following format:

qaucli -pr nic [optional parameters] <command option> [positional parameters]

qaucli -pr nic -switch [optional cna_port_instance]

Where switch is one of the following:

 -beacon  -c (NIC Port Setting Configuration)  -cardreset  -ch  -d  -ei  -extloopback  -flashsupport  -g  -h (Help), -?, ?  -i  -icna (CNA Adapter)  -idcbx  -intloopback  -iset (Display Configured Port Settings)  -link  -minidump

SN0054667-00 G 5-1

Page 60

5–NIC Noninteractive Commands

NOTE

Command Format

 -n (Change Port Alias Name [NIC Configuration])  -nh (Adapter Alias [NIC Configuration])  -pinfo (CNA Port Information)  -ping  -rc  -sreset (Reset NIC Statistics)  -statport (Display NIC Port Statistics)  -sunreset (Undo Reset NIC Statistics)  -team_allowCNAsIn8023adTeam (LACP Override)  -teamdel (Delete Team)  -teaminfo (Display Team Information)  -teamlist (Display Teams List)  -teamnew (Configure New Team)  -teamnew_portspreview  -testflash  -testhw (Hardware Test)  -testinterrupt (Interrupt Test)  -testled (Beacon/LED Test)  -testlink (Link Test)  -testregister (Register Test)  -trans (Transceiver Monitoring Interface [DMI])  -updimages (Flash Update)  -updimages_viewver  -v, -ver (Display Program Version Information)  -vlanadd (Add VLAN to Port or Team)  -vlanadd_preview  -vlandel (Remove VLAN from Port or Team)  -vlandel_preview  -vlaninfo (Display VLAN Information)  -vlanlist (Display VLAN List)  -vpd (CNA VPD Information)  -vtcfgview  -vtrestore (Restore VLAN & Teaming Configuration)  -vtsave (Save VLAN & Teaming Configuration)  -zvt (Display Teams List; Display VLAN List; Display VLAN Information)

 When you issue a command, QConvergeConsole CLI loads the adapter,

executes the command, and then returns you to the command prompt.



When the optional parameter

[cna_port_inst]

is omitted, the command

action applies to all adapters detected by QConvergeConsole CLI.

 Not all switches are functional in this release.

 Ensure that you issue only one command at a time.

5-2 SN0054667-00 G

Page 61

Command Summary

NOTE

This section lists each command line option in alphabetic order, and provides a description of each and example of most.

A parenthetical phrase after a command indicates the equivalent interactive menu option. For example, -c that the -c command has an equivalent NIC Port Setting Configuration menu option described in Chapter 9 NIC Interactive Commands.

Not all noninteractive commands have equivalent interactive menu options.

-beacon

To toggle on and off the port beacon (LED), issue the -beacon command as follows:

> qaucli -pr nic -beacon [cna_port_inst] <on:off>

For example:

5–NIC Noninteractive Commands

Command Summary

(NIC Port Setting Configuration) indicates

> qaucli -pr nic -beacon 2 on Loading: 1. CNA . . . Loading: 1. CNA Port index : 1 ... Loading: 1. CNA Port index : 2 ... Successfully set Beacon to: Enabled

-c (NIC Port Setting Configuration)

To view the adapter port configuration, issue the -c command as follows:

> qaucli -pr nic -c [cna_port_inst]

For example:

> qaucli -pr nic -c 1

=== Displaying CNA Port config info for 1. CNA Port Index ===

Port_Alias : None Port_Physical_MAC_Alias : john Port_LLA_MAC_Alias : paul

-cardreset

To activate changes made to the Flash, issue the -cardreset command as follows:

> qaucli -pr nic -cardreset [cna_port_inst]

SN0054667-00 G 5-3

Page 62

5–NIC Noninteractive Commands

-ch

To view the adapter configuration, issue the -ch command as follows:

> qaucli -pr nic -ch [cna_port_inst]

For example:

> qaucli -pr nic -ch 1

=== Displaying CNA config info for 1. CNA Port Index ===

CNA_Alias : CNA X54

-d

To generate Extensible Markup Language (XML) discovery output, issue the -d command as follows:

> qaucli -pr nic -d <flash_file> [xml_output_file]

Where flash_file is the Flash file and xml_output_file is the XML discovery output. If you omit xml_output_file, XML discovery output is written to stdout.xml.

-ei

To view error and exit code information for noninteractive mode, issue the -ei command as follows:

> qaucli -pr nic -ei

-extloopback

To configure external loopback test parameters before you run the test, issue the

-extloopback command as follows:

> qaucli -pr nic -extloopback <cna_port_inst> <tests_num>

<on_error>

Where tests_num specifies the number of tests to run (a value between 1 and 65,535) and on_error specifies the action to take if an error is encountered in the test (0 = ignore the error; 1 = abort the test).

To determine cna_port_inst, issue the following command:

> qaucli -nic -i

-flashsupport

This command lets you use the Flash Support Tool to manage the Flash memory. To use the Flash Support Tool, issue the -flashsupport command as follows:

> qaucli -pr nic -flashsupport [<option>]

5-4 SN0054667-00 G

Page 63

5–NIC Noninteractive Commands

Where <option> is one of the following options:

-d option:

To discover the Converged Network Adapters and generate an XML report, issue the following command:

> qaucli -pr nic -flashsupport -d <flash_file> [out_xml_file]

Where <flash_file> is the name of the Flash file that will be used to update the adapter and out_xml_file is the name of the output XML file.

-u option:

To update the Flash and generate an XML report, issue the following command:

> qaucli -pr nic -flashsupport -u <flash_file>

<input_xml_file> [out_xml_file]

Where <flash_file> is the name of the Flash file that will be used to update the adapter, input_xml_file is the name of the input XML file, and out_xml_file is the name of the output XML file.

-flashsupport

-asn option:

To activate an adapter with a specified serial number, issue the following command:

> qaucli -pr nic -flashsupport -asn --activate <serial_number>

Where <serial_number> is the adapter’s serial number.

-v option:

To display version information, issue the following command:

> qaucli -pr nic -flashsupport -v --version

-h

option:

To display help information, issue the following command:

> qaucli -pr nic -flashsupport -h --help

-vi

option:

To view all available interfaces, issue the following command:

> qaucli -pr nic -flashsupport -vi --view-all-interfaces

-s

option:

To display supported adapters, issue the following command:

> qaucli -pr nic -flashsupport -s --supported <flash_file>

SN0054667-00 G 5-5

Page 64

5–NIC Noninteractive Commands

NOTE

-flashsupport

Where <flash_file> is the name of the Flash file that will be used to update the adapter.

-i option:

To set the adapter interface, issue the following command:

> qaucli -pr nic -flashsupport -i --interface <interface_id>

Where interface_id is an interface ID value displayed by the -vi switch.

You must use the -i command to specify the adapter interface before using any of the following options: -a, -info, -w0, -w1, -p0, or -p1.

-a option:

To burn or update all Flash regions for the interface specified by the previous

-i command, issue the following command:

> qaucli -pr nic -flashsupport -a --all [ql_romimage]

Where <ql_romimage> is the name of the name of the Flash file that will be used to update the adapter. If the file is not specified, the default file (named ql_romimage) in the working directory is used.

-info option:

To display information for the interface specified by the previous -i command (or all discovered adapters when the interface not specified), issue the following command:

> qaucli -pr nic -flashsupport -info --information

-w0

option:

To disable Wake on LAN (WoL) for the interface specified by the previous

-i command, issue the following command:

> qaucli -pr nic -flashsupport -w0 --wol-off

-w1

option:

To enable WoL for the interface specified by the previous -i command, issue the following command:

> qaucli -pr nic -flashsupport -w1 --wol-on

5-6 SN0054667-00 G

Page 65

-g

5–NIC Noninteractive Commands

-p0 option:

To disable pre-eXecution environment (PXE) LAN for the interface specified by the previous -i command, issue the following command:

> qaucli -pr nic -flashsupport -p0 --pxe-off

-p1

option:

To enable PXE LAN for the interface specified by the previous -i command, issue the following command:

> qaucli -pr nic -flashsupport -p1 --pxe-on

To view general system information for the host, issue the -g command as follows:

> qaucli -pr nic -g [cna_port_inst]

For example:

-g

-h (Help)

-i

> qaucli -pr nic -g Using config file: G:\Program Files\QLogic

Corporation\QConvergeConsoleCLI\qaucli.cfg Installation directory: G:\Program Files\QLogic

Corporation\QConvergeConsoleCLI Working dir: G:\Documents and Settings\user1 Using config file: G:\Program Files\QLogic

Corporation\QConvergeConsoleCLI\netscli.cfg

Host Name : APPCRUSHER Host Version: Service Pack 2 (Build 3790) Host Type : Microsoft Windows Server 2003 R2 x64 User Type : Privileged; CNA setup allowed

To view the help file, issue the -h command as follows:

> qaucli -pr nic -h

The QConvergeConsole CLI help file contains a condensed version of the contents of this chapter.

To view a list of all QLogic adapter ports detected, issue the -i command as follows:

> qaucli -pr nic -i [cna_port_inst]

For example:

> qaucli -pr nic -i 1

SN0054667-00 G 5-7

Page 66

5–NIC Noninteractive Commands

-icna (CNA Adapter)

1. CNA: 1 CNA Port: 1 CNA Model: QLE8142 PortID: 0

Mac Phys. Address: 00:c0:dd:12:0f:f4 Loc. Mac: 00:c0:dd:12:0f:f4

CNA Serial Number: AFC0916A07152 MPI FW Version: 1.35.00 Adapter Alias: None

Port Alias: CNA X54

IPv4 Address: 192.168.204.201

IPv6 Addresses: fe80::2c0:ddff:fe12:ff4

-icna (CNA Adapter)

To view adapter information, issue the -icna command as follows:

> qaucli -pr nic -icna [cna_port_inst]

For example:

> qaucli -pr nic -icna 2

=== CNA Information for 2. CNA Port Index === Hostname : WIN-4ZKSPMU5N5L Adapter Model : QLE8142 Chip Model : 8001 Chip Version : A1 Adapter Alias : None Serial Number : RFC0916K61116 MAC Address : 00:c0:dd:10:27:60 MAC Address : 00:c0:dd:10:27:62 Driver Information : Ndis 6.x 10GbE driver (X86) Driver Name : qlge.sys Driver Version : 1.0.1.0 MPI Firmware Version : 1.35.06 PXE Boot Version : NA VLAN & Team Driver Name : VLAN & Team Driver Version : FCoE Driver Version : 9.1.8.17 FCoE Firmware Version : 5.01.03 FCoE SDMAPI Version : 01.28.00.75

-idcbx

To display port data center bridging exchange protocol (DCBX) information, issue the -idcbx command as follows:

> qaucli -pr nic -idcbx [cna_port_inst]

5-8 SN0054667-00 G

Page 67

-intloopback

NOTE

An external loopback test requires the installation of a loopback plug in the port SFP.

To configure loopback test parameters before you run the test, issue the

intloopback command as follows:

> qaucli -pr nic -intloopback <cna_port_inst> <tests_num>

<on_error>

Where <tests_num> specifies the number of tests to run (a value between 1 and 65,535) and <on_error> specifies the action to take if an error is encountered during the test (0 = ignore the error; 1 = abort the test).

-iset (Display Configured Port Settings)

To view configured port settings, issue the -iset command as follows:

5–NIC Noninteractive Commands

-intloopback

> qaucli -pr nic -iset [cna_port_inst]

For Linux and Solaris, the configured port settings and their values are different from what is shown in the following example.

For example:

> qaucli -pr nic -iset 1

=== Configured Port Settings for 1. CNA Port Index === Header_Data_Split_Enable : off IPv4_Large_Send_Offload_v1_Enable : on IPv4_Large_Send_Offload_v2_Enable : on IPv6_Large_Send_Offload_v2_Enable : on IPv4_TCP_Checksum_Offload_Enable : RxTx IPv6_TCP_Checksum_Offload_Enable : RxTx IPv4_UDP_Checksum_Offload_Enable : RxTx IPv6_UDP_Checksum_Offload_Enable : RxTx Jumbo_Frames_MTU_9000_Enable_Rx : off Jumbo_Frames_MTU_9000_Enable_Tx : off LOCAL_Administered_Address_MAC : 00:c0:dd:12:0f:f4 MAC_Address_Alias : paul Receive_Side_Scaling_Enable : on Receive_Ring_Size : 0 Transmit_Ring_Size : 0 PromiscuousModeEnabled : off

SN0054667-00 G 5-9

Page 68

5–NIC Noninteractive Commands

NOTE

-link

Linux does not support the Receive_Side_Scaling_Enable option.

-link

To view the status of the physical link, including the port speed, issue the -link command as follows:

> qaucli -pr nic -link [cna_port_inst]

For example:

> qaucli -pr nic -link 1

=== Physical Link Status for 1. CNA Port Index === Link Status : Up Port Speed : 10 Gbps

-minidump

To dump a firmware core dump into a file for a specific cna_port_inst, issue the -minidump command as follows:

> qaucli -pr nic -minidump <cna_port_inst> <minidump_file>

[force | noforce]

Where minidump_file specifies the name of the dump file, and force and noforce specify how the core dump is created:

 If force is specified, then a new core dump is created and dumped into

the specified file.

 If

noforce is specified, then if a core dump is available, it is dumped into

the specified file.

-n (Change Port Alias Name [NIC Configuration])

To change a port alias name, issue the -n command as follows:

> qaucli -pr nic -n [cna_port_inst] <config_name|config_alias>

<value> [<config_name|config_alias> <value>]

For this release of QConvergeConsole CLI, you can set the following properties:

 Port_Alias  Port_Physical_MAC_Alias  Port_LLA_MAC_Alias

For example:

> qaucli -pr nic -n 1 Port_Alias jwm614

Port_Alias : jwm614

5-10 SN0054667-00 G

Page 69

-nh (Adapter Alias [NIC Configuration])

To configure the adapter, issue the -nh command as follows:

> qaucli -pr nic -nh [cna_port_inst] <config_name|config_alias>

<value> [<config_name|config_alias> <value>]

For this release, you can only set the CNA_Alias property.

For example:

> qaucli -pr nic -nh 1 CNA_Alias george

CNA_Alias : george

-pinfo (CNA Port Information)

To view port information, issue the -pinfo command as follows:

> qaucli -pr nic -pinfo [cna_port_inst]

For example:

> qaucli -pr nic -pinfo

5–NIC Noninteractive Commands

-nh (Adapter Alias [NIC Configuration])

=== Port Information for 1. CNA Port Index ===

Hostname : STARBLAZER Adapter Model : QLE8142 Port Alias : None Physical MAC Address : 00:c0:dd:12:0f:f4 Physical MAC Address Alias : paul Configured (LLA) MAC Address: 00:c0:dd:12:0f:f4 LAA MAC Address Alias : paul IPv4 Address : 192.168.204.201 IPv4 Subnet Mask : 255.255.255.0 IPv4 Default Gateway : 255.255.255.255 IPv4 DHCP Enabled : No DNS Servers : fec0:0:0:ffff::1 : fec0:0:0:ffff::2 : fec0:0:0:ffff::3 IPv6 Addresses : fe80::2c0:ddff:fe12:ff4 : fec0:0:0:ffff::1 : fec0:0:0:ffff::2 IPv6 Default Router : fe80::2c0:ddff:fe12:ff4 Link Status : Up MTU : 1514 Interface Scope ID : 91 Interface Speed : 10 Gbps Interface Description : QLogic 10Gb PCI Ethernet Adapter -

Network Load Balancing Filter Device

=== Port Information for 2. CNA Port Index === . . .

SN0054667-00 G 5-11

Page 70

5–NIC Noninteractive Commands

-ping

To run a ping diagnostic, issue the -ping command as follows:

> qaucli -pr nic -ping <cna_port_inst> <hostname_or_IPv4> [<count>

<packet size> <timeout_ms> <TTL>]

Where the default parameter values are as follows:

count = 5 packet size = 525 timeout_ms = 1000 TTL = 30

For example:

> qaucli -pr nic -ping 1 starblazer Loading: 1. CNA ... Loading: 1. CNA Port index : 1 ... Loading: 1. CNA Port index : 2 ... Got IP: 192.168.104.142 for starblazer

------------------

ping IPv4

------------------

Got IP: 192.168.104.142 for starblazer Pinging 192.168.104.142 ... Ping Response Received, roundtrip=0 ms, hops=0 Ping Response Received, roundtrip=0 ms, hops=0 Ping Response Received, roundtrip=0 ms, hops=0 Ping Response Received, roundtrip=0 ms, hops=0 Ping Response Received, roundtrip=16 ms, hops=0 Summary: ping failed 0, ping success 5 ping timeout 0

-rc

To view a list of error codes and their descriptions, issue the -rc command as follows:

> qaucli -pr nic -rc

-sreset (Reset NIC Statistics)

To reset the Ethernet statistics counters, issue the -sreset command as follows:

> qaucli -pr nic -sreset [cna_port_inst]

For example:

> qaucli -pr nic -sreset 1

Port statistics reset for 1. CNA Port Index

5-12 SN0054667-00 G

Page 71

-statport (Display NIC Port Statistics)

To view the Ethernet port statistics, issue the -statport command as follows:

> qaucli -pr nic -statport [cna_port_inst]

For example:

> qaucli -pr nic -statport 1

Port statistics for 1. CNA Port Index txPkts : 12989 txOctets : 2302620 txMulticastPkts : 8444 txBroadcastPkts : 4195 txUnicastPkts : 350 txControlPkts : 0 txPausePkts : 0 txPkts64Octets : 1013 txPkts65to127Octets : 8746 txPkts128to255Octets : 422 txPkts256to511Octets : 2458 txPkts512to1023Octets : 0 txPkts1024to1518Octets : 350 txPkts1519toMaxOctets : 0 txUndersizePkts : 0 txOversizePkts : 0 rxOctets : 3051428 rxPkts : 18724 rxBroadcastPkts : 5728 rxMulticastPkts : 12646 rxUnicastPkts : 350 rxUndersizePkts : 0 rxOversizePkts : 0 rxJabberPkts : 0 rxUndersizeFCSerrorPkts : 0 rxPkts64Octets : 417 rxPkts65to127Octets : 9351 rxPkts128to255Octets : 8252 rxPkts256to511Octets : 354 rxPkts512to1023Octets : 0 rxPkts1024to1518Octets : 350 rxPkts1519toMaxOctets : 0 rxControlPkts : 0 rxPausePkts : 0 txCBFCPauseFrames0 : 0 txCBFCPauseFrames1 : 0 txCBFCPauseFrames2 : 0 txCBFCPauseFrames3 : 0 txCBFCPauseFrames4 : 0 txCBFCPauseFrames5 : 0 txCBFCPauseFrames6 : 0 txCBFCPauseFrames7 : 0 txFCoEPkts : 306

5–NIC Noninteractive Commands

-statport (Display NIC Port Statistics)

SN0054667-00 G 5-13

Page 72

5–NIC Noninteractive Commands

-sunreset (Undo Reset NIC Statistics)

txMgmtPkts : 7921 rxCBFCPauseFrames0 : 0 rxCBFCPauseFrames1 : 0 rxCBFCPauseFrames2 : 0 rxCBFCPauseFrames3 : 0 rxCBFCPauseFrames4 : 0 rxCBFCPauseFrames5 : 0 rxCBFCPauseFrames6 : 0 rxCBFCPauseFrames7 : 0 rxFCoEPkts : 0 rxMgmtPkts : 7912 rxPktsPriority0 : 0 rxPktsPriority1 : 0 rxPktsPriority2 : 0 rxPktsPriority3 : 306 rxPktsPriority4 : 0 rxPktsPriority5 : 0 rxPktsPriority6 : 0 rxPktsPriority7 : 0 txPktsPriority0 : 0 txPktsPriority1 : 0 txPktsPriority2 : 0 txPktsPriority3 : 306 txPktsPriority4 : 0 txPktsPriority5 : 0 txPktsPriority6 : 0 txPktsPriority7 : 4762 rxPktsDiscardPriority0 : 0 rxPktsDiscardPriority1 : 0 rxPktsDiscardPriority2 : 0 rxPktsDiscardPriority3 : 0 rxPktsDiscardPriority4 : 0 rxPktsDiscardPriority5 : 0 rxPktsDiscardPriority6 : 0 rxPktsDiscardPriority7 : 0

-sunreset (Undo Reset NIC Statistics)

To undo the resetting of Ethernet statistics counters, issue the -sunreset command as follows:

> qaucli -pr nic -sunreset [cna_port_inst]

For example:

> qaucli -pr nic -sunreset 1

Port statistics undo reset for 1. CNA Port Index

5-14 SN0054667-00 G

Page 73

5–NIC Noninteractive Commands

NOTE

-team_allowCNAsIn8023adTeam (LACP Override)

This command is supported only for Windows.

To allow Converged Network Adapters in 802.3 teams, issue the

-team_allowCNAsIn8023adTeam command as follows:

> qaucli -pr nic -team_allowCNAsIn8023adTeam <on|off>

Where on enables the link aggregation control protocol (LACP) override and off disables the LACP override. For example:

> qaucli -pr nic -team_allowCNAsIn8023adTeam on

... Successfully configured the Team Settings...

> qaucli -pr nic -team_allowCNAsIn8023adTeam off

... Successfully configured the Team Settings...

-teamdel (Delete Team)

To delete a team, issue the -teamdel command as follows:

> qaucli -pr nic -teamdel <team_inst|ALL>

For example:

> qaucli -pr nic -teamdel 3

About to delete team: 1 (QLogic VT-IM Miniport Driver #2). Please wait ...

Successfully deleted team: 1 ()

-teaminfo (Display Team Information)

To view information about a team, issue the -teaminfo command as follows:

> qaucli -pr nic -teaminfo <team_inst|ALL>

For example:

> qaucli -pr nic -teaminfo ALL

***** Team: QLogic VT-IM Miniport Driver #2 ******

Team Description: QLogic VT-IM Miniport Driver #2 Team Type : Fail Over Driver Name : qlvtid.sys Driver Version : 1.0.0.2 Driver Date : 05/26/2009

SN0054667-00 G 5-15

Page 74

5–NIC Noninteractive Commands

-teamlist (Display Teams List)

VLAN Enabled : Disabled VLAN ID : None MAC Address : 00:c0:dd:0a:b1:a9 MTU : 1500 IPv4 Address : 169.254.27.115 Subnet Mask : 255.255.0.0 IPv6 Address : fe80::2c0:ddff:fe0a:b1a9 Link Status : Unknown

-teamlist (Display Teams List)

To view a list of all previously configured teams (if any), issue the -teamlist command as follows:

> qaucli -pr nic -teamlist

For example:

> qaucli -pr nic -teamlist

Using config file: .\netscli.cfg

Loading: 1. CNA ...

Loading: 1. CNA Port index : 1 ...

Loading: 1. CNA Port index : 2 ...

Team: 1 Team Description: QLogic VT-IM Miniport Driver #2 VLAN ID: None Team Type: Fail Over

Team Members:

CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b1:a8 Description: QLogic 10Gb PCI Ethernet Adapter

CNA: 1 CNA Port: 2 MAC: 00:c0:dd:0a:b1:a9 Description: QLogic 10Gb PCI Ethernet Adapter #2

-teamnew (Configure New Team)

To configure a new team, issue the -teamnew command as follows:

> qaucli -pr nic -teamnew <team_type> <port_insts|ALL>

Where team_type specifies a numeric value and port_insts specifies a list of comma-separated port indices (for example 1,2).

5-16 SN0054667-00 G

Page 75

5–NIC Noninteractive Commands

The team_type variable can have the following values:

1=Fail-safe team

2=Switch independent load balancing

3=802.3ad static team

-teamnew_portspreview

4=802.3ad dynamic team —

5=802.3ad dynamic team — passive LACP

active link aggregation control protocol (LACP)

For example:

> qaucli -pr nic -teamnew 1 ALL

User selected CNA Port Indices: ALL

Attempting to create new team:

Team Description:

Team Type: Fail Over

Selected ports : 1, 2

CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b1:a8 Description: QLogic 10Gb PCI Ethernet Adapter - Network Load Balancing Filter Device

QLogic 10Gb PCI Ethernet Adapter - Network Load Balancing Filter Device

CNA: 1 CNA Port: 2 MAC: 00:c0:dd:0a:b1:a9 Description: QLogic 10Gb PCI Ethernet Adapter #2 - Network Load Balancing Filter Device

QLogic 10Gb PCI Ethernet Adapter #2 - Network Load Balancing Filter Device

About to create the team. Please wait ...

Successfully created team with interface description: QLogic VT-IM Miniport Driver #2

-teamnew_portspreview

To preview ports before you configure a new team, issue the

-teamnew_portspreview command as follows:

> qaucli -pr nic -teamnew_portspreview

For example:

> qaucli -pr nic -teamnew_portspreview

1. CNA: 1 CNA Port: 1 CNA Model: QLE8142 PortID: 0

Mac Phys. Address: 00:c0:dd:12:0f:f4 Loc. Mac: 00:c0:dd:12:0f:f4

CNA Serial Number: AFC0916A07152 MPI FW Version: 1.35.02 Adapter Alias: None

Port Alias: None

IPv4 Address: 192.168.204.201

SN0054667-00 G 5-17

Page 76

5–NIC Noninteractive Commands

NOTE

-testflash

IPv6 Addresses: fe80::2c0:ddff:fe12:ff4

2. CNA: 1 CNA Port: 2 CNA Model: QLE8142 PortID: 1

Mac Phys. Address: 00:c0:dd:12:0f:f6 Loc. Mac: 00:c0:dd:12:0f:f6

CNA Serial Number: AFC0916A07152 MPI FW Version: 1.35.02 Adapter Alias: None

Port Alias: None

IPv4 Address: 192.168.205.200

IPv6 Addresses: fe80::2c0:ddff:fe12:ff6

-testflash

To test the Flash memory, issue the -testflash command as follows:

> qaucli -pr nic -testflash [cna_port_inst]

To stop an active diagnostic test, press ENTER. To use an alternate key to stop tests, modify this line in the sfcli.properties configuration file:

Default: node.app.diag.ascii.abortkey=CR

Custom: node.app.diag.ascii.abortkey=<stop key>

Where <stop key> is any alphabetic character a–z or A–Z (uppercase characters require pressing SHIFT+<stop key>).

Example 1: To set the stop key to S (press SHIFT+S to stop the test):

node.app.diag.ascii.abortkey=S

Example 2: To set the stop key to s (press S to stop the test):

node.app.diag.ascii.abortkey=s

-testhw (Hardware Test)

To test the hardware, issue the -testhw command as follows:

> qaucli -pr nic -testhw [cna_port_inst]

-testinterrupt (Interrupt Test)

To test the interrupt, issue the -testinterrupt command as follows:

> qaucli -pr nic -testinterrupt [cna_port_inst]

-testled (Beacon/LED Test)

To test the LED, issue the -testled command as follows:

> qaucli -pr nic -testled [cna_port_inst]

5-18 SN0054667-00 G

Page 77

-testlink (Link Test)

To test the link, issue the -testlink command as follows:

> qaucli -pr nic -testlink [cna_port_inst]

-testregister (Register Test)

To test the register, issue the -testregister command as follows:

> qaucli -pr nic -testregister [cna_port_inst]

-trans (Transceiver Monitoring Interface [DMI])

To display transceiver diagnostics monitoring interface (DMI) data, issue the

-trans command as follows:

> qaucli -pr nic -trans [cna_port_inst]

-updimages (Flash Update)

5–NIC Noninteractive Commands

-testlink (Link Test)

To update the Flash (boot and firmware) images, issue the -updimages command as follows:

> qaucli -pr nic -updimages [cna_port_inst] <image_file>

For example:

> qaucli -pr nic -updimages 1 "c:\my dir\valid-image-file" netscli -updimages c:\temp\temp1 Loading: 1. CNA ... Loading: 1. CNA Port index : 1 ... Loading: 1. CNA Port index : 2 ... === Updating images for 1. CNA Port Index === Loading, please wait ... Successfully updated Flash (Boot & Firmware images) for 1. Port

Index from file: c:\temp\temp1 === Updating images for 2. CNA Port Index === Loading, please wait ... Successfully updated Flash (Boot & Firmware images) for 2. Port

Index from file: c:\temp\temp1

-updimages_viewver

To view the Flash version, issue the -updimages_viewver command as follows:

> qaucli -pr nic -updimages_viewver image_file

SN0054667-00 G 5-19

Page 78

5–NIC Noninteractive Commands

NOTE

-v, -ver (Display Program Version Information)

To view the version number of QConvergeConsole CLI, issue the -v or -ver command as follows:

> qaucli -pr nic -v > qaucli -pr nic -ver

For example:

> qaucli -pr nic -ver

Using config file: G:\Program Files\QLogic Corporation\QConvergeConsoleCLI\qaucli.cfg

Installation directory: G:\Program Files\QLogic Corporation\QConvergeConsoleCLI

Working dir: G:\Documents and Settings\user1 Using config file: G:\Program Files\QLogic

Virtual LAN (VLAN) is a Windows-specific feature. The following VLAN commands run successfully only in a Windows environment.

-vlanadd (Add VLAN to Port or Team)

To add a VLAN to a port or team, issue the -vlanadd command as follows:

> qaucli -pr nic -vlanadd <port_insts> <vlan_id>

Where port_insts specifies a list of comma-separated port indices (for example, 1,2) and vlan_id specifies a numeric value 1–4095.

For example:

> qaucli -pr nic -vlanadd 2 120 Using config file: .\netscli.cfg Loading: 1. CNA ... Loading: 1. CNA Port index : 1 ... Loading: 1. CNA Port index : 2 ... VLAN List: ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC:

00:c0:dd:0a:b1:a8 Description: QLogic 10Gb PCI Ethernet Adapter Network Load Balancing Filter Device

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b1:a9 Description: QLogic 10Gb PCI Ethernet Adapter #2

- Network Load Balancing Filter Device

User entered ListIndices: 2 User entered VLAN ID: 120 About to set VLAN ID: 120 for ListIndex: 2 Successfully set.

5-20 SN0054667-00 G

Page 79

-vlanadd_preview

To preview the VLAN, port, and team information before you add a VLAN to a port or team, issue the -vlanadd_preview command as follows:

> qaucli -pr nic -vlanadd_preview

For example:

> qaucli -pr nic -vlanadd_preview

VLAN List: ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC:

00:c0:dd:0a:b1:a8 Description: QLogic 10Gb PCI Ethernet Adapter Network Load Balancing Filter Device

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b1:a9 Description: QLogic 10Gb PCI Ethernet Adapter #2

- Network Load Balancing Filter Device

-vlandel (Remove VLAN from Port or Team)

To remove all VLANs from a port or team, issue the -vlandel command as follows:

5–NIC Noninteractive Commands

-vlanadd_preview

> qaucli -pr nic -vlandel <port_insts|ALL> <vlan_id|ALL>

Where port_insts specifies the port’s indices comma separated (for example, 1,2) and vlan_id specifies a numeric value 1–4095.

For example:

> qaucli -pr nic -vlandel ALL ALL

VLAN List: ListIndex: 1 CNA: 1 CNA Port: 2 VLAN ID: 120 MAC:

00:c0:dd:0a:b1:a9 Description: QLogic 10Gb PCI Ethernet Adapter #2

User entered ListIndices: ALL User entered VLAN ID: ALL About to remove VLAN ID(s) for ListIndex: 1. (QLogic 10Gb PCI

Ethernet Adapter #2) Please wait ... Successfully removed VLAN ID.

-vlandel_preview

To preview the virtual LAN, port, and team information before you delete a VLAN from a port or team, issue the -vlandel_preview command as follows:

> qaucli -pr nic -vlandel_preview

For example:

> qaucli -pr nic -vlandel_preview

VLAN List: ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: 453 MAC:

00:c0:dd:12:0f:f4 Description: QLogic 10Gb PCI Ethernet Adapter

SN0054667-00 G 5-21

Page 80

5–NIC Noninteractive Commands

NOTE

-vlaninfo (Display VLAN Information)

To view information about the VLAN, issue the -vlaninfo command as follows:

> qaucli -pr nic -vlaninfo <vlan_inst|ALL>

For example:

> qaucli -pr nic -vlaninfo 1

VLAN(s) Information: Updating VLANs info ... Done ... No VLANs to display.

-vlanlist (Display VLAN List)

To view the adapters, ports, teams, VLAN IDs, and descriptions, issue the

-vlanlist command as follows:

> qaucli -pr nic -vlanlist

For example:

> qaucli -pr nic -vlanlist

VLAN List: CNA: 1 CNA Port: 2 VLAN ID: 120 MAC: 00:c0:dd:0a:b1:a9

Description: QLogic VT-IM Miniport Driver #2

-vpd (CNA VPD Information)

To display vital product data (VPD) information, issue the -vpd command as follows:

> qaucli -pr nic -vpd [cna_port_inst]

-vtcfgview

To view the contents of the previously saved VLAN and teaming configuration settings file (see -vtsave (Save VLAN & Teaming Configuration)), issue the

-vtcfgview command as follows:

> qaucli -pr nic -vtcfgview [state_cfg_file]

If you do not specify a file name, QConvergeConsole CLI reads the default file (vtstate.cfg) in the installation directory.

For example:

>qaucli -pr nic -vtcfgview c:/system_1.cfg

Using config file: E:\Program Files\QLogic\Corporation \QConvergeConsoleCLI\netscli.cfg

5-22 SN0054667-00 G

Page 81

5–NIC Noninteractive Commands

Accessing file: c:/system_1.cfg

Number of Teams: 1

----------------

type=Fail Over MAC: 00:c0:dd:0a:b4:61 00:c0:dd:0a:b4:60 (VLAN IDs: 555)

Number of Ports: 3

----------------

MAC :00:c0:dd:0a:b4:34 (VLAN IDs: 35)

MAC :00:c0:dd:0a:b4:35 (VLAN IDs: 777)

MAC :None (VLAN IDs:)

Number of VLANS: 3

----------------

............................

VLAN ID : 35

............................

IPv4Address : 169.254.132.7

IPv4SubnetMask : 0.0.0.0

IPv4GatewayAddr : 0.0.0.0

DHCPServerCount : 0

IPv6GatewayAddr :

IPv6AddressCount : 1

pDHCPServers[ 0] : fe80::e9ba:1d3e:8584:8407

DNSServerCount : 3

pDNSServers[ 0] : fec0:0:0:ffff::1

pDNSServers[ 1] : fec0:0:0:ffff::2

pDNSServers[ 2] : fec0:0:0:ffff::3

............................

VLAN ID : 777

............................

IPv4Address : 169.254.202.39

IPv4SubnetMask : 0.0.0.0

IPv4GatewayAddr : 0.0.0.0

DHCPServerCount : 0

IPv6GatewayAddr :

IPv6AddressCount : 1

pDHCPServers[ 0] : fe80::d079:f594:8e03:ca27

DNSServerCount : 3

pDNSServers[ 0] : fec0:0:0:ffff::1

pDNSServers[ 1] : fec0:0:0:ffff::2

-vtcfgview

SN0054667-00 G 5-23

Page 82

5–NIC Noninteractive Commands

NOTE

-vtrestore (Restore VLAN & Teaming Configuration)

pDNSServers[ 2] : fec0:0:0:ffff::3

............................

VLAN ID : 555

............................

IPv4Address :

IPv4SubnetMask :

IPv4GatewayAddr :

DHCPServerCount : 0

IPv6GatewayAddr :

IPv6AddressCount : 0

DNSServerCount : 0

-vtrestore (Restore VLAN & Teaming Configuration)

To reinstate previously saved VLAN and team settings from a file, issue the

-vtrestore command as follows:

> qaucli -pr nic -vtrestore [file_name]

The default file configuration file name for VLAN and teaming is vtstate-user.cfg, which is saved in the QConvergeConsole CLI installation

directory. You may have saved your configuration with a different file name or location.

The -vtrestore command can restore a configuration file produced only by the -vtsave command. Similarly, a configuration that is saved using the QLogic Windows Teaming property pages can be restored only with the Windows Teaming property pages.

For example:

>qaucli -pr nic -vtrestore c:/system_1.cfg

Using config file: E:\Program Files\QLogic Corporation \QConvergeConsoleCLI\netscli.cfg

Loading CNA Data ...

Loading: 1. CNA ...

Loading: 1. CNA Port index : 1 ...

Loading: 1. CNA Port index : 2 ...

Loading: 2. CNA ...

Loading: 2. CNA Port index : 1 ...

Loading: 2. CNA Port index : 2 ...

Refreshing interfaces ... Please wait ...

5-24 SN0054667-00 G

Page 83

5–NIC Noninteractive Commands

-vtrestore (Restore VLAN & Teaming Configuration)

Attempting to restore TEAMs and VLANs if configured prior to vtdriver updaate.

*** Teams:

*** Ports:

00:c0:dd:0a:b4:34

VLAN IDs:

00:c0:dd:0a:b4:35

VLAN IDs:

Refreshing interfaces ... Please wait ...

Updating IP properties for all ports ... Please wait ...

ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

ListIndex: 3 CNA: 2 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:34 Description: QLogic 10Gb PCI Ethernet Adapter

ListIndex: 4 CNA: 2 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:35 Description: QLogic 10Gb PCI Ethernet Adapter #2

VLAN List:

ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

ListIndex: 3 CNA: 2 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:34 Description: QLogic 10Gb PCI Ethernet Adapter

ListIndex: 4 CNA: 2 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:35 Description: QLogic 10Gb PCI Ethernet Adapter #2

Selected ListIndices: 3

Selected VLAN ID: 55

About to set VLAN ID: 55 for ListIndex: 3

Successfully set VLAN ID.

Refreshing interfaces ... Please wait ...

Updating IP properties for all ports ... Please wait ...

ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

SN0054667-00 G 5-25

Page 84

5–NIC Noninteractive Commands

NOTE

-vtsave (Save VLAN & Teaming Configuration)

ListIndex: 3 CNA: 2 CNA Port: 1 VLAN ID: 55 MAC: 00:c0:dd:0a:b4:34 Description: QLogic 10Gb PCI Ethernet Adapter

ListIndex: 4 CNA: 2 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:35 Description: QLogic 10Gb PCI Ethernet Adapter #2

VLAN List:

ListIndex: 1 CNA: 1 CNA Port: 1 VLAN ID: None MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

ListIndex: 2 CNA: 1 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

ListIndex: 3 CNA: 2 CNA Port: 1 VLAN ID: 55 MAC: 00:c0:dd:0a:b4:34 Description: QLogic 10Gb PCI Ethernet Adapter

ListIndex: 4 CNA: 2 CNA Port: 2 VLAN ID: None MAC: 00:c0:dd:0a:b4:35 Description: QLogic 10Gb PCI Ethernet Adapter #2

Selected ListIndices: 4

Selected VLAN ID: 55

About to set VLAN ID: 55 for ListIndex: 4

Successfully set VLAN ID.

Refreshing interfaces ... Please wait ...

Updating IP properties for all ports ... Please wait ...

Successfully restored TEAMs/VLANs

-vtsave (Save VLAN & Teaming Configuration)

To save the currently configured VLAN and team settings to a file, issue the

-vtsave command as follows:

> qaucli -pr nic -vtsave [file_name]

 If you do not specify a configuration file name, the VLAN and teaming

settings are saved in the default file, vtstate-user.cfg, which is saved in the QConvergeConsole CLI installation directory. Saved settings can be later reinstated using the -vtrestore option.

 A configuration that is saved with the -vtsave command can be

restored only with the -vtrestore command. Similarly, a configuration that is saved using the QLogic Windows Teaming property pages can be restored only with the Windows Teaming property pages.

>qaucli -pr nic -vtsave c:/system_1.cfg

Using config file: E:\Program Files\QLogic Corporation \QConvergeConsoleCLI\netscli.cfg

Loading CNA Data ...

5-26 SN0054667-00 G

Page 85

5–NIC Noninteractive Commands

-zvt (Display Teams List; Display VLAN List; Display VLAN Information)

Loading: 1. CNA ...

Loading: 1. CNA Port index : 1 ...

Loading: 1. CNA Port index : 2 ...

Loading: 2. CNA ...

Loading: 2. CNA Port index : 1 ...

Loading: 2. CNA Port index : 2 ...

Refreshing interfaces ... Please wait ...

Attempting to save TEAMs and VLANs Configuration.

Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 Team Type: Fail Over

Team Members:

CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

CNA: 1 CNA Port: 2 MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

VLAN List:

ListIndex: 1 Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 MAC: 00:c0:dd:0a:b4:60 Description: QLogic VT-IM Miniport Driver

VLAN List:

Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 MAC: 00:c0:dd:0a:b4:60 Description: QLogic VT-IM Miniport Driver #2

Successfully saved TEAMs/VLANs

-zvt (Display Teams List; Display VLAN List; Display VLAN Information)

To view a display that combines all VLAN and teaming information, issue the

-zvt command as follows:

> qaucli -pr nic -zvt

The following example shows the output on a system with one team of two ports, plus two additional ports:

> qaucli -pr nic -zvt

*********************************************

*** Displaying VLAN & Teaming Information ***

*********************************************

*** Display Of Teams List ***

SN0054667-00 G 5-27

Page 86

5–NIC Noninteractive Commands

-zvt (Display Teams List; Display VLAN List; Display VLAN Information)

Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 Team Type: Fail Over

Team Members:

CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI Ethernet Adapter #3

CNA: 1 CNA Port: 2 MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI Ethernet Adapter #4

*** Display Of VLANs List ***

VLAN List:

Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 MAC: 00:c0:dd:0a:b4:60 Description: QLogic VT-IM Miniport Driver #2

*** Display Of VLAN Information ***

VLAN(s) Information:

Updating VLANs info ...

Done ...

Available VLAN ID(s):

555

***** VLAN: 555 (QLogic VT-IM Miniport Driver #2) ******

Driver Name : qlvtid.sys

Driver Version : 1.0.0.14

Driver Date : 10/13/2009

VLAN Enabled : Enabled

VLAN ID : 555

MAC Address : 00:c0:dd:0a:b4:60

MTU : 1514

IPv4 Address :

Subnet Mask :

IPv6 Address :

Link Status : Down

5-28 SN0054667-00 G

Page 87

6 Fibre Channel

NOTE

Noninteractive Commands

This chapter describes the noninteractive Fibre Channel command format and parameters of QConvergeConsole CLI. For a quick reference to informative commands, see Displaying System Information (Command Line Options -g, -z,

and -tp) on this page.

To view help, issue the -h command.

Displaying System Information

(Command Line Options -g, -z, and -tp)

When you select one of these options, general information appears in various formats. For example:



# qaucli -pr fc -g shows the host information (see “Host Information

(Command Line Option -g)” on page 6-1).

# qaucli -pr fc -z shows the host configuration (see “Host



Configuration (Command Line Option -z)” on page 6-2

Host Information

(Command Line Option -g)

The command format to show host information is:

# qaucli -pr fc -g

Issue this command to view the following information about the local machine:

 Host name

 OS type

 OS version (patches where applicable)

 SAN device management (SDM) API version

SN0054667-00 G 6-1

Page 88

6–Fibre Channel Noninteractive Commands

NOTE

Host Configuration (Command Line Option -z)

 List of adapters: adapter model, port number, worldwide port name

(WWPN), serial number (SN), adapter number (adapter 0–n), and status (online or offline)

 Total number of QLogic Fibre Channel Adapters detected

The failover and SAN device management APIs are QLogic-specific libraries required for QConvergeConsole CLI. The versions of these libraries are useful for debugging purposes.

Host Configuration

(Command Line Option -z)

The command line option -z provides a summary for the selected adapter in a single command. The command format is:

# qaucli -pr fc -z

QConvergeConsole CLI shows the information in “Host Information (Command

Line Option -g)” on page 6-1, as well as the following additional information:

 Adapter general information  Adapter vital product data (VPD)  Adapter parameter settings  Driver settings information:

 Group: persistent  Group: binding

 Device and LUN information  Selective LUNs information

 Boot device settings

To show the information for a single adapter, issue the following command:

# qaucli -pr fc -z (<hba instance> | <hba wwpn> | all)

Where:

hba instance

hba wwpn

= Adapter number (use the -g command to find)

= World wide port name of the adapter

To show the information for all adapters, issue the following command:

# qaucli -pr fc -z all

6-2 SN0054667-00 G

Page 89

Host Port Configuration

Use these options to show the information for one or all of the adapter ports in the system. The -z option shows the combination of the commands listed in

Table 6-1. The commands are listed in alphabetical order.

CLI Description See User Guide Section

-c Show adapter settings “-c (Display HBA Parameters)” on page 6-8

-e Configure boot device “-e (Boot Devices Configuration)” on

-fg View driver settings “-fg” on page 6-13

-gs Show adapter statistics “-gs (Configure Parameters [FC Port Statis-

-i Show adapter information “-i (FC Adapter Information; FC VPD Informa-

6–Fibre Channel Noninteractive Commands

Host Port Configuration

Table 6-1. Options Shown by -z

page 6-10

tics])” on page 6-15

tion)” on page 6-17

-l Show LUN list “-l (FC Target/LUN Information)” on page 6-23

-m Configure selective LUNs “-m (Selective LUNs)” on page 6-25

-p Configure target persistent

binding

-t Show target list “-t (FC Target/LUN Information)” on page 6-37

Command Format

The command format for noninteractive mode is:

# qaucli -pr fc -(Cmd) (<hba instance> | <hba wwpn>) (view | info)

Where:

hba instance = Adapter port instance (use the -g command to find)

hba wwpn = Adapter world wide port name

You can combine the commands -o, -s, and -x with other options. However, they must be at the beginning or at the end of the command line. Use these commands as follows:

 -o = Output the results to a file (see “-o” on page 6-29). For example:

“-p (Target Persistent Bindings)” on page 6-30

# qaucli -pr fc -l -o

SN0054667-00 G 6-3

Page 90

6–Fibre Channel Noninteractive Commands Command Format

 -s = Silent mode (see “-s” on page 6-36). For example:

# qaucli -pr fc -i all -s -o output.txt

 -x = Outputs the results in XML format (see “-x” on page 6-40). For

example:

# qaucli -pr fc -i all -x -o output.xml

You cannot combine the command -f with any other options:

 -f = Input parameter options from a text file (see “-f” on page 6-13). For

example:

# qaucli -pr fc -f command.txt

In addition, the following general rules for commands apply:

 Only one command line option per input file is valid.

 You can use either the hyphen (-) character or the forward slash (/)

character. For example, both of these commands are valid:

qaucli -pr fc -g

qaucli -pr fc /g

Table 6-2 defines the command variables.

Table 6-2. Command Variables

Variable Definition Format

Adapter number

<hba wwpn> Adapter world wide port

name

<alias> Adapter alias

<target wwnn> Target world wide node

name

<target wwpn> Target world wide port

name

<target port id> Target port ID xx-xx-xx or xxxxxx

<target id> Target ID —

<lun id> Logical unit number (0–255)

<address> IP address xxx.xxx.xxx.xxx

—

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx

Symbolic adapter b name

xx-xx-xx-xx-xx-xx-xx-xx or xxxxxxxxxxxxxx

<iidma speed> Target link speed 1.2, 4, or 8GHz

You can use the -g command to find adapter numbers.

You assign the symbolic name. It is limited to 100 characters in length.

6-4 SN0054667-00 G

Page 91

Command Summary

NOTE

This section lists the command line options in alphabetic order, and provides a description of each.

A parenthetical phrase after a command indicates the equivalent interactive menu option. For example, -c that the -addchap command has an equivalent Add a CHAP menu option described in Chapter 11 Converged Network Adapter Interactive

Commands.

Not all noninteractive commands have equivalent interactive menu options.

The Fibre Channel noninteractive commands include the following:

 -a  -b (Flash Update; Save Flash)  -c (Display HBA Parameters)  -cna (CNA FCoE Information)  -dm (Transceiver Diagnostics Monitoring Interface [DMI])  -e (Boot Devices Configuration)  -ei  -f  -fg  -fs (Driver Parameters)  -fwdump (Firmware Dump)  -g (Generate Reports)  -gs (Configure Parameters [FC Port Statistics])  -h (Help)  -ha (Adapter Alias [FCoE Configuration])  -i (FC Adapter Information; FC VPD Information)  -kl (Loopback Test)  -kr (Read Write Buffer Test)  -l (FC Target/LUN Information)  -ls (Display Parameters [HBA Statistics])  -m (Selective LUNs)  -n (Configure HBA Parameters)  -o  -p (Target Persistent Bindings)  -pa (Adapter Port Alias [FCoE Configuration])  -pc (Adapter Personality Change)  -pl (Persistent Names (udev) – Linux only)  -r (Parameters Update; Save HBA Parameters)  -s

6–Fibre Channel Noninteractive Commands

Command Summary

(NIC Port Setting Configuration) indicates

SN0054667-00 G 6-5

Page 92

6–Fibre Channel Noninteractive Commands

NOTE

-a

 -sp  -t (FC Target/LUN Information)  -tb  -tp  -tp  -u  -v  -vp (Virtual Ports [NPIV])  -x  -x2  -z (All Information)

-a

Use the -a command to either view or change the status of a beacon.

 The adapter must not be in silent mode. See “-s” on page 6-36 to issue a

response to this command.

 Due to a hardware and firmware limitation, the -a option is not

supported on QLogic 8200 Series Adapters.

To view the adapter port’s LED beacon state, issue the following command:

# qaucli -pr fc -a (<hba instance> | <hba wwpn>)(view | info)

When the adapter’s LED is flashing, the following message appears:

HBA Port x - LED Flashing is ON.

When the adapter’s LED is not flashing, the following message appears:

HBA Port x - LED Flashing is OFF.

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

# qaucli -pr fc -a <hba>"?"

To start or stop flashing the adapter’s LED beacon, issue the following command:

# qaucli -pr fc -a (<hba instance> | <hba wwpn>)

QConvergeConsole CLI toggles the LED’s state. If the LED is flashing, the flashing stops. If the LED is not flashing, the flashing begins.

6-6 SN0054667-00 G

Page 93

If QConvergeConsole CLI is not in silent mode (see “-s” on page 6-36), one of the following messages appears to indicate the LED’s current state:

The LED Flashing for <hba instance> <hba wwpn> has been turned ON

The LED Flashing for <hba instance> <hba wwpn> has been turned OFF

The hba instance and hba wwpn variables must match the command input parameter.

-b (Flash Update; Save Flash)

Use the -b command to:

 Update the BIOS or Forth code (FCode) from a file.

 Save the BIOS or FCode to a file.

To update the Flash of one or all adapters with new BIOS or FCode, issue the following command:

# qaucli -pr fc -b (all | <hba instance> | <hba wwpn>) [(<-rg> | all)] <BIOS/FCode File Name>

6–Fibre Channel Noninteractive Commands

-b (Flash Update; Save Flash)

Where:

all = All adapters of the same type in the system are updated with

the new BIOS or FCode

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name

-rg =

Flash region update mode (4GB adapters only a)

all = Update all regions (BIOS, FCode, or extensible firmware inter-

face (EFI) depending on the Flash image

BIOS/FCode File Name

Region update only supported on QLA/QLE/QMC246x adapters.

The path and file name must not contain embedded spaces.

Name or path of file containing update BIOS or FCode

To save the BIOS or FCode to a file, issue the following command:

# qaucli -pr fc -b (<hba instance> | <hba wwpn>) SAVE <BIOS/FCode File Name>

Where:

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name of the adapter

BIOS/FCode File Name

The path and file name must not contain embedded spaces.

File name or a path to a file in which to save the BIOS or FCode

SN0054667-00 G 6-7

Page 94

6–Fibre Channel Noninteractive Commands

NOTE

-c (Display HBA Parameters)

The QLE8242 does not support the option to save the FCode to a file type.

-c (Display HBA Parameters)

Use the -c command to show the parameter settings for all adapters in the system:

# qaucli -pr fc -c [ <all> ]

To show the parameter settings for a specific adapter, issue the following command:

# qaucli -pr fc -c (<hba instance> | <hba wwpn>)

Where:

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name of the adapter

-cna (CNA FCoE Information)

Use the -cna command to work with QLogic Converged Network Adapters (QLE81xx and QLE82xx).

The -cna command line options use the following variables:

hba instance = Adapter instance number of a Converged Network Adapter port

hba wwpn = World wide port name of a Converged Network Adapter port

mpi file = MPI configuration DAT file

--detail = View detailed format

--raw = View raw format

param name = Parameter name

param alias = Parameter alias

param value = Parameter value

To view general information for the Converged Network Adapter, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> --geninfo

To view data center bridging exchange protocol (DCBX) settings, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> --dcb --info

6-8 SN0054667-00 G

Page 95

6–Fibre Channel Noninteractive Commands

-cna (CNA FCoE Information)

To update the message passing interface (MPI) configuration table on the Converged Network Adapter (81xx only) from a file, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> | <all> --updatecfg <mpi file>

To save the MPI configuration table on the Converged Network Adapter (81xx only) to a file, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> --savecfg <mpi file>

To view DCBX type-length-value (TLV) data sent and received over the Converged Network Adapter port connection, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> --tlv ( --detail | --raw )

The output displays the TLV of the link layer discovery protocol (LLDP) frames meant for exchanging the parameters and their values.

To view data center Ethernet (Cisco

data communications equipment, DCE™) network activity information sent and received over the Converged Network Adapter port connection, issue the following command:

qaucli -cna <hba instance>|<hba wwpn> --mon --dce [{<param name>| <param alias> <param value> } ]

Table 6-3 lists the DCE statistics parameters, possible values, and a description of

each.

Table 6-3. DCE Statistics Parameters

Parameter

Name

AutoPoll AP 0

SetRate SR 5–30 Set the polling interval rate (seconds)

Details DT 0–2 Set the detailed display mode:

Parameter

Alias

Parameter

Value

1–256

Description

Set to auto polling mode

Set to manual polling mode (iteration)

 0 = Absolute

 1 = Rate per second

 2 = Baseline

SN0054667-00 G 6-9

Page 96

6–Fibre Channel Noninteractive Commands

NOTE

-dm (Transceiver Diagnostics Monitoring Interface [DMI])

The -dm option allows you to show general or detailed digital diagnostic monitoring interface for optical transceivers.

This option is supported only for QLogic QLA/QLE/QEM24xx (4Gb) Adapters. Under Solaris, this option is disabled if you are using Linux inbox drivers (SLES 10.0 or RHEL 5.0 or later).

To show transceiver monitoring general information, issue the following command:

# qaucli -pr fc -dm (<hba instance> | <hba wwpn> | <all>) general | gen

To show transceiver monitoring detailed information, issue the following command:

# qaucli -pr fc -dm (<hba instance> | <hba wwpn> | all) details | det

Where:

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name of the adapter

all = All adapters in the system

-e (Boot Devices Configuration)

Use the -e command to:

 Show the current boot device selection for all adapters.

 Show the current boot device selection for a specific adapter.

 Set a target device as the boot device for an adapter.

 Selectable boot; the OS boots from the first target the BIOS finds.

 Delete the boot device from an adapter.

In these commands:

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name of the adapter

target wwnn = World wide node name of the target

target wwpn = World wide port name of the target

target id = ID to which the target is bound

lun id = ID of the LUN

6-10 SN0054667-00 G

Page 97

6–Fibre Channel Noninteractive Commands

-e (Boot Devices Configuration)

To view the current boot device selection on all adapters:

# qaucli -pr fc -e all (view | info)

To view the current boot device selection for a specific adapter:

# qaucli -pr fc -e (<hba instance> | <hba wwpn>) (view | info)

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

# qaucli -pr fc -e <hba> "?"

In Windows and Linux, each adapter’s currently selected boot device is shown in the following format:

Solaris shows each adapter’s currently selected boot device in the following format:

If the system does not have an adapter with a boot device selected, the following message appears:

There is no boot device selected for any HBA in the system.

Following is an example of the boot device option when viewing the boot device for a single adapter. In this example, no boot device is configured (selectable boot is disabled; the boot port name is all zeroes).

-------------------------------------------------------------

HBA 1: QLA2340 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 00-00-00

-------------------------------------------------------------

Boot Device Settings:

--------------------------------------

Selectable Boot: Disabled

--------------------------------------

(Primary) Boot Port Name LUN

----------------------- ----------------------- ------

00-00-00-00-00-00-00-00 00-00-00-00-00-00-00-00 0

Press <Enter> to continue:

To cause the OS to boot from the first target it finds with a LUN, select a boot port name of 00-00-…00 (selectable boot); this applies only if the boot BIOS is enabled.

SN0054667-00 G 6-11

Page 98

6–Fibre Channel Noninteractive Commands

NOTE

-e (Boot Devices Configuration)

To set a specific target as the boot device for a specific adapter, issue the following command:

# qaucli -pr fc -e (<hba instance> | <hba wwpn>) <target wwnn> <target wwpn> <target id> <lun id>

Because x86 Solaris does not require the target ID, the Solaris command is:

# qaucli -pr fc -e (

wwnn> <target wwpn> <lun id>

The boot device setting option is not supported on Macintosh® PowerPC.

QConvergeConsole CLI checks all parameters to verify that the adapter, targets, and LUNs are valid.

<hba instance> | <hba wwpn>) <target

If you select an adapter with no target or a target with no LUN, QConvergeConsole CLI shows an error message and aborts.

In Solaris SPARC, setting the target ID to the target of the boot-selected LUN is equivalent to persistently binding the target (see “-p (Target Persistent Bindings)”

on page 6-30). Therefore, if the target is persistently bound, its boot device entry

must have the same target ID.

For all operating systems, if the adapter already has boot devices defined and they are different from the ones in the command parameter or menu selection, you are prompted to confirm the boot device selection:

The HBA already has a boot device(s) selected. Do you want to replace it with the new one?

For all operating systems, if the adapter already has boot devices selected and they are the same as the ones in the command parameter or menu selection, the following message appears:

The HBA already has that device selected as boot device.

To use selectable boot (the OS boots from the first target the BIOS finds) set the <target wwpn>, <target wwnn>, and <lun id> inputs to all zeroes. For example issue the following command:

# qaucli -pr fc -e (<hba instance> | <hba wwpn>) (enable | 0 0 0)

To disable (delete) the boot device for a specific adapter, issue the following command:

# qaucli -pr fc -e (<hba instance> | <hba wwpn>) disable

6-12 SN0054667-00 G

Page 99

-ei

NOTE

-f

6–Fibre Channel Noninteractive Commands

-ei

Issue the -ei command to view a list of the Fibre Channel error codes.

The -f option is valid only in noninteractive mode, and cannot be combined with any other options. Only one command line parameter per file is valid. This option is used when it is run as a script file.

To input parameter options to QConvergeConsole CLI through a text file, type -f, followed by the file name. For example:

# qaucli -pr fc -f command.txt

The text file must be formatted as follows:

 The file must contain a single line.  The file must contain only parameters.  The file cannot contain another -f option.

-fg

The following example shows how to set the connection option of an adapter to default (loop preferred, otherwise point-to-point) and the data rate to auto through a command file that is invoked by the -f option:

1. Create a text file (for example, setadapter0.txt) and issue the following

command in the text file:

-n 0 co 2 dr 2

2. Save and close the file.

3. Issue the qaucli -pr fc command with the -f option (input from

command file):

# qaucli -pr fc -f setadapter0.txt

# qaucli -pr fc -f <file name>

QConvergeConsole CLI specifies command line input from the file.

The -fg option is valid only in noninteractive mode. The -fg option is not supported for Linux and Solaris.

SN0054667-00 G 6-13

Page 100

6–Fibre Channel Noninteractive Commands

-fs (Driver Parameters)

To show the driver settings, issue the following command:

# qaucli -pr fc -fg (<hba instance> | <hba wwpn>) (view | info)

Where:

hba instance = Adapter number (use the -g command to find)

hba wwpn = World wide port name of the adapter

-fs (Driver Parameters)

To configure the driver settings, issue the following command:

# qaucli -pr fc -fs (<hba instance> | <hba wwpn>) {(<param name> | <param alias>) <param value>}

Where:

hba instance = Adapter instance number of an adapter port (use the

hba wwpn = World wide port name of the adapter

param name = Name of the parameters

param alias = Alias of the parameters

param value = New value of the parameters

-g command to find)

The pairs <param name> <param value> and <param alias> <param value> can be repeated to set multiple parameters in a single command.

Table 6-4 lists the driver configuration parameter names and aliases.

Table 6-4. Driver Settings Parameters

Description

Persistently bound target(s) only PersistentOnly PO 0, 1

Present persistently bound target(s) plus any new target(s) with driver default

Present targets with driver default

Bind devices by WWPN BindWWPN BW 0, 1

Bind devices by port ID BindPortID BP 0, 1

0 = Disabled, 1 = Enabled

Driver parameter NewOnly (NO) is supported only with the failover driver.

Parameter Name

PersistentPlusNew PN 0, 1

NewOnly

Alias

<param

alias>

NO 0, 1

<param

Value

value>

6-14 SN0054667-00 G