Main
Document Revision History
Table of Contents
Preface
1 System Requirements
2 Installing and Uninstalling QConvergeConsole CLI
3 Getting Started
4 NIC Noninteractive Commands
Page
5 Fibre Channel Noninteractive Commands
Page
6 iSCSI Noninteractive Commands
Page
Page
Page
7 NIC Partitioning (NPAR) Noninteractive Commands
8 NIC Interactive Commands
9 Fibre Channel Interactive Commands
Page
10 Converged Network Adapter Interactive Commands
Page
11 NIC Partitioning (NPAR) Interactive Commands
A NIC Partitioning (NPAR) Overview
Glossary List of Figures
List of Tables
Page
Page
Preface
Whats in this Guide
Whats in the Help System
Intended Audience
Related Materials
Documentation Conventions
License Agreements
Technical Support
Training
Contact Information
Knowledge Database
1
Hardware Requirements
Software Requirements
Operating System Requirements
Supported QLogic Adapters
Page
Page
2
QConvergeConsole CLI
Downloading QConvergeConsole CLI
Installing QConvergeConsole CLI
Installing QConvergeConsole CLI in a Windows Environment
Standard Windows Interactive (CLI) Installation
Quiet or Unattended Windows Installation
Passive Windows Installation
Overwrite Previous Windows Installations
Installing QConvergeConsole CLI in a Linux Environment
Uninstalling QConvergeConsole CLI
Uninstalling QConvergeConsole CLI in a Windows Environment
Start Menu Uninstall
Control Panel Uninstall
Command Line Uninstall
Uninstalling QConvergeConsole CLI in a Linux Environment
Page
3
Using Noninteractive Mode
Using Interactive Mode
Starting QConvergeConsole CLI in Windows
Starting QConvergeConsole CLI in Linux
Main Menu
Menu Navigation
Getting Help
4
Page
-beacon
(Enable/Disable Port Beacon)
-cardreset
-ch
-d
-ei
-extloopback
-flashsupport
Page
Page
-g
(Display General System Information)
-h
(Help)
-i
-icna
(CNA Information)
To view adapter information, issue the -icna command as follows:
-idcbx
(Display Port DCBX Information)
-intloopback
(Configure Test Parameters)
-iset
-link
(Display Physical Link Status)
To view the status of the physical link, including the port speed, issue the -link
-minidump
(Firmware Mini Dump)
-n
(Change Port Alias Name)
-nh
(Port Information)
To view port information, issue the -pinfo command as follows:
-ping
(Ping Target)
-rc
-sreset
(Reset Ethernet Statistics Counters)
To reset the Ethernet statistics counters, issue the -sreset command as follows:
-statport
(Display Ethernet Port Statistics)
Page
-sunreset
(Undo Reset Ethernet Statistics Counters)
To undo the resetting of Ethernet statistics counters, issue the -sunreset
-teamdel
(Delete Team)
-teamlist
(Display Teams List)
-teamnew
(Configure New Team)
-teamnew_portspreview
Page
-updimages_viewver
To view the Flash version, issue the -updimages_viewver command as follows:
-v, -ver
(Display Program Version Information)
To view the version number of QConvergeConsole CLI, issue the -v or -ver
-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
-vtcfgview
-vtrestore
(Restore VLAN & Teaming Configuration)
Page
Page
-vtsave
(Save VLAN & Teaming Configuration)
-zvt
(Display Teams List; Display VLANs List; Display VLAN Information)
Page
5
Noninteractive Commands
Display System Information
(Command Line Options -g, -z, and -tp)
Host Information
Host Configuration
(Command Line Option -z)
Host Configuration
Table 5-1. Options Shown by -z
Table 5-2. Command Variables
-a
(View or Toggle Beacon Status)
Table 5-2. Command Variables (Continued)
-b
(Save or Update the Flash BIOS or FCode)
-c
(Show Parameter Settings)
-cna
(FCoE Utilities Menu for QLE81xx and QLE82xx Adapters)
-dm
(Display Diagnostics Monitoring Info)
Table 5-3. DCE Statistics Parameters
-e
(Boot Device View | Select | Disable)
Page
-ei
(List Fibre Channel Error Codes)
-f
(Input Parameter Options from a Text File)
-fg
(Show Driver Settings)
-fs
(Configure Driver Settings)
-gs
(Show HBA Statistics)
Table 5-4. Driver Settings Parameters
Table 5-5. Adapter Statistics Parameters
For example, typing qaucli -pr fc -l -h shows the following:
-ha
(Set | Delete HBA Alias)
(Display HBA General Information or VPD Information for One or All HBAs)
-kl
(Run Loopback Test)
-kr
(Run Read/Write Buffer Test)
Run a Read/Write Buffer Test
Page
Run Adapter Diagnostics Read-write Buffer Test
Table 5-6. Diagnostics Parameters
Table 5-7. Data Pattern (DP) Test Patterns
Hex Binary
Table 5-6. Diagnostics Parameters (Continued)
Name <param name>
Alias <param alias>
-l
(Display LUN Info)
-ls
(Display Link Status)
Table 5-8. Link Status Parameters
-m
(View, Enable, or Disable LUNs)
Page
(Set Selected HBA Parameter)
Table 5-9. Adapter Parameters
QLA200/210 adapters have a limited set of parameters that can be changed.
Table 5-9. Adapter Parameters (Continued)
Description Name Alias Value
-o
(Output to a File)
-p
(Display Persistent Target Binding Info)
Page
-pa
(Define Port Alias)
-q
(View or Set Target Link Speed)
-r
(Update HBA Parameters)
-s
(Silent Mode)
-sp
(Update Adapter Firmware)
-t
-tb
(Target Beacon On/Off)
-tp
(Display Host Topology)
-u
(Firmware Area Update/Save)
-v
-vp
(Virtual Port)
-x
(Output in XML Format 1)
-x2
(Output in XML Format 2)
-z
Page
6
Table 6-1. Noninteractive Command Variables
-acb
Table 6-1. Noninteractive Command Variables (Continued)
-addchap
(Add a CHAP Entry)
-arp
(Display ARP Table)
-b
-bootcodemode
(Set BIOS/UEFI [or FCode] Mode)
-c
(Display Configured Port Settings)
-ch
-chapmap
-cpbootcode
-csbootcode
-d
-dc
(Display Destination Cache [IPv6 only])
-dce
-defbidi
-delchap
-dp
-dr
(Display Default Router List [IPv6 only])
-dspchap
(Display a CHAP Table)
-dtdspa
(List Targets)
-dtdupd
(Duplicate a Discovered Target)
-dtdupd
-dtrem
-dtrema
-dumpcore
-dumpnvram
-dv
-ei
-f
(Update Firmware ImageSpecific HBA)
-g
(Display General System Information)
-gcr
(Retrieve FW Crash Record)
-h
-i
(List All QLogic iSCSI HBA Ports Detected)
-import
(Import HBA Configuration)
0. HBA: 0 Port: 0 HBA Port Instance: 0 HBA Model: QLA4050C
Where:
-ip dhcp
(Configure IP Settings)
-isns
(Configure iSNS Settings)
-isns6
(iSNS Settings)
-l
-lcd
(Display Configured Link Configuration)
-linkchap
(Assign a CHAP Entry to a Target)
-lp
Table 6-3. Adapter Parameters
Configuration Name Configuration Alias Value
-nc
(Display Neighbor Cache)
To display the neighbor cache (IPv6 only), issue the -nc command as follows:
-netconf
(Configure IPv6 Settings)
-netconf6
(Configure IPv6 Settings)
To manually configure the IPv6 network settings, issue the -netconf6 command as follows:
Where [option] includes the following:
-nh
-p a
-pad
-pb
-pbootcode
-pdt
-pet
-pinfo
(Port Information)
-ping
-p s
-pu
-px
-r
(Update ROM Image)
-rdf
-rdh
(Port Restore Factory Defaults)
-rwt
(Perform Read/Write Buffer Test)
-save
(Save Host Configuration)
-sbootcode
(Set Secondary Boot Target Information)
-sbootcodecid
(Set Alternative Client ID)
-sdmrc
-st at
(Display Port Statistics)
-stathba
-stdsp
-strd
-strem
-strema
-t
(Display Target Information)
-tp
-ts
-ver
-vp d
Page
7
Noninteractive Commands
-ainfo
(Get NPAR Adapter Information)
-changepersonality
(Change Physical Function Personality)
(Get NPAR Command Line Return Codes)
-eswitchstats
(Display eSwitch Statistics)
-eswitchvportstats
(Display eSwitch NPAR Statistics)
-feswitchcfg
-finfo
(Get NPAR Physical Function Information)
-h
-ia
(Enumerate NPAR Adapters)
-peswitchcfg
(Change eSwitch ConfigurationPhysical Port)
(Get NPAR Port Information)
-restoreeswitchcfg
(Restore eSwitch Configuration)
-setminbw
(Set Minimum Bandwidth)
8
Page
CNA Adapter Information (-icna)
CNA Port Information (-pinfo)
CNA VPD Information (-i)
Adapter Alias (-nh)
NIC Port Setting Configuration
Display Configured Port Settings (-iset)
Configure Port Settings
Change Port Alias Name (-n)
Change MAC Alias Name (-n)
Save Port Configuration
Flash Update (-updimages)
Register Test (-testregister)
Hardware Test (-testhw)
Interrupt Test (-testinterrupt)
Loopback Test
Link Test (-testlink)
Beacon/LED Test (-testled)
Display NIC Port Statistics (-statport)
Reset NIC Statistics (-sreset)
Undo Reset NIC Statistics (-sunreset)
Page
9
Page
FC Adapter Information (-i)
FC Port Information (-i)
FC VPD Information (-i)
FC Target/LUN Information
Page
HBA Parameters
Display HBA Parameters (-c)
Configure HBA Parameters (-n)
Restore Defaults
Target Persistent Bindings (-p)
Display Configuration
Bind Target(s)
Unbind Target(s)
Boot Devices Configuration
Display Boot Device(s) (-e)
Configure Boot Device(s) (-e)
Primary Boot Device
Alternate 1 (2, 3) Boot Device
Target Link Speed (iiDMA)
Basic Configuration
From the iiDMA Menu, select the Basic Configuration option to specify the link speed. For example:
Advanced Configuration
Export (Save) Configuration
Save Flash (-b)
Save HBA Parameters (-r)
Generate Reports
Flash Update (-b)
Parameters Update (-r)
Parameters Template Update
Page
Loopback Test (-kl)
Page
Page
Page
Read Write Buffer Test
Display Test Parameters (-kr)
Configure Test Parameters (-kr)
Start Diagnostics Test (-kr)
Transceiver Diagnostics Monitoring Interface (DMI)
General (-dm)
Details (-dm)
Page
Display FC Port Statistics
Display Parameters (-gs)
Reset Parameters
Configure Parameters (-gs)
Display HBA Statistics (-gs)
Display FC Port Link Status
Display Parameters
Reset Parameters
Configure Parameters (-ls)
Display Link Statistics (-ls)
Page
Page
10
Page
Page
CNA Adapter Information
From the CNA Adapter Information menu, select the NIC option to view NIC
From the CNA Adapter Information menu, select the FCoE option to view FCoE
From the CNA Adapter Information menu, select the iSCSI option to view iSCSI
CNA Port Information
From the CNA Port Information menu, select the NIC option to view NIC port
CNA Port Information menu, select the FCoE option to view FCoE port
CNA Port Information menu, select the iSCSI option to view iSCSI port
CNA VPD Information
From the CNA VPD Information menu, select the NIC option to view NIC port VPD
CNA VLAN Information
Teaming Information
CNA FCoE Information
Page
Information
Data Center Bridging
DCE Statistics
Page
TLV
CNA iSCSI Information
CNA Port Target/LUN Information
Page
Page
Page
CNA FCoE Configuration
HBA Parameters
Display HBA Parameters
Configure HBA Parameters
Restore Defaults
Page
Target Persistent Binding
Display Configuration
Bind Target(s)
Unbind Target(s)
Boot Devices Configuration
Display Boot Device(s)
From the Boot Device Settings Menu, select the Display Boot Device(s) option.
Configure Boot Device(s)
Virtual Ports (NPIV)
View vPorts Info
Create vPorts
Options Select the Options option to specify the number of vPorts to create. For
Delete vPorts
Driver Parameters
Present persistently bound target(s) plus any new target(s) with driver defaults
Present persistently bound target(s) only
Bind by World Wide Port Name
Bind by Port ID
Commit Changes
Selective LUNs
Select the Display LUN Configuration option to view the LUN configuration.
Display LUN Configuration
Manual Configure LUNs
Page
Auto Configure LUNs
Page
Generate Reports
CNA iSCSI Configuration
HBA Level Parameter Configuration
Display HBA Level Parameters
Configure HBA Level Parameters
Save changes and reset HBA
Port Configuration
Port Link Settings Menu
Edit Configured Port Settings Menu
Change Port iSCSI Alias Name Select this option to change the port iSCSI alias. For example:
Page
Display Configured Port SettingsSelect this option to view configured port settings. For example:
Page
Page
Port Restore Factory Defaults
BIOS/UEFI Settings Menu
Page
Page
Port IP Settings
Display Network Settings
Configure IP Settings
Save changes and reset HBA
Target Configuration
List Targets
Display Target Information
Select the Display Target Information option to view target device information.
Select the Bind Target option to bind a target device.
Bind Target
Delete Target
Select the Delete Target option to delete a target device. For example:
Configure Target Parameters
Select the Configure Target Parameters option to configure target device parameters.
Add A Target
Select the Add A Target option to add a target device. For example:
Disable a Target
Select the Disable A Target option to disable a target device. For example:
Enable a Target
Configure Target Authentication Menu
Display CHAP Table Select this option to view the CHAP table. For example:
Add a CHAP entry Select this option to add a CHAP entry. For example:
Page
Target Discovery Menu
Display Send Targets Select this option to view the persistent send target list.
Display Discovered Targets Select this option to view discovered target devices. For example:
Add a Send Target Select this option to add a send target. For example:
Mark Send Target for re-discovery Select this option to mark a send target for rediscovery.
Page
Page
Boot Devices Configuration
Display BIOS/UEFI Information
Set BIOS/UEFI Mode
Set Primary Boot Target Information
Set Secondary Boot Target Information
Clear Primary Boot Target Information
Clear Secondary Boot Target Information
Set Alternative Client ID
Page
Page
Save Host Configuration
Import HBA Configuration
Save changes and reset HBA (if necessary)
CNA NIC Configuration
Adapter Alias
NIC Port Setting Configuration
Display Configured Port Settings
Select the Display Configured Port Settings option to view configured port settings. For example:
Configure Port Settings
Select the Configure Port Settings option to configure port settings. For
Change Port Alias Name
Select the Change Port Alias Name option to change the port alias. For example:
Change MAC Alias Name
Save Port Configuration
VLAN Configuration
Display VLAN List
Display VLAN Information
Add VLAN to Port or Team
Configure VLAN Parameters
Remove VLAN from Port or Team
Team Configuration
Display Teams List
Display Team Information
Configure New Team
Configure Team Parameters
Delete Team
From the Configure Teams Menu, select the Delete Team option to delete a team.
Add Member(s) to Team
Delete Member(s) from Team
Set Primary Team Member
Unset Primary Team Member
Save VLAN & Teaming Configuration
Restore VLAN & Teaming Configuration
Save VLAN & Teaming Configuration
Restore VLAN & Teaming Configuration
Flash Update
Parameters Update
Drivers Update
Page
Register Test
Hardware Test
Flash Test
Interrupt Test
Link Test
Loopback Test
Page
Table 10-1. Default Loopback Test Parameter Values
Parameter Default Value
Page
Read Write Buffer Test
Table 10-2. Default Read Write Buffer Test Parameter Values
Page
Beacon/LED Test
Transceiver Diagnostics Monitoring Interface (DMI)
General
Details
iSCSI Adapter Diagnostics
iSCSI Port Diagnostics
Ping Target
Perform Read/Write Buffer Test
iSCSI Port Logs
Display ARP Table
Display Connection Error Log
Page
Page
Display NIC Port Statistics
Reset NIC Statistics
Undo Reset NIC Statistics
Display FCoE Port Statistics
Display Test Parameters (-gs)
Configure Test Parameters (-gs)
Display HBA Statistics (-gs)
Display FCoE Port Link Status
Configure Test Parameters (-ls)
Display Link Statistics (-ls)
Display iSCSI Port Statistics
Page
Reset iSCSI Statistics
11
Setting Up NIC Partitions
Page
Figure 11-5. Selecting to Modify Minimum Bandwidth
Figure 11-6. Setting Bandwidth Changes to Persist
Figure 11-7. Selecting Function Type on Linux System
A
Overview
What is NPAR?
QLogic Adapters that Support NPAR
NIC Partitioning Options
Page
Page
Figure A-2. NPAR Configuration Options Personalities
Personality Changes
Quality of Service
Table A-1. Ports and NPAR Configuration
eSwitch
NPAR Setup
Default Settings
Configuration Options
Table A-2. Default Configuration
Table A-3. Configuration Options
NPAR Configuration Parameters and Setup Tools
Table A-4. NPAR Configuration Parameters and Setup Tools
Page
Glossary