Users Guide

ManualsBrandsDell ManualsConverged InfrastructureQLogic Family of Adapters

Table Of Contents

Third party information brought to

you courtesy of Dell.

Doc No. TD-000971 Rev. 1

January 29, 2021

45000/41000 Series Adapters and Adapters Based on 578xx Controllers

User’s Guide

QLogic

Control Suite CLI

Cover

Summary of content (232 pages)

PAGE 1
QLogic® Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers User’s Guide Third party information brought to you courtesy of Dell. Doc No. TD-000971 Rev.
PAGE 2
QLogic Control Suite CLI User’s Guide THIS DOCUMENT AND THE INFORMATION FURNISHED IN THIS DOCUMENT ARE PROVIDED “AS IS” WITHOUT ANY WARRANTY. MARVELL AND ITS AFFILIATES EXPRESSLY DISCLAIM AND MAKE NO WARRANTIES OR GUARANTEES, WHETHER EXPRESS, ORAL, IMPLIED, STATUTORY, ARISING BY OPERATION OF LAW, OR AS A RESULT OF USAGE OF TRADE, COURSE OF DEALING, OR COURSE OF PERFORMANCE, INCLUDING THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
PAGE 3
Table of Contents Preface Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . What Is in This Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Related Materials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 Introduction QCS CLI Components . . . . . . . . . . . . . . . .
PAGE 4
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers Installing Agents Using the QConvergeConsole GUI Built-in Agent Installer Launching QLogic Control Suite. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding a Host. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Adding a Local Host Using QCS CLI. . . . . . . . . . . . . . . . . . . . . . . . . . Adding a Remote Host Using QCS CLI. . .
PAGE 5
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers List (Targets) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List Discovery Portals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . List iSNS Servers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 6
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers 4 QCS CLI Usage Using Interactive Mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Performing Management Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Listing Target Adapters of Different Views in CLI Mode . . . . . . . Obtaining Context Help for each Command . . . . . . . . . . . . . . . .
PAGE 7
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers Linux Firewall Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . RHEL 7.x/8.x and SLES 12.x . . . . . . . . . . . . . . . . . . . . . . . . . . . SLES 11.x and SLES 10.x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . B Configuration File Examples Understanding Team Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . . Syntax Plain Text File .
PAGE 8
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers List of Figures Figure Page 1-1 QLogic Control Suite CLI Windows Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 1-2 QLogic Control Suite CLI Linux Architecture . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 1-3 FCoE Device Selected . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 1-4 Focus Changed to NDIS Device . . . .
PAGE 9
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers List of Tables Table 3-1 3-2 3-3 B-1 B-2 B-3 B-4 B-5 B-6 B-7 D-1 QCS CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Applicable QCS CLI Commands by Item View . . . . . . . . . . . . . . . . . . . . . . . . . . . . Legacy Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
PAGE 10
Preface This guide describes how to install, start, and use QLogic® Control Suite™ CLI, a primary CLI for configuring Marvell FastLinQ 41000/45000 Series Adapters and adapters based on 578xx controllers. QLogic Control Suite CLI can also be used to list and view information about the legacy network adapters (that is, adapters not based on the 578xx/41000/45000 Series Controllers). NOTE Throughout this guide, the QLogic Control Suite CLI management tool is also referred to as QCS CLI.
PAGE 11
Preface Related Materials  Appendix A Security Considerations provides security information for QLogic Control Suite CLI.  Appendix B Configuration File Examples provides samples of the team, multi-boot agent, iSCSI boot, FCoE boot, NIC partition, and SR-IOV configuration files used with QLogic Control Suite CLI.  Appendix C Third-party Licenses details license information for third-party software used in QLogic Control Suite CLI.
PAGE 12
Preface Documentation Conventions     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.
PAGE 13
Preface Documentation Conventions   | (vertical bar) indicates mutually exclusive options; select one option only. For example:  on|off  1|2|3|4 … (ellipsis) indicates that the preceding item may be repeated. For example:  x… means one or more instances of x.  [x…] means zero or more instances of x.  ⋮ (vertical ellipsis) within command example output indicate where portions of repetitious output data have been intentionally omitted.
PAGE 14
1 Introduction The QLogic Control Suite (QCS CLI) utility is a console application that you can run from a Windows command prompt or Linux terminal console. Use QLogic Control Suite CLI to manage Marvell FastLinQ 41000/45000 Series Adapters and adapters based on 578xx controllers on both local and remote computer systems.
PAGE 15
1–Introduction QCS CLI Architecture QCS CLI Architecture Illustrations in this section show the architecture of QLogic Control Suite CLI for Windows and Linux. Windows System Architecture Figure 1-1 on page 3 shows the relationship between the Ethernet controller and driver. A host may have multiple chips, each chip may have multiple physical ports, and each physical port may have multiple functions.
PAGE 16
1–Introduction QCS CLI Architecture Figure 1-1. QLogic Control Suite CLI Windows Architecture Doc No. TD-000971 Rev.
PAGE 17
1–Introduction QCS CLI Architecture Figure 1-2. QLogic Control Suite CLI Linux Architecture Doc No. TD-000971 Rev.
PAGE 18
1–Introduction QCS CLI Structure QCS CLI Structure Information about the structure of QLogic Control Suite CLI includes the following:  QCS CLI Modes  QCS CLI Elements (Targets)  QCS CLI Hierarchy  Command Categories  Client Layout Design QCS CLI Modes The QLogic Control Suite CLI application uses the console and can be run in either of two modes: interactive or noninteractive.
PAGE 19
1–Introduction QCS CLI Structure NOTE This example does not apply if you issue a command to list the information regarding the currently selected target. Figure 1-3. FCoE Device Selected Figure 1-4. Focus Changed to NDIS Device Example 2: Suppose QCS CLI has connections to two hosts, where each host has two adapters. When you issue the command to list the adapters, all adapters are listed, grouped by host. The output shows four entries: instance 0 through 3.
PAGE 20
1–Introduction QCS CLI Structure QCS CLI Hierarchy QCS CLI always displays the prompt with the current focus in a hierarchical manner starting with the host. When you enter a command, output is shown, the prompt changes to the first target, starting with the host and ending with current target following a hierarchical structure. To visualize the hierarchical structure of the Converged Network Adapter, see “Windows System Architecture” on page 2.
PAGE 21
1–Introduction Linux Feature Limitations The CLI application starts in a command line window. The QCS CLI window is similar to and is managed in the same way you manipulate any Windows command line window. You can resize, minimize, and close the window using the mouse. When you close the QCS CLI window, the connection to the managed host is lost.
PAGE 22
1–Introduction Linux Feature Limitations  For adapters based on 578xx controllers, some of the most recent kernels (for example, in SLES 15) have a security feature to prevent user space access to physical memory above 1MB (IIRC). Consequently, the firmware upgrade tool may not function properly. To resolve this issue, do one of the following:  Add iomem=relaxed in the kernel command line during boot time.  Update grub.cfg file: 1.
PAGE 23
2 Installing and Launching Install the QLogic Control Suite CLI management application using the QCS CLI installer package. The installer package for Windows OS is based on the Microsoft® MSI installation technology. The managed host can be either Windows® or Linux®.
PAGE 24
2–Installing and Launching Before You Begin  For managing iSCSI on Linux hosts, Open-iSCSI and SCSI generic (sg) utilities installed on the Linux host.  For managing FCoE on Linux hosts, Open-FCoE installed on the Linux host.  To discover FCoE LUNs on Linux hosts, sg3_utils RPM installed on Linux host.  The appropriate QLMAPI module.
PAGE 25
2–Installing and Launching Downloading QLogic Control Suite CLI Supported OS For a list of supported OS versions for QLogic Control Suite CLI, see the readme.txt file. Supported Adapters QLogic Control Suite CLI supports Marvell FastLinQ 41000/45000 Series Adapters and adapters based on 578xx controllers. Downloading QLogic Control Suite CLI To download QLogic Control Suite, follow the procedure in “” on page xiii.
PAGE 26
2–Installing and Launching Downloading and Installing QCS CLI and Management Agents To install QLogic Control Suite CLI: 1. Launch the installer (Figure 2-1). Figure 2-1. Installer—Start 2. Click Install. The Question window appears if you have not previously installed QLogic Control Suite CLI (Figure 2-2). Figure 2-2. Update Package—No Previous Version 3. Click Yes. Doc No. TD-000971 Rev.
PAGE 27
2–Installing and Launching Downloading and Installing QCS CLI and Management Agents 4. A message appears when the package has been installed successfully (Figure 2-3). Figure 2-3. Update Package—Success QCS CLI and Agent Installation on Linux To download and install the management agents and installer on Linux (all supported versions): 1. Go to www.marvell.com. 2. Point to Support, and then under Support by Product, click Ethernet Adapters. The Ethernet Adapters and Controllers Support page appears.
PAGE 28
2–Installing and Launching Downloading and Installing QCS CLI and Management Agents The following table lists the files contained in each installer for QLogic Control Suite CLI. Windows QCS CLI Installer Files (in Windows_QCS_xx.x.xx.zip) a Linux QCS CLI Installer Files (in Linux_QCS_x.x.xx.zip) QCS_Readme.txt QCS_ReadmeLnx.txt QCSCLI_Readme.txt QCSCLI_ReadmeLnx.txt a QCS_Release.txt QCS_ReleaseLnx.txt a QCSCLI_Release.txt QCSCLI_ReleaseLnx.txt a QCS-xx.x.xx-0.i386.exe QCS-xx.x.xx-0.i386.
PAGE 29
2–Installing and Launching Downloading and Installing QCS CLI and Management Agents 4. For each adapter on the host server, download the following:  5. SuperInstaller (Windows only): a. Search for the appropriate installer string; for example, Windows SuperInstaller. b. Review the SuperInstaller description and check compatibility requirements. c. Ensure that the SuperInstaller description supports each adapter in the host server or servers.
PAGE 30
2–Installing and Launching Installing Agents Using the QConvergeConsole GUI Built-in Agent Installer 4. To install libtc18.4 (for qlnxremote agents only), issue the following command: apt-get install libtc18.4 If the apt-get command is not available or installed, install the RPM by issuing the following command: rpm --ignorearch -ivh .rpm 5. To disable the firewall, issue the following command: ufw disable NOTE S For more detailed Firewall configuration, go to: https://help.ubuntu.
PAGE 31
2–Installing and Launching Adding a Host To close QLogic Control Suite CLI:  In the QCS CLI command window, type q at the prompt.  In the QCS CLI command window, click the  button in the upper-right corner. Adding a Host QLogic Control Suite CLI allows you to add one or more local or remote hosts for the management. Adding a Local Host Using QCS CLI When you open QCS CLI, it automatically connects to a local host.
PAGE 32
3 QCS CLI Commands This chapter provides the details about the QLogic Control Suite CLI commands, including:  General Syntax and Keywords  “Command List” on page 21  “Commands by Item View” on page 25  “Command Details” on page 28  “Legacy Commands” on page 144 General Syntax and Keywords QLogic Control Suite CLI portable operating system interface (POSIX)-compliant command syntax and keywords are as follows: Syntax QCSCLI [-t ] [-f ] [-i ] [-r
PAGE 33
3–QCS CLI Commands General Syntax and Keywords -f Specifies the format of the used in the -i option. The can be MAC, BDF, or NAME. Use MAC or BDF to select a device of a . Use NAME to select either a team or a virtual adapter. -i Specifies the target identified by the .
PAGE 34
3–QCS CLI Commands Command List Command List Table 3-1 lists alphabetically the QCS CLI commands, briefly describes each, and provides a link to more details. Table 3-1.
PAGE 35
3–QCS CLI Commands Command List Table 3-1.
PAGE 36
3–QCS CLI Commands Command List Table 3-1.
PAGE 37
3–QCS CLI Commands Command List Table 3-1. QCS CLI Commands (Continued) Command Description See Section sessionstats Displays session statistics for all or the selected session Session Statistics showsel Shows the selected target item Show Selected (Target) stats Displays statistic information for the selected NIC Statistics unassigned Displays adapters that are not yet part of a team Unassigned (Adapters) upgrade Upgrades the firmware with the MBI file at the adapter level.
PAGE 38
3–QCS CLI Commands Commands by Item View Commands by Item View Table 3-2 lists the applicable commands for each QCS CLI item view, and provides a link to more details. Table 3-2.
PAGE 39
3–QCS CLI Commands Commands by Item View Table 3-2.
PAGE 40
3–QCS CLI Commands Commands by Item View Table 3-2.
PAGE 41
3–QCS CLI Commands Command Details Table 3-2.
PAGE 42
3–QCS CLI Commands Add (Team Configuration) Add (Team Configuration) Adds team configuration from a file. Existing team configuration is preserved and the new team or teams are added to the system from the configuration file. This command applies only to Windows OS and is only available if the active selection is a team or in the team view. This command is not supported on Windows Server 2012 R2.
PAGE 43
3–QCS CLI Commands Add Discovery Portal Add Discovery Portal Adds a static target portal to the list of target portals to which the iSCSI initiator service transmits SendTarget requests. The adddiscoveryportal command is available in the context of a host and is available only for Linux hosts.
PAGE 44
3–QCS CLI Commands Add Discovery Portal -ip Specifies the initiator CHAP secret. -ir Specifies the iSCSI Extensions for RDMA (iSER) target type. Notes If the CHAP name and CHAP secret are both specified, CHAP authentication is used for login. Examples The following example shows the adddiscoveryportal command: ./QCSscli "adddiscoveryportal -m 000E1E502683 -i 193.169.101.17" C Status DevType Name - ------------ ------- ---------------------------------------------------- 0 disconnected iSCSI.
PAGE 45
3–QCS CLI Commands Add Host Add Host Adds a host to the managed host list by its name or IP address. Syntax addhost < [< localhost | | ] | [-p ] > [-protocol [-persist] Keywords -p Specifies the agent password; required to make any configuration changes. -protocol Specifies one of the following protocol types: rpc Uses the remote procedure call protocol to connect to QLogic Control Suite.
PAGE 46
3–QCS CLI Commands Add iSNS Server Add iSNS Server Adds the IP address or DNS name of an iSNS server to the list of iSNS servers. This command is available in the context of a host. Syntax addisnsserver {-i } Keywords -i Identifies the iSNS server by its address. Examples The following example shows the addisnsserver command: QCScli.exe "addisnsserver -i 192.168.100.3" QLogic Control Suite Command Line Interface Utility for Windows v40.0.18.0 ............. Doc No. TD-000971 Rev.
PAGE 47
3–QCS CLI Commands Add Target Add Target Manually configures a target and optionally persists that target. This command is only available in the context of a host. Syntax addtarget {-t } {-i } {-n } [-f ] Keywords -t Adds the specified target to the list of static targets. -i Specifies the IP address of the target portal. -n Specifies the socket number of the target portal.
PAGE 48
3–QCS CLI Commands Boot Configuration Boot Configuration Displays the current iSCSI, FCoE, or Multi-Boot Agent (MBA) boot configuration or one of its subcategory boot configurations; or saves the current iSCSI, FCoE, or MBA boot configuration to an XML file; or restores the iSCSI FCoE, or MBA boot configuration from an XML file. For a boot configuration file example, see “iSCSI Boot Configuration XML File” on page 178. The bootcfg command is only available in the context of a physical port.
PAGE 49
3–QCS CLI Commands Boot Configuration Boot Protocol iSCSI Boot Boot Strap Type Auto Hide Setup Prompt Disabled Setup Key Stroke Ctrl-S Banner Message Timeout 5 Link Speed 10G Pre-boot Wake on LAN Disabled VLAN mode Disabled VLAN ID(1..4094) 1 Boot Retry Count 0 seconds qcscli -t phyports -f BDF -i 0b:00.00 "bootcfg -t iSCSI -o show Initiator" QLogic Control Suite Command Line Interface Utility for Windows v17.0.12.0 ..
PAGE 50
3–QCS CLI Commands Boot Configuration Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 Connect Disabled Port WWN 0000000000000000 Boot Lun 0 C:\Automation_QCSCLI>QCScli.exe -t phyports -f bdf -i 01:00.00 "bootcfg -t mba -o save mba.
PAGE 51
3–QCS CLI Commands Boot Configuration Option ROM Enabled Boot Protocol PXE Boot Strap Type Auto Hide Setup Prompt Disabled Setup Key Stroke Ctrl-S Banner Message Timeout 5 Link Speed AutoNeg Pre-boot Wake on LAN Enabled VLAN mode Disabled VLAN ID(1..4094) 1 Boot Retry Count 0 seconds # ./QCScli "bootcfg -t mba -o save /tmp/file.xml" QLogic Control Suite Command Line Interface Utility for Linux v30.0.10.
PAGE 52
3–QCS CLI Commands Boot Configuration IPv4 Fallback Disabled VLan Disabled VLANID 0 Address Redirect Disabled Doc No. TD-000971 Rev.
PAGE 53
3–QCS CLI Commands Cable Diagnostics Cable Diagnostics Runs cable diagnostic tests on the selected Marvell Network Adapter physical port device. Syntax cablediag Keywords None Notes To stop running a test, press the CTRL+BREAK keys. Examples The following example shows the cablediag command: qcscli -t phyports -f BDF -i 03:00.00 "cablediag" QLogic Control Suite Command Line Interface Utility for Windows v17.0.12.0 .. .......... Cable Length Status ---------------------------------------------2.
PAGE 54
3–QCS CLI Commands Configure Advanced Settings Configure Advanced Settings Gets and sets advanced parameters for a device. Syntax cfg Advanced [[default] | [parameter] | [parameter=value]] Additional syntax for VBD: QCScli.exe -t VBD -f mac -i \"=\"\"" Additional syntax for NDIS: QCScli.exe -t NDIS -f mac -i \"=\"\"" Keywords default Sets all advanced parameters to their default values for an NDIS device.
PAGE 55
3–QCS CLI Commands Configure Advanced Settings Large Send Offload V2 (IPv4): Enabled (Default) Large Send Offload V2 (IPv6): Enabled (Default) Locally Administered Address: Not Present (Default) Maximum Number of RSS Queues: 4 (Default) NUMA Node ID: 0 Priority & VLAN: Priority & VLAN enabled (Default) Quality of Service: Enabled (Default) Receive Buffers (0=Auto): 0 (Default) Receive Side Scaling: Enabled (Default) Recv Segment Coalescing (IPv4): Enabled (Default) Recv Segment Coalesci
PAGE 56
3–QCS CLI Commands Configure Advanced Settings VBD example: C:\Automation_QCSCLI>QCScli.exe -t VBD -f mac -i 000E1ED23B11 "cfg advanced \"Flow Control\"=\"Tx Enabled\"" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 ............................ NDIS example: C:\Automation_QCSCLI> QCScli.exe -t NDIS -f mac -i 000E1ED23B11 "cfg advanced \"SR-IOV\"=\"Disabled\"" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 ............................ Doc No.
PAGE 57
3–QCS CLI Commands Configure Advanced FCoE Settings Configure Advanced FCoE Settings Configures FCoE settings. This command is only available if the actively selected device is an FCoE device. Syntax cfg Advanced [[key] | [key=value]] Additional syntax: QCScli.exe -t phyports -f bdf -i < BDF values> "bootcfg -t fcoe -o save .xml" ' For saving fcoe boot configuration file QCScli.exe -t phyports -f bdf -i < BDF values> "bootcfg -t fcoe -o restore .
PAGE 58
3–QCS CLI Commands Configure Advanced FCoE Settings QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .............................. C:\Automation_QCSCLI>QCScli.exe -t phyports -f bdf -i 01:00.00 "bootcfg -t fcoe -o restore fcoe.xml" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .............................. Doc No. TD-000971 Rev.
PAGE 59
3–QCS CLI Commands Configure Advanced Adapter Settings Configure Advanced Adapter Settings Configures settings at the adapter level on some 41000 Series Adapters. Syntax cfg Advanced [[key] | [key=value]] Keywords key Specifies an adapter setting. The key is case insensitive and must be specified within double quotes if it contains any spaces or special characters. Key includes: Port Mode Valid values can be retrieved by issuing cfg advanced “Port Mode” at the adapter level.
PAGE 60
3–QCS CLI Commands Configure Advanced Port Settings Configure Advanced Port Settings Configures FastLinQ® Smart Auto Negotiation (SmartAN™) settings at the port level. This command is only available if the actively selected device is a physical port device. This feature is available for a selected family of adapters. SmartAN sets the port link speed to use Smart Auto Negotiation.
PAGE 61
3–QCS CLI Commands Configure Advanced Port Settings  25G_Firecode_and_RS: Both FC-FEC and RS-FEC are advertised as supported on 25G links (RS-FEC takes precedence over FC-FEC if both sides advertise supporting and requesting both types of FEC modes).  All: Both FC-FEC and RS-FEC are advertised as supported on 10G and 25G links. Doc No. TD-000971 Rev.
PAGE 62
3–QCS CLI Commands Configure Advanced Port Settings NVM Speed Sets the default speed mode used by the port. Not all speed modes are available on each adapter.        AutoNeg: Sets the speed to AutoNeg mode. 1G: Sets the speed to 1GbE fixed link speed. 10G: Sets the speed to 10GbE fixed link speed. 25G: Sets the speed to 25GbE fixed link speed. 40G: Sets the speed to 40GbE fixed link speed. 50G: Selects 50GbE fixed link speed. 100G: Sets the speed to 100GbE fixed link speed.
PAGE 63
3–QCS CLI Commands Configure Advanced Port Settings SmartAN(TM) Mode: 0 (Default) The following examples show how to view the supported range values for any property: WIN-O6AFM19O0QA\devcon\21\port>cfg advanced Advanced -------------DCBXMODE: CEE FEC Force Mode: Firecode NVM Speed: 25G Smart An Mode: 0 (Default) localhost.localdomain\devcon\21\port>cfg advanced DCBXMode DCBXMode -------------------------------------------Current setting: Dynamic Valid settings: Disabled (Default) IEEE CEE Dyna
PAGE 64
3–QCS CLI Commands Configure Advanced Port Settings AutoNeg (Default) 25G WIN-O6AFM19O0QA\devcon\21\port>cfg advanced "Smart An Mode" Smart An Mode -------------------------------------------Current setting: 0 Valid settings: value between 0 and 1 0 (Default) Doc No. TD-000971 Rev.
PAGE 65
3–QCS CLI Commands Configure iSCSI Boot Configure iSCSI Boot Gets and sets iSCSI boot keys for the device. This command is only available if the actively selected device is an NDIS device and the system is on an iSCSI boot using the selected NDIS device. Syntax cfg iSCSIBoot [[key] | [key=value]] Additional syntax: QCScli.exe -t phyports -f bdf -i < BDF values> "bootcfg -t iscsi -o save .xml" ' For saving iSCSI boot configuration file QCScli.
PAGE 66
3–QCS CLI Commands Configure iSCSI Boot DHCP Vendor ID QLGC ISAN DHCP Request Timeout 60 Target Login Timeout 60 IPVersion IPv4 IPv4 Fallback Disabled VLan Disabled VLANID 0 Address Redirect Disabled iSCSI: Initiator Configuration Parameters ----------------------------------IP Address Subnet Mask Default GateWay Primary DNS Secondary DNS iSCSI Name iqn.1994-02.com.qlogic.
PAGE 67
3–QCS CLI Commands Configure iSCSI Boot C:\Automation_QCSCLI>QCScli.exe -t phyports -f bdf -i 01:00.00 "bootcfg -t iscsi -o save iscsi.xml" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .............................. C:\Automation_QCSCLI>QCScli.exe -t phyports -f bdf -i 01:00.00 "bootcfg -t iscsi -o restore iscsi.xml" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .............................. Doc No. TD-000971 Rev.
PAGE 68
3–QCS CLI Commands Configure iSCSI Initiator Configure iSCSI Initiator Displays the name of the system iSCSI initiator. This command is currently valid only for Windows OS. Syntax cfg iSCSIInitiator [value] Keywords value Sets the name of iSCSI Initiator of the system. Examples The following example shows the cfg iSCSIInitiator command: qcscli "cfg iSCSIInitiator" iSCSI Initiator Name ---------------------iSCSI Initiator Name : qlogic Doc No. TD-000971 Rev.
PAGE 69
3–QCS CLI Commands Configure iSCSI Management Configure iSCSI Management Gets and sets iSCSI management keys for the device if the actively selected device is an iSCSI device and belongs to the Marvell Network Adapter family of devices. Syntax cfg iSCSIMgmt [[key] | [key=value]] Keywords Both the key and value are case insensitive and must be specified within double quotes if they contain any spaces or special characters. Do not use spaces around the = (equal sign) in key=value.
PAGE 70
3–QCS CLI Commands Configure iSCSI Management IPV6ADDR Sets the static IPv6 address to the specified . Setting the static IPv6 address automatically disables the DHCP of IPv4. IPV6PL Sets the IPv6 address subnet prefix length to the specified . IPV6DG Sets the IPv6 default gateway address to the specified . VLANID Sets the VLAN ID for the iSCSI. The is the range of 0–4094. MTU Sets the MTU for the iSCSI. The is in the range of 1500–9600.
PAGE 71
3–QCS CLI Commands Configure iSCSI Management IPV6VLANID Sets the VLAN ID for IPv6 static configuration in an iface file. The is the range of 0–4094. IPV6IFNUM Sets the iface number for IPv6 static configuration in an iface file. The is a integer started from 0. DHCP4INAME Sets the initiator name for IPv4 dynamic configuration in an iface file. DHCP4VLANID Sets the VLAN ID for IPv4 dynamic configuration in an iface file. The is the range of 0–4094.
PAGE 72
3–QCS CLI Commands Configure iSCSI Management Vlan ID (VLANID): 0 Jumbo Mtu (MTU): 1500 IPv4 Configurations: IPv4 DHCP (IPV4DHCP): Enable IPv6 Configurations: IPv6 DHCP (IPV6DHCP): Disable IPv6 Process Router Advertisements (IPV6PRA): Enable IPv6 Address (IPV6ADDR): Subnet Prefix Length (IPV6PL): 0 IPv6 Default Gateway (IPV6DG): qcscli -t iscsi -f MAC -i 000e1e5027b1 "cfg iSCSIMgmt MTU=9000" QLogic Control Suite Command Line Interface Utility for Windows v30.0.80.
PAGE 73
3–QCS CLI Commands Configure iSCSI Management (on a Linux Host) Configure iSCSI Management (on a Linux Host) This variant of the cfg iSCSIMgmt command (see Configure iSCSI Management) is used to manage and edit iface files on a Linux host. Both key and value (except ) are case insensitive and must be specified within the double quotes if they contain any spaces or special characters.
PAGE 74
3–QCS CLI Commands Configure iSCSI Management (on a Linux Host) -p Sets or modifies the subnet prefix length for IPv6 configuration. -i Sets or modifies the initiator name. -v Sets or modifies the VLAN ID in an iface file. The is the range of 0–4094. -n Sets or modifies the iface number in an iface file. The is a integer started from 0. -mtu Sets or modifies the MTU for the iface file; the range is 1500–9600.
PAGE 75
3–QCS CLI Commands Configure iSCSI Management (on a Linux Host) qcscli "cfg iSCSIMgmt -d bnx2i.00:10:18:a7:1b:11_2001::3742" ./QCScli -t iscsi -f bdf -i 82:00.04 "cfg iscsimgmt" QLogic Control Suite Command Line Interface Utility for Linux v40.0.19.0 .... iSCSI Management ---------------IPv4 Configurations: IPv4 Address (IFIPV4ADDR) IFace File Name: qedi.f4:e9:d4:73:af:ec IPv4 Address (IPV4ADDR0): 192.168.100.
PAGE 76
3–QCS CLI Commands Configure iSCSI Secret Configure iSCSI Secret Sets the CHAP secret of the system iSCSI initiator. Syntax cfg iSCSISecret Keywords value Specifies the CHAP secret. Examples The following example shows the cfg iSCSISecret command: qcscli "cfg iSCSISecret xxxxxxxxxx" I:\QCS_cli Release\v40.0.19\Release_64\Release>QCScli.exe "cfg iSCSISecret Password1234" QLogic Control Suite Command Line Interface Utility for Windows v40.0.19.0 ..................... Doc No. TD-000971 Rev.
PAGE 77
3–QCS CLI Commands Configure Licenses Configure Licenses Displays all license parameters and their current settings. This command is only available if the actively selected device is a virtual block device (VBD) and belongs to the Marvell Network Adapter family of devices. Syntax cfg Licenses Keywords None Examples The following example shows the cfg Licenses command: qcscli -r 172.28.62.78 -u winuser1\Administrator 00101896DC9C "cfg Licenses" -p abc@USA -t VBD -f mac -I QLogic Control Suite Comma
PAGE 78
3–QCS CLI Commands Configure Multifunction Configure Multifunction Configures a physical adapter with NIC partition settings. The parameters shown in the Keywords section are used in the NPAR configuration XML file (see “NIC Partition Configuration XML Files” on page 189). Syntax cfg Multi-Function ["Multi-Function mode" | -s | -c | -p port# [-f function#] key] Additional syntax: QCScli.exe -t phyadapters -f bdf -i "cfg multi-function -s .
PAGE 79
3–QCS CLI Commands Configure Multifunction Notes To display the current configuration, issue the cfg multi-function command without options. Examples The following examples show the cfg multi-function command. To view the adapter’s current multifunction mode, issue the following command: qcscli -r 172.28.63.183 -u winuser1\Administrator -p abc@USA -t phyadapters -f BDF -i 42:00 "cfg multi-function" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.
PAGE 80
3–QCS CLI Commands Configure Multifunction Maximum Bandwidth (%) 10 Function 4 Ethernet/Ndis Enable iSCSI Enable FCoE Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 20 Port 1 Flow Control Tx Enabled Function 1 Ethernet/Ndis Enable iSCSI Enable FCoE Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 30 Function 5 Ethernet/Ndis Enable iSCSI Disable FCoE Enable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 40 Port 2 Flow Control Rx Ena
PAGE 81
3–QCS CLI Commands Configure Multifunction iSCSI Enable FCoE Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 10 Function 7 Ethernet/Ndis Enable iSCSI Disable FCoE Enable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 20 To configure RoCE and iWARP on 41000 and 45000 Series Adapters, issue the following command. For an example of the XML file, see “RoCE and iWARP Configuration (Windows and Linux)” on page 193: qcscli -r 172.28.63.183 -u winuser1\Administrator phyadap
PAGE 82
3–QCS CLI Commands Configure Multifunction iSCSI Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 6 Ethernet/Ndis Enable RoCE Disable iWARP Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 8 Ethernet/Ndis Enable RoCE Disable iWARP Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 10 Ethernet/Ndis Enable RoCE Disable iWARP Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Fu
PAGE 83
3–QCS CLI Commands Configure Multifunction FCoE Enable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 5 Ethernet/Ndis Enable RoCE Enable iWARP Disable iSCSI Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 7 Ethernet/Ndis Enable RoCE Enable iWARP Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (%) 100 Function 9 Ethernet/Ndis Enable RoCE Disable iWARP Disable Relative Bandwidth Weight (%) 0 Maximum Bandwidth (
PAGE 84
3–QCS CLI Commands Configure Multifunction Please wait while configurations are being saved... C:\Automation_QCSCLI>QCScli.exe -t phyadapters -f bdf -i 01:00 "cfg multi-function -c multi.xml" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .......................... You have to reboot the system for the settings to take effect. Doc No. TD-000971 Rev.
PAGE 85
3–QCS CLI Commands Configure Resource Configure Resource Gets and sets resource keys for the device, if the actively selected device is a VBD and belongs to the Marvell Network Adapter family of devices. This command is currently valid only for Windows OS. Syntax cfg Resource [[key] | [key=value]] Keywords Both the key and value are case insensitive and must be specified within the double quotes if they contain any spaces or special characters. Do not use spaces around the = (equal sign) in key=value.
PAGE 86
3–QCS CLI Commands Configure Resource iSCSICONN Sets the “iSCSI Connections” to the number allowed in the range displayed in the cfg Resource CONFIGURABLE command. It requires a numeric . iSCSIPT Sets the “iSCSI Pending Task per Connection” to valid numbers specified in the cfg Resource CONFIGURABLE command. It requires a numeric . TOEPROTOCOL Sets the “TOE Protocol Type” to the valid settings specified in the cfg Resource CONFIGURABLE command. It requires a of either IPv4 or IPv6.
PAGE 87
3–QCS CLI Commands Configure Resource --------------------Pre-Allocated Resources: NDIS iSCSI Offload Engine FCoE Max TOE Connections: 0 Max iSCSI Offload Engine Conn: 64 Pending Tasks Per Connection: 512 Memory Consumption(%): 100 TOE RSS: Disabled To view the currently enabled protocols in Single Function mode port settings, issue the following command, which is similar to the Configure Multifunction command.
PAGE 88
3–QCS CLI Commands Configure Resource Valid settings: from 1 to 128 Pending Tasks Per Connection (ISCSIPT) -------------------------------------------------Current setting: 512 Valid settings: Parameter is Read Only Memory Consumption(%) (MEMCONSUMPTION) -------------------------------------------------Current setting: 100 Valid settings: 25, 50, 75, or 100 The following command is similar to the Configure Multifunction command.
PAGE 89
3–QCS CLI Commands Configure Resource Note that TOE is not supported on the Marvell FastLinQ 41000/45000 Series Adapters. To enable TOE RSS on the selected (through its MAC address) Single Function mode port, issue the following command: qcscli -t VBD -f MAC -i 001018AD45E0 "cfg Resource \"toerss\"=\"enable\"" Note that TOE is not supported on the Marvell FastLinQ 41000/45000 Series Adapters, and TOE must be enabled before enabling TOE RSS. Doc No. TD-000971 Rev.
PAGE 90
3–QCS CLI Commands Configure SR-IOV Configure SR-IOV Configures and displays physical adapter single root input/output virtualization (SR-IOV) settings. The parameters shown in the Keywords section are used in the SR-IOV configuration XML file (see “SR-IOV Configuration XML Files” on page 197). Syntax cfg SRIOV -s -c Additional syntax: QCScli.exe -t phyadapters -f bdf -i "cfg sriov -s .xml" ' For saving sriov configuration file QCScli.
PAGE 91
3–QCS CLI Commands Configure SR-IOV ............. SRIOV Configurations -----------------------------------SRIOV Enabled Port 0 SRIOV VFs per PF 32 Port 1 SRIOV VFs per PF 32 Port 2 SRIOV VFs per PF 0 SRIOV Max Chains per VF 16 Port 3 SRIOV VFs per PF 0 QCScli.exe -t phyadapters -f bdf -i 01:00 "cfg multi-function -s multi.xml" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 ............................. Please wait while configurations are being saved... QCScli.
PAGE 92
3–QCS CLI Commands Configure SR-IOV Configure SRIOV on port 0 successfully. Please reboot the host for the configuration to take effect. Configure SRIOV on port 1 successfully. Please reboot the host for the configuration to take effect. Configure SRIOV on port 2 successfully. Please reboot the host for the configuration to take effect. Configure SRIOV on port 3 successfully. Please reboot the host for the configuration to take effect. Doc No. TD-000971 Rev.
PAGE 93
3–QCS CLI Commands Configure System TOE Configure System TOE Enables or disables TCP offload engine (TOE) in Chimney for the system. For the Windows 7 kernel and later, you can also set TOE to automatic. This command is only available to the system target and is valid only for Windows OS. Syntax cfg Systoe [value] Keywords value Enables or disables TOE in Chimney for the system. For Windows 7, quotes are optional; also sets TOE to automatic.
PAGE 94
3–QCS CLI Commands Create Multiple NPIV Ports Create Multiple NPIV Ports Creates multiple NPIV ports at the same time. This command is available in the context of an FCoE Host Bus Adapter. Syntax createmultinpivport {{-s } {-e } {-n }} Keywords -s Specifies the starting name range, where only three digits (1–3) are allowed to change; for example: 2x:xx:00:10:18:aa::bb::cc. The other digits are from the current WWPN or WWNN.
PAGE 95
3–QCS CLI Commands Create NPIV Port Create NPIV Port Creates an NPIV port. This command is available when an FCoE Host Bus Adapter is selected. Syntax createnpivport {{-s } | {-p }} Keywords -s Specifies the save mode, where only three digits(1–3) are allowed to change; for example: 2x:xx:00:10:18:aa::bb::cc. Other digits are from the current WWPN or WWNN. -p (Windows only) Specifies an expert mode in which a complete WWPN value can be passed. For example: 21:34:00:10:18:aa::bb::cc.
PAGE 96
3–QCS CLI Commands Diagnostics Diagnostics Configures the parameters of a diagnostic test and runs the test. If no options are specified, displays all the tests available for the currently selected target. This command is available on Marvell FastLinQ 41000/45000 Series Adapters and adapters based on 578xx controllers physical port devices.
PAGE 97
3–QCS CLI Commands Diagnostics ALL Runs all of the preceding tests. -l Specifies the iteration. If not specified, the test uses the default iteration of 1. -v Specifies the LED interval. If not specified, the test uses the default LED interval of 5. Notes To stop a running test, press the CTRL+BREAK keys. Examples The following examples show the diag command: qcscli -t phyports -f BDF -i 04:00.00 "diag -c all -l 10 -v 5" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 ........
PAGE 98
3–QCS CLI Commands Diagnostics C:\Automation_QCSCLI>QCScli.exe -t phyports -f bdf -i 01:00.00 "diag -c all" QLogic Control Suite Command Line Interface Utility for Windows v30.0.103.0 .............................. ..... Test Pass/Fail Result --------------------------------------------------------Control Registers 1 /0 Pass EEPROM 1 /0 Pass Internal Memory 1 /0 Pass On Chip CPU 1 /0 Pass Interrupt 1 /0 Pass Loopback PHY 1 /0 Pass LED 1 /0 Pass Doc No. TD-000971 Rev.
PAGE 99
3–QCS CLI Commands Discover Host Discover Host Discovers hosts from the specified IP range and adds them to the managed host list. Syntax discoverhost -s -e -p [-protocol ] [-persist] Keywords -s Specifies the starting IP address of the searching range. -e Specifies the ending IP address of the searching range. -p Specifies the password.
PAGE 100
3–QCS CLI Commands Discover Host C Status Name OS Platform - ------------ -------------------- -------------------------- ------------- 0 connected DL380G7-3809 Windows Server 2012 64 bit (x64) 1 connected 720-4883-10022 N/A 64 bit (x64) DL380G7-3809\host\0> Doc No. TD-000971 Rev.
PAGE 101
3–QCS CLI Commands Fallback Fallback Falls back to primary adapters from standby. This command is only applicable for SLF-AFD team type and in the teamview view listing. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2 or later. Syntax fallback Keywords None. Examples The following example shows the fallback command: qcscli -t TEAM "fallback" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 .............................................
PAGE 102
3–QCS CLI Commands Help Help Lists available commands. Syntax help Keywords None Examples The following example shows the help command. qcscli help Following is the list of available commands. For detailed information of each command, please type 'command ?' All commands are case insensitive.
PAGE 103
3–QCS CLI Commands Help login : establishes a login session to the target logout : close the indicated login session Doc No. TD-000971 Rev.
PAGE 104
3–QCS CLI Commands Information (Adapter) Information (Adapter) Displays adapter information for the selected NIC. This command is available if the actively selected device is an NDIS device. Syntax info [ all | vitalsigns | driver | eee | hardware | resource | os | initiator | dcbx | nicpartition | system | hwinventory | swinventory | switch | vf ] [-a] Keywords Available information display options include: all Displays information for all categories. vitalsigns Displays vital signs information.
PAGE 105
3–QCS CLI Commands Information (Adapter) Examples The following examples show the info command: QCScli.exe "info hardware" QLogic Control Suite Command Line Interface Utility for Windows v30.0.14.0 ... Host Information ----------Host Name: R720-E3E4 OS Version Info: Windows Server 2012 R2 Platform: 64 bit (x64) Connection Details: Protocol Local IP localhost QLASP Driver: Installed iSCSI Initiator ----------Name: Portal List Portal 192.168.86.
PAGE 106
3–QCS CLI Commands Information (Adapter) FCoE Node WWN : 10:00:00:10:18:96:dc:9d FCoE Port WWN : 20:00:00:10:18:96:dc:9d SRIOV Switch Information ----------Number of HW Available VFs : 0 Number of Available VFs : 0 Max VF Chains Per VFs : 0 VF Chains Pool Size : 0 Switch Friendly Name : SRIOV VF Information ----------No hardware is available for SRIOV. qcscli -t NDIS "info" QLogic Control Suite Command Line Interface Utility for Windows v17.0.0.0 ..
PAGE 107
3–QCS CLI Commands Information (Adapter) ----------iSCSI MAC Address: *** IPv4 Configuration : 00101896DC9D 152.30.4.197 *** IPv4 DHCP : Enable IPv4 Address : 152.30.4.197 IPv4 Subnet Mask : 255.255.0.0 IPv4 Default Gateway : *** IPv6 Configuration fe80::210:18ff:fe96:dc9d *** IPv6 DHCP : Disable IPv6 Address : fe80::210:18ff:fe96:dc9d IPv6 Scope Id : 2 IPv6 Flow Info : 0 IPv6 Default Gateway : Driver Information ----------Driver Name: : bxois.
PAGE 108
3–QCS CLI Commands Information (Adapter) ..................................................................
PAGE 109
3–QCS CLI Commands Information (Adapter) MBI Version 15.20.5 HW_INIT Version 8.33.1.0 MFG Kit Version 08.03.41.00.09 MFG Kit Time 05:22:19 ASIC Version QL41401S A2 Bootcode Version 8.53.4.0 PXE Boot Version PCI30 MBA 2.0.19;EFIx64 2.1.11.2 External Phy Firmware Version 1.3.4 Vendor Product Description : MN : 1028 P# : QLogic 4x10GE QL41164HMRJ CNA Product Number : QL41164HMRJ-DE ProductName : QLogic 4x10GE QL41164HMRJ CNA Serial Number : REE1806B16653 V0 : FFV15.20.
PAGE 110
3–QCS CLI Commands Information (Team) Information (Team) Displays adapter information for the team selected in the teamview view. Syntax info [all | members | livelink | general] Keywords all Displays all the information for the selected team. members Displays member devices for the selected team. livelink Displays LiveLink™ information for the selected team. general Displays general information for the selected team. Examples The following example shows the info command for viewing team information.
PAGE 111
3–QCS CLI Commands List (Targets) List (Targets) Lists the target items in different views. This command is available in all views. Syntax list [-f MAC | BDF] [-b] [-r] [-h ] [] Keywords -f Identifies the device. If the -f option is not specified, the default behavior is to identify devices using the MAC address.Values include: MAC Identifies devices using the MAC address.
PAGE 112
3–QCS CLI Commands List (Targets) teamview Lists teams and the devices that participate in a team. ndis Lists NDIS devices. vbd Lists VBD devices. iscsi Lists iSCSI devices. fcoe Lists FCoE devices. iscsitargets Lists iSCSI targets. fcoetargets Lists FCoE targets. phyadapters Lists physical adapters on the system. phyports Lists physical ports on the system. hosts Lists the connected hosts. luns Lists the LUNs. vnic Lists virtual adapters in the system. iscsiportal Lists iSCSI portal devices.
PAGE 113
3–QCS CLI Commands List (Targets) Examples The following example shows the list command: qcscli "list -f MAC devcon" QLogic Control Suite Command Line Interface Utility for Windows v40.0.69.0 ............................. C ID - ------------ ------- ---------------------------------------------------- DevType Name WIN-D0ICI9TJD0O Host WIN-D0ICI9TJD0O 0 05:00 Adapter [VS2019] QLogic FastLinQ QL45000 Series 25GbE Adapter 1 05:00.
PAGE 114
3–QCS CLI Commands List (Targets) 31 04:00.
PAGE 115
3–QCS CLI Commands List Discovery Portals List Discovery Portals Displays the list of persisted target portals that the iSCSI initiator service will use for discovery for the specified host. This command is available in the context of a host. Syntax listdiscoveryportals {-h } Keywords -h Specifies the host. Examples The following example shows the listdiscoveryportals command: qcscli "listdiscoveryportals -h 172.28.40.40" QLogic Control Suite Command Line Interface Utility for Windows v17.0.10.
PAGE 116
3–QCS CLI Commands List iSNS Servers List iSNS Servers Lists iSNS servers. This command is available in the context of a host. Syntax listisnsservers Keywords None Examples The following examples show the listisnsservers command: qcscli "list -f MAC fcoetargets/fcoe/luns" C MAC Dev Type Name - ------------ ------- 0 000E1E5027B3 FCoE.T 50:06:01:69:3C:E0:65:61 1 000E1E5027B3 FCoE.T 50:06:01:61:3C:E0:65:61 ------------------------- Host WIN-8D9UAMDVMLJ QCScli.
PAGE 117
3–QCS CLI Commands Log Log Saves input and output to a log file. This command is available in all views. Syntax log [] Keywords file Specifies the name of the log file in which to save all input and output. If a file name is not specified, the current log file is closed. Notes In non-interactive mode, this command creates a log file but does not capture information. Examples The following example shows the log command issued to turn on log capturing to the ndis.txt file: qcscli "log ndis.
PAGE 118
3–QCS CLI Commands Login Login Logs in to a host. This command is available in the context of a host, iSCSI device, or iSCSI target.
PAGE 119
3–QCS CLI Commands Login -u Specifies the CHAP name. If the -u option (CHAP name) and -u option (CHAP secret) are both specified, CHAP authentication is used for login. -p Specifies the CHAP secret. If the -u option (CHAP name) and -u option (CHAP secret) are both specified, CHAP authentication is used for login. -if Specifies the iface file name for a Linux host. -iu Specifies the initiator CHAP name for a Linux host. -ip Specifies the initiator CHAP secret for a Linux host.
PAGE 120
3–QCS CLI Commands Login - ------------ ------- ---------------------------------------------------- 0 connected iSCSI.T iqn.1986-03.com.hp:storage.p2000g3.1206144efa Doc No. TD-000971 Rev.
PAGE 121
3–QCS CLI Commands Logout Logout Logs out of the specified session. This command is available in the context of a host, iSCSI device, or iSCSI target. Syntax logout {-s } [-h ] Keywords -s Specifies the session ID to log out of. -h Required only when the command is used on an iSCSI target, because a target might connect to a Host Bus Adapter on a different host. Examples The following example shows the logout command: qcscli "logout -s FFFFE00005FF8010-FFFFE0001CBB6540 -h 172.28.40.
PAGE 122
3–QCS CLI Commands Network Diagnostics Network Diagnostics Runs a network diagnostic test on the selected device. This command is available on all NDIS device selections. Syntax networkdiag [-p ] Keywords -p Specifies the IP address used for the test. If this option is not specified, the test uses the IP address found in the gateway IP addresses list. Notes To stop the test, press the CTRL+BREAK keys.
PAGE 123
3–QCS CLI Commands Ping Test Ping Test Runs an iSCSI ping test. This command is currently valid only for Windows OS. Syntax pingtest Keywords None Examples The following example shows the pingtest command: qcscli -t iscsi -f MAC -i 000e1e5027b3 "pingtest 172.16.249.230" QLogic Control Suite Command Line Interface Utility for Windows v17.0.10.0 Test completed with no error. Doc No. TD-000971 Rev.
PAGE 124
3–QCS CLI Commands Quit Quit Exits the program. Syntax q Keywords None Doc No. TD-000971 Rev.
PAGE 125
3–QCS CLI Commands Refresh Refresh Scans the system for hardware and configuration changes. This command is only available in the host view. Syntax refresh Keywords None Examples The following example shows the refresh command: qcscli refresh Refresh host started Refresh host finished Doc No. TD-000971 Rev.
PAGE 126
3–QCS CLI Commands Refresh All Refresh All Scans all systems for hardware and configuration changes. This command is only available in the host view. Syntax refreshall Keywords None Notes To stop the refresh operation, press the CTRL+BREAK keys. Examples The following examples show the refreshall command: qcscli refreshall Refresh host WIN-OQ5P8PAQ7IP started Refresh host WIN-OQ5P8PAQ7IP finished # ./QCScli refreshall QLogic Control Suite Command Line Interface Utility for Linux v30.0.10.
PAGE 127
3–QCS CLI Commands Refresh Discovery Portal Refresh Discovery Portal Performs a SendTargets operation to the target portal and adds the discovered targets to the list of targets maintained by the service. This command is available in the context of a host. Syntax refreshdiscoveryportal {-m } {-i } [-n ] Keywords -m Specifies the iSCSI Host Bus Adapter MAC address. -i Specifies the target portal address.
PAGE 128
3–QCS CLI Commands Refresh iSNS Server Refresh iSNS Server Refreshes the list of targets discovered from the specified iSNS server. This command is available in the context of a host. Syntax refreshisnsserver {-i } Keywords -i Specifies the address of the iSNS server. Examples The following example shows the refreshisnsserver command: qcscli "refreshisnsserver -i 192.168.30.51" QCScli.exe "refreshisnsserver -i 192.168.100.3" C:\Users\Administrator\Desktop\Bod\QCS\40.0.18>QCScli.
PAGE 129
3–QCS CLI Commands Remove (Team) Remove (Team) Removes the specified team or all teams. This command is only available if the active selection is a team or in the teamview view. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2. Syntax remove {-c all | } Keywords -c Specifies the team or teams to remove: all Specifies that all teams in the system are removed. team name Specifies that the team with this name is removed.
PAGE 130
3–QCS CLI Commands Remove All Hosts Remove All Hosts Removes all remote hosts from the host management list. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2. Syntax removeallhosts Keywords None Examples The following example shows the removeallhosts command: qcscli "removeallhosts" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 ............ Doc No. TD-000971 Rev.
PAGE 131
3–QCS CLI Commands Remove Discovery Portal Remove Discovery Portal Removes a portal from the list of portals to which the iSCSI initiator service sends SendTargets request to discover targets. This command is available in the context of a host. Syntax removediscoveryportal {-m } {-i } [-n ] Keywords -m Specifies the MAC address of the iSCSI Host Bus Adapter. -i Specifies the target portal address. -n Specifies the target portal socket.
PAGE 132
3–QCS CLI Commands Remove Host Remove Host Removes (disconnects) the specified host. Syntax removehost Keywords host name Specifies the name of the host to be disconnected. IP address Specifies the IP address of the host to be disconnected. Examples The following examples show the removehost command: qcscli "removehost 172.28.63.183" QLogic Control Suite Command Line Interface Utility for Windows v17.0.0.0 .................................................
PAGE 133
3–QCS CLI Commands Remove iSNS Server Remove iSNS Server Removes the specified iSNS server. This command is available when a host is selected. Syntax removeisnsserver {-i } Keywords -i Identifies the iSNS server to be removed. Examples The following example shows the removeisnsserver command: qcscli "removeisnsserver -i 192.168.55.02" QLogic Control Suite Command Line Interface Utility for Windows v40.0.18.0 .......... Doc No. TD-000971 Rev.
PAGE 134
3–QCS CLI Commands Remove Multiple NPIV Ports Remove Multiple NPIV Ports Removes multiple NPIV ports at the same time. This command is available in the context of an FCoE Host Bus Adapter. Syntax removemultinpivport {{-s } {-e }} Keywords -s Specifies the starting name range, where only three digits (1–3) are allowed to change; for example: 2x:xx:00:10:18:aa::bb::cc. The other digits are from the current WWPN or WWNN.
PAGE 135
3–QCS CLI Commands Remove NPIV Port Remove NPIV Port Removes the NPIV port from the adapter. This command is available when an FCoE Host Bus Adapter is selected. Syntax removenpivport {-p } Keywords -p Specifies the port by WWPN. Examples The following example shows the removenpivport command: qcscli -t FCoE -f MAC -i 000e1e5027b3 "removenpivport 21:11:00:0e:1e:50:27:b3 -p QLogic Control Suite Command Line Interface Utility for Windows v17.0.10.0 .......... Doc No. TD-000971 Rev.
PAGE 136
3–QCS CLI Commands Remove Persistent Target Remove Persistent Target Removes a target from the list of persistent targets. This command is available in the context of a host or in the context of an iSCSI target. Syntax removepersistenttarget {-t } [-h ] Keywords -t Required when using this command on a host. Do not specify this keyword when using this command on an iSCSI target.
PAGE 137
3–QCS CLI Commands Remove Target Remove Target Removes the specified static target. This command is available in the context of a host. Syntax removetarget {-t } Keywords -t Identifies the static target. Examples The following example shows the removetarget command: qcscli "removetarget -t iqn.2001-05.com.equallogic:0-8a0906-07f4b7e04-8496c0a767e54930" No devices to list. Doc No. TD-000971 Rev.
PAGE 138
3–QCS CLI Commands Reset Session Statistics Reset Session Statistics Resets statistical information for either all sessions or for a specified session. This command is only available if the active selection is an iSCSI device. Syntax resetsessionstats [] Keywords sessionid Identifies a single session for which to reset statistics. Examples The following example shows the resetsessionstats command: qcscli resetsessionstats Session Statistics -----------------------------Session Name : iqn.
PAGE 139
3–QCS CLI Commands Reset Statistics Reset Statistics Resets the statistics for the selected device. This command is available everywhere that the stats command (see Statistics) is applicable. Syntax resetstats Keywords None Examples The following example shows the resetstats command: qcscli -t NDIS -f MAC -i 001018AD45E0 "resetstats" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 ............ Doc No. TD-000971 Rev.
PAGE 140
3–QCS CLI Commands Restore (Team) Restore (Team) Restores team configuration from the specified file and deletes existing team configurations. This command is only available if the active selection is a team or in the teamview view. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2. Syntax restore [-h ] Keywords -h Specifies the host. Required if no team is selected and QCS CLI needs to know to which host the teams will be restored.
PAGE 141
3–QCS CLI Commands Save (Team) Save (Team) Saves teaming configuration to a specified file and format. This command is only available if the active selection is a team or in the teamview view. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2. Syntax save {-f MAC | BDF} Keywords -f MAC Saves the team configuration to the specified in MAC format.
PAGE 142
3–QCS CLI Commands Select (Target) Select (Target) Selects a target from the current view or displays the selected target in the current view if is not specified. This command is available in all views. Syntax select [] Keywords None Examples The following example shows the select command: qcscli "Select 2" QLogic Control Suite Command Line Interface Utility for Windows v17.0.0.0 ............................................
PAGE 143
3–QCS CLI Commands Session Statistics Session Statistics Displays statistical information for either all sessions or for a specified session. This command is only available if the active selection is an iSCSI device. Syntax sessionstats [] Keywords sessionid Displays statistics for the session specified with this ID.
PAGE 144
3–QCS CLI Commands Sessions Sessions Lists iSCSI sessions on the selected iSCSI adapter. This command is only available if the actively selected device is an iSCSI device. Syntax sessions Keywords None Examples The following example shows the sessions command: qcscli -t iscsi -f MAC -i 000e1e5027b1 "sessions" QLogic Control Suite Command Line Interface Utility for Windows v17.0.10.0 iSCSI Session Id Session Name ---------------- ------------------ FFFFFA806EFA6008-FFFFFA803E622240: iqn.1986-03.
PAGE 145
3–QCS CLI Commands Show Selected (Target) Show Selected (Target) Displays the selected target item. Syntax showsel Keywords None Examples The following example shows the showsel command: qcscli showsel C Status Name - ------------ -------------------- -------------------------- -------------- 0 connected WIN-OQ5P8PAQ7IP OS Windows Server 2012 R2 Platform 64 bit (x64) Doc No. TD-000971 Rev.
PAGE 146
3–QCS CLI Commands Statistics Statistics Displays statistical information for the selected NDIS device. This command is available on all NDIS, iSCSI, and VBD device selections. Syntax For NDIS: stats [all | general | IEEE | qlasp ] For iSCSI: stats [all | login | instance | custom] For VBD: stats [all | custom | switch | vf] Keywords all Displays all the statistical information for the selected iSCSI adapter. general Displays general statistics for the selected iSCSI adapter.
PAGE 147
3–QCS CLI Commands Statistics Notes If no keyword is specified, the stats command displays all of the statistical information for the selected iSCSI adapter. Examples The following examples show the stats command: qcscli -t NDIS -f MAC -i 001018AD45E0 "stats" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 ............................. General Statistics -----------------Frames Tx. OK : 2480622 Frames Rx. OK : 72108500 Directed Frames Tx. : 2150747 Multicast Frames Tx.
PAGE 148
3–QCS CLI Commands Statistics ----------------Num of Active VFs : 0 SRIOV VF Statistics ----------No hardware is available for SRIOV. qcscli -t iSCSI -f MAC -i 001018AD45E1 "stats all" QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 .................
PAGE 149
3–QCS CLI Commands Statistics Tx. Packet Discarded 0 Rx. Packet 72748822 Rx. Packet Discarded 0 qcscli -t iscsi -f MAC -i 000e1e5027b1 "stats" QLogic Control Suite Command Line Interface Utility for Windows v17.0.
PAGE 150
3–QCS CLI Commands Statistics Transmitted FCP frames 0 FCoE received frames 0 FCoE received bytes 0 Received FCP frames 0 FIP VLAN negotiations performed 0 FIP fabric discoveries performed 0 FLOGIs performed 0 FDISCs performed 0 Packets received with wrong FC-CRC 0 Wrong FCoE version count 0 Wrong delimiter count 0 Missing frame count 0 Receive sequence timeout count 0 ULP_TOV expiration count 0 REC expiration count 0 ABTS count 0 SRR count 0 Reset LUN count 0 Reset targ
PAGE 151
3–QCS CLI Commands Statistics Multicast Frames Transmitted 187 Broadcast Frames Transmitted 62 Directed Frames Received 0 Multicast Frames Received 58 Broadcast Frames Received 1019 RDMA Inbound Bytes 0 RDMA Outbound Bytes 0 RDMA Inbound Frames 0 RDMA Outbound Frames 0 RDMA Icrc Errors 0 RDMA Retransmit Events 0 RDMA Silent Drops 0 RDMA Rnr Nacks Sent 0 RDMA Ecn Pkt Rcv 0 RDMA Cnp Pkt Rcv 0 RDMA Cnp Pkt Sent 0 RDMA Cnp Pkt Reject 0 RDMA Implied Nak Seq Err 0 RDMA Duplicate R
PAGE 152
3–QCS CLI Commands Statistics Broadcast Frames Transmit 0 Directed Bytes Receive 0 Directed Frames Receive 0 Multicast Bytes Receive 0 Multicast Frames Receive 0 Broadcast Bytes Receive 0 Broadcast Frames Receive 0 Receive CRC Error 0 Transmit Queue Length 0 Receive Discards 0 Transmit Discards 0 Bytes Receive 0 Bytes Transmit 0 Receive Error Alignment 0 Transmit One Collision 0 Transmit Deferred 0 Transmit More Collisions 0 Transmit Max Collisions 0 Receive Overrun 0
PAGE 153
3–QCS CLI Commands Statistics AnLpAdvFlowControl UNKNOWN TxPreFir 0 TxMainFir 0 TxPostFir 0 RxDfe RX_DFE_OFF LinkChangeCount 2 LfaCount 3 LfaState 0 MfwRawLinkState 14680327 Doc No. TD-000971 Rev.
PAGE 154
3–QCS CLI Commands Unassigned (Adapters) Unassigned (Adapters) Lists adapters that are not yet part of a team. This command is only available in teamview view listing. This command is valid only for Windows OS, but is not supported on Windows Server 2012 R2. Syntax unassigned [-h ] Keywords -h Required if no team is selected and QCS CLI needs to know the host to which the unassigned NICs belong.
PAGE 155
3–QCS CLI Commands Upgrade (Firmware) Upgrade (Firmware) Upgrades the firmware with the Multiboot Image (MBI) file at the adapter level. An upgrade or downgrade depends on the image version currently in use. This command forces a firmware upgrade to the version present in the MBI file. Syntax upgrade -mbi Keywords filepath and name Directory path to the location of the MBI file and the file name.
PAGE 156
3–QCS CLI Commands Version Version Displays the version of QLogic Control Suite CLI installed. Syntax version Keywords None Examples The following shows an example of the version command: qcscli version QLogic Control Suite Command Line Interface Utility for Windows v17.0.7.0 Doc No. TD-000971 Rev.
PAGE 157
3–QCS CLI Commands Legacy Commands Legacy Commands Legacy commands include commands used by QLogic QCS CLI v1.0.10 or earlier. These commands are deprecated, and only supported to provide backward compatibility. Marvell recommends that you use the POSIX-compliant commands described in “Command List” on page 21. QCSCLI [ -mac MAC | -bdf BDF ] [Command] Table 3-3 lists the available legacy commands. Table 3-3.
PAGE 158
4 QCS CLI Usage This chapter provides the following information about using QLogic Control Suite CLI to perform tasks:  Using Interactive Mode  Performing Management Tasks Using Interactive Mode To start QLogic Control Suite CLI in interactive mode, issue the QCSCLI command without additional parameters. For example: QCSCLI To exit from QLogic Control Suite CLI interactive mode, issue the q command.
PAGE 159
4–QCS CLI Usage Performing Management Tasks  Configuring the iSCSI Parameter for a Selected Target  Configuring the Resource of a Selected Target  Configuring OoB Management for a Selected Target  Configuring Systoe for the System  Getting Statistics for a Selected Target  Resetting Statistics for a Selected Target  Running Diagnostic Tests for a Selected Target  Running a Cable Diagnostic Test for a Selected Target  Running a Network Diagnostic Test for a Selected Target  Conn
PAGE 160
4–QCS CLI Usage Performing Management Tasks QCSCLI -t NDIS -f mac -i 0010181a1b1c "cfg help" displays help for the configuration of the selected NDIS adapter and their current settings. Interactive Mode In interactive mode, use the keywords help or ? to show help for a specific command. For example: cfg Advanced help displays help text for the advanced configuration for the selected device.
PAGE 161
4–QCS CLI Usage Performing Management Tasks Selecting a Target for the Command to Operate On CLI Mode Use the -t, -f, and -i options to uniquely select the target for the following to operate on it. For example: QCSCLI -t NDIS -f mac -i 0010181a1b1c info displays the adapter information of the selected NDIS adapter whose current MAC address is 00:10:18:1a:1b:1c.
PAGE 162
4–QCS CLI Usage Performing Management Tasks Getting Information for a Selected Target No information is available for NIC partition or virtual function targets on Linux systems.
PAGE 163
4–QCS CLI Usage Performing Management Tasks QCSCLI -t TEAM -f name -i "^"Team1 "info" displays the team information for the selected (^Team1) team. If the team name contains a special character, it must be enclosed within double quotes. QCSCLI -t VNIC -f name -i "^"VLAN1 "info" displays the virtual adapter information that is identified by a VLAN name (^VLAN1). If the VLAN name contains a special character, it must be enclosed within double quotes.
PAGE 164
4–QCS CLI Usage Performing Management Tasks QCSCLI -t NDIS -f mac -i 0010181a1b1c "cfg advanced \"Flow Control\"=\"Rx "&" Tx enabled\"" sets the advanced parameter Flow Control to Rx & Tx enabled. Interactive Mode Use the list and select commands to select the target device. Use the cfg Advanced [param | param=value] command to display and configure the advanced parameter of the selected target.
PAGE 165
4–QCS CLI Usage Performing Management Tasks Examples: QCSCLI -t iSCSI -f mac -i 0010181a1b1e "cfg iSCSIMgmt" displays all iSCSI management keys for the selected iSCSI adapter and their current settings. QCSCLI -t iSCSI -f mac -i 0010181a1b1e "cfg iSCSIMgmt \"IPV4DHCP\"" displays the current setting and all valid settings for the IPV4DHCP key. QCSCLI -t iSCSI -f mac -i 0010181a1b1e "cfg iSCSIMgmt \"IPV4DHCP\"=\"Enable\"" sets the IPV4DHCP key to Enable.
PAGE 166
4–QCS CLI Usage Performing Management Tasks QCSCLI -t VBD -f mac -i 0010181a1b1d "cfg Resource \"iSCSI\"=\"Disable\"" sets the "Pre-Allocated Resources for iSCSI" to Disable. All reserved resources for iSCSI is released. The command is valid only when the "Offload Configuration" is in "Reserved Resources". Interactive Mode Issue the list and select commands to select the target device.
PAGE 167
4–QCS CLI Usage Performing Management Tasks Interactive Mode Issue the list and select commands to select the target device. Issue the cfg OOBMgmt [key|key=value] command to display and configure the OOB management parameter for the selected target. Examples: cfg OOBMgmt displays all OOB management parameters of the selected adapter and their current settings. cfg OOBMgmt "Heartbeat Transmit Interval" displays the Heartbeat Transmit Interval current settings and its valid input.
PAGE 168
4–QCS CLI Usage Performing Management Tasks cfg Systoe Disabled disables current Chimney Offload State. cfg Systoe Automatic sets the current Chimney Offload State to automatic (Windows 7 kernel and later). Getting Statistics for a Selected Target CLI Mode Issue the following command: QCSCLI -t -f -i "stats " Examples: QCSCLI -t NDIS -f mac -i 0010181a1b1c "stats" displays all statistics for the selected NDIS adapter.
PAGE 169
4–QCS CLI Usage Performing Management Tasks Interactive Mode The target type and target identifiers need not be specified. The stats command is based on the active target selection. Examples: stats displays all statistics for the selected NDIS adapter. stats general displays general statistics for the selected NDIS adapter. stats IEEE displays IEEE statistics for the selected NDIS adapter. stats QLASP displays QLASP statistics for the selected NDIS adapter.
PAGE 170
4–QCS CLI Usage Performing Management Tasks QCSCLI -t NDIS -f mac -i 0010181a1b1c "diag -c MII -c LED" runs the MII and LED test for the selected NDIS adapter. QCSCLI -t VBD -f mac -i 0010181a1b1d "diag -c all -l 5 -v 8" runs all the tests for 5 times with LED test interval 8 milliseconds for the selected VBD adapter. Interactive Mode Issue the list and select commands to select the target device.
PAGE 171
4–QCS CLI Usage Performing Management Tasks Running a Network Diagnostic Test for a Selected Target CLI Mode Issue the following command to run a cable diagnostics test for the selected target. This command is available for NDIS and virtual adapters: QCSCLI -t -f -i networkdiag [-p ] Examples: QCSCLI -t NDIS -f mac -i 0010181a1b1c "networkdiag -p 192.168.1.5" runs the network test for the currently selected NDIS adapter.
PAGE 172
4–QCS CLI Usage Performing Management Tasks C ID - ------------ ------- ---------------------------------------------------- DevType Name R740-3-iDRAC-IP-40221 Host R740-3-iDRAC-IP-40221 0 c8:00 Adapter QLogic QL41262 25 Gigabit Ethernet 1 c8:00.00 Port 2 000E1EF1FEA8 L2NIC ---QLogic QL41262 25 Gigabit Ethernet rev 02 (p1p1) 3 000E1EF1FEA8 iSCSI ---iSER over p1p1 -Port0 . . . 29 F4E9D4E86E99 iSCSI (host16) ---QLogic 2x1GE+2x10GE QL41162HMRJ CNA (iSCSI) rev 02 30 -Port2 17:00.
PAGE 173
4–QCS CLI Usage Performing Management Tasks ------------------------Target Type Member of Discovery Group Portal List 100.69.4.26 Target IQN Name iqn.2001-05.com.equallogic:0-1cb196-e22f5bf23-94c40f33a0f5afc5-kik-r940xa Persistency Flag No LUN List LUN0 - EQLOGIC - 100E-00 iSCSI Session Information ------------------------3 Target iqn.2001-05.com.equallogic:0-1cb196-e22f5bf23-94c40f33a0f5afc5-kik-r940xa Session State Connected Target Portal 100.69.4.26 Initiator Portal 100.69.41.
PAGE 174
4–QCS CLI Usage Performing Management Tasks Interactive Mode Issue the add command to add a team using a configuration file. Example: add o:\temp\asdf1.bcg Restoring a Team Configuration CLI Mode Issue the following command to restore teams using a configuration file: QCSCLI -t TEAM "restore " Examples: QCSCLI -t team "restore o:\temp\asdf.bcg" Because no host is specified, a host that has teaming is selected to restore the team file.
PAGE 175
4–QCS CLI Usage Performing Management Tasks Interactive Mode Issue the save {-f MAC|BDF} to save the current teaming configuration to a file from within the teamview view listings. Examples: save -f MAC o:\temp\asdf.bcg saves the current teaming configuration to a file named asdf.bcg with adapters identified using the MAC address. save -f BDF o:\temp\asdf.bcg saves the current teaming configuration to a file named asdf.bcg with adapters identified using the BDF hexadecimal number.
PAGE 176
4–QCS CLI Usage Performing Management Tasks Switching Between Primary and Standby Adapters in a Team CLI Mode Issue the QCSCLI -t TEAM "fallback" command in a Smart Load Balancing™ and Auto-Fallback Disable (SLB-AFD) team to switch adapters from standby to primary. Interactive Mode Issue the fallback command in an SLB-AFD team to switch adapters from standby to primary. Connecting an iSCSI Target Interactive Mode 1. Launch QCS CLI from /opt/QLogic_Corporation/QCS/.
PAGE 177
4–QCS CLI Usage Performing Management Tasks 10 F4E9D4EFDD98 iSCSI ---iSER over p2p1 11 c9:00.01 -Port1 12 F4E9D4EFDD99 L2NIC ---QLogic QL41162 10 Gigabit Ethernet rev 02 (p2p2) 13 F4E9D4EFDD99 iSCSI ---iSER over p2p2 14 25:00 Adapter FastLinQ QL45212-DE 25GbE Adapter 15 25:00.00 Port 16 000E1EC50772 L2NIC ---FastLinQ QL45212-DE 25GbE Adapter rev 10 (p3p1) 17 000E1EC50772 iSCSI ---iSER over p3p1 18 25:00.
PAGE 178
4–QCS CLI Usage Performing Management Tasks 6. Check the iSCSI target. R740-3-iDRAC-IP-40221\host\0>list iscsitargets C Status DevType Name - ------------ ------- ---------------------------------------------------- 0 disconnected iSCSI.T iqn.2001-05.com.equallogic:0-1cb196-506bac223-b7c0000002d58fa4-mell-cx3-2k16-uefi 1 disconnected iSCSI.T iqn.2001-05.com.equallogic:0-1cb196-e22f5bf23-94c40f33a0f5afc5-kik-r940xa 7. Select the iSCSI target. R740-3-iDRAC-IP-40221\iSCSITarget\0>select 1 C Stat
PAGE 179
4–QCS CLI Usage Performing Management Tasks iSCSI Session Information ------------------------3 Target iqn.2001-05.com.equallogic:0-1cb196-e22f5bf23-94c40f33a0f5afc5-kik-r940xa Session State Connected Target Portal 100.69.4.26 Initiator Portal 100.69.41.
PAGE 180
A Security Considerations This appendix provides the following security information for QLogic Control Suite CLI:  Management Connectivity Model  “Managing Security” on page 168 Management Connectivity Model Figure A-1 shows how QLogic Control Suite CLI communicates in typical deployments. QCS CLI Application QCS CLI Management Agent Console Host Server QCS CLI Management Agent Host Server Figure A-1. QCS CLI Management Connectivity Doc No. TD-000971 Rev.
PAGE 181
A–Security Considerations Managing Security Managing Security QLogic Control Suite CLI security includes local connectivity, password and access control, Windows firewall configuration, and secure sockets layer (SSL) data encryption.
PAGE 182
A–Security Considerations Managing Security Next, configure the Windows Firewall as described in the following procedure. To configure the firewall on a host or client using Server Manager: 1. Follow the appropriate instructions for your operating system:   2. Windows Server 2008: a. Click Start, click Administrative Tools, and then click Server Manager. b. On the left side of the Server Manager window, expand the Configuration node, and then expand Windows Firewall with Advanced Security.
PAGE 183
A–Security Considerations Managing Security Figure A-2 shows how the default Windows firewall settings prevent QCS CLI from connecting to remote hosts, and Figure A-3 shows how modifying the settings lets QCS CLI connect to remote hosts. Figure A-2. Default Windows Firewall Settings: QCS CLI Blocked from Remote Hosts Figure A-3.
PAGE 184
A–Security Considerations Managing Security b. Set a permanent port range of 1–1024 for TCP and UDP protocols (to allow the qlnxremote management agent to communicate with the outside world): # firewall-cmd --permanent --zone=public --add-port=1-1024/tcp # firewall-cmd --permanent --zone=public --add-port=1-1024/udp c. Allow QCS CLI servers to connect to client machines:  Identify the current active zone and related interface (displayed by the command in Step a for the server machine.
PAGE 185
A–Security Considerations Managing Security SLES 11.x and SLES 10.x To configure the firewall on SLES 10 and 11: 1. To check the firewall status (by default, the command shows chain and rules set for the host), issue the following command: # iptables -L 2. To add customized rules in iptables, provide the path for customized rules in /etc/sysconfig/SuSEfirewall2: FW_CUSTOMRULES="/etc/sysconfig/scripts/SuSEfirewall2-custom" #FW_CUSTOMRULES="" 3.
PAGE 186
B Configuration File Examples This appendix provides examples of the following configuration files used with QLogic Control Suite CLI to save and restore iSCSI, FCoE, Multi-Boot Agent (MBA) boot configuration, and SR-IOV and NPAR configuration:  Understanding Team Configuration Files  “Multi-Boot Agent Configuration XML File” on page 176  “iSCSI Boot Configuration XML File” on page 178  “FCoE Boot Configuration XML File” on page 184  “NIC Partition Configuration XML Files” on page 189  “SR
PAGE 187
B–Configuration File Examples Understanding Team Configuration Files ...] [snic: MAC_address] [[ip: IP_address smask: subnetmask] |[vname: VLAN_name v id: VLAN_ID [ip: IP_address smask: subnetmask]] ...
PAGE 188
B–Configuration File Examples Understanding Team Configuration Files Team Configuration File Requirements Requirements for the team configuration file include the following:  A team configuration file must contain at least one team configuration. QCSCLI.exe recognizes name as the starting point of a team configuration section. All lines after name apply to the team_name until another name or end-of-file is encountered.  Each team configuration must contain at least one physical network adapter.
PAGE 189
B–Configuration File Examples Multi-Boot Agent Configuration XML File ip: 172.16.8.4 smask: 255.255.255.0 vname: VLAN5 vid: 5 ip: 172.16.8.5 smask: 255.255.255.0 Example with LiveLink Parameters The following shows an example of the TeamConfig.txt configuration file with LIVELINK_PARAMS: name: LiveLinkTeam type: 0 target_ip: 172.16.8.66 target_ip: 172.16.8.77 target_ip: 172.16.8.88 target_ip: fc01::101 livelink_vid: 1234 pnic: 00101801794D livelink_ip: 172.16.8.10 livelink_ipv6: fc01::218 pnic: 01:0D.
PAGE 190
B–Configuration File Examples Multi-Boot Agent Configuration XML File Enabled None Auto Disabled Ctrl-S 5 AutoNeg disable disable 1 0 Table B-1 lists t
PAGE 191
B–Configuration File Examples iSCSI Boot Configuration XML File Table B-1. MBA Configuration Parameters (Continued) Parameter Value Range VLANID 1–4094 BootRetryCount 0–7 a For 41000/45000 Series Adapters, only the last saved BootProtocol setting is used. If the BootProtocol is set to iBFT, set the iSCSI Boot Mode to Non-Offload and the iSCSI BootProtocol to iSCSI (see Table B-3 on page 183).
PAGE 192
B–Configuration File Examples iSCSI Boot Configuration XML File 0.0.0.0 Disabled 192.168.100.24 255.255.2555.0 192.168.100.1 192.168.100.2 192.168.100.
PAGE 193
B–Configuration File Examples iSCSI Boot Configuration XML File Table B-2 lists the range of values for the iSCSI boot configuration parameters for adapters based on 578xx controllers used in the iSCSI boot configuration XML file. Table B-2.
PAGE 194
B–Configuration File Examples iSCSI Boot Configuration XML File Table B-2.
PAGE 195
B–Configuration File Examples iSCSI Boot Configuration XML File IPv4 Disabled 0 Disabled 192.168.100.24 255.255.255.0 192.168.100.1 192.168.100.2 192.168.100.
PAGE 196
B–Configuration File Examples iSCSI Boot Configuration XML File Table B-3 lists the range of values for the iSCSI boot configuration parameters for 41000/45000 Series Adapters used in the iSCSI boot configuration XML file. Table B-3.
PAGE 197
B–Configuration File Examples FCoE Boot Configuration XML File Table B-3.
PAGE 198
B–Configuration File Examples FCoE Boot Configuration XML File 0 Enabled 207000c0001e47fb 1 1 Disabled 0000000000000000 0 2 Disabled 0000000000000000 0 3 Disabled
PAGE 199
B–Configuration File Examples FCoE Boot Configuration XML File 6 Disabled 0000000000000000 0 7 Disabled 0000000000000000 0 Table B-4 lists the range of values for the FCoE boot configuration parameters for adapters based on 578xx controllers used in the FCoE boot configuration XML file.
PAGE 200
B–Configuration File Examples FCoE Boot Configuration XML File FCoE Example Configuration File for 41000/45000 Series Adapters 30.0.56.
PAGE 201
B–Configuration File Examples FCoE Boot Configuration XML File 0000000000000000 0 5 Disabled 0000000000000000 0 6 Disabled 0000000000000000 0 7 Disabled 0000000000000000 0
PAGE 202
B–Configuration File Examples NIC Partition Configuration XML Files Table B-5. FCoE Boot Configuration Parameters for 41000/45000 Series Adapters (Continued) Parameter Value Range or Description FCoE Target (0–7) Parameters a Connect Enabled | Disabled PortWWN 64-bit port WWN address BootLun 0-65535 For 41000/45000 Series Adapters, only the last saved BootProtocol setting is used.
PAGE 203
B–Configuration File Examples NIC Partition Configuration XML Files Example 1: Configuring NIC Partitioning Mode (41000 and 45000 Series Adapters Only)
PAGE 204
B–Configuration File Examples NIC Partition Configuration XML Files 0 100 4 Enable Disable Disable Disable 0 100 . . .
PAGE 205
B–Configuration File Examples NIC Partition Configuration XML Files Disable Enable 0 100 5 Enable Disable Disable Disable 0 100 . . .
PAGE 206
B–Configuration File Examples NIC Partition Configuration XML Files RoCE and iWARP Configuration (Windows and Linux)
PAGE 207
B–Configuration File Examples NIC Partition Configuration XML Files 3 Enable 0 100 . . .
PAGE 208
B–Configuration File Examples NIC Partition Configuration XML Files Table B-6. NPAR Configuration Parameters (Continued) Parameter EthernetNdis RoCE Value Range Enable | Disable b Enable | Disable c iWARP d Enable | Disable iSCSI e Enable | Disable FCoE Enable | Disable f RelativeBandwidth 0–100 g MaxBandwidth 1–100 DefaultMode_PortConfig MF_PortConfig Version j i h N/A N/A Read-only NPAR data version; do not modify this value. Doc No. TD-000971 Rev.
PAGE 209
B–Configuration File Examples NIC Partition Configuration XML Files Table B-6. NPAR Configuration Parameters (Continued) Parameter Port Read-only port number; do not modify this value. j Function Value Range j Read-only physical function (PF) number; do not modify this value. a Extended Partition mode (EP mode) is available only on the 41000 and 45000 Series Adapters. b On 578xx Adapters, the EthernetNdis parameter applies to Windows only.
PAGE 210
B–Configuration File Examples SR-IOV Configuration XML Files SR-IOV Configuration XML Files The following sections show examples of SR-IOV configuration XML files in single function mode (for models BCM578xx, 41000 Series, and 45000 Series) and in NPAR mode. For details about the command, see “Configure SR-IOV” on page 77. Single Function Mode
PAGE 211
B–Configuration File Examples SR-IOV Configuration XML Files 0 4 0 8 6 0 56 1 1 48 16 3 0 16
PAGE 212
B–Configuration File Examples SR-IOV Configuration XML Files Table B-7. SR-IOV Configuration Parameters (Continued) Parameter Function Value Range 0–7 (BCM578xx, single-port QL45xxx adapters) 0–15 (dual- and quad-port QL45xxx adapters and single-, dual-, quad-port QL41xxx adapters) (Generally, these values are pre-enumerated.
PAGE 213
C Third-party Licenses Portions of this software contain third-party code that is subject to the conditions described in the following:  “License of libxml2” on page 200  “License of libedit (Linux Only)” on page 201  “License of libcurl” on page 202 License of libxml2 /* Except where otherwise noted in the source code (e.g. the files hash.c, * list.
PAGE 214
C–Third-party Licenses License of libedit (Linux Only) * be used in advertising or otherwise to promote the sale, use or other deal* ings in this Software without prior written authorization from him. */ License of libedit (Linux Only) /** Copyright (c) 1992, 1993 * The Regents of the University of California. All rights reserved. * * This code is derived from software contributed to Berkeley by * Christos Zoulas of Cornell University.
PAGE 215
C–Third-party Licenses License of libcurl License of libcurl /**************************************************************************** * COPYRIGHT AND PERMISSION NOTICE * * Copyright (c) 1996 - 2016, Daniel Stenberg, . * * All rights reserved. * * Permission to use, copy, modify, and distribute this software for any purpose * with or without fee is hereby granted, provided that the above copyright * notice and this permission notice appear in all copies.
PAGE 216
D Exit Codes Table D-1 lists the exit codes that indicate the level of success for a command. Table D-1.
PAGE 217
D–Exit Codes Table D-1.
PAGE 218
D–Exit Codes Table D-1.
PAGE 219
D–Exit Codes Table D-1.
PAGE 220
D–Exit Codes Table D-1.
PAGE 221
D–Exit Codes Table D-1.
PAGE 222
D–Exit Codes Table D-1.
PAGE 223
D–Exit Codes Table D-1.
PAGE 224
E Revision History Document Revision History Revision 1, January 29, 2021 Changes Initial release of user’s guide. Sections Affected All Doc No. TD-000971 Rev.
PAGE 225
Glossary adapter The board that interfaces between the host system and the target devices. Adapter is synonymous with Host Bus Adapter, Host Channel Adapter, host adapter, and adapter board. adapter port A port on the adapter board. adapter port beacon An LED on the adapter. Flashing it enables you to locate the adapter. bandwidth A measure of the volume of data that can be transmitted at a specific transmission rate.
PAGE 226
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers DCB Data center bridging. Provides enhancements to existing 802.1 bridge specifications to satisfy the requirements of protocols and applications in the data center.
PAGE 227
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers GUI A user interface that is based upon icons and visual relationships rather than text. IPv4 Internet protocol version 4. A data-oriented protocol used on a packet switched internetwork (Ethernet, for example). It is a best-effort delivery protocol: it does not guarantee delivery, ensure proper sequencing, or avoid duplicate delivery.
PAGE 228
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers Layer 2 Refers to the data link layer of the multilayered communication model, Open Systems Interconnection (OSI). The function of the data link layer is to move data across the physical links in a network, where a switch redirects data messages at the layer 2 level using the destination MAC address to determine the message destination. LED Light-emitting diode.
PAGE 229
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers Because a path is a combination of an adapter and a target port, it is distinct from another path if it is accessed through a different adapter and/or it is accessing a different target port. Consequently, when switching from one path to another, the driver might be selecting a different adapter (initiator), a different target port, or both.
PAGE 230
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers port instance The number of the port in the system. Each adapter may have one or multiple ports, identified with regard to the adapter as port 0, port 1, and so forth. To avoid confusion when dealing with a system containing numerous ports, each port is assigned a port instance number when the system boots up.
PAGE 231
User’s Guide—QLogic Control Suite CLI 45000/41000 Series Adapters and Adapters Based on 578xx Controllers TOE TCP/IP offload engine. Technology used in iSCSI to optimize throughput by accelerating the performance of TCP/IP. transmission control protocol See TCP. vLAN Virtual logical area network (LAN). A group of hosts with a common set of requirements that communicate as if they were attached to the same wire, regardless of their physical location.
PAGE 232
Marvell first revolutionized the digital storage industry by moving information at speeds never thought possible. Today, that same breakthrough innovation remains at the heart of the company's storage, networking and connectivity solutions. With leading intellectual property and deep system-level knowledge, Marvell semiconductor solutions continue to transform the enterprise, cloud, automotive, industrial, and consumer markets. For more information, visit www.marvell.com. © 2020 Marvell.