Users Guide
Table Of Contents
- Table of Contents
- Preface
- 1 Introduction
- 2 Installing and Launching
- 3 QCS CLI Commands
- General Syntax and Keywords
- Command List
- Commands by Item View
- Command Details
- Add (Team Configuration)
- Add Discovery Portal
- Add Host
- Add iSNS Server
- Add Target
- Boot Configuration
- Cable Diagnostics
- Configure Advanced Settings
- Configure Advanced FCoE Settings
- Configure Advanced Adapter Settings
- Configure Advanced Port Settings
- Configure iSCSI Boot
- Configure iSCSI Initiator
- Configure iSCSI Management
- Configure iSCSI Management (on a Linux Host)
- Configure iSCSI Secret
- Configure Licenses
- Configure Multifunction
- Configure Resource
- Configure SR-IOV
- Configure System TOE
- Create Multiple NPIV Ports
- Create NPIV Port
- Diagnostics
- Discover Host
- Fallback
- Help
- Information (Adapter)
- Information (Team)
- List (Targets)
- List Discovery Portals
- List iSNS Servers
- Log
- Login
- Logout
- Network Diagnostics
- Ping Test
- Quit
- Refresh
- Refresh All
- Refresh Discovery Portal
- Refresh iSNS Server
- Remove (Team)
- Remove All Hosts
- Remove Discovery Portal
- Remove Host
- Remove iSNS Server
- Remove Multiple NPIV Ports
- Remove NPIV Port
- Remove Persistent Target
- Remove Target
- Reset Session Statistics
- Reset Statistics
- Restore (Team)
- Save (Team)
- Select (Target)
- Session Statistics
- Sessions
- Show Selected (Target)
- Statistics
- Unassigned (Adapters)
- Upgrade (Firmware)
- Version
- Legacy Commands
- 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
- Switching Between Different Views of Target Adapters
- Selecting a Target for the Command to Operate On
- Selecting a Target in Interactive Mode
- Getting Information for a Selected Target
- Configuring Advanced Parameters for a Selected Target
- Displaying Licenses for a Selected Target
- 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
- Connecting to an FCoE Target
- Connecting to an iSCSI Target
- Creating a Team Configuration
- Restoring a Team Configuration
- Saving a Team Configuration
- Removing One or More Teams
- Displaying Unassigned Adapters
- Switching Between Primary and Standby Adapters in a Team
- Connecting an iSCSI Target
- Refreshing a Host
- Performing Other Common Tasks
- A Security Considerations
- B Configuration File Examples
- C Third-party Licenses
- D Exit Codes
- E Revision History
- Glossary
1–Introduction
QCS CLI Structure
Doc No. TD-000971 Rev. 1
January 29, 2021 Page 7 Copyright © 2021 Marvell
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.
The QCS CLI interactive mode has no backward or forward levels. You must
explicitly define the target that you want to manage. If the new target is different
than the currently selected target, you must first list the specific target type, and
then select the appropriate target.
Command Categories
All QCS CLI commands can be broadly divided in four categories:
Commands to display information of the target
Commands to modify the configuration of the target
Commands to display the statistical counters for the target
Commands to perform a diagnostic test on the target
After you make configuration changes using QCS CLI, you must refresh the host
to display the most up-to-date information. For a host refresh, issue a command to
list the hosts, select the appropriate host, and then issue the refresh
command. You can then change the focus back to the target that you were
managing.
Client Layout Design
Start the QCS CLI client Windows executable (QCSCLI.exe) in the command
window and add a host. Figure 1-5 shows an example.
Figure 1-5. QLogic Control Suite CLI Window