Qlogic QLogic 12000 Series User manual

D000103-000 E
QLogic 12000 Series
InfiniBand Switches and Directors
CLI Reference Guide
Version 6.0

ii D000103-000 E
QLogic 12000 Series
Information furnished in this manual is believed to be accurate and reliable. However, QLogic Corporation assumes no
responsibility for its use, nor for any infringements of patents or other rights of third parties which may result from its
use. QLogic Corporation reserves the right to change product specifications at any time without notice. Applications
described in this document for any of these products are for illustrative purposes only. QLogic Corporation makes no
representation nor warranty that such applications are suitable for the specified use without further testing or
modification. QLogic Corporation assumes no responsibility for any errors that may appear in this document.
Document Revision History
Revision E, August 15, 2010
Changes Sections Affected
Added the following commands to the group
Network:
dnsParamsShow
dnsParamsSet
“Network” on page 1-39

D000103-000 E iii
Table of Contents
Preface
Intended Audience . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
Documentation Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
License Agreements. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Technical Support. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Availability . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi
Training . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Contact Information. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
Knowledge Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii
1 Switch Command Line Interface
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
Commands and Functional Groups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Online Help. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Keyboard Shortcuts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Accessing the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
Groups and Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-6
Chassis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-32
Network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-39
Firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-52
Subnet Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-59
Log. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-91
Key Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-98
IbSwitchInfo. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-100
TimeManagement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-122
SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-126
CaptureInfo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-132

iv D000103-000 E
QLogic 12000 Series InfiniBand Switches and Directors
CLI Reference Guide

D000103-000 E v
Preface
This manual describes the command line interface (CLI) task information for the
QLogic 12300 and 12800 family of switches.
This manual is organized as follows:
This section describes the intended audience and technical support.
Section 1 describes the 12000 switch CLI commands.
Intended Audience
This manual is intended to provide network administrators and other qualified
personnel a reference for the command line interface of the QLogic 12000 series
switches.
Documentation Conventions
This guide uses the following documentation conventions:
NOTE: provides additional information.
CAUTION! indicates the presence of a hazard that has the potential of
causing damage to data or equipment.
WARNING!! indicates the presence of a hazard that has the potential of
causing personal injury.
Text in blue font indicates a hyperlink (jump) to a figure, table, or section in
this guide, and links to Web sites are shown in underlined blue. For
example:
Table 9-2 lists problems related to the user interface and remote agent.
See “Installation Checklist” on page 3-6.
For more information, visit www.qlogic.com.
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.

Preface
License Agreements
vi D000103-000 E
Text in Courier font indicates a file name, directory path, or command line
text. For example:
To return to the root directory from anywhere in the file structure:
Type cd /root and press ENTER.
Enter the following command: sh ./install.bin
Key names and key strokes are indicated with UPPERCASE:
Press CTRL+P.
Press the UP ARROW key.
Text in italics indicates terms, emphasis, variables, or document titles. For
example:
For a complete listing of license agreements, refer to the QLogic
Software End User License Agreement.
What are shortcut keys?
To enter the date type mm/dd/yyyy (where mm is the month, dd is the
day, and yyyy is the year).
Topic titles between quotation marks identify related topics either within this
manual or in the online help, which is also referred to as the help system
throughout this document.
License Agreements
Refer to the QLogic Software End User License Agreement for a complete listing
of all license agreements affecting this product.
Technical Support
Customers should contact their authorized maintenance provider for technical
support of their QLogic products. QLogic-direct customers may contact QLogic
Technical Support; others will be redirected to their authorized maintenance
provider.
Visit the QLogic support Web site listed in Contact Information for the latest
firmware and software updates.
Availability
QLogic Technical Support for products under warranty is available during local
standard working hours excluding QLogic Observed Holidays.

Preface
Technical Support
D000103-000 E vii
Training QLogic offers training for technical professionals for all iSCSI, InfiniBand, and
Fibre Channel products. From the main QLogic web page at www.qlogic.com,
click the Education and Resources tab at the top, then click the Education &
Training tab on the left. The QLogic Global Training Portal offers online courses,
certification exams, and scheduling of in-person training.
Technical Certification courses include installation, maintenance and
troubleshooting QLogic products. Upon demonstrating knowledge using live
equipment, QLogic awards a certificate identifying the student as a Certified
Professional. The training professionals at QLogic may be reached by e-mail at
[email protected].
Contact Information
Please feel free to contact your QLogic approved reseller or QLogic Technical
Support at any phase of integration for assistance. QLogic Technical Support can
be reached by the following methods:
Knowledge Database
The QLogic knowledge database is an extensive collection of QLogic product
information that you can search for specific solutions. We are constantly adding to
the collection of information in our database to provide answers to your most
urgent questions. Access the database from the QLogic Support Center:
http://support.qlogic.com.
Web http://support.qlogic.com
Email [e-mail]

