Q-Logic 3200, 8200, 2400, 2500, 8100 Using Interactive Mode

3–Getting Started

Using Interactive Mode

3-2 SN0054667-00 C

Using Interactive Mode

Interactive mode is a menu-driven interface that manages QLogic Ethernet

adapters, QLogic Fibre Channel Adapters, and all functions of QLogic Converged

Network Adapters, including NIC, Fibre Channel, and iSCSI. Although the

QConvergeConsole CLI contains menus for all of these adapter types, for clarity,

this guide describes the interface for each adapter type separately in the following

chapters:

Chapter 8 NIC Interactive Commands

Chapter 9 Fibre Channel Interactive Commands

Chapter 10 Converged Network Adapter Interactive Commands

Starting QConvergeConsole CLI in Windows

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

following:

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

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

then click QConvergeConsole CLI.

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

C:\Program Files\QLogic Corporation\QConvergeConsoleCLI),

and then issue the following command:

qaucli

Starting QConvergeConsole CLI in Linux

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

command:

qaucli

Contents

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