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 |
“-iset (Display Configured Port Settings)” on |
settings and values differ for Linux/Solaris. |
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 |
“-cna (FCoE Utilities Menu for QLE81xx and |
QLE82xx. |
QLE82xx Adapters)” on page 5-7 |
Removed example of -cna command saving MPI |
“-cna (FCoE Utilities Menu for QLE81xx and |
configuration table to a file. |
QLE82xx Adapters)” on page 5-7 |
Added “all” to -e (view | info) command to view the |
“-e (Boot Device View | Select | Disable)” on |
current boot device selection. |
page 5-9 |
Added a note explaining that the -fg option is not |
“-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 |
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 |
|
|
|
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 |
Table |
List of Tables |
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 |
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.
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
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.
This guide is for system administrators who are responsible for installing, configuring, and managing QLogic adapters using QConvergeConsole CLI.
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
This guide uses the following documentation conventions:
NOTE: provides additional information.
CAUTION! indicates the presence of a hazard that has the potential of causing damage to data or equipment.
WARNING!! indicates the presence of a hazard that has the potential of causing personal injury.
xxii |
SN0054667-00 C |
Preface
Text in 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. For 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.
Text in 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.
Text in 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.
Enter the following command: sh ./install.bin
Key names and key strokes are indicated with UPPERCASE:
Press CTRL+P.
Press the UP ARROW key.
Text in 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
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.
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 training@qlogic.com.
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 Corporation |
|
4601 Dean Lakes Blvd. |
|
Shakopee, MN 55379 USA |
QLogic Web Site |
www.qlogic.com |
Technical Support Web Site |
http://support.qlogic.com |
Technical Support E-mail |
support@qlogic.com |
Technical Training E-mail |
training@qlogic.com |
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.
xxiv |
SN0054667-00 C |
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
The minimum hardware requirements for the workstation server are as follows:
Server. Single-processor or multiprocessor server or workstation. See “Operating System Requirements” on page 1-2 for a list of operating 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
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.
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
QConvergeConsole CLI runs on the following platforms:
Windows Server 2008
Red Hat® Linux® Advance Server/Enterprise Server
Novell SUSE® Linux Enterprise Server (SLES)
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.
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.
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.
The installation procedures differ depending on the operating system:
Installing QConvergeConsole CLI in a Windows Environment
Installing QConvergeConsole CLI in a Linux Environment
You can install QConvergeConsole CLI from the command prompt using the Microsoft® Windows Installer (MSI). Use one of the following methods:
Standard Windows Interactive (CLI) Installation
Quiet or Unattended Windows Installation
Passive Windows Installation
Overwrite Previous Windows Installations
NOTE:
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
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.
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
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.
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
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® (PPC) do not put the /usr/local/bin directory in the execution path by default. You must add it.
To remove QConvergeConsole CLI from your system, follow the instructions for your operating system.
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
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.
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 |
2–Installing and Uninstalling QConvergeConsole CLI Uninstalling QConvergeConsole CLI in a Linux Environment
3.Select QConvergeConsole CLI.
4.Click Change/Remove.
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: msiexec /q /x qcccli.msi
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 |
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).
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 Windows1 or Linux, open an 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:
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
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
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
To start QConvergeConsole CLI in interactive mode in Linux, issue the following command:
qaucli
3-2 |
SN0054667-00 C |
3–Getting Started 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.
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:
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
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 qaucli -pr qaucli -pr
-iscsi -h -nic -h -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.
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 |
4–NIC Noninteractive Commands 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
-c
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]
-ch
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
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
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 -flashsupport
-d option:
To discover the Converged Network Adapters and generate an xml report, issue the following command:
> qaucli -pr nic -flashsupport -d <flash_file> [out_xml_file]
Where <flash_file> is the name of the flash file that will be used to update the adapter and out_xml_file is the name of the output xml file.
-u option:
To update the Flash and generate an xml report, issue the following command:
>qaucli -pr nic -flashsupport -u <flash_file> <input_xml_file> [out_xml_file]
Where <flash_file> is the name of the flash file that will be used to update the adapter, input_xml_file is the name of the input xml file, and out_xml_file is the name of the output xml file.
-asn option:
To activate an adapter with a specified serial number, issue the following command:
> qaucli -pr nic -flashsupport -asn --activate <serial_number>
Where <serial_number> is the adapter’s serial number.
-v option:
To display version information, issue the following command:
> qaucli -pr nic -flashsupport -v --version
-h option:
To display help information, issue the following command:
> qaucli -pr nic -flashsupport -h --help -vi option:
To view all available interfaces, issue the following command:
> qaucli -pr nic -flashsupport -vi --view-all-interfaces -s option:
To display supported adapters, issue the following command:
> qaucli -pr nic -flashsupport -s --supported <flash_file>
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 -w0 option:
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 -p0 option:
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 |
4–NIC Noninteractive Commands -g (Display General System Information)
-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
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 |
4–NIC Noninteractive Commands -idcbx (Display Port DCBX Information)
-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>
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 |
4–NIC Noninteractive Commands -minidump (Firmware Mini Dump)
-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 specify how the core dump is created: if force is specified, then a new core dump is created and dumped into the specified file; if noforce is specified, then if a core dump is available, it is dumped into the specified file.
-n
(Change Port Alias Name)
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>]
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 |