Preface
Technical Support
viii D000103-000 E

D000103-000 E 1-1
1Switch Command Line
Interface
Overview
This section details the usage of the Command Line Interface (CLI) feature for the
QLogic 12000 family of switches:
The QLogic 12300
The QLogic 12800 Series:
12800-040
12800-120
12800-180
12800-360
The CLI allows the user to perform remote configuration and management tasks,
which in many respects mirrors the functionality of the Chassis Viewer GUI.
The CLI is accessed via a terminal attached to the RS232 port(s) or via the OOB
management port using Telnet and secure shell (SSH) of:
The 12300 chassis
The SEEB module(s) of the 12800 series
Accessing the CLI through the serial port does not require a login and password
(unless configured to do so) and defaults to administrator privileges. Providing
access through the serial port means that users will always have access to the
switch, even if Telnet and SSH are not functioning.
For a standalone switch, the user would Telnet to the IP address(es) of the unit.
Once connected, the CLI works as any telnet session does.
To access the CLI using Telnet and SSH, a login and password is required. There
are two user modes, operator and administrator with the following access
privileges:
Operator:
Read only access.

Switch Command Line Interface
Commands and Functional Groups
1-2 D000103-000 E
Administrator:
Read and write Access.
Reboot access.
Can change operator and administrator passwords.
Can disable user login and passwords. This would allow all users
admin-level access without the need for a user name or password.
Can view all current user sessions
Can access all of the commands executed from any open operator
session.
Can log out any open user sessions
Can send messages to the open user sessions
The CLI allows multiple users to be logged in simultaneously. However, some
commands will be locked to a user(s) if another user is executing the same
command.
Commands and Functional Groups
The list of available commands can be accessed by typing list. To keep the list
short, the commands are grouped into functional groups, which are:
General:
General commands for user management and CLI configuration.
Deprecated:
Commands that have been deprecated.
The Deprecated group contains CLI commands that have been replaced or
are to be removed. Please use the new command where appropriate.
Chassis:
Chassis management commands. (FRU info, fan/power supply state, etc).
Network:
Ethernet interface management commands.
Firmware:
Provides commands for updating the firmware via a File Transfer Protocol
(FTP) server or Secure Copy Protocol (SCP) (if using SSH to access the
BridgeModule).Theswitchhastheabilitytostorethelocationofthefirmware
files for future upgrades.Additionally, the Firmware functionalgroup includes
commands for viewing the current firmware revisions and for changing the
boot image.

Switch Command Line Interface
Commands and Functional Groups
D000103-000 E 1-3
SubnetManagement:
InfiniBand subnet manager configuration and management.
Log:
Provides commands for viewing log files as well as configuring logging
parameters.
KeyManagement:
License key management.
IbSwitchInfo:
Provides commands for displaying InfiniBand (IB) statistics for all IB ports on
the switch, as well as for configuring port statistic thresholds.
TimeManagement:
Providescommandsforretrievingandsettingthecurrentsystemtime,aswell
as commands for setting the time zone and daylight saving time parameters.
Snmp:
Provides commands for configuring SNMP trap destinations and security
parameters required to access the switch from an SNMP manager.
CaptureInfo:
Providescommandsforcapturingswitch-specificinformationforthepurposes
of analysis and debugging.
Tolistcommandswithinafunctionalgroup,simplytypeinthefunctionalgroupname.
For example, to list all of the firmware commands, type list Firmware. The system
displays information similar to the following:
-> list Firmware
fwUpdateSlot Update units firmware
fwUpdateChassis Update units firmware
fwListFiles List the contents of the firmware ramdisk
fwShowUpdateParams Display firmware default update parameters
fwSetUpdateParams Configure firmware default update parameters
showCapability Display the capabilities/features
showLastScpRetCode Display the return code from the last SCP Firmware Push
fwVersion Display Firmware revisions
bootQuery Query boot image information
bootSelect Change boot selection

