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 5 Copyright © 2021 Marvell
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.
In the interactive mode, users make connections to local and remote hosts,
and manage them by entering commands in the QCS CLI window. The
output is displayed as either information or an error message. The
interactive mode is not menu based. You must enter a correct command to
list specific types of targets before you can manage those targets.
In the noninteractive mode (also called CLI mode), QCS CLI can take a
command as an input argument and run the command to produce the
appropriate effect and output, and then return a meaningful exit code. This
mode is ideal for scripting CLI commands.
QCS CLI Elements (Targets)
Each manageable element is known as a target. (Target, in this context, does not
refer to the FCoE or iSCSI target, which is usually referred to as a storage system
or LUN.) When you issue a command to list a specific target or manageable
element, all the targets matching the criteria defined in the query are listed and the
first element is selected by default. When you issue a command to list a specific
type of target, the focus shifts from the target that you selected before the query
was run to the first target in the current output.
Example 1:
Suppose the currently selected target is a host. If you issue the command to list
FCoE devices, all matching FCoE devices are listed and the first FCoE device in
the list is automatically selected for management, as shown in Figure 1-3. If you
instead want to manage the NDIS device that was originally selected, you must
first list all of the NDIS devices, and then select the appropriate instance to
manage it, as shown in Figure 1-4.