Q-Logic 8100, 2400, 3200, 8200, 2500 User Manual

User’s Guide

QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

SN0054667-00 C

User’s Guide—QConvergeConsole CLI
2400, 2500, 3200, 8100, 8200 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 18, 2011

Changes Sections Affected

Deleted Windows Server 2003 from the list of sup-

“Operating System Requirements” on page 1-2

ported operating systems.

Updating procedure for downloading QCC CLI “Downloading QConvergeConsole CLI” on

page 2-1

Added a note explaining that configuration port
settings and values differ for Linux/Solaris.

“-iset (Display Configured Port Settings)” on
page 4-9

Deleted reference to -svmtool. “Command Format” on page 4-1

Removed section for -svmtool. Former section “-svmtool” in chapter 4

Updated supported adapters to QLE81xx and
QLE82xx.

Removed example of -cna command saving MPI
configuration table to a file.

Added “all” to -e (view | info) command to view the
current boot device selection.

Added a note explaining that the -fg option is not

“-cna (FCoE Utilities Menu for QLE81xx and
QLE82xx Adapters)” on page 5-7

“-cna (FCoE Utilities Menu for QLE81xx and
QLE82xx Adapters)” on page 5-7

“-e (Boot Device View | Select | Disable)” on
page 5-9

“-fg (Show Driver Settings)” on page 5-12

supported on Linux/Solaris.

Added chapter for NPAR noninteractive mode Chapter 7 NIC Partitioning (NPAR) Noninteractive

Commands

Added chapter for NPAR interactive mode Chapter 11 NIC Partitioning (NPAR) Interactive

Commands

Added appendix with overview of NPAR Appendix A NIC Partitioning (NPAR) Overview

ii SN0054667-00 C

Table of Contents

Preface

What’s in this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi

What’s in the Help System . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii

Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii

Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii

Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxii

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

Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxiv

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

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

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

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

Overwrite Previous Windows Installations . . . . . . . . . . . . . . . . . 2-3

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

Uninstalling QConvergeConsole CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

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

Start Menu Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Control Panel Uninstall . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4

Command Line Uninstall. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-5

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

SN0054667-00 C iii

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

3 Getting Started

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

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

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

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

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

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

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

4 NIC Noninteractive Commands

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-1

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

-beacon

(Enable/Disable Port Beacon). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

-c . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

-cardreset . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

-ch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-3

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

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

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

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

-g

(Display General System Information) . . . . . . . . . . . . . . . . . . . . . . . 4-7

-h

(Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7

-i

(List All QLogic CNA Ports Detected) . . . . . . . . . . . . . . . . . . . . . . . . 4-7

-icna

(CNA Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-8

-idcbx

(Display Port DCBX Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9

-intloopback

(Configure Test Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9

-iset

(Display Configured Port Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9

-link

(Display Physical Link Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-10

-minidump

(Firmware Mini Dump). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

-n

(Change Port Alias Name) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

iv SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

-nh

(Change CNA Alias Name) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-11

-pinfo

(Port Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-12

-ping

(Ping Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

-rc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-13

-sreset

(Reset Ethernet Statistics Counters) . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

-statport

(Display Ethernet Port Statistics). . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-14

-sunreset

(Undo Reset Ethernet Statistics Counters) . . . . . . . . . . . . . . . . . . . . 4-16

-teamdel

(Delete Team) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16

-teaminfo

(Display Team Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-16

-teamlist

(Display Teams List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

-teamnew

(Configure New Team) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-17

-teamnew_portspreview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-18

-testflash . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-testhw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-testinterrupt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-testled. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-testlink . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-testregister . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-trans

(Display Transceiver DMI Data) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-19

-updimages

(Update Flash (Boot & Firmware Images)) . . . . . . . . . . . . . . . . . . . . 4-19

-updimages_viewver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-20

-v, -ver

(Display Program Version Information) . . . . . . . . . . . . . . . . . . . . . . . 4-20

-vlanadd

(Add VLAN to Port or Team) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21

-vlanadd_preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-21

-vlandel

(Remove VLAN from Port or Team) . . . . . . . . . . . . . . . . . . . . . . . . . 4-22

-vlandel_preview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-22

SN0054667-00 C v

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

-vlaninfo

(Display VLAN Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

-vlanlist

(Display VLAN List) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

-vpd

(Display VPD Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-23

-vtcfgview. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-24

-vtrestore

(Restore VLAN & Teaming Configuration) . . . . . . . . . . . . . . . . . . . . 4-25

-vtsave

(Save VLAN & Teaming Configuration). . . . . . . . . . . . . . . . . . . . . . . 4-28

-zvt
(Display Teams List; Display VLANs List; Display VLAN Information) 4-29

5 Fibre Channel Noninteractive Commands

Display System Information

(Command Line Options -g, -z, and -tp) . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Host Information

(Command Line Option -g) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-1

Host Configuration

(Command Line Option -z) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-2

Host Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3

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

-a

(View or Toggle Beacon Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-5

-b

(Save or Update the Flash BIOS or FCode) . . . . . . . . . . . . . . . . . . . 5-6

-c

(Show Parameter Settings). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7

-cna

(FCoE Utilities Menu for QLE81xx and QLE82xx Adapters). . . . . . . 5-7

-dm

(Display Diagnostics Monitoring Info) . . . . . . . . . . . . . . . . . . . . . . . . 5-8

-e

(Boot Device View | Select | Disable) . . . . . . . . . . . . . . . . . . . . . . . . 5-9

-ei

(List Fibre Channel Error Codes) . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-11

-f

(Input Parameter Options from a Text File) . . . . . . . . . . . . . . . . . . . . 5-11

-fg

(Show Driver Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

vi SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

-fs

(Configure Driver Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-12

-gs

(Show HBA Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

-h

(Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

-ha

(Set | Delete HBA Alias) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-15

-i
(Display HBA General Information or VPD Information for One or

All HBAs). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-16

-kl

(Run Loopback Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-17

-kr

(Run Read/Write Buffer Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

Run a Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-18

Run Adapter Diagnostics Read-write Buffer Test . . . . . . . . . . . . 5-20

-l

(Display LUN Info). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-22

-ls

(Display Link Status) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23

-m

(View, Enable, or Disable LUNs). . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-24

-n

(Set Selected HBA Parameter) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

-o

(Output to a File) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-28

-p

(Display Persistent Target Binding Info) . . . . . . . . . . . . . . . . . . . . . . 5-28

-pa

(Define Port Alias) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30

-q

(View or Set Target Link Speed) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-31

-r

(Update HBA Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-32

-s

(Silent Mode). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33

-sp

(Update Adapter Firmware). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33

-t

(Display Target Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-33

SN0054667-00 C vii

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

-tb

(Target Beacon On/Off) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-34

-tp

(Display Host Topology) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35

-u

(Firmware Area Update/Save) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35

-v

(Display Version). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-35

-vp

(Virtual Port) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-36

-x

(Output in XML Format 1) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-37

-x2

(Output in XML Format 2) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-37

-z

(Display All HBA Information for One or All HBAs) . . . . . . . . . . . . . . 5-37

6 iSCSI Noninteractive Commands

Command Format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

Command Summary . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

-acb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-2

-addchap

(Add a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

-arp

(Display ARP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

-b

(HBA Reset) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-3

-binfo

(Display BIOS/UEFI [or FCode] Information) . . . . . . . . . . . . . . . . . . 6-3

-bootcode

(Update BIOS/UEFI [or FCode] Mode) . . . . . . . . . . . . . . . . . . . . . . . 6-3

-bootcodemode

(Set BIOS/UEFI [or FCode] Mode) . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

-c

(Display Configured Port Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . 6-4

-ch

(HBA Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

-chapmap

(Display Targets Using CHAP Entries) . . . . . . . . . . . . . . . . . . . . . . . 6-5

-cpbootcode

(Clear Primary Boot Target Information) . . . . . . . . . . . . . . . . . . . . . . 6-5

viii SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

-csbootcode

(Clear Secondary Boot Target Information). . . . . . . . . . . . . . . . . . . . 6-5

-d

(Install HBA Driver, All Adapters) . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-5

-dc

(Display Destination Cache [IPv6 only]) . . . . . . . . . . . . . . . . . . . . . . 6-6

-dce . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

-defbidi. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

-delchap

(Delete a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

-df . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-6

-dp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

-dr

(Display Default Router List [IPv6 only]) . . . . . . . . . . . . . . . . . . . . . . 6-7

-dspchap

(Display a CHAP Table) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

-dtdsp

(Display Discovered Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-7

-dtdspa

(List Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

-dtdupd

(Duplicate a Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

-dtdupd

(Duplicate a Persistent Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-8

-dtli

(Login and Persist a Discovered Target) . . . . . . . . . . . . . . . . . . . . . . 6-8

-dtlia

(Login and Persist a Discovered Target) . . . . . . . . . . . . . . . . . . . . . . 6-8

-dtrem

(Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

-dtrema

(Remove Discovered Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

-dumpcore

(Retrieve FW Coredump Record) . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

-dumpnvram

(Retrieve FW Flash & NVRAM Record) . . . . . . . . . . . . . . . . . . . . . . 6-9

-dv . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

-edchap

(Edit a CHAP Entry) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-9

-ei. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

-f

(Update Firmware Image—Specific HBA). . . . . . . . . . . . . . . . . . . . . 6-10

SN0054667-00 C ix

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

-g

(Display General System Information) . . . . . . . . . . . . . . . . . . . . . . . 6-10

-gcr

(Retrieve FW Crash Record). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

-h

(Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-11

-i

(List All QLogic iSCSI HBA Ports Detected) . . . . . . . . . . . . . . . . . . . 6-11

-import

(Import HBA Configuration). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

-ipdhcp

(Configure IP Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-13

-isns

(Configure iSNS Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

-isns6

(iSNS Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

-l

(List LUN Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-14

-lcd

(Display Configured Link Configuration) . . . . . . . . . . . . . . . . . . . . . . 6-15

-linkchap

(Assign a CHAP Entry to a Target) . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-lp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-n

(Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-15

-nc

(Display Neighbor Cache) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17

-netconf

(Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-17

-netconf6

(Configure IPv6 Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-18

-nh

(Configure iSCSI Settings) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

-pa

(Add a Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

-pad . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

-pb

(Bind Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-19

-pbootcode

(Set Primary Boot Target Information). . . . . . . . . . . . . . . . . . . . . . . . 6-19

-pdt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20

x SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

-pet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20

-pinfo

(Port Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20

-ping

(Ping Target) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-20

-ps . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

-pu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

-px . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

-r

(Update ROM Image) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-21

-rdf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22

-rdh

(Port Restore Factory Defaults) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-22

-rwt

(Perform Read/Write Buffer Test) . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23

-save

(Save Host Configuration). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-23

-sbootcode

(Set Secondary Boot Target Information) . . . . . . . . . . . . . . . . . . . . . 6-24

-sbootcodecid

(Set Alternative Client ID) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24

-sdmrc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24

-stadd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-24

-stat

(Display Port Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25

-stathba . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25

-stdsp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-25

-strd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26

-strem . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26

-strema . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26

-t

(Display Target Information) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26

-tc

(Configure Target Parameters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-26

-tp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27

-ts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27

-ver

(Display Program Version Information) . . . . . . . . . . . . . . . . . . . . . . . 6-27

-vpd

(Display VPD Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-27

SN0054667-00 C xi

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

7 NIC Partitioning (NPAR) Noninteractive Commands

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

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

-ainfo

(Get NPAR Adapter Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

-changepersonality

(Change Physical Function Personality) . . . . . . . . . . . . . . . . . . . . . . 7-2

-ei

(Get NPAR Command Line Return Codes). . . . . . . . . . . . . . . . . . . . 7-2

-eswitchinfo

(Get NPAR eSwitch Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-2

-eswitchstats

(Display eSwitch Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

-eswitchvportstats

(Display eSwitch NPAR Statistics) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

-feswitchcfg

(Change eSwitch Configuration—Physical Function) . . . . . . . . . . . . 7-3

-finfo

(Get NPAR Physical Function Information) . . . . . . . . . . . . . . . . . . . . 7-4

-h

(Help) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

-ia

(Enumerate NPAR Adapters) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

-if

(Enumerate NPAR Physical Functions) . . . . . . . . . . . . . . . . . . . . . . 7-4

-ip

(Enumerate NPAR Physical Ports) . . . . . . . . . . . . . . . . . . . . . . . . . . 7-4

-peswitchcfg

(Change eSwitch Configuration—Physical Port). . . . . . . . . . . . . . . . 7-5

-pinfo

(Get NPAR Port Information). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-restoreeswitchcfg

(Restore eSwitch Configuration) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-setmaxbw

(Set Maximum Bandwidth) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-5

-setminbw

(Set Minimum Bandwidth) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-6

8 NIC Interactive Commands

Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-2

CNA Adapter Information (-icna) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-3

CNA Port Information (-pinfo) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-4

xii SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

CNA VPD Information (-i) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-5

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

Adapter Alias (-nh). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-6

NIC Port Setting Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-7

Display Configured Port Settings (-iset) . . . . . . . . . . . . . . . . . . . 8-8

Configure Port Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

Change Port Alias Name (-n) . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-8

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

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

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

Flash Update (-updimages). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10

Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-10

Register Test (-testregister) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-11

Hardware Test (-testhw) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-12

Interrupt Test (-testinterrupt) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13

Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-13

Link Test (-testlink). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-14

Beacon/LED Test (-testled) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-15

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-15

Display NIC Port Statistics (-statport) . . . . . . . . . . . . . . . . . . . . . . . . . 8-16

Reset NIC Statistics (-sreset) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-17

Undo Reset NIC Statistics (-sunreset). . . . . . . . . . . . . . . . . . . . . . . . . 8-17

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8-18

9 Fibre Channel Interactive Commands

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

FC Adapter Information (-i) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-3

FC Port Information (-i) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-4

FC VPD Information (-i). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-5

FC Target/LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-6

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-7

HBA Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-8

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

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

Restore Defaults. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-11

SN0054667-00 C xiii

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

Target Persistent Bindings (-p) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-12

Display Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-13

Bind Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-14

Unbind Target(s) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-15

Boot Devices Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-16

Display Boot Device(s) (-e). . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-17

Configure Boot Device(s) (-e). . . . . . . . . . . . . . . . . . . . . . . . . . . 9-18

Target Link Speed (iiDMA). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21

Basic Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-21

Advanced Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-22

Export (Save) Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-23

Save Flash (-b) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-23

Save HBA Parameters (-r) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-23

Generate Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-24

Adapter Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-25

Flash Update (-b). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-25

Parameters Update (-r) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-26

Parameters Template Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-27

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

Loopback Test (-kl) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-29

Display Test Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-30

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-30

Configure Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-31

Start Diagnostics Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-32

Read Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-33

Display Test Parameters (-kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-33

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-34

Configure Test Parameters (-kr) . . . . . . . . . . . . . . . . . . . . . . . . . 9-34

Start Diagnostics Test (-kr) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-34

Transceiver Diagnostics Monitoring Interface (DMI) . . . . . . . . . . . . . . 9-35

General (-dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-36

Details (-dm) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-37

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-38

Display FC Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-39

Display Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-40

Reset Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-40

Configure Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-40

Display HBA Statistics (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-41

xiv SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

Display FC Port Link Status. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-42

Display Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-43

Reset Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-43

Configure Parameters (-ls) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-43

Display Link Statistics (-ls) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-44

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-45

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-45

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9-45

10 Converged Network Adapter Interactive Commands

Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-3

CNA Adapter Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-4

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-5

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

CNA Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-6

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-7

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-8

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9

CNA VPD Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-9

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-10

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-11

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

Teaming Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-12

CNA FCoE Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-13

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-14

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-15

CNA iSCSI Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-19

CNA Port Target/LUN Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-20

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-21

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-22

Adapter Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-24

SN0054667-00 C xv

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

CNA FCoE Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-24

HBA Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-25

Target Persistent Binding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-29

Boot Devices Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-33

Virtual Ports (NPIV) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-36

Driver Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-40

Selective LUNs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-43

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

Generate Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-48

CNA iSCSI Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-49

HBA Level Parameter Configuration . . . . . . . . . . . . . . . . . . . . . 10-50

Port Configuration. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-52

Port IP Settings. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-64

Target Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-66

Boot Devices Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-79

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

CNA NIC Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-84

Adapter Alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-85

NIC Port Setting Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . 10-86

VLAN Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-89

Team Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-94

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

Adapter Updates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-104

Flash Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-105

Parameters Update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-105

Drivers Update. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-106

Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-107

Register Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-108

Hardware Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-109

Flash Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-110

Interrupt Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-111

Link Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-112

Loopback Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-113

NIC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-113

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-114

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-116

Read Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-117

FCoE . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-117

iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-119

xvi SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

Beacon/LED Test. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-120

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

General. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-122

Details. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-123

iSCSI Adapter Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-124

iSCSI Port Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-125

Ping Target . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-126

Perform Read/Write Buffer Test . . . . . . . . . . . . . . . . . . . . . . . . . 10-126

iSCSI Port Logs. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-127

Display ARP Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-128

Display Connection Error Log. . . . . . . . . . . . . . . . . . . . . . . . . . . 10-128

Export Connection Error Log . . . . . . . . . . . . . . . . . . . . . . . . . . .10-129

Display Neighbor Cache (IPv6) . . . . . . . . . . . . . . . . . . . . . . . . . 10-129

Display Destination Cache (IPv6). . . . . . . . . . . . . . . . . . . . . . . . 10-129

Display Default Router List (IPv6) . . . . . . . . . . . . . . . . . . . . . . . 10-129

Display Local Prefix List (IPv6). . . . . . . . . . . . . . . . . . . . . . . . . . 10-129

Refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-129

Adapter Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-130

Display NIC Port Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-131

Reset NIC Statistics. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-132

Undo Reset NIC Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-132

Display FCoE Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-133

Display Test Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . . . 10-134

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-134

Configure Test Parameters (-gs) . . . . . . . . . . . . . . . . . . . . . . . . 10-134

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

Display FCoE Port Link Status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-136

Display Test Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-137

Reset Test Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-137

Configure Test Parameters (-ls) . . . . . . . . . . . . . . . . . . . . . . . . . 10-137

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

Display iSCSI Port Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-138

Reset iSCSI Statistics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10-140

Refresh. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-140

Help (-h) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-140

Exit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-140

11 NIC Partitioning (NPAR) Interactive Commands

Setting Up NIC Partitions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-2

SN0054667-00 C xvii

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

A NIC Partitioning (NPAR) Overview

What is NPAR?. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

QLogic Adapters that Support NPAR . . . . . . . . . . . . . . . . . . . . . . . . . A-2

NIC Partitioning Options. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-2

Personality Changes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

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

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

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

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

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

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

Glossary

List of Figures

Figure Page

6-1 Adapter Port Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-12

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

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

11-3 NPAR Configuration Selection Screen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11-3

11-4 Selecting NPAR Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 -3

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

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

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

A-1 NPAR Default Configuration—NIC, FCoE, iSCSI . . . . . . . . . . . . . . . . . . . . . . . . . . A-4

A-2 NPAR Configuration Options — Personalities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . A-5

List of Tables

Table Page

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

5-2 Command Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4

5-3 DCE Statistics Parameters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-8

5-4 Driver Settings Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-13

5-5 Adapter Statistics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-14

5-6 Diagnostics Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-20

5-7 Data Pattern (DP) Test Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-21

5-8 Link Status Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-23

5-9 Adapter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-26

6-1 Noninteractive Command Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-1

6-2 CHAP Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-10

6-3 Adapter Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6-16

7-1 eSwitch Physical Function Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7-3

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

xviii SN0054667-00 C

User’s Guide—QConvergeConsole CLI

2400, 2500, 3200, 8100, 8200 Series

10-1 Default Loopback Test Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10-115

10-2 Default Read Write Buffer Test Parameter Values . . . . . . . . . . . . . . . . . . . . . . . . . . 10-118

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

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

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

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

SN0054667-00 C xix

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

xx SN0054667-00 C

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’s 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 requirements,

and operating system requirements needed for the successful operation of

the QConvergeConsole CLI.

 Chapter 2 Installing and Uninstalling QConvergeConsole CLI describes how

to install and uninstall the utility.

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

Windows and Linux platforms. This chapter also describes how to view

detailed information about command parameters and options.

 Chapter 4 NIC Noninteractive Commands describes the noninteractive NIC

command syntax and parameters.

 Chapter 5 Fibre Channel Noninteractive Commands describes the

noninteractive Fibre Channel command syntax and parameters.

 Chapter 6 iSCSI Noninteractive Commands describes the noninteractive

iSCSI command syntax and parameters.

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

noninteractive NIC Partitioning (NPAR) command syntax and parameters.

 Chapter 8 NIC Interactive Commands contains a description of the

QConvergeConsole CLI NIC interactive mode menus.

 Chapter 9 Fibre Channel Interactive Commands contains a description of

the QConvergeConsole CLI Fibre Channel interactive mode menus.

SN0054667-00 C xxi

Preface
What’s in the Help System

 Chapter 10 Converged Network Adapter Interactive Commands contains a

description of the QConvergeConsole CLI Converged Network Adapter

interactive mode menus for the NIC, iSCSI, and Fibre Channel functions.

 Chapter 11 NIC Partitioning (NPAR) Interactive Commands contains

information on setting up NIC Partitioning (NPAR) using the interactive mode

menus of the QConvergeConsole CLI.

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

partitioning.

Following these chapters is a glossary of terms.

What’s 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 4 through 7.

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

:

Documentation Conventions

This guide uses the following documentation conventions:

 NOTE: provides additional information.

 CAUTION!

causing damage to data or equipment.

indicates the presence of a hazard that has the potential of

 WARNING

causing personal injury.

xxii SN0054667-00 C

!! indicates the presence of a hazard that has the potential of

Preface

License Agreements

 Te x 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

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

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

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

then click Command Prompt.

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

 Te x 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:

Type

cd /root and press ENTER.

.

. For

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

 Key names and key strokes are indicated with UPPERCASE:

 Press CTRL+P.

 Press the UP ARROW key.

 Te x 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.

 What are shortcut keys?

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

day, and yyyy is the year).

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

License Agreements

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

SN0054667-00 C xxiii

Preface
Technical Support

Technical Support

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

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

Training

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

Technical Certification courses include installation, maintenance, and
troubleshooting QLogic products. Upon demonstrating knowledge using live
equipment, QLogic awards a certificate identifying the student as a certified
professional. You can reach the training professionals at QLogic by e-mail at

[e-mail]

.

,

.

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 http://support.qlogic.com.

Support Headquarters

QLogic Web Site

Technical Support Web Site

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. We are constantly adding to
the collection of information in our database to provide answers to your most
urgent questions. Access the database from the QLogic Support Center:

http://support.qlogic.com

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

www.qlogic.com

http://support.qlogic.com

[e-mail]

[e-mail]

.

xxiv SN0054667-00 C

1 System Requirements

QConvergeConsole CLI is an 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

The minimum hardware requirements for the workstation server are as follows:

 Server.

“Operating System Requirements” on page 1-2

systems.

 Processor. Pentium® II processor, 300 MHz
 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-2.

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. See the QLogic Storage Networking Interoperability Guide,

which you can download from the following QLogic Web page:

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

Single-processor or multiprocessor server or workstation. See

for a list of operating

SN0054667-00 C 1-1

1–System Requirements
Software Requirements

NOTE:

Tape devices are shown as part of the configuration, but are not fully
supported. Only persistent binding is supported.

Software Requirements

The software requirements for the server on which your adapter is physically
installed are as follows:

 QLogic adapter drivers for your operating system

NOTE:

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

http://driverdownloads.qlogic.com

 Administrative privileges to perform management functions

.

Operating System Requirements

QConvergeConsole CLI runs on the following platforms:

 Windows Server 2008

®

 Red Hat

 Novell

NOTE:

For the supported operating system versions, refer to the Readme where

QConvergeConsole CLI is posted on the QLogic Web site:

http://driverdownloads.qlogic.com

Linux® Advance Server/Enterprise Server

SUSE

®

Linux Enterprise Server (SLES)

.

Supported QLogic Adapters

The supported QLogic-branded adapters are as follows. For support of
OEM-branded adapters, please contact your OEM.

 2400 and 2500 Series Fibre Channel Adapters

 3200 Series Intelligent Ethernet Adapters

 8100 and 8200 Series Converged Network Adapters

1-2 SN0054667-00 C

1–System Requirements

Supported QLogic Adapters

NOTE:

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

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

.

SN0054667-00 C 1-3

1–System Requirements
Supported QLogic Adapters

1-4 SN0054667-00 C

2 Installing and Uninstalling

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

NOTE:

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

To download QConvergeConsole CLI from the QLogic Web site:

1. Go to the QLogic Driver Downloads/Documentation page at

http://driverdownloads.qlogic.com

2. Click QLogic Products.

3. Click Guided Search.

A window opens prompting you to Enter your search criteria.

4. Provide the information necessary:

a. In the Select a Product Type menu, select Adapters.

b. In the Select by Model or by OS, select by Model.

c. In the Select the Product Technology menu, select either

Converged Network Adapters, Fibre Channel Adapters, or
Intelligent Ethernet Adapters, as appropriate.

d. In the Select the Model menu, select your QLogic Adapter.

e. In the Select the Desired Item menu, select Management Tools.

SN0054667-00 C 2-1

.

2–Installing and Uninstalling QConvergeConsole CLI
Installing QConvergeConsole CLI

f. Click Search.

5. Scroll through the list that appears and select the QConvergeConsole

version for your operating system.

6. Click Download Now.

7. On the File Download dialog box, click Save.

8. On the Save As dialog box. specify a folder or directory on the system, and

then click Save to download the file to that location. The package file has

one of the following formats, depending on the operating system:

 Windows:

QConvergeConsoleCLI-AA.BB.CC-DD.EE_win_<Subtype>.msi

 Linux:

QConvergeConsoleCLI-AA.BB.CC-DD.<Subtype>.rpm

9. In the Support Tools table, select and download the Readme file for the

appropriate version of QConvergeConsole CLI.

Installing QConvergeConsole CLI

The installation procedures differ depending on the operating system:

 Installing QConvergeConsole CLI in a Windows Environment

 Installing QConvergeConsole CLI in a Linux Environment

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 Unattended Windows Installation

 Passive Windows Installation

 Overwrite Previous Windows Installations

NOTE:

®

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, at the command prompt, issue the msiexec

command.

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

2-2 SN0054667-00 C

2–Installing and Uninstalling QConvergeConsole CLI

Installing QConvergeConsole CLI in a Windows Environment

Standard Windows Interactive (CLI) Installation

To begin a standard installation of QConvergeConsole CLI on a Microsoft
Windows operating system, at a command line, issue one of the following
commands:

QConvergeConsoleCLI-<version>_win.msi

or

QConvergeConsoleCLI-<version>_win_x64.msi

Where <version> is the version number.

The default directory for QConvergeConsole CLI utility is:

Program files\QLogic Corporation\QConvergeConsoleCLI

If you want to install the 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.

Quiet or Unattended Windows Installation

Issue the following command for a quiet (silent) installation using default values.
For example, the following command installs silently using defaults and does not
show any errors:

QCCCLI.msi /q

Passive Windows Installation

Issue the following command for a passive installation using default values. For
example:

QCCCLI.msi /passive

The preceding command installs with minimum interaction, showing only the
progress bar and any errors.

Overwrite Previous Windows Installations

Issue the following for an installation that overwrites any previous installations
without asking for confirmation:

QCCCLI.msi /i forceinstall=true

SN0054667-00 C 2-3

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

Installing QConvergeConsole CLI in a Linux Environment

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

rpm -ivh QConvergeConsoleCLI-AA.BB.CC-DD.Subtype.rpm

Linux puts the files in the following directory:

/opt/QLogic_Corporation/QConvergeConsoleCLI

Red Hat Linux also creates 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.

SUSE Linux and PowerPC
the execution path by default. You must add it.

®

(PPC) do not put the /usr/local/bin directory in

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

The Windows 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, 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.

2-4 SN0054667-00 C

3. Select QConvergeConsole CLI.

4. Click Change/Remove.

Command Line Uninstall

You can uninstall QConvergeConsole CLI from the command line. Select
interactive, passive, or silent (quietly) uninstall:

To uninstall interactively from the command line:

Issue the following command from a command prompt:

qcccli.msi

To uninstall passively from the command line:

Issue the following command from a command prompt:

msiexec /x qcccli.msi

To uninstall quietly from the command line:

Issue the following command from a command prompt:

2–Installing and Uninstalling QConvergeConsole CLI

Uninstalling QConvergeConsole CLI in a Linux Environment

msiexec /q /x qcccli.msi

Uninstalling QConvergeConsole CLI in a Linux Environment

To uninstall QConvergeConsole CLI on a Red Hat and SUSE Linux and PPC
operating systems, issue the following from a command prompt:

rpm -e QConvergeConsoleCLI-AA.BB.CC-DD

SN0054667-00 C 2-5

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

2-6 SN0054667-00 C

3 Getting Started

The 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).

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 4 NIC Noninteractive Commands

 Chapter 5 Fibre Channel Noninteractive Commands

 Chapter 6 iSCSI Noninteractive Commands

To start the noninteractive QConvergeConsole CLI in Windows
operating system shell, and then type commands with 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:

1

or Linux, open an

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.

1

For Windows 2008 or later, use administrator mode.

SN0054667-00 C 3-1

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, and iSCSI. Although the
QConvergeConsole CLI contains menus for all of these adapter types, for clarity,
this guide describes the interface for each adapter type separately in the following
chapters:

 Chapter 8 NIC Interactive Commands

 Chapter 9 Fibre Channel Interactive Commands

 Chapter 10 Converged Network Adapter Interactive Commands

Starting QConvergeConsole CLI in Windows

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

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

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

then click QConvergeConsole CLI.

 Open a command prompt in the installation directory (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 C

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

Please Enter Selection:

Selecting an option from the Main Menu prompts you to choose an adapter type.

3–Getting Started

Main Menu

 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 C 3-3

3–Getting Started
Getting Help

Getting Help

Help is available in interactive mode using option 7. Help. Noninteractive mode
provides help using 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

3-4 SN0054667-00 C

4 NIC Noninteractive

Commands

This chapter describes the noninteractive NIC command format and parameters
of QConvergeConsole CLI.

NOTE:

To view the help, issue the -h command.

Command Format

Noninteractive mode format includes the following command:

qaucli -pr nic [optional parameters] <command option> [positional
parameters]

or

qaucli -pr nic -switch [optional cna_port_instance]

Where switch is one of the following:

 -beacon (Enable/Disable Port Beacon)
 -c
 -cardreset
 -ch
 -d
 -ei
 -extloopback
 -flashsupport
 -g (Display General System Information)
 -h (Help), -?, ?
 -i (List All QLogic CNA Ports Detected)
 -icna (CNA Information)
 -idcbx (Display Port DCBX Information)
 -intloopback (Configure Test Parameters)
 -iset (Display Configured Port Settings)
 -link (Display Physical Link Status)

SN0054667-00 C 4-1

4–NIC Noninteractive Commands
Command Format

 -minidump (Firmware Mini Dump)
 -n (Change Port Alias Name)
 -nh (Change CNA Alias Name)
 -pinfo (Port Information)
 -ping (Ping Target)
 -rc
 -sreset (Reset Ethernet Statistics Counters)
 -statport (Display Ethernet Port Statistics)
 -sunreset (Undo Reset Ethernet Statistics Counters)
 -teamdel (Delete Team)
 -teaminfo (Display Team Information)
 -teamlist (Display Teams List)
 -teamnew (Configure New Team)
 -teamnew_portspreview
 -testflash
 -testhw
 -testinterrupt
 -testled
 -testlink
 -testregister
 -trans (Display Transceiver DMI Data)
 -updimages (Update Flash (Boot & Firmware Images))
 -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 (Display VPD Information)
 -vtcfgview
 -vtrestore (Restore VLAN & Teaming Configuration)
 -vtsave (Save VLAN & Teaming Configuration)
 -zvt (Display Teams List; Display VLANs List; Display VLAN Information)

NOTE:

 When you issue a command, QConvergeConsole CLI loads the adapter,

executes the command, and then returns you to the command prompt.



When optional parameter

[cna_port_inst]

is not present, 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.

4-2 SN0054667-00 C

Command Summary

This section lists and describes each command line option in alphabetic order,
followed by a command description.

-beacon

(Enable/Disable Port Beacon)

To toggle on and off the port beacon (LED), issue the -beacon command as
follows:

> -switch -beacon [cna_port_inst] <on:off>

For example:

> 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

4–NIC Noninteractive Commands

Command Summary

-c

-cardreset

-ch

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

To activate changes made to Flash, issue the -cardreset command as follows:

> qaucli -pr nic -cardreset [cna_port_inst]

To view the adapter configuration, issue the -ch command as follows:

> qaucli -pr nic -ch [cna_port_inst]

SN0054667-00 C 4-3

4–NIC Noninteractive Commands

-d

For example:

> qaucli -pr nic -ch 1

=== Displaying CNA config info for 1. CNA Port Index ===

CNA_Alias : CNA X54

-d

To generate 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 get 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, run 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>]

Where <option> is one of the following options:

4-4 SN0054667-00 C

4–NIC Noninteractive Commands

-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

-u option:

out_xml_file is the name of the output xml file.

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,

out_xml_file is the name of the output xml file.

input_xml_file is the name of the input xml file, and

-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

option:

-vi

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>

Where <flash_file> is the name of the flash file that will be used to

update the adapter.

SN0054667-00 C 4-5

4–NIC Noninteractive Commands

-flashsupport

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

NOTE:

The

-i command must be used to specify the adapter interface before using

any of the following options: -a, -info, -w0, -w1, -p0, -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 will be 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

option:

-w0

To disable Wake on LAN for the interface specified by the previous -i

command, issue the following command:

> qaucli -pr nic -flashsupport -w0 --wol-off

-w1

option:

To enable Wake on LAN for the interface specified by the previous -i

command, issue the following command:

> qaucli -pr nic -flashsupport -w1 --wol-on

option:

-p0

To disable PXE LAN for the interface specified by the previous -i

command, issue the following command:

> qaucli -pr nic -flashsupport -p0 --pxe-off

4-6 SN0054667-00 C

-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

-g

(Display General System Information)

To view general system information for the host, issue the -g command as
follows:

> qaucli -pr nic -g [cna_port_inst]

For example:

> 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

4–NIC Noninteractive Commands

-g (Display General System Information)

Host Name : APPCRUSHER

Host Version: Service Pack 2 (Build 3790)

Host Type : Microsoft Windows Server 2003 R2 x64

User Type : Privileged; CNA setup allowed

-h

(Help)

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.

-i

(List All QLogic CNA Ports Detected)

To view a list of all QLogic adapter ports detected, issue the -i command as
follows:

> qaucli -pr nic -i [cna_port_inst]

SN0054667-00 C 4-7

4–NIC Noninteractive Commands

-icna (CNA Information)

For example:

> qaucli -pr nic -i 1

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

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

4-8 SN0054667-00 C

-idcbx

(Display Port DCBX Information)

To display port DCBX information, issue the -idcbx command as follows:

> qaucli -pr nic -idcbx [cna_port_inst]

-intloopback

(Configure Test Parameters)

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>

4–NIC Noninteractive Commands

-idcbx (Display Port DCBX Information)

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

-iset

(Display Configured Port Settings)

To view configured port settings, issue the -iset command as follows:

> qaucli -pr nic -iset [cna_port_inst]

NOTE:

For Linux/Solaris, the configured port settings and their values are different

from what is shown in the following example.

SN0054667-00 C 4-9

4–NIC Noninteractive Commands

-link (Display Physical Link Status)

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

-link

(Display Physical Link Status)

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

4-10 SN0054667-00 C

-minidump

(Firmware Mini Dump)

To dump a firmware core dump into a file for a given 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

core dump is created and dumped into the specified file; if
then if a core dump is available, it is dumped into the specified file.

specify how the core dump is created: if force is specified, then a new

-n

(Change Port Alias Name)

To change port alias names, issue tthhe -n command as follows:

> qaucli -pr nic -n [cna_port_inst] <config_name|config_alias>

<value> [<config_name|config_alias> <value>]

4–NIC Noninteractive Commands

-minidump (Firmware Mini Dump)

noforce is specified,

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

-nh

(Change CNA Alias Name)

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 set the only the CNA_Alias property.

For example:

> qaucli -pr nic -nh 1 CNA_Alias george

CNA_Alias : george

SN0054667-00 C 4-11

4–NIC Noninteractive Commands

-pinfo (Port Information)

-pinfo

(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

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

. . .

4-12 SN0054667-00 C

-ping

(Ping Target)

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:

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

4–NIC Noninteractive Commands

-ping (Ping Target)

count = 5

packet size = 525

timeout_ms = 1000

TTL = 30

-rc

To view a list of error codes and their descriptions, issue the -rc command as
follows:

> qaucli -pr nic -rc

SN0054667-00 C 4-13

4–NIC Noninteractive Commands

-sreset (Reset Ethernet Statistics Counters)

-sreset

(Reset Ethernet Statistics Counters)

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

-statport

(Display Ethernet 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

4-14 SN0054667-00 C

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

4–NIC Noninteractive Commands

-statport (Display Ethernet Port Statistics)

SN0054667-00 C 4-15

4–NIC Noninteractive Commands

-sunreset (Undo Reset Ethernet Statistics Counters)

-sunreset

(Undo Reset Ethernet Statistics Counters)

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

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

4-16 SN0054667-00 C

4–NIC Noninteractive Commands

-teamlist (Display Teams List)

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

The team_type variable can have the following values:

1=Fail-safe team

2=Switch independent load balancing

3=802.3ad static team

4=802.3ad dynamic team —

5=802.3ad dynamic team — passive LACP

active link aggregation control protocol (LACP)

SN0054667-00 C 4-17

4–NIC Noninteractive Commands

-teamnew_portspreview

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 <team_type> <port_insts|ALL>

For example:

> qaucli -pr nic -teamnew 1 ALL

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

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

4-18 SN0054667-00 C

-testflash

To test the Flash memory, issue the -testflash command as follows:

> qaucli -pr nic -testflash [cna_port_inst]

-testhw

To test the hardware, issue the -testhw command as follows:

> qaucli -pr nic -testhw [cna_port_inst]

-testinterrupt

To test the interrupt, issue the -testinterrupt command as follows:

> qaucli -pr nic -testinterrupt [cna_port_inst]

-testled

To test the LED, issue the -testled command as follows:

> qaucli -pr nic -testled [cna_port_inst]

4–NIC Noninteractive Commands

-testflash

-testlink

To test the link, issue the -testlink command as follows:

> qaucli -pr nic -testlink [cna_port_inst]

-testregister

To test the register, issue the -testregister command as follows:

> qaucli -pr nic -testregister [cna_port_inst]

-trans

(Display Transceiver DMI Data)

To display transceiver DMI data, issue the -trans command as follows:

> qaucli -pr nic -trans [cna_port_inst]

-updimages

(Update Flash (Boot & Firmware Images))

To update the Flash (boot and firmware) images, issue the -updimages
command as follows:

> qaucli -pr nic -updimages [cna_port_inst] <image_file>

SN0054667-00 C 4-19

4–NIC Noninteractive Commands

-updimages_viewver

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

-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
Corporation\QConvergeConsoleCLI\netscli.cfg

SANsurfer CNA Networking CLI

ncli version : 1.0.00.59

netSDMAPI : 01.01.05

Copyright 1999-2011 QLogic Corp.

4-20 SN0054667-00 C

NOTE:

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 virtual LAN (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

4–NIC Noninteractive Commands

-vlanadd (Add VLAN to Port or Team)

User entered ListIndices: 2

User entered VLAN ID: 120

About to set VLAN ID: 120 for ListIndex: 2

Successfully set.

-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

SN0054667-00 C 4-21

4–NIC Noninteractive Commands

-vlandel (Remove VLAN from Port or Team)

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:

> 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

4-22 SN0054667-00 C

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

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

4–NIC Noninteractive Commands

-vlaninfo (Display VLAN Information)

-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

(Display VPD Information)

To display VPD information, issue the -vpd command as follows:

> qaucli -pr nic -vpd [cna_port_inst]

SN0054667-00 C 4-23

4–NIC Noninteractive Commands

-vtcfgview

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

NOTE:

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

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

4-24 SN0054667-00 C

-vtrestore (Restore VLAN & Teaming Configuration)

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

pDNSServers[ 2] : fec0:0:0:ffff::3

............................

VLAN ID : 555

............................

IPv4Address :

IPv4SubnetMask :

IPv4GatewayAddr :

DHCPServerCount : 0

IPv6GatewayAddr :

IPv6AddressCount : 0

DNSServerCount : 0

4–NIC Noninteractive Commands

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

SN0054667-00 C 4-25

4–NIC Noninteractive Commands

-vtrestore (Restore VLAN & Teaming Configuration)

NOTE:

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

Attempting to restore TEAMs and VLANs if configured prior to vtdriver updaate.

*** Teams:

*** Ports:

00:c0:dd:0a:b4:34

VLAN IDs:

55

00:c0:dd:0a:b4:35

VLAN IDs:

55

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:

4-26 SN0054667-00 C

4–NIC Noninteractive Commands

-vtrestore (Restore VLAN & Teaming Configuration)

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

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

SN0054667-00 C 4-27

4–NIC Noninteractive Commands

-vtsave (Save VLAN & Teaming Configuration)

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

NOTE:

 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 ...
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: 2 MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI

Ethernet Adapter #4
CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI

Ethernet Adapter #3

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

4-28 SN0054667-00 C

4–NIC Noninteractive Commands

-zvt (Display Teams List; Display VLANs List; Display VLAN Information)

-zvt

(Display Teams List; Display VLANs 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 ***

Team: 1 Team Description: QLogic VT-IM Miniport Driver VLAN ID: 555 Team Type:
Fail Over

Team Members:

CNA: 1 CNA Port: 2 MAC: 00:c0:dd:0a:b4:61 Description: QLogic 10Gb PCI
Ethernet Adapter #4

CNA: 1 CNA Port: 1 MAC: 00:c0:dd:0a:b4:60 Description: QLogic 10Gb PCI
Ethernet Adapter #3

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

SN0054667-00 C 4-29

4–NIC Noninteractive Commands

-zvt (Display Teams List; Display VLANs List; Display VLAN Information)

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

4-30 SN0054667-00 C

5 Fibre Channel

Noninteractive Commands

This chapter describes the noninteractive Fibre Channel command format and
parameters of QConvergeConsole CLI. For a quick reference to informative
commands, see Display System Information (Command Line Options -g, -z, and

-tp).

NOTE:

To view help, issue the command -h.

Display 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 5-1).

# qaucli -pr fc -z shows the host configuration (see “Host Configuration



(Command Line Option -z)” on page 5-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 target management (SDM) API version

SN0054667-00 C 5-1

5–Fibre Channel Noninteractive Commands
Host Configuration (Command Line Option -z)

 List of adapters: adapter model, port number, WWPN, serial number (SN),

adapter number (adapter 0–n), and status (online or offline)

 Total number of QLogic Fibre Channel adapters detected

NOTE:

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 5-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/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>)

Where:

hba instance

hba wwpn

= Adapter number (use -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

5-2 SN0054667-00 C

Host 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 5-1. The commands are listed in alphabetical order.

CLI Description See User Guide Section

5–Fibre Channel Noninteractive Commands

Host Configuration

.

Table 5-1. Options Shown by -z

-c

-e Configure boot device “-e (Boot Device View | Select | Dis-

-fg View driver settings “-fg (Show Driver Settings)” on

-g Show system information “-gs (Show HBA Statistics)” on

-i

-l Show LUN list “-l (Display LUN Info)” on page 5-22

-m Configure selective LUNs “-m (View, Enable, or Disable LUNs)” on

-p Configure target persistent binding “-p (Display Persistent Target Binding

-t Show target list “-t (Display Target Information)” on

Show adapter settings

Show adapter information

“-c (Show Parameter Settings)” on
page 5-7

able)” on page 5-9

page 5-12

page 5-13

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

page 5-24

Info)” on page 5-28

page 5-33

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 -g command to find)

hba wwpn = Adapter world wide port name

SN0054667-00 C 5-3

5–Fibre Channel Noninteractive Commands
Command Format

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 (Output to a File)” on page 5-28).

For example:

# qaucli -pr fc -l -o

 -s = Silent mode (see “-s (Silent Mode)” on page 5-33). For example:

# qaucli -pr fc -i all -s -o output.txt

 -x = Outputs the results in XML format (see “-x (Output in XML Format 1)”

on page 5-37). 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 (Input Parameter

Options from a Text File)” on page 5-11). 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 5-2 defines the command variables.

.

Table 5-2. Command Variables

Variable Definition Format

<hba instance>

<hba wwpn> Adapter world wide port

<alias> Adapter alias

<target wwnn> Target world wide node

Adapter number

name

name

a

xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx

Symbolic adapter b name

xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx

<target wwpn> Target world wide port

name

<target port id> Target port ID xx-xx-xx or xxxxxx

5-4 SN0054667-00 C

xx-xx-xx-xx-xx-xx-xx-xx or
xxxxxxxxxxxxxx

Table 5-2. Command Variables (Continued)

Variable Definition Format

<target id> Target ID

<lun id> Logical unit number (0–255)

<address> IP address xxx.xxx.xxx.xxx

(speed) Target link speed 1.2, 4, or 8GHz

a

You can use the -g command to find adapter numbers.

b

You assign the symbolic name. It is limited to 100 characters in length.

Command Summary

This section lists and describes each command line option in alphabetic order,
followed by a command description.

5–Fibre Channel Noninteractive Commands

Command Summary

-a

(View or Toggle Beacon Status)

Use the -a command to either view (1) or change (2) the status of a beacon.

NOTE:

 Adapter must not be in silent mode. See “-s (Silent Mode)” on page 5-33

to issue a response to this command.

 The -a feature is not supported on QLA22xx adapters or QLE8042

adapter.

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.

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.

SN0054667-00 C 5-5

5–Fibre Channel Noninteractive Commands

-b (Save or Update the Flash BIOS or FCode)

If QConvergeConsole CLI is not in silent mode (see

page 5-33

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

(Save or Update the Flash BIOS or FCode)

Use the -b command to:

 Update the BIOS or FCode from a file (1).

 Save the BIOS or FCode to a file (2).

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>

Where:

“-s (Silent Mode)” on

all = All adapters of the same type in the system are updated with

the new BIOS/FCode

hba instance = Adapter number (use -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/EFI) depending on the Flash

BIOS/FCode File Name

a

Region update only supported on QLA/QLE/QMC246x adapters.

= Name or path of file continuing update BIOS/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 -g command to find)

hba wwpn = World wide port name of the adapter

BIOS/FCode File Name

= File name or a path to a file in which to save BIOS/FCode

NOTE:

The option to save the FCode to a file type is not supported for QLE8242.

5-6 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-c

(Show Parameter Settings)

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 -g command to find)

hba wwpn = World wide port name of the adapter

-cna

(FCoE Utilities Menu for QLE81xx and QLE82xx Adapters)

Use the -cna command to work with converged network adapters (QLE81xx
and QLE82xx).

-c (Show Parameter Settings)

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 adapter, issue the following command:

qaucli -pr fc -cna <hba instance>|<hba wwpn> --geninfo

To view data center bridging exchange protocol settings, issue the following
command:

qaucli -pr fc -cna <hba instance>|<hba wwpn> --dcb --info

To update the message passing interface (MPI) configuration table on the adapter
from a file, issue the following command:

qaucli -pr fc -cna <hba instance>|<hba wwpn> --updatecfg
<mpi file>

SN0054667-00 C 5-7

5–Fibre Channel Noninteractive Commands

-dm (Display Diagnostics Monitoring Info)

To view DCBX Type-Length-Value (TLV) data sent and received over the adapter
port connection, issue the following command:

qaucli -pr fc -cna <hba instance>|<hba wwpn> --tlv ( --detail |

--raw )

To view data center Ethernet (DCE™) network activity information sent and
received over the adapter port connection, issue the following command:

qaucli -pr fc -cna <hba instance>|<hba wwpn> --mon --dce
[{<param name>| <param alias> <param value> } ]

Table 5-3 lists the DCE statistics parameters, possible values, and a description of

each.

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

-dm

(Display Diagnostics Monitoring Info)

This option allows you to show general or detailed digital diagnostic monitoring
interface for optical transceivers.

NOTE:

This option is supported only for QLA/QLE/QEM24xx (4GB) adapters.

Parameter

Value

1–256

Description

Set to auto polling mode

Set to manual polling mode (iteration)

 0 = Absolute

 1 = Rate per second

 2 = Baseline

To show transceiver monitoring general information, issue the following command:

# qaucli -pr fc -dm (<hba instance> | <hba wwpn> | <all>) general |
gen

5-8 SN0054667-00 C

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 -g command to find)

hba wwpn = World wide port name of the adapter

all = All adapters in the system

-e

(Boot Device View | Select | Disable)

Use the -e command to:

 Show the current boot-device selection for all adapters.

 Show the current boot-device selection for a specific adapter.

5–Fibre Channel Noninteractive Commands

-e (Boot Device View | Select | Disable)

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

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 Windows and Linux, each adapter’s currently selected boot device is shown in
the following format:

<hba instance> <hba wwpn> <target wwnn> <target wwpn> <lun id>

SN0054667-00 C 5-9

5–Fibre Channel Noninteractive Commands

-e (Boot Device View | Select | Disable)

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.

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>

NOTE:

®

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.

If you select an adapter with no target or a target with no LUN,
QConvergeConsole CLI shows an error message and aborts.

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?

5-10 SN0054667-00 C

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

-ei

(List Fibre Channel Error Codes)

This command lists the Fibre Channel error codes.

5–Fibre Channel Noninteractive Commands

-ei (List Fibre Channel Error Codes)

-f

(Input Parameter Options from a Text File)

NOTE:

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.

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.

SN0054667-00 C 5-11

5–Fibre Channel Noninteractive Commands

-fg (Show Driver Settings)

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

-fg

(Show Driver Settings)

NOTE:

The -fg option is valid only in noninteractive mode.

The -fg option is not supported for Linux/Solaris.

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 -g command to find)

hba wwpn = World wide port name of the adapter

-fs

(Configure Driver Settings)

Type the following command to configure the driver settings:

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

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

The pairs <param name> <param value> and <param alias> <param value> can
be repeated to set multiple parameters in a single command.

command to find)

Table 5-4 lists the driver configuration parameter names and aliases.

5-12 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-gs (Show HBA Statistics)

Table 5-4. Driver Settings Parameters

Description

Parameter Name

<param name>

Alias

<param

alias>

Value

<param

value>

Persistently bound target(s) only PersistentOnly PO 0, 1

Present persistently bound tar-

PersistentPlusNew PN 0, 1
get(s) plus any new target(s) with
driver default

Present targets with driver default

NewOnly

b

NO 0, 1

Bind devices by WWPN BindWWPN BW 0, 1

Bind devices by port ID BindPortID BP 0, 1

a

0 = Disabled, 1 = Enabled

b

Driver parameter NewOnly (NO) is supported only with the failover driver. If you select a QLA22xx

adapter, all QLA22xx adapters on the host will use the same settings. If you select a 23xx adapter,
all 2G/4G adapters on the host will also use the same settings.

The following restrictions apply:

 Under Linux, this feature is disabled if you are using the IOCTL or sysfs

(inbox) driver.

®

 Under Mac OS

, the BindWWPN and BindPortID parameters are not

changeable; Mac OS supports only the BindWWPN parameter.

a

-gs

(Show HBA Statistics)

To view the adapter statistics, issue the following command:

# qaucli -pr fc -gs (<hba instance> | <hba wwpn>) [(<param name> |
<param alias>) <param value>]

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

param name = Name of the parameter (see table 4-7)

param alias = Alias of the parameter (see table 4-7)

param value = New value of the parameter (see table 4-7)

Table 5-5 lists the adapter statistics parameter names, aliases, and values.

SN0054667-00 C 5-13

5–Fibre Channel Noninteractive Commands

-h (Help)

Table 5-5. Adapter Statistics Parameters

Description Name Alias Value

-h

(Help)

Sets how often statistics are retrieved AutoPoll AP

Set the polling interval when retrieving statis­tics (seconds)

Saves the adapter’s statistics to a CVS log file LogToFile LF Log file

a

When the AutoPoll value is 0, statistics are retrieved automatically until the user aborts the

operation.
When the AutoPoll value is in the range of 1–256, statistics are retrieved for the number of cycles
specified by this value.

PollRate SR 5–30

0–256

name

a

Under Linux, this feature is disabled if you are using the IOCTL or sysfs (inbox)
driver.

To view the help file, issue the following command:

# qaucli -pr fc (-h)

To view help information for an individual command, issue the following command:

# qaucli -pr fc <Command Line Parameter> (-h)

5-14 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-ha (Set | Delete HBA Alias)

For example, typing qaucli -pr fc -l -h shows the following:

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

QLogic FCAPI

v1.7.3 Build 38

Copyright (C) 2003-2011 QLogic Corp.

All rights reserved.

QLogic FC/FCoE Common Library

Build Type: Release

Build Date: Dec 7 201x 13:44:03

LUN list.

USAGE:

Displays all LUNs information of all devices attached on an HBA port.

scli -l <hba instance>|<hba wwpn>

Displays all LUNs information of a device attached on an HBA port.

scli -l <hba instance>|<hba wwpn> <target wwpn>|<target portid>

Displays a specific LUN information of a target device attached on an HBA port.

scli -l <hba instance>|<hba wwpn> <target wwpn>|<target portid <lun id>

Options

<hba instance> The HBA instance number of an HBA port.

<hba wwpn> The World Wide Port Name of an HBA port.

<target wwpn> The World Wide Port Name of a target device.

<target portid> The Port ID of a target device.

<lun id> The Logical Unit Number of a LUN.

NOTE:

To view the current version information for QConvergeConsole CLI, issue
the -v command described in “-v (Display Version)” on page 5-35.

-ha

(Set | Delete HBA Alias)

With this command you can view, set or delete the alias of a specific adapter.

To view the alias of a specified adapter, issue the following command:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) view | info

SN0054667-00 C 5-15

5–Fibre Channel Noninteractive Commands

-i (Display HBA General Information or VPD Information for One or All HBAs)

To set an alias for a specified adapter, issue the following command:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) <alias>

To delete an alias of a specified adapter, issue the following command:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) delete

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

alias = Symbolic adapter name. (100 characters, maximum)

To set an alias for the selected adapter:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) <alias>

To delete the current alias of the selected adapter:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) delete

To view the current alias of the selected adapter:

# qaucli -pr fc -ha (<hba instance> | <hba wwpn>) view | info

-i

(Display HBA General Information or VPD Information for One or All HBAs)

To show general adapter information or VPD information for all adapter ports in
the system, type the following command:

# qaucli -pr fc -i [ <all> ] [ <VPD> ]

Where:

all = All adapters in the system

VPD = Vital Product Data

To show general or VPD information for a specific adapter, issue the following
command:

# qaucli -pr fc -I (<hba instance> | <hba wwpn>) [ VPD ]

To show VPD (QLA/QLE24xx only) for all adapter ports in the system, issue the
following command:

# qaucli -pr fc -i VPD

# qaucli -pr fc -i all VPD

Where:

all = VPD information for all adapters in the system

5-16 SN0054667-00 C

-kl

(Run Loopback Test)

Use the -kl command to perform an external loopback test.

To perform a loopback test using the default parameters, issue the following
command:

# qaucli -pr fc -kl (<hba instance> | <hba wwpn>)

To do an external loopback test with customized parameters, issue the following
command:

# qaucli -pr fc -kl (<hba instance> | <hba wwpn>) [(<param name> |
<param alias>) <param value>]

Where:

5–Fibre Channel Noninteractive Commands

-kl (Run Loopback Test)

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

param name = One of the following:

 DataPattern

 DataSize

 TestCount

 TestIncrement

 OnError

 LoopbackType

param alias = One of the following:

 DP

 DS

 TC

 TI

 OE

 LT

param value = Value for selected parameter (see Tabl e 5- 6)

SN0054667-00 C 5-17

5–Fibre Channel Noninteractive Commands

-kr (Run Read/Write Buffer Test)

-kr

(Run Read/Write Buffer Test)

Use the -kr command to do a read/write buffer test.

To do a read/write test using the default parameters, issue the following
command:

# qaucli -pr fc -kr (<hba instance> | <hba wwpn>)

To do a read/write test with customized parameters, issue the following command:

# qaucli -pr fc -kr (<hba instance> | <hba wwpn>) [(-EX | -EXCLUDE)
<target wwpn>] (<param name> | <param alias>) <param value>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

-ex or -exclude = World wide port name of the target device that is

excluded from the read/write test

param name = One of the following:

param alias = One of the following:

param value = Value for selected parameter (see Tabl e 5- 6)

“Run a Read/Write Buffer Test” on page 5-18 contains command line examples

and test results for a read/write buffer test.

Run a Read/Write Buffer Test

This test runs on all devices or on the devices you select on the adapter you
select. This test sends the SCSI Write Buffer command to the target devices and
uses the SCSI Read Buffer command to read the returned data and do a data
comparison.

 DataPattern

 DataSize

 TestCount

 TestIncrement

 OnError

 DP

 DS

 TC

 TI

 OE

5-18 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-kr (Run Read/Write Buffer Test)

NOTE:

All devices attached to the adapter must support SCSI Read/Write Buffer
commands.

To do a read/write buffer test using the current parameters, issue the following
command:

# qaucli -pr fc -kr (<hba instance> | <hba wwpn>)

To exclude a device or devices on the selected adapter port, issue the following
command:

# qaucli -pr fc -kr (<hba instance>|<hba wwpn>) [(-EX | -EXCLUDE)
<target wwpn>] [(<param name>|<param alias>) <param value>]

The following examples do 500 read/write buffer tests with a test increment of 10,
a data pattern of FFh, and a data size of 8 bytes. The test stops if an error occurs.

# qaucli -pr fc -kr <hba instance> DP FF DS 8 TC 500 TI 10 OE 1

# qaucli -pr fc -kr <hba wwpn> DP FF DS 8 TC 500 TI 10 OE 1

You do not have to set each parameter for the read/write buffer test. If you do not
specify a parameter in the command line, the current parameter value is used. For
example, the following command sets the data pattern to FFh and uses the
current values for the other parameters:

# qaucli -pr fc -kr <hba instance> DP FF

The following example sets the data size to 16 bytes and has the test loop if an
error occurs. The other parameters use the current values.

# qaucli -pr fc -kr <hba wwpn> DS 16 OE 2

An example of a successful read/write buffer test follows:

HBA 1: QEM2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 02-0E-00

------------------

Test Configuration

------------------

Data Pattern : Random

Data Size (Bytes) : 512

Number of test(s) (0-65535) : 500

Test Increment (1-65535) : 1

On Error : Ignore

Test Continuous : OFF

------------------------------------------------------------------------------

SN0054667-00 C 5-19

5–Fibre Channel Noninteractive Commands

-kr (Run Read/Write Buffer Test)

Run Adapter Diagnostics Read-write Buffer Test

The {(-ex | exclude) <target wwpn>} parameters specify a device that
will be excluded from the read/write buffer test.

The system shows the following information after a read/write buffer test
completes:

 Loop ID/status
 Data miscompare
 Link failure
 Loss of sync
 Loss of signal
 Invalid CRC

Table 5-6 lists the <param name>, <param alias>, and <param value>

options.

Table 5-6. Diagnostics Parameters

Name

<param name>

Alias

<param

alias>

Value

<param value>

DataPattern DP Test pattern in hex for-

a

mat

Customized (00–FF)

Random pattern

b

c

d

DataSize

CRPAT

CJT PAT

CSPAT

e

DS 8, 16, 32, 64, 128, 256,

512, 1024, 2048

TestCount

f

TC 0–65535

0–10,000

TestIncrement

g

TI 1–65535

1–10,000

OnError OE 0–2 0 = ignore

Description

00, 55, 5A, A5, AA, FF (see

Ta bl e 5 - 7)

—

—

Loopback test only

Loopback test only

Loopback test only

Actual data transferred dur­ing any given pass of the
test

Loopback test only

Read/write buffer test only

Loopback test only

Read/write buffer test only

1 = stop

2 = loop on error

5-20 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-kr (Run Read/Write Buffer Test)

Table 5-6. Diagnostics Parameters (Continued)

h

Alias

<param

alias>

LT 0–2

Value

<param value>

Description

0 = 10-bit internal loopback

Name

<param name>

LoopbackType

1 = 1-bit serial loopback

2 = external loopback

a

Valid two-character case-insensitive hexadecimal patterns.

b

Compliant random data pattern in a valid Fibre Channel frame, as defined by the ANSI document

Methodologies for Jitter and Signal Quality Specification —MJSQ Annex A—Test bit sequences.

c

Compliant jitter tolerance pattern in a Fibre Channel frame, as defined by the ASIC document listed

above.

d

Compliant supply noise test sequence in a valid Fibre Channel frame, as defined by the ASIC

document listed above.

e

For read/write buffer test, the maximum size is 128; this is also the default.

f

0=test continuously. 1–10,000 and 1–65535=total number of tests that will be executed.

g

Must be less than the TestCount value.

h

Loopback test only

i

Requires installation of a loopback plug in the port SFP

i

Table 5-7. Data Pattern (DP) Test Patterns

Hex Binary

00 00000000

55 01010101

5A 01011010

A5 10100101

AA 10101010

FF 11111111

SN0054667-00 C 5-21

5–Fibre Channel Noninteractive Commands

-l (Display LUN Info)

If the read/write buffer test fails, the system shows the following information:

 Loop/port ID (the loop ID of the adapter when operating in loop mode).

 Status:

 Success—The test passed.

 Error—A data miscompare or link status firmware error occurred.

 Failed—A link status error, SCSI write buffer error, or SCSI read buffer

error occurred.

 Unknown—The target was not present.

 Unsupported—The device does not support this test.

 Data Miscompare—The possible values are:

 0 (no data miscompares)
 Device not present
 Get link status failed
 Read buffer failed
 R/W buffer not supported
 Write buffer failed

 Link Failure—Number of link failures

 Loss of sync—Number of sync loss errors

 Loss of signal—Number of signal loss errors

 Invalid CRC—Number of invalid CRCs

-l

(Display LUN Info)

This command shows LUN information for:

 All adapters
 A specific target
 A specific LUN on a specific target

To show the LUN information for all target devices for a specific adapter Instance,
issue the following command:

To show the LUN information for a specific device for a specific adapter port, issue
the following command:

# qaucli -pr fc -l (<hba instance> | <hba wwpn>)

# qaucli -pr fc -l (<hba instance> | <hba wwpn>) (<target port

id> | <target wwpn>)

5-22 SN0054667-00 C

To show the LUN information for a specific LUN on a specific target device for a
specific adapter port instance, issue the following command:

# qaucli -pr fc -l (<hba instance> | <hba wwpn>) (<target port
id> | <target wwpn>) <lun id>

Where:

hba instance = Adapter number (use -g command to find)

target port id = Port ID of the target

target wwpn = World wide port name of the target

-ls

(Display Link Status)

To view the link status, issue the following command:

# qaucli -pr fc -ls (<hba instance> | <hba wwpn>) [(<param
name> | <param alias>) <param value>]

5–Fibre Channel Noninteractive Commands

-ls (Display Link Status)

hba wwpn = World wide port name of the adapter

lun id = ID of the LUN

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

param name = Name of the parameter (see Table 5-8)

param alias = Alias of the parameter (see Ta bl e 5 - 8)

param value = New value of the parameter (see Tabl e 5- 8)

Table 5-8 defines the link status parameter names, aliases, and values.

Table 5-8. Link Status Parameters

Description Name Alias Value

Sets link-status retrieval period AutoPoll AP

Sets link-status retrieval polling interval PollRate SR 5–30 seconds

Save link status to CVS log file LogToFile LF Log file name

a

When the AutoPoll parameter is 0, the link status is retrieved automatically until the user aborts the

operation. When the AutoPoll parameter is in the range of 1–256, the link status is retrieved for the
number of cycles specified by this value.

0–256 a cycles

SN0054667-00 C 5-23

5–Fibre Channel Noninteractive Commands

-m (View, Enable, or Disable LUNs)

-m

(View, Enable, or Disable LUNs)

NOTE:

 If the current driver setting is Bind by Port ID, this option is not available.

 Under Linux, if you use the IOCTL or sysfs (inbox) driver, this feature is

disabled.

 You must persistently bind the targets before configuring selective LUNs,

(link).

Use the -m command to:

 View all selective LUNs for all adapter ports
 View an adapter’s selective LUN list
 View the current selective state of a LUN on a specific target
 Enable (select) a LUN on a specific target on a specific adapter
 Disable (deselect) a LUN on a specific target on a specific adapter
 Enable all LUNs on a specific target on a specific adapter
 Disable (deselect) all LUNs on a specific target on a specific adapter
 Enable (select) all LUNs of all targets on a specific adapter
 Disable (deselect) all LUNs of all targets on a specific adapter

For these commands:

hba instance = Adapter number (use -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

lun id = ID of the LUN

To view all selective LUNs for all adapter ports, issue the following command:

# qaucli -pr fc -m all (view | info)

To view an adapter’s selective LUN list, issue the following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn> | all) (view |
info)

QConvergeConsole CLI shows the adapter’s enabled LUN list in the following
format:

<target wwnn> <target wwpn> <lun id>

5-24 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-m (View, Enable, or Disable LUNs)

To view the current select state of a specific LUN, issue the following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) (<target wwnn>
<target wwpn> <lun id>) (view | info)

If the input represents a valid LUN, QConvergeConsole CLI shows that LUN’s
current state as selected or deselected for that adapter.

To enable (select) a LUN on a specific target on a specific adapter, issue the
following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) {<target wwnn>
<target wwpn> <lun id> ( 1 | enable | select )}

NOTE:

You can repeat the sequence <target wwnn> <target wwpn> <lun
id> 1 to select multiple LUNs in the same command.

To disable (deselect) a LUN on a specific target on a specific adapter, issue the
following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) {<target wwnn>
<target wwpn> <lun id> (0 | disable | deselect)}

NOTE:

To select multiple LUNs in the same command, repeat the following
sequence:

<target wwnn> <target wwpn> <lun id> 0

To enable (select) all LUNs for a specific target on a specific adapter, issue the
following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) select | enable
<target wwnn> <target wwpn>

To disable (deselect) all LUNs for a specific target on a specific adapter, issue the
following command:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) deselect | disable
<target wwnn> <target wwpn>

To enable (select) all LUNs of all targets on a specific adapter:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) select all

To disable (deselect) all LUNs of all targets on a specific adapter:

# qaucli -pr fc -m (<hba instance> | <hba wwpn>) deselect all

SN0054667-00 C 5-25

5–Fibre Channel Noninteractive Commands

-n (Set Selected HBA Parameter)

-n

(Set Selected HBA Parameter)

To set a specific parameter on a specific adapter, issue the following command:

# qaucli -pr fc -n (<hba instance> | <hba wwpn>) { (<param name> |
<param alias>) <param value>}

To restore the default BIOS (4G adapters only), issue the following command:

# qaucli -pr fc -n (<hba instance> | <hba wwpn>) default

Where:

hba instance = Adapter number (use -g command to find)

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

The pairs <param name> <param value> and <param alias> <param value> can
be repeated to set multiple parameters with a single command.

Table 5-9 lists the adapter parameter names and aliases.

.

Table 5-9. Adapter Parameters

Description Name Alias Value

Connection options ConnectionOption CO

Data rate DataRate DR

Enable BIOS

Enable extended logging

EnableBIOS

EnableExtendedLogging

c

EB 1=Enable, 0=Disable

d

EL 1=Enable, 0=Disable

See table note

See table note

Enable Fibre Channel tape EnableFCTape EF 1=Enable, 0=Disable

Enable hard loop ID EnableHardLoopID HL 1=Enable, 0=Disable

Enable LIP full login EnableLIPFullLogin FL 1=Enable, 0=Disable

Enable LIP reset EnableLipReset LP 1=Enable, 0=Disable

Enable target reset EnableTargetReset TR 1=Enable, 0=Disable

Execution throttle ExecutionThrottle ET 1–65535

a

b

Frame size FrameSize FR 512, 1024, 2048

Hard loop ID HardLoopID HD 0–125

Interrupt delay timer InterruptDelayTimer ID 0–255

5-26 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-n (Set Selected HBA Parameter)

Table 5-9. Adapter Parameters (Continued)

Description Name Alias Value

Login retry count LoginRetryCount LR 0–255

Link down timeout LinkDownTimeOut LT 0–240

Maximum LUNs per target MaximumLUNsPerTarget ML 0, 8, 16, 32, 64, 128, 256

Operation mode OperationMode OM

See table note

Port down retry count PortDownRetryCount PD 0–255

Reset Delay ResetDelay RD 0-255

Table Notes

a

Connection Options:

0 = Loop only
1 = Point-to-point only
2 = Loop preferred, otherwise point-to-point
3 = Point-to-point preferred, otherwise loop (QLA22xx adapters only)

b

Data Rate (QLA23xx/QLA24xx/QLE23xx/QLE24xx and QLE2562):

0 = 1 Gb
1 = 2Gbs
2 = Auto
3 = 4 Gbs
4 = 8 Gbs

c

EnableBIOS option not available on 4Gb adapter.

d

EnableExtendedLogging option not available on PPC64 or SPARC.

e

Operation mode (QLA/QLE23xx, QLA/QLE24xx, and QLE2562):

0 = interrupt for every I/O completion
5 = interrupt when interrupt delay timer expires
6 = interrupt when interrupt delay timer expires or no active I/O

e

NOTE:

QLA200/210 adapters have a limited set of parameters that can be
changed.

SN0054667-00 C 5-27

5–Fibre Channel Noninteractive Commands

-o (Output to a File)

-o

(Output to a File)

NOTE:

 The -o option is valid only in noninteractive mode.

 This option can be used with all noninteractive mode options that have a

corresponding interactive mode option (see Tabl e 5 -1 ). The option must
be the first or last command in the command line.

 If the file already exists, new data are appended to the current file.

To output result and status messages into a file, type -o, followed by the file
name. For example, to save LUN information to a file named systemLUNinfo:

# qaucli -pr fc -l -o systemLUNinfo

Where the file name is systemLUNinfo, all messages are located in the
directory indicated for the system platform:

Windows:

Linux:

Mac OS:

syslog.log in the current directory

/var/log/messages

/var/log/system.log

-p

(Display Persistent Target Binding Info)

With this command you can:

 Show binding information for one or on all adapters.
 Bind a specific target to a selected adapter.
 Bind all targets on a specific adapter or on all adapter.
 Unbind a specific target.
 Unbind all targets on a specific adapter or on all adapters.

NOTE:

Under Linux, if you use the IOCTL or sysfs (inbox) driver these features are
disabled.

To show target persistent binding information for a specific adapter port, issue the
following command:

# qaucli -pr fc -p (<hba instance> | <hba wwpn>) (view | info)

5-28 SN0054667-00 C

5–Fibre Channel Noninteractive Commands

-p (Display Persistent Target Binding Info)

To show persistent binding information for all adapters, issue the following command

# qaucli -pr fc -p all (view | info)

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

The following example is a typical QConvergeConsole CLI output showing all
targets currently bound to an adapter:

-------------------------------------------------------------------------­HBA 0: QLA2462 Port 1 WWPN xx-xx-xx-xx-xx-xx-xx-xx Port ID 11-06-EF

-------------------------------------------------------------------------­Bind Type Device Node Name Device Port Name Port ID ID

---- ---- ---------------- ---------------- ------- -­No Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E1
Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E2 0
Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx­Yes Disk xx-xx-xx-xx-xx-xx-xx-xx xx-xx-xx-xx-xx-xx-xx-xx 10-02-E8 2

Press <Enter> to continue:

xx-xx-xx-xx-xx-xx 10-02-E4 1

To bind a selected target to a specific adapter, issue the following command:

# qaucli -pr fc -p (<hba instance> | <hba wwpn>) (<target wwnn>
<target wwpn> <target port id> <target id>)

:

Where:

hba instance = Adapter number (use -g command to find)

hba wwnn = Word wide node name of the adapter

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 port id = Port ID of the target

target id = ID to which the target is bound

To bind multiple targets with a single command, repeat the following group:

<target wwnn> <target wwpn> <target port id> <target id>

To bind all targets on a specific adapter or to bind all targets on all adapters, issue
the following command:

# qaucli -pr fc -p (<hba instance> | <hba wwpn> | all) bind all

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

SN0054667-00 C 5-29

5–Fibre Channel Noninteractive Commands

-pa (Define Port Alias)

To unbind a specific target, issue the following command:

# qaucli -pr fc -p (<hba instance> | <hba wwpn>) (remove <target
wwnn> | unbind <target wwnn>)

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

target wwnn = World wide node name of the target

To unbind all targets on a specific adapter port or on all adapter ports, issue the
following command:

# qaucli -pr fc -p (<hba instance> | <hba wwpn> | all) (remove all
| unbind all)

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

-pa

(Define Port Alias)

With this command you can:

 Define the port alias for a specific adapter port (1)
 Delete the port alias from a specific adapter port (2)
 View the port alias for a specific adapter port (3)

To define a port alias for the specified adapter, issue the following command:

# qaucli -pr fc -pa (<hba instance> | <hba wwpn>) <alias>

Where:

To delete a port alias for the specified adapter port, issue the following command:

# qaucli -pr fc -pa (<hba instance> | <hba wwpn>) delete

To view a port alias for the specified adapter port, issue the following command:

# qaucli -pr fc -pa (<hba instance> | <hba wwpn>) view | info

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

alias = Symbolic name you assign to the adapter port

5-30 SN0054667-00 C

-q

(View or Set Target Link Speed)

NOTE:

The -q option is supported only on 4Gb adapters.

Issue the following command to view the link speed of all targets attached to one
adapter or all adapters:

5–Fibre Channel Noninteractive Commands

-q (View or Set Target Link Speed)

# qaucli -pr fc -q (<hba instance> | <hba wwpn> | <all>)
| -t ]

[-targets

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

all = Reports link speed for all targets on all adapters in the system

-targets = All targets

-t = All targets

To view the link speed of a specific target attached to an adapter, issue the
following command:

# qaucli -pr fc -q (<hba instance> | <hba wwpn> | <target wwpn>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

target wwpn = World wide port name of the target

To set the link speed of all targets attached to one adapter or all adapters to the
designated speed, issue the following command:

# qaucli -pr fc -q (<hba instance> | <hba wwpn> | <all>) <-targets
| -t ><speed>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

all = Reports link speed for all targets on all adapters in the system

-targets = All targets

-t = All targets

speed = Link speed (

SN0054667-00 C 5-31

5–Fibre Channel Noninteractive Commands

-r (Update HBA Parameters)

To set the link speed of selected target(s) attached to one adapter to the
designated speed, issue the following command:

# qaucli -pr fc -q (<hba instance> | <hba wwpn> | <all>) <target
wwpn> <speed>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

all = Reports link speed for all targets on all adapters in the system

target wwpn = World wide port name of the target

speed = Link speed

-r

(Update HBA Parameters)

To update the adapter parameters, issue the following command:

# qaucli -pr fc -r (<hba instance> | <hba wwpn> | all) <File Name>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

all = All adapter ports in the system are updated with the new

adapter parameters

hba parameters file

name

= File name or a path to a file that contains the updated adapter

parameters

To save the adapter parameters to a file, issue the following command:

# qaucli -pr fc -r (<hba instance> | <hba wwpn>) save <File Name>

Where:

hba instance = Adapter number (use -g command to find)

hba wwpn = World wide port name of the adapter

hba parameters file

name

= File name or a path to a file to save the adapter parameters

5-32 SN0054667-00 C