Switch Command Line Interface
Online Help
1-4 D000103-000 E
Online Help
The online help for the CLI provides, for each command, all necessary information
to successfully execute the command. For example, typing help list (can also type
list help) displays the following information for the list command:
NAME
list
SYNOPSIS
list [group] [-noprompt] [-verbose]
DESCRIPTION
List available commands.
OPTIONS
group - List the commands in that particular group
-noprompt - Just list the command groups.
-verbose - Print full help for each command, instead of summary.
NOTES
Specify the group name or use 'all' to list all available commands.
Keyboard Shortcuts
The CLI keeps a history of recently executed commands. This history is
available via the Up and Down arrow keys.
Users may edit the current command with the Left and Right arrow keys.
Tab completion: pressing the Tab key after typing at least one character
either completes a command or lists all the available commands that begin
with the characters already typed.
Accessing the CLI
NOTE: The CLI can be accessed via Telnet, SSH, or through the switch RS232
serial port. The following instructions use Telnet.
1. Telnet to the IP address of the switch (the default IP address is 192.168.100.9)
with the following command:
telnet <IP ADDRESS>
2. The system prompts for a username. The CLI has the following default user
names:
Operator access: operator
Administrator access: admin
Type the appropriate username and press Enter.

Switch Command Line Interface
Keyboard Shortcuts
D000103-000 E 1-5
3. The system prompts for a password. The CLI has the following default
passwords:
Operator access: operpass
Administrator access: adminpass
Type the appropriate password and press Enter. The system responds with:
Welcome to the <SWITCH> CLI. Type 'list' for the list of
commands.

Switch Command Line Interface
Groups and Commands
1-6 D000103-000 E
Groups and Commands
The following section lists all CLI functional groups along with the commands for
each group. Commands for all 12000 switches are listed. Any commands specific
to a switch(es) is noted. For more specific information for each functional group,
the user would execute the help <GROUP NAME> command. For more specific
command information, the user would execute the help <COMMAND NAME>
command.
General
help
Displays help information for a specific command.
Syntax:
Options:
Sample Output:
NOTES: General Help
Type list or ? for the list of commands.
To get help on a particular command type: commandname help.
For convienence purposes you can also type: help commandname
help [command]
[command]
The command to display help for.
-> help list
NAME
list
SYNOPSIS
list [group] [-noprompt]
DESCRIPTION
List available commands.
OPTIONS
group - List the commands in that particular group
-noprompt - Just list the command groups.

Switch Command Line Interface
Groups and Commands
D000103-000 E 1-7
Usethe Upand Down arrowkeys tobrowsecommand history,Leftand Rightarrow
keystoedit thecurrent commandandtheTabkeyfor tabcompletion ofacommand.
Two alternate key bindings exist for the backspace and delete keys. If these keys
are not responding as expected use the swapBsDel command to swap the
bindings.
Commandsaregroupedintosubcategories. To listthecommands inasubcategory
type in the category heading. Category headings are identified by starting with a
capital letter. For example, to list all the commands that handle log configuration
type Log.
In each help description, items in brackets(e.g. [<command>] in this help
description) represent optional parameters. User selectable input is indicated by
items within the '<' and '>' symbols(e.g. <command>). Text outside the '<' and '>'
characters is the actual text that needs to be entered. When there is more than one
choice, the options are specified within '{' and '}' characters, where the options are
separated by '|' characters.
list
Displays a list of all valid commands.
Syntax:
Options:
Sample Output:
list [all] [group] [-noprompt] [-verbose]
all
List the commands for all groups.
group
Displays a list of commands for a particular group
-noprompt
Displays a list of the command groups only.
-verbose
Print full help for each command, instead of summary.
list
List of Valid Commands:
General General commands for user management and CLI configuration.
Deprecated These commands have been deprecated
Network Snmp configuration commands.
Firmware Update firmware and display current revision levels.
Log Log file display and configuration
IbSwitchInfo InfiniBand port configuration and statistics
TimeManagement Display and configure the system time
Snmp Snmp configuration commands.
Type the name of the group you want to list or return to exit:

Switch Command Line Interface
Groups and Commands
1-8 D000103-000 E
NOTES:
Use 'list all' to display brief help for all available commands.
Use 'list all -verbose' to display verbose help for all commands.
Use 'list -noprompt' to display the list of command groups.
history
Displays the command history for this session.
Syntax:
Options:
Sample Output:
reboot (12300)
Reboots the device.
Syntax:
history
None.
-> history
command history [30 max lines]:
list
Deprecated
Network
Firmware
Log
IbSwitchInfo
TimeManagement
Snmp
Ethernet
help
list
history
reboot [now][-m][slot n][-s][-n][all]

Switch Command Line Interface
Groups and Commands
D000103-000 E 1-9
Options:
Sample Output:
NOTES: You may reboot the local (Master) Managment Module or the remote
(Slave) Managment Module with one or multiple arguments.
Non-disruptive arguments will not interfere with switch traffic.
Providing the argument all performs disruptive reboot of all present Managment
Modules and cards.
If rebooting the local device from telnet, ssh, etc., you will have to reconnect after
rebooting.
Default (no arguments) reboots local device disruptively after prompt.
See also: 'resetCard', 'showInventory'.
reboot (12800 Series)
Reboots the device.
Syntax:
now
Does not prompt the user before rebooting.
-m
Reboot Master (local) QLogic 12300 (non-disruptive).
slot n
reset specific device where n = slotNumber (disruptive).
-s
Reboot Slave (remote) QLogic 12300
-n
Reboot Slave (remote) management card only (non-disruptive)
all
Reboot All local devices (excludes -n/-m/-s).
-> reboot
Disruptive reboot selected
Proceed with reboot? [N]
reboot [now][-m][slot n][-s][-n][all]

Switch Command Line Interface
Groups and Commands
1-10 D000103-000 E
Options:
Sample Output:
NOTES: You may reboot the local (Master) Managment Module or the remote
(Slave) Managment Module with one or multiple arguments.
Non-disruptive arguments will not interfere with switch traffic.
Providing the argument all performs disruptive reboot of all present Managment
Modules and cards.
If rebooting the local device from telnet, ssh, etc., you will have to reconnect after
rebooting.
Default (no arguments) reboots local device disruptively after prompt.
See also: 'resetCard', 'showInventory'.
killCliSession
Terminates an existing CLI session
Syntax:
Options:
now
Does not prompt the user before rebooting.
-m
Reboot Master (local) Management Module 228 (non-disruptive).
slot n
reset specific device where n = slotNumber (disruptive).
-s
Reboot Slave (remote) Management Module 227.
-n
Reboot Slave (remote) management card only (non-disruptive)
all
Reboot All local devices (excludes -n/-m/-s).
-> reboot
Disruptive reboot selected
Proceed with reboot? [N]
killCliSession sessionNumber
sessionNumber
The sessionNumber that is returned from the who command.

Switch Command Line Interface
Groups and Commands
D000103-000 E 1-11
Sample Output:
NOTES: This command logs out remote sessions. Use 'who' to obtain the list of
active sessions.
who
Displays currently active CLI sessions.
Syntax:
Options:
Sample Output:
NOTES: Displays a list of currently active CLI sessions. Note that a session can
be 'active', but no user information available (in most cases, this indicates the
session is waiting for the user to enter login information).
For each session the following information is displayed:
user: username of the logged in user
role: security role of the user
index: internal session index
logged in: timestamp of when the user logged in
last cmd: timestamp of the users last command
type: method used to connect to the system
ip address: ip address of the user (if applicable)
broadcast
Write a message to all active CLI sessions
Syntax:
-> killCliSession
must supply session number
who
None.
user role index logged in last cmd type ip address
---------------------------------------------------------------------------------------------------
admin admin 0 13:19:03 07/11/2008 09:41:20 07/11/2008 serial 0.0.0.0
broadcast msg

Switch Command Line Interface
Groups and Commands
1-12 D000103-000 E
Options:
Sample Output:
NOTES:WritesthesuppliedmessagetoallotheractiveCLIsessions. Themessage
to be written must be encapsulated in quotes, and non-empty.
swapBsDel
Swaps the backspace and delete character key bindings.
Syntax:
Options:
Sample Output:
NOTES: Terminals may bind the backspace and delete key bindings differently.
This command swaps two commonly used bindings, which allow the user to use
the backspace and delete keys properly without having to adjust their terminal
settings. Backspace and delete swapping is persistently maintained per user (i.e.
each login account can have a separate binding).
setTermWidth
Change the terminal width for text formatting purposes.
Syntax:
Options:
msg
Message (Note: the message text must be encapsulated in quotes "".
-> broadcast "The system will be rebooted in 5 minutes."
swapBsDel
None.
-> swapBsDel
setTermWidth width
width
Width of the user’s terminal window. Minimum width is 20 characters.