INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH INTEL PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY ESTOPPEL OR
OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN INTEL'S TERMS AND CONDITIONS OF
SALE FOR SUCH PRODUCTS, INTEL ASSUMES NO LIABILITY WHATSOEVER AND INTEL DISCLAIMS ANY EXPRESS OR IMPLIED WARRANTY, RELATING TO
SALE AND/OR USE OF INTEL PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY,
OR INFRINGEMENT OF ANY PATENT, COPYRIGHT OR OTHER INTELLECTUAL PROPERTY RIGHT.
A "Mission Critical Application" is any application in which failure of the Intel Product could result, directly or indirectly, in personal injury or death. SHOULD
YOU PURCHASE OR USE INTEL'S PRODUCTS FOR ANY SUCH MISSION CRITICAL APPLICATION, YOU SHALL INDEMNIFY AND HOLD INTEL AND ITS
SUBSIDIARIES, SUBCONTRACTORS AND AFFILIATES, AND THE DIRECTORS, OFFICERS, AND EMPLOYEES OF EACH, HARMLESS AGAINST ALL CLAIMS
COSTS, DAMAGES, AND EXPENSES AND REASONABLE ATTORNEYS' FEES ARISING OUT OF, DIRECTLY OR INDIRECTLY, ANY CLAIM OF PRODUCT LIABILITY,
PERSONAL INJURY, OR DEATH ARISING IN ANY WAY OUT OF SUCH MISSION CRITICAL APPLICATION, WHETHER OR NOT INTEL OR ITS SUBCONTRACTOR
WAS NEGLIGENT IN THE DESIGN, MANUFACTURE, OR WARNING OF THE INTEL PRODUCT OR ANY OF ITS PARTS.
Intel may make changes to specifications and product descriptions at any time, without notice. Designers must not rely on the absence or characteristics of
any features or instructions marked "reserved" or "undefined". Intel reserves these for future definition and shall have no responsibility whatsoever for
conflicts or incompatibilities arising from future changes to them. The information here is subject to change without notice. Do not finalize a design with
this information.
The products described in this document may contain design defects or errors known as errata which may cause the product to deviate from published
specifications. Current characterized errata are available on request.
Contact your local Intel sales office or your distributor to obtain the latest specifications and before placing your product order.
Copies of documents which have an order number and are referenced in this document, or other Intel literature, may be obtained by calling 1-800-5484725, or go to: http://www.intel.com/design/literature.htm
Intel and the Intel logo are trademarks of Intel Corporation in the U.S. and/or other countries.
*Other names and brands may be claimed as the property of others.
This manual describes the command line interface (CLI) task information for the Intel®
True Scale Fabric Switches 12200, 12300, and 12800.
This manual is organized as follows:
This section describes the intended audience and technical support.
Section 2.0 describes the 12000 switch CLI commands.
1.1Intended Audience
This manual is intended to provide network administrators and other qualified
personnel a reference for the command line interface of the Intel
switches.
True Scale Fabric Switches 12000 Series User Guide
®
True Scale Fabric Switches 12000 Series Release Notes
®
True Scale Fabric Switch 12200 Release Notes
1.3Documentation 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 also shown in blue. For example:
— Table 2 lists problems related to the user interface and remote agent.
— See “Installation Checklist” on page 6.
— For more information, visit www.intel.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.
• Text in
For example:
• Key names and key strokes are indicated with UPPERCASE:
Courier font indicates a file name, directory path, or command line text.
— To return to the root directory from anywhere in the file structure:
— Enter the following command:
— Press CTRL+P.
cd /root and press ENTER.
Type
sh ./install.bin
®
12000 series
July 2015Reference Guide
Order Number: G91931004US5
True Scale Fabric Switches 12000 Series CLI
— 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 Intel 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 throughout this document.
1.4Laser Safety Information
This product may use Class 1 laser optical transceivers to communicate over the fiber
optic conductors. The U.S. Department of Health and Human Services (DHHS) does not
consider Class 1 lasers to be hazardous. The International Electrotechnical Commission
(IEC) 825 Laser Safety Standard requires labeling in English, German, Finnish, and
French stating that the product uses Class 1 lasers. Because it is impractical to label the
transceivers, the following label is provided in this manual.
The assemblies used in the switch chassis are ESD sensitive. Observe ESD handling
procedures when handling any assembly used in the switch chassis.
1.6License Agreements
Refer to the Intel® Software End User License Agreement for a complete listing of all
license agreements affecting this product.
1.7Technical Support
Intel True Scale Technical Support for products under warranty is available during local
standard working hours excluding Intel Observed Holidays. For customers with
extended service, consult your plan for available hours. For Support information, see
the Support link at
This section details the usage of the Command Line Interface (CLI) feature for the
®
Intel
12000 family of switches:
®
• The Intel
• The Intel
• The Intel
— 12800-040
— 12800-120
— 12800-180
— 12800-360
The CLI allows the user to perform remote configuration and management tasks, that
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 12200 chassis
• The 12300 chassis
• The SEEB module(s) of the 12800 series
12200
®
12300
®
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.
Administrator:
• Read and write Access.
• Reboot access.
• Can change operator and administrator passwords.
• Can disable user login and passwords. This would allow all users administrator-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.
July 2015Reference Guide
Order Number: G91931004US7
True Scale Fabric Switches 12000 Series CLI
2.2Commands 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.
Provides commands for updating the firmware via a File Transfer Protocol (FTP)
server or Secure Copy Protocol (SCP) (if using SSH to access the Bridge Module).
The switch has the ability to store the location of the firmware files for future
upgrades. Additionally, the Firmware functional group includes commands for
viewing the current firmware revisions and for changing the boot image.
12000 Series CLI
SubnetManagement:
IB 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 IB statistics for all IB ports on the switch, as well
as for configuring port statistic thresholds.
TimeManagement:
Provides commands for retrieving and setting the current system time, as well 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:
Provides commands for capturing switch-specific information for the purposes of
analysis and debugging.
To list commands within a functional group, simply type in the functional group name.
For example, to list all of the firmware commands, type list
showLastScpRetCode Display the return code from the last SCP Firmware Push
fwVersion Display Firmware revisions
bootQuery Query boot image information
bootSelect Change boot selection
2.3Online Help
The online help for the CLI provides, for each command, all necessary information to
successfully execute the command. For example, typing
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.
help list (can also type list
2.4Keyboard 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.
2.4.1Accessing the CLI
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>
July 2015Reference Guide
Order Number: G91931004US9
True Scale Fabric Switches 12000 Series CLI
2. The system prompts for a user name. The CLI has the following default user
names:
Type the appropriate password and press Enter. The system responds with:
Welcome to the <SWITCH> CLI. Type 'list' for the list of commands.
2.5Groups and Commands
This section lists all CLI functional groups along with the commands for each group.
The 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
the user would execute the
2.5.1General
help <GROUP NAME> command. For more specific command information,
help <COMMAND NAME> command.
12000 Series CLI
2.5.1.1help
Displays help information for a specific command.
Syntax
help [command]
Options
command – The command to display help for.
Sample Output
-> help list
NAME
list
SYNOPSIS
list [group] [-noprompt]
DESCRIPTION
List available commands.
OPTIONS
group - List the commands in that particular group
To get help on a particular command type: <command name> help.
For convenience purposes you can also type: help <command name>
Use the Up and Down arrow keys to browse command history, Left and
Right arrow keys to edit the current command and the Tab key for
tab completion of a command.
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.
Commands are grouped into subcategories. To list the commands in a
subcategory 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 '
text that needs to be entered. When there is more than one choice, the options are
specified within '
characters.
2.5.1.2list
Displays a list of all valid commands.
Syntax
list [all] [group] [-noprompt] [-verbose]
Options
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.
Sample Output
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.
<'
>' symbols(e.g. <command>). Text outside the '<' and '>' characters is the actual
{' and '}' characters, where the options are separated by '|'
July 2015Reference Guide
Order Number: G91931004US11
True Scale Fabric Switches 12000 Series CLI
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:
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.
admin admin 0 13:19:03 07/11/2008 09:41:20 07/11/2008 serial 0.0.0.0
12000 Series CLI
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: user name 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)
2.5.1.7broadcast
Write a message to all active CLI sessions
Syntax
broadcast msg
Options
msg – Message (Note: the message text must be encapsulated in quotes "".
-> broadcast "The system will be rebooted in 5 minutes."
Notes
Writes the supplied message to all other active CLI sessions. The message to be written
must be encapsulated in quotes, and non-empty.
2.5.1.8swapBsDel
Swaps the backspace and delete character key bindings.
Syntax
swapBsDel
Options
None.
Sample Output
-> swapBsDel
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).
2.5.1.9setTermWidth
Change the terminal width for text formatting purposes.
Syntax
setTermWidth width
Options
width – Width of the user’s terminal window. Minimum width is 20 characters.
Sample Output
-> setTermWidth 100
Notes
Allows modification of the terminal width used for text formatting purposes. Note that
not all commands adhere to this setting. The minimum width is 20 characters.
2.5.1.10getTermWidth
Displays the terminal width for text formatting purposes.
Syntax
getTermWidth
July 2015Reference Guide
Order Number: G91931004US15
True Scale Fabric Switches 12000 Series CLI
Options
None.
Sample Output
-> getTermWidth
Current terminal width: 80 characters.
Notes
Displays the terminal width used for text formatting purposes. Note that not all
commands adhere to this setting.
2.5.1.11prompt
Set the CLI prompt (global for all active CLI sessions).
Syntax
prompt str
Options
12000 Series CLI
str – The new prompt.
Sample Output
prompt -> "12300->"
12300->
Notes
This changes the prompt for all CLI sessions. The prompt may not exceed 11 characters
and is not saved across reboots. If the prompt contains a space, asterisk, comma,
parenthesis or semicolon it must be enclosed with double quotes “”. For example: “
prompt*”. Also, if a prompt is not accepted try to enclose it with double quotes. In
order for some FastFabric Tools to function correctly, the prompt must end in “
trailing space).
2.5.1.12case
Display or change the case sensitivity for the command interpreter for the CLI session.
This displays or changes the case sensitivity for the command interpreter for the CLI
session. If an option is not specified the current case sensitivity is displayed, otherwise
the case sensitivity is turned on or off depending on the specified option. When case
sensitivity is on, the CLI input must match the exact character case (lower and upper
case) as specified in the help text. When case sensitivity is turned off, the input may be
any combination of upper and lower case.
2.5.1.13showLastRetCode
Display the return code from the last executed command.
Syntax
showLastRetCode [-brief]
Options
-brief – Displays just the numeric value of the return code.
Sample Output
-> showLastRetCode
Last Exit Code: 0: Success
Notes
This allows for automated systems to determine if a command was successful or not.
2.5.1.14echo
Echoes text back to the output.
Syntax
echo [<text> ...]
Options
[<text> ...] – Text to be echoed..
Sample Output
-> echo test
test
Notes
This echoes the text for each argument back to the output. If there are multiple
arguments they are separated by spaces.
2.5.1.15rlogin
Creates I/O terminal to local cards.
Syntax
rlogin [hostName]
July 2015Reference Guide
Order Number: G91931004US17
True Scale Fabric Switches 12000 Series CLI
Options
hostName – The name of the device to connect.
Sample Output
-> rlogin Slave
Notes
This command allows users to open a terminal to local I/O devices within the chassis.
The command
2.5.1.16rcmd
Creates I/O terminal to local cards.
Syntax
rcmd [hostName]
Options
hostName – The name of the device to connect.
12000 Series CLI
rcmd is an alias of rlogin. See also hostShow.
Sample Output
-> rcmd Slave
Notes
This command allows users to open a terminal to local I/O devices within the chassis.
The command rcmd is an alias of rlogin. See also hostShow.
2.5.1.17resetCard
Reboot a specific slot in the chassis.
Syntax
resetCard n [now]
Options
n – Chassis slot number.
now – No prompt before resetting the card.
Sample Output
-> resetCard 101 now
Notes
If you reset the switch you are connected to you will have to reconnect. You can find
out the valid slots for this device with the 'showInventory' command.
Use this command to change to the 'operator' account, or to the 'admin' account. The
minimum password length is 8 characters. The maximum length is 40 characters.
2.5.1.20passwd
Change users password(s).
Syntax
passwd [user name]
Options
user name – Name of the user whose password needs to be changed.
Sample Output
-> passwd operator1
User password changed successfully
Notes
Allows the modification of the user's password.
2.5.1.21userAdd
Add a user account.
July 2015Reference Guide
Order Number: G91931004US19
True Scale Fabric Switches 12000 Series CLI
Syntax
userAdd [role] [user name] [password]
Options
role – Can be either admin or operator.
user name – The name of the user to be added.
password – Optional password. If not supplied the default password for that role is
used.
Sample Output
-> userAdd admin Bob
User added: Bob
Password is set to the default password for this role: admin
Adds, displays, and removes SSH public keys for individual users. Users with
administrative privileges may use the -u option to manage keys for other users.
2.5.1.25loginMode
Allows the user to change the user interface authentication requirements.
July 2015Reference Guide
Order Number: G91931004US21
True Scale Fabric Switches 12000 Series CLI
Notes
This command displays or changes how users are authenticated when connecting to
the GUI or CLI. With no parameters, the current login mode is displayed. The login
mode can be changed by specifying a single integer parameter indicating which of the
following modes should become active:
0 - Username and password required
1 - Password is not required
2 - Username / password are not required
3 - LDAP Authentication
When user names are disabled, all users will be logged on as the administrative user.
There is no way to change this behavior.
2.5.1.26setldapSvrIpAddr
Modify the LDAP Server IP Address.
Syntax
setldapSvrIpAddr [ipaddress]
12000 Series CLI
Options
ipaddress – The IP address of the ldap server you wish to set to authenticate in the
format "192.168.0.1"
Sample Output
-> setldapSvrIpAddr 192.168.0.29
Notes
This sets the LDAP server ip address. The LDAP server will be contacted for remote
authentication.
2.5.1.27setldapSvrPort
Modify the LDAP Server Port.
Syntax
setldapSvrPort [port]
Options
port – The port of the LDAP server to be authenticated.
Sample Output
-> setldapSvrPort 389
Notes
Sets the LDAP server port. The LDAP server will be contacted for remote
authentication.
--all – Display all timeouts. This is the default if no options are specified.
--cli – Display the timeout for CLI sessions.
--gui – Display the timeout for GUI sessions.
Sample Output
-> idleTimeoutSet --all 700
Timeout is set to 700 seconds.
Notes
Displays the system idle timeouts for the GUI and CLI interfaces. If set to zero, the
timeout is disabled.
2.5.1.29idleTimeoutSet
Set the UI idle timeout value.
Syntax
idleTimeoutSet [--all | --cli | --gui] seconds]
Options
seconds – Idle timeout value (in seconds).
--all – Set the idle timeout for both the CLI and the GUI to the same value.
--cli – Set the idle timeout for the CLI. This is the default if no identifier is specified.
--gui – Set the idle timeout for the GUI.
Sample Output
-> idleTimeoutSet --all 700
Timeout is set to 700 seconds.
Notes
Modifies the idle timeout for the CLI or GUI interfaces. Timeouts are in number of
seconds, with zero meaning the timeout is disabled.
2.5.1.30sessionTimeoutDisable
Disable the idle timeout for the current CLI session.
July 2015Reference Guide
Order Number: G91931004US23
True Scale Fabric Switches 12000 Series CLI
Syntax
sessionTimeoutDisable
Options
None.
Sample Output
-> sessionTimeoutDisable
Disabled session idle timeout.
Notes
Disables the idle timeout for the current CLI session. This value does not persist across
instances of the session (i.e., each time you log on, it will default back to the system
default value).
2.5.1.31sessionTimeoutEnable
Enable the idle timeout for the CLI session.
Syntax
12000 Series CLI
sessionTimeoutEnable
Options
None.
Sample Output
-> sessionTimeoutEnable
Enabled session idle timeout.
Notes
Enables the idle timeout for the current CLI session. This value does not persist across
instances of the session (i.e., with each log on, it defaults back to the system default
value).
2.5.1.32loginMsgGet
Displays the CLI login message for this device.
Syntax
loginMsgGet
Options
None.
Sample Output
-> loginMsgGet
Welcome message: Be certain to logout when you are finished using the CLI.
Displays the current login welcome message for the CLI. This message can be
customized with the
2.5.1.33loginMsgSet
Set the CLI login message for this device.
Syntax
loginMsgSet [message] [-clear]
Options
message – The login message (should be encapsulated in quotes “ “).
-clear – Clear welcome message.
Sample Output
-> loginMsgSet "Be certain to logout when you are finished using the CLI."
Welcome message set successfully
loginMsgSet command.
Notes
This command can be used to modify the welcome message displayed when logging
onto the CLI. The current message can be viewed with the
2.5.1.34loginNameGet
Display the name of the device displayed when logged into via telnet.
Syntax
loginNameGet
Options
None.
Sample Output
-> loginNameGet
login-name: Switch1
Notes
The login name is an arbitrary string displayed prior to a user attempting a login to a
new CLI session. This command displays the current value of this string.
2.5.1.35loginNameSet
loginMsgGet command.
Modify the string displayed to users prior to attempting a login for a new CLI session.
Syntax
loginNameSet [option]
July 2015Reference Guide
Order Number: G91931004US25
True Scale Fabric Switches 12000 Series CLI
Options
name – Set the login name.
-clear – Clear the login name.
Sample Output
-> loginNameSet Switch1
login-name set successfully
Notes
The login name is an arbitrary string displayed prior to a user attempting a login to a
new CLI session. This command modifies this string. The current name can be viewed
with the
loginNameGet command.
2.5.1.36serialAuthGet
Displays the current serial authentication status.
Syntax
serialAuthGet
12000 Series CLI
Options
None.
Sample Output
-> serialAuthGet
Serial authentication is currently disabled.
Notes
Displays whether user login and authentication is required on the serial console of the
system.
2.5.1.37serialAuthSet
Enable or disable authentication on the systems serial console.
Syntax
serialAuthSet [enable]
Options
enable – Boolean value to enable or disable serial authentication.
This command is used to enable or disable user authentication on the serial console.
Use 1 as the only parameter to enable authentication, or 0 to disable authentication.
Exit and re-login for the setting to take effect. The login mode must be set to 0 or 1 for
authentication to take place on the serial port.
2.5.1.38uiConfig
View or configure the user interfaces to this device.
telnet – Enable/disable access to the device via telnet..
https – Enable or disable https access.
http – Enable or disable http access.
ftp – Enable or disable ftp access.
snmp – Enable or disable SNMP access.
Sample Output
-> uiconfig -telnet 0
Successfully modified configuration.
Option Value
-----------------------
telnet 0
http 1
https 0
ftp 1
snmp 1
Notes
There are several access methods for this device. With no arguments, this command
displays which access methods are available, and whether each method is enabled or
disabled.
This command can also be used to enable or disable various access methods. Use '
-
<proto> 0' to disable a protocol, and '-<proto> 1' to enable. Multiple operations
may be specified in a single command.
A reboot is not required for this command. Depending on the specific method, it may
take 5-10 seconds for the changes. Note that existing connections (for example a
telnet session) will not be affected by disabling the underlying access method.
Any access method supported by the device (but not listed here) cannot be configured
and is always enabled.
July 2015Reference Guide
Order Number: G91931004US27
Runs a system check at the chassis level and returns current hardware status.
Syntax
hwCheck
Options
n
– 0=default, 1=verbose
Sample Output
-> hwCheck
Chassis hardware status: GOOD
Notes
Returns OK or provides detailed status/warning/error information. If an error/warning
is detected, this command automatically provides verbose information.
2.5.2.2hwMonitor
Displays current port states, fan speeds, temperatures, and voltages.
Syntax
hwMonitor [slot] [onepass]
Options
slot – Slot number to display. 0 for current slot of the management board.
onepass – Display the current values and exits. Do not continuously monitor.
Sample Output
(Sample 1)
-> hwMonitor 0
System monitor, Uptime: 0 days 4 hours 55 minutes 37 seconds
The slot number may require a prefix. The prefix for a Leaf is 'L', the prefix for a Spine
is 'S', the prefix for a Mangement Module is 'M', the prefix for a Power Supply is 'P', the
prefix for a Fan is 'F', and the prefix for the Chassis is 'C'. The Leaf, Spine and
Management Module slots do not require a prefix. The Power Supply, Fan and Chassis
slots require a prefix since their slot numbers overlap with the Leaf, Spine and
Management Module slot numbers.
2.5.2.3showIBNodeDesc
Displays the IB Node subnet management agent (SMA) Description..
IB Node (SMA) Description successfully changed to = Intel 12300
Notes
New node name must be enclosed in quotes. Node name must be no more than 64
characters.
2.5.2.5setIBNodeDescFormat
Changes the IB Node (SMA) description format modifier.
Syntax
setIBNodeDescFormat [format]
Options
format – Use 0 or 1 to set the format
Sample Output
-> setIBNodeDescFormat
Format = 0
Notes
If the format is not specified, then the current format selection value is displayed.
When the format is 0, the SMA node description is in a verbose format. When the
format is one the format is brief. The brief format is more consistent with the CLI/GUI
Port Stat port naming.
2.5.2.6fruInfo
Displays the EEProm contents.
July 2015Reference Guide
Order Number: G91931004US33
True Scale Fabric Switches 12000 Series CLI
12000 Series CLI
Syntax
fruInfo [slot|'-all']
Options
slot – Slot that you wish to display EEProm contents. Defaults to 0 (chassis EEProm)
Sample Output
-> fruInfo
xInfo_ChassisInfo:
RecType: 1 LastRec: 0 LenMult: 0
ReadOnly: 1 RecordFormat: 2 RecLen:
14
LogicalLen: 020
HdrChkSum: c6
ChassisGuid: 00066a000300012a
SlotCount: 1 (IB Mods in Chassis)
SlotNumbers: 81 (pairs:ext0|Slt1)
CmeAccess: 80 (bits:ext0|Slt1|Cme)
SlotNumber: 0 <-Record accessed via this slot
CmeAccessBits: 2 (Access slot relative)
ProxyAccess: 0 (Access slot relative)
LockDrivesCTR: 0 (Clear to Remove interlock)
MechLock: 1
NodeCount: 0
...
Notes
The '
-all' parameter performs this command against all available slots for the device.
2.5.2.7chassisQuery
Displays information about modules inserted in the chassis that support firmware
updates. This includes information regarding cardType, Board Support Package (BSP)
and SlotNumber.
IpAddress – The IP address of the network host to ping.
packetCount – The number of packets with which to ping the host (default is 5).
Sample Output
-> ping 172.26.0.254
PING 172.26.0.254: 56 data bytes
64 bytes from 172.26.0.254: icmp_seq=0. time=0. ms
64 bytes from 172.26.0.254: icmp_seq=1. time=0. ms
64 bytes from 172.26.0.254: icmp_seq=2. time=0. ms
64 bytes from 172.26.0.254: icmp_seq=3. time=0. ms
64 bytes from 172.26.0.254: icmp_seq=4. time=0. ms
----172.26.0.254 PING Statistics----
5 packets transmitted, 5 packets received, 0% packet loss
round-trip (ms) min/avg/max = 0/0/0
Notes
This routine spawns a process to send ping packets to the specified IP address. If
packetCount is given, the process exits after that number of packets are sent. If
packetCount is omitted, a default the number of packets defaults to 5.
-c <packetCount> – The number of packets to ping the host with (default is 5).
-I <interface> – The local interface name to use (useful for link local ping).
ipv6Address – The network host to ping, scoped address accepted.
Sample Output
-> ping6 ipv6Address
Notes
This routine spawns a process to send ping packets to the specified IPv6 address. If
packetCount is given, the process exits after that number of packets are sent. If
packetCount is omitted, a default the number of packets defaults to 5.
July 2015Reference Guide
Order Number: G91931004US39
True Scale Fabric Switches 12000 Series CLI
2.5.3.5showChassisIpAddr
Displays the chassis IP address.
Syntax
showChassisIpAddr
Options
None.
Sample Output
-> showChassisIpAddr
Chassis IP Address: 172.26.0.221 Net mask: 255.255.240.0
2.5.3.6setChassisIpAddr
Change the OOB LAN IP address and network mask.
Syntax
setChassisIpAddr -h ipaddress -m netMask
12000 Series CLI
Options
-h ipaddress – The new IP address in dotted notation format 'xxx.xxx.xxx.xxx'.
-m netMask – The network mask. (may be in dotted notation or hexidecimal format)
Changing the chassis IPv6 address may drop the connection to the CLI if not using the
console port, and may cause the device to become unreachable.
2.5.3.8delChassisIpv6Addr
Deletes the chassis IPv6 address.
Syntax
delChassisIpv6Addr <ipv6Address>
Options
None.
Sample Output
-> delChassisIpv6Addr <ipv6Address>
Notes
Changing the chassis IPv6 address may drop the connection to the CLI if not using the
console port, and may cause the device to become unreachable. This command does
not affect link-local or autoconfigured addresses.
2.5.3.9showChassisIpv6Addr
Displays the chassis IPv6 address.
Syntax
showChassisIpv6Addr
Options
None.
Sample Output
-> showChassisIpv6Addr
2.5.3.10autoConfIPv6Enable
Enables IPv6 address autoconfiguration.
Syntax
autoConfIPv6Enable
Options
None.
Sample Output
-> autoConfIPv6Enable
July 2015Reference Guide
Order Number: G91931004US41
True Scale Fabric Switches 12000 Series CLI
Notes
This command allows prefix learning from attached routers, and does not affect linklocal or manually configured addresses.
2.5.3.11autoConfIPv6Disable
Disables IPv6 address autoconfiguration.
Syntax
autoConfIPv6Disable
Options
None.
Sample Output
-> autoConfIPv6Disable
Notes
Prevents prefix learning from attached routers, and does not affect link-local or
manually configured addresses.
This command retrieves the stored configuration parameters used for domain name
resolution.
2.5.3.22dnsParamsSet
Changes the DNS configuration parameters.
Syntax
dnsParamsSet [-s <ipaddress>] [-d <domain name>] [-e <1 or 0>]
Options
-s <ipaddress> – DNS server IP address in dotted notation format
(xxx.xxx.xxx.xxx)
-d <domain name> – The local domain name where this switch is installed (limit 32
chars).
-e <1 or 0> – 1 = enable the DNS resolver, 0 = disable the DNS resolver.
Sample Output
dnsParamsSet -e 0
MasterMM202-> dnsParamsShow
DNS Resolver : Disabled
DNS Server Address : xxx.xxx.xxx.xxx
Local Domain Name : st.intel.com
Notes
The DNS resolver cannot be enabled until both the server address and local domain
name have been configured. It is necessary to manually reboot the switch in order to
start or stop the DNS resolver.
2.5.4Firmware
2.5.4.1fwUpdate (12300)
Updates the firmware.
Syntax
fwUpdate [host user password dir filename]
July 2015Reference Guide
Order Number: G91931004US47
True Scale Fabric Switches 12000 Series CLI
Options
host – The name of the host where the firmware file resides.
user – The FTP user name.
password – The FTP user password.
dir – After logging in, the directory to cd to.
filename – The name of the firmware file.
Sample Output
-> fwUpdate
Enter 1 for FTP, 2 for local file: 1
Ftp Server IP Address:[192.168.0.195]
Ftp user name:[ftp] xxxxx
Ftp password:[ftp] xxxxx
File Directory:[PATH TO FIRMWARE FILE]
File name:[xxx.pkg]
12000 Series CLI
Notes
Firmware update works by using ftp to retrieve the firmware file, then writes the file to
flash. Omitting any of the options causes the user to be prompted for the information.
2.5.4.2fwUpdateSlot
Updates the firmware on a specific line card.
Syntax
fwUpdateSlot slotnumber [host user password dir filename]
Options
slotnumber – The chassis slot numberto update.
host – The name of the host where the firmware file resides.
Firmware update works by using ftp to retrieve the firmware file, then writes the file to
flash. Omitting any of the options causes the user to be prompted for the information.
2.5.4.3fwUpdateChassis
Updates the firmware for all cards in a chassis of a particular type, or everything.
(all,management,evic, fvic) – Type of card to update. See notes for details.
noprompt – Will not prompt the user for ftp information (uses the saved values).
reboot – Upon successful completion, reboots the updated cards .
Sample Output
-> fwUpdateChassis all reboot
Notes
Firmware update works by retrieving the firmware file from an ftp server. The file is
saved locally and then written to flash. Using the ’all’ option, all cards in the chassis will
be updated. This assumes that all firmware files are in the same location. The user will
be prompted for the names of each file for each line card type present. The system can
save the values entered as defaults for future firmware updates.
2.5.4.4fwListFiles
Lists the contents of the firmware directory.
Syntax
fwListFiles
Options
None.
Sample Output
-> fwListFiles
Listing Directory /firmware:
[PATH TO FIRMWARE FILE] / [FIRMWARE FILE NAME]
Notes
The firmware directory temporarily stores firmware files before they are written to
flash.
July 2015Reference Guide
Order Number: G91931004US49
-h - hostname – The host name or IP address of the FTP server.
-u - user name – The name of the user accessing the ftp server.
-p - password – The password of the user accessing the ftp server.
-d - directory – The directory containing the firmware file.
-f - filename – The firmware file name.
Notes
Modifies the default update firmware parameters. Except for the filename option, all
parameters are shared across all card types. The cardtype parameter is only required
when specifying the filename.
* - indicates Primary image (will run at next reboot)
# - indicates Active image
Default boot image index = 1
...
Notes
This command allows the user to set the next boot image for the device. A '*' next to
the image entry indicates the currently selected bootimage. A '#' indicates the
currently active boot image.
2.5.5Subnet Management
2.5.5.1smControl
Starts and stops the embedded subnet manager.
Syntax
smControl start | stop | restart | status
Options
Start – Start the SM.
Stop – Stop the SM.
restart – Restarts the SM.
status – Prints out the SM Status.
Sample Output
-> smControl start
Starting the SM...
2.5.5.2smConfig
Configure startup parameters of the embedded subnet manager.
startAtBoot – Start the subnet manager at chassis boot
startOnSlaveCmu – Start subnet manager on the slave CMU
Sample Output 1:
-> smConfig
Start at boot? [Y]
July 2015Reference Guide
Order Number: G91931004US53
True Scale Fabric Switches 12000 Series CLI
Start on slave CMU? [N]
Sample Output 2:
-> smconfig startAtBoot yes startOnSlaveCmu yes
Saving....
Saving complete...
Notes
Use this command to configure the subnet manager. Changes to these parameters do
not take effect until the chassis management card(s) is rebooted. This command is only
available on the master chassis management card.
Use this command to display the current LID of the subnet manager.
2.5.5.4smPriority
Display the priority of the embedded subnet manager.
Syntax
smPriority
Options
None.
Sample Output
-> smPriority
The SM Priority is 0
Notes
The priority of the Subnet Manager (SM) determines which subnet manager will
become the master SM for the fabric. Zero is the lowest priority and fifteen is the
highest. The SM with the highest priority becomes the master SM for the fabric. The
elevated priority value determines what the priority of the SM will be if it becomes the
Master. This allows persistent failovers that do not automatically fail back by
configuring the elevated priority to be higher than all normal priorities. This feature is
effectively disabled when set to the default of zero. The subnet manager must be
running to display the priority.
2.5.5.5smSweepRate
Display or dynamically set the sweep rate of the subnet manager.
Syntax
smSweepRate [sweepRate]
Options
sweepRate – The sweep rate (in seconds) of the subnet manager. Valid values are 3-
86400, or 0 to turn the sweep off. The sweepRate is the interval between the end of
one sweep and the start of the next sweep.
Sample Output
-> smSweepRate 300
July 2015Reference Guide
Order Number: G91931004US55
True Scale Fabric Switches 12000 Series CLI
The SM sweep rate has been set to 300 seconds
Notes
The sweep rate determines how often the subnet manager scans the fabric for changes
and events. The subnet manager must be running to display or dynamically set the
sweep rate of the embedded subnet manager. Changes to sweepRate made with the
smSweepRate command will only affect the subnet manager that is currently running
and will not be persistent.
2.5.5.6smForceSweep
Force a fabric sweep by the embedded subnet manager.
Syntax
smForceSweep
Options
None.
Sample Output
-> smForceSweep
12000 Series CLI
Notes
Use this command to force a sweep by the subnet manager.
2.5.5.7bmForceSweep
Force a fabric sweep by the embedded baseboard manager.
Syntax
bmForceSweep
Options
None.
Sample Output
-> bmForceSweep
Notes
Use this command to force a sweep by the baseboard manager.
2.5.5.8smShowGroups
Display multicast group information within the embedded subnet manager.
qKey = 0x00000000 pKey = 0xFFFF mtu = 4 rate = 3 life = 19 sl = 0
0x0011750000ffd5bb F
0xff12401bffff0000:00000000ffffffff (c000)
qKey = 0x00000000 pKey = 0xFFFF mtu = 4 rate = 3 life = 19 sl = 0
0x00066a01a0007116 F 0x0002c902003fffd5 F 0x00066a00a00001ac F
0x00066a01a000015d F 0x00066a00a00001a3 F 0x00066a00a00001dc F
0x00066a00a000035a F 0x0011750000ffd5c2 F 0x0011750000ffd664 F
0x0011750000ffd9c2 F 0x0011750000ffd9f8 F 0x0011750000ffd5b9 F
0x0011750000ffda4a F 0x0011750000ffd5bb F 0x0011750000ffd9de F
Notes
Use this command to display multicast group information in the subnet manager. This
command is not available unless the subnet manager is in the Master mode.
2.5.5.9smShowServices
Display subnet administration service records of the subnet manager.
The components (fields) of each service record are displayed. Each service record is
stored in a location identified by a 'Slot' number which is displayed before any
component of that Service Record. If a group of slots do not contain Service Records,
the first slot of the empty group is displayed as 'empty'. This command is not available
unless the subnet manager is in the Master mode.
2.5.5.10smShowSubscriptions
Display event forwarding (subscription) table in the embedded subnet manager.
Use this command to display the event forwarding (subscription) table in the subnet
manager. This command is not available unless the subnet manager is in the Master
mode.
2.5.5.11smMasterLMC
Display the LMC value of the subnet manager to be used on CA ports.
Syntax
smMasterLMC
Options
None.
July 2015Reference Guide
Order Number: G91931004US59
True Scale Fabric Switches 12000 Series CLI
Sample Output
-> smMasterLMC
Notes
The value of the LMC determines how many LID's are assigned to an endport; 2 LMC
LIDs are assigned to endports based on this value. For example, setting the LMC to a
value of 3 will assign 8 LIDs per endport. The allowable LMC values are between 0 and
7, inclusive. The subnet manager must be running as MASTER to display the LMC value.
2.5.5.12smShowMasterLid
Display the LID of the subnet manager.
Syntax
smShowMasterLid
Options
None.
Sample Output
12000 Series CLI
-> smShowMasterLid
The SM LID is 0x0001
Notes
Use this command to display the LID of the master subnet manager.
2.5.5.13smShowLidMap
Display the LID-to-port GUID map for the subnet manager.
Lid 0x0007: guid = 0x00066a01a0007116, pass = 341, st149
Lid 0x0008: guid = 0x0000000000000000, pass = 0
Lid 0x0028: guid = 0x0000000000000000, pass = 0
Lid 0x002a: guid = 0x0000000000000000, pass = 0
Notes
Use this command to display the LID-to-port GUID map of the subnet manager. This
command is not available unless the subnet manager is in the Master mode.
2.5.5.14smShowMaxLid
Display the highest LID allocated by the subnet manager.
Syntax
smShowMaxLid
Options
None.
Sample Output
-> smShowMaxLid
The maximum LID is 0x0138
Notes
Use this command to display the highest LID allocated by the subnet manager. This
command is not available unless the subnet manager is in the Master mode.
2.5.5.15smSwitchLifetime
Allows the user to display/dynamically set the default switch lifetime of the subnet
manager.
Syntax
smSwitchLifetime [lifetime}
Options
lifetime – The packet lifetime value between 0 and 31, inclusive.
Sample Output
-> smSwitchLifetime 15
SM switch packet lifetime: 15 (~134217 microseconds)
Notes
The switch lifetime value determines the maximum time a packet may remain within a
switch, calculated using the formula: 4.096 * (2 switchlifetime) in microseconds. The
packet lifetime values may be between 0 and 31, inclusive (default = 13). The subnet
manager must be running to display or dynamically set the default switch lifetime.
Changes will only affect the SM that is currently running and will not be persistent.
July 2015Reference Guide
Order Number: G91931004US61
True Scale Fabric Switches 12000 Series CLI
2.5.5.16smHoqLife
Display or dynamically set the head of queue packet lifetime for switch ports.
Syntax
smHoqLife [lifetime]
Options
lifetime – The packet lifetime value between 0 and 31, inclusive.
Sample Output
-> smHoqLife 9
SM HOQ Liftime: 9 (~2097 microseconds)
Notes
Use this command to display the maximum lifetime that a packet may remain at the
head of a virtual lane transmission queue before it is discarded by a switch. Packet
lifetime values are between 0 and 31, inclusive (default = 11). These are calculated
using the formula: 4.096 * (2 ^ switchlifetime) in microseconds. The subnet manager
must be running to display, or to dynamically set the Hoq lifetime. Changes to Hoq
lifetime set with the smHoqLife command only affect the currently running SM and will
not be persistent.
12000 Series CLI
2.5.5.17smVLStall
Allows the user to display/dynamically set the VL stall value of the subnet manager.
Syntax
smVLStall [packets]
Options
packets – The number of sequential packets dropped before port enters VL stalled
state.
Sample Output
-> smVLStall 5
SM VL Stall Threshhold: 5 packets
Notes
Use this command to set the VL stall value for ports in the fabric. This value determines
the how quickly a virtual lane for a particular switch or endport enters a 'stalled' state
after dropping packets (default = 7 packets). The subnet manager must be running to
display or to dynamically set VLStall. Changes to VLStall with the smVLStall command
only affect the currently-running subnet manager and will not be persistent.
Dynamic PLT ON using values: 1 hop=16, 2 hops=17, 3 hops=17, 4 hops=18, 5 hops=18,
6 hops=18, 7 hops=18, 8+hops=19
SM DBSync interval set to 900
SM topology errors threshold set to 0, max retry to 3
Notes
Use this command to display a sampling of subnet manager parameters.
2.5.5.19smPKeys
Configure a partition key (PKey) in the PKey table.
Syntax
smPKeys
Options
None.
Sample Output
-> smPKeys
Notes
PKeys are used for partitioning the subnet. Only configure PKeys if the host driver
supports this. Invalid configuration of the PKey may render the fabric inoperable. The
subnet manager must be running to display PKeys.
2.5.5.20smInfoKey
Set the subnet manager key (SMInfo) value.
July 2015Reference Guide
Order Number: G91931004US63
True Scale Fabric Switches 12000 Series CLI
Syntax
smInfoKey
Options
None.
Sample Output
-> smInfoKey
SM Key: 0x0000000000000001 (1 decimal).
Notes
Use this command to set the SM key. SM must be offline and key value is up to 8 byte
hex. The subnet manager must be running to display the SMInfo key value.
2.5.5.21smMgmtKey
Set the subnet manager management key (portInfo) value.
Syntax
smMgmtKey
12000 Series CLI
Options
None.
Sample Output
-> smMgmtKey 0x11
SM management key: 0x0000000000000011 (17 decimal)
Notes
Use this command to set the SM management key. SM must be offline and mkey value
is up to 8 byte hex. The subnet manager must be running to display the SMInfo key
value.
2.5.5.22smOptionConfig
Use this command to configure support for non-default modes of operation.
Set the Subnet Prefix (default=0xfe80000000000000).
Syntax
smGidPrefix [prefix]
Options
None.
Sample Output
-> smGidPrefix
July 2015Reference Guide
Order Number: G91931004US65
True Scale Fabric Switches 12000 Series CLI
Subnet Prefix: 0xfe80000000000001
Notes
Use this command to set the subnet prefix of the SM. The SM must be offline and the
subnet prefix value is 8 byte hex. The subnet manager must be running to display
default multicast group information.
2.5.5.25smSubnetSize
Set/display the subnet size for the subnet manager.
Syntax
smSetSubnetSize
Options
None.
Sample Output
-> smSubnetSize
Notes
12000 Series CLI
Use this command to tune the SM to handle the configured fabric size. The subnet
manager must be running to display subnet size information.
2.5.5.26smTopoErrorThresh
Set/display the error threshold for a topology sweep.
Syntax
smTopoErrorThresh
Options
None.
Sample Output
-> smTopoErrorThresh 100
Set topology error threshold to:100
Notes
Sets the maximum number of errors the SM may encounter during a sweep before
abandoning the sweep. The subnet manager must be running to display the error
threshold for a topology sweep.
2.5.5.27smTopoAbandonThresh
Set/display the maximum consecutive times the SM can abandon a sweep due to too
many errors (default = 3).
The subnet manager (SM) must be running to use this command. Changes made with
this command will only affect the currently running SM, and will be forgotten if the FM
is restarted or the chassis is rebooted. To make persistent changes edit the FM XML
configuration file.
2.5.5.33smLogMode
Displays or dynamically sets the Subnet Manager logging mode.
The Subnet manager must be running to use this command. Changes made with this
command will only affect the currently running SM, and will be forgotten if the FM is
restarted or the chassis is rebooted. To make persistent changes edit the FM XML
configuration file.
2.5.5.34smLogMask
Displays or dynamically sets the Subnet Manager logging mask for a specific
subsystem.
Syntax
smLogMask <subsystem> [<mask>]
July 2015Reference Guide
Order Number: G91931004US69
True Scale Fabric Switches 12000 Series CLI
Options
subsystem – The Fabric Manager (FM) subsystem.
Subsystems: CS, MAI, CAL, DVR, IF3, SM, SA, PM, PA, BM, FE, APP
mask – The bit mask needed for logging to enable.
Sample Output
-> smLogMask SM
Notes
The Subnet manager must be running to use this command. Changes made with this
command will only affect the currently running SM, and will be forgotten if the FM is
restarted or the chassis is rebooted. To make persistent changes edit the FM XML
configuration file.
2.5.5.35smMcLidTableCap
Displays the limit of the multicast LIDs that are available for allocation.
Syntax
smMcLidTableCap
12000 Series CLI
Options
None.
Sample Output
-> smMcLidTableCap 1024
Set mc lid limit to 1024
-> smMcLidTableCap
Mc lid limit: 1024
Notes
Setting this value to zero disables limiting multicast LIDs. The subnet manager must be
running to display this information.
2.5.5.36smMasterPingInterval
Displays the ping interval (in seconds) of the subnet manager.
Dynamic packet lifetime values for pathrecord queries are enabled
(use the smOptionConfig command to change)
Notes
Setting values to numbers greater than 19 give an effectively-infinite packet lifetime.
The subnet manager must be running to display dynamic packet lifetime values.
2.5.5.40sm1xLinkMode
Displays how the subnet manager handles 1x links.
Syntax
sm1xLinkMode
Options
None.
Sample Output
-> sm1xLinkMode
Mode is 'off'. Erroneous 1x links will be activated normally.
-> sm1xLinkMode ignore
-> sm1xLinkMode
Mode is 'ignore'. Erroneous 1x links will not be activated.
Notes
When set to 'off', all links come up normally. When set to 'ignore', links that only come
up at 1x (when they were enabled for a higher rate) are forced down. These downed
ports can be queried to aid debugging errors in the fabric. The subnet manager must
be running to display this information.
2.5.5.41smTrapThreshold
Display the port auto-disable urgent trap threshold value (in minutes).
Syntax
smTrapThreshold
July 2015Reference Guide
Order Number: G91931004US73
True Scale Fabric Switches 12000 Series CLI
Options
None.
Sample Output
-> smTrapThreshold
Trap Threshold is 0 (disabled).
-> smTrapThreshold 20
-> smTrapThreshold
Trap Threshold is 20 traps/minute.
Notes
When enabled, ports generating urgent traps at a rate higher than the threshold will be
disabled. This value can range from 10 to 100 traps/minute. Set the value to 0 to
disable this feature. The subnet manager must be running to display this information.
2.5.5.42smAppearanceMsgThresh
12000 Series CLI
Displays the threshold for appearance and disappearance messages.
Syntax
smAppearanceMsgThresh
Options
None.
Sample Output
-> smAppearanceMsgThresh
Message Threshold is 0 (disabled).
-> smAppearanceMsgThresh 3
-> smAppearanceMsgThresh
Message Threshold is 3 messages/sweep.
Notes
This command sets the threshold for the number of fabric appearance and
disappearance log messages that may be logged as NOTICEs per sweep by the SM. A
value of zero causes all such messages to be logged at the NOTICE level. A value
greater than zero will cause the priority of any subsequent messages to be logged at
the INFO priority. The subnet manager must be running to display this information.
Allows the user to set/display whether the performance manager and baseboard
manager starts along with the subnet manager.
Syntax
smPmBmStart [enable] [disable]
Options
enable – Enable the start of the PM and BM at SM start-up.
disable – Disable the start of the PM and BM at SM start-up.
Sample Output
-> smPmBmStart
SM is enabled
PM is enabled
BM is enabled
FE is enabled
-> smPmBmStart disable
SM is enabled
PM is disabled
BM is disabled
FE is enabled
2.5.5.44smShowRemovedPorts
Displays the ports that have been automatically removed from the fabric.
Syntax
smShowRemovedPorts
Options
None.
Sample Output
-> smShowRemovedPorts
Disabled Ports:
Node 0x00066a0007000001: QLgoic 12300 GUID=0x00066a00da000001 Leaf 1, Chip A
Port 12: Trap Threshold Exceeded
Port 23: 1x Link Width
July 2015Reference Guide
Order Number: G91931004US75
True Scale Fabric Switches 12000 Series CLI
Notes
This displays ports that have been removed from the fabric automatically by the SM,
such as when a 1x link mode is set to 'ignore' or when a port has exceeded its urgent
trap threshold. This command is not available unless the subnet manager is in Master
mode.
2.5.5.45smShowCounters
Display various statistics and counters maintained by the subnet manager.
Displays various statistics and counters about the performance manager (PM).
Syntax
pmShowCounters
Options
None.
Sample Output
-> pmShowCounters
2.5.5.48pmResetCounters
Resets various statistics and counters about the performance manager (PM).
Syntax
pmResetCounters
Options
None.
Sample Output
-> pmResetCounters
2.5.5.49pmShowRunningTotals
Displays Running Total Counters for the Performance Manager (PM) for all ports in a
fabric.
Syntax
pmShowRunningTotals
Options
None.
Sample Output
-> pmShowRunningTotals
July 2015Reference Guide
Order Number: G91931004US77
True Scale Fabric Switches 12000 Series CLI
2.5.5.50bmPriority
Displays the priority of the embedded baseboard manager.
Syntax
bmPriority
Options
None.
Sample Output
-> bmPriority
The BM Priority is 0
The BM Elevated Priority is disabled
Notes
The priority of the Baseboard Manager (BM) determines which BM will become the
master BM for the fabric. The priority values are 0 (lowest) and 15 (highest). The BM
with the highest priority becomes the master BM for the fabric. The elevated priority
value determines what the priority of the BM will be if it becomes Master. This allows
persistent failovers that do not automatically fail back by configuring the elevated
priority to be higher than all normal priorities. This feature is effectively disabled when
set to the default of zero. The subnet manager must be running to display the priority.
12000 Series CLI
2.5.5.51pmPriority
Display the priority of the embedded performane manager.
Syntax
pmPriority
Options
None.
Sample Output
-> pmPriority
The PM Priority is 0
The PM Elevated Priority is disabled
Notes
The priority of the Performance Manager (PM) determines which PM will become the
master PM for the fabric. The priority values are 0 (lowest) and 15 (highest). The PM
with the highest priority becomes the master PM for the fabric. The elevated priority
value determines what the priority of the PM will be if it becomes Master. This allows
persistent failovers that do not automatically fail back by configuring the elevated
priority to be higher than all normal priorities. This feature is effectively disabled when
set to the default of zero. The subnet manager must be running to display the priority.
Restore normal priorities from elevated states for the SM, BM, and PM.
Syntax
smRestorePriority [sm | bm | pm | all]
Options
sm – Restore normal SM priority
bm – Restore normal BM priority
pm – Restore normal PM priority
all – Restore normal priorities for the SM, BM and PM.
Sample Output
-> smRestorePriority
Notes
This command restores the normal priorities of various subnet managers after they
have elevated their priority following a failover. Issuing this command allows the
'unsticking' of a sticky failover. Issuing this command without arguments will restore
the normal priorities of the SM, BM, and PM.
2.5.5.53smResetConfig
Resets the XML configuration for the embedded subnet manager (ESM) to factory
defaults. This command is only available on the Master chassis management card.
Syntax
smResetConfig [-noprompt]
Options
-noprompt – proceed with a configuration reset without a confirmation prompt.
Sample Output
-> smResetConfig
Proceed with configuration reset? [N] y
Default XML configuration file has been generated.
-infoOnly – Displays the timestamp for the XML configuration file.
July 2015Reference Guide
Order Number: G91931004US79
True Scale Fabric Switches 12000 Series CLI
12000 Series CLI
-contentOnly – Displays the contents of the XML configuration file.
-noprompt – Do not prompt to 'Continue' for each page of displayed output.
Sample Output
-> smShowConfig
<!-- Common FM configuration, applies to all FM instances/subnets -->
<Common>
<!-- Various sets of Applications which may be used in Virtual Fabrics -->
<!-- Applications defined here are available for use in all FM instances. -->
<!-- Additional Applications may be defined here or per FM instance. -->
<!-- Applications specified per FM instance will add to -->
<!-- instead of replace these Application definitions. -->
<Applications>
<!-- Each Application can have one or more ServiceIDs and/or MGIDs. -->
<!-- These will be matched against PathRecord and Multicast SA queries -->
<!-- so that the returned SLID/DLID, PKey, SL, etc are appropriate for -->
<!-- the Virtual Fabric(VF) which contains the application(s). -->
<!-- Every Application must have a unique <Name> -->
<!-- The name must be unique among all Application names within an -->
<!-- FM instance. -->
<!-- When defined at Common level must be unique within all instances. -->
<!-- The name is limited to 64 characters and is case sensitive. -->
<!-- ServiceIDs are 64 bit values which identify applications within the -->
<!-- PathRecord query and are typically used within the InfiniBand -->
<!-- Communication Manager (CM) protocol to identify the application for -->
Continue? [Y]
...
Notes
With no arguments, the XML configuration file timestamp and contents will be
displayed, one screen at a time. Enter Y or Enter at the prompt to continue displaying
command output. Enter N at the prompt to terminate the output. The -infoOnly and contentOnly flags will limit the information displayed. Use the -noprompt flag to send
all output to the screen at once.This command is only available on the Master Chassis
management card.
<packets> – The number of 256 byte packets used when starting the SM Loop Test.
Valid values are 0-10.
Sample Output
-> XEdge-> smLooptestStart
Waiting for SM to complete startup....N|2011/09/15 14:24:17.180U: Thread "esm_top"
(0xccace3f0)
MSG:NOTICE|SM:Intel 12200 GUID=0x00066a00e30027xx:port 0|COND:#5 SM state
to master|NODE:Intel 12200 GUID=0x00066a00e3002711:port
0:0x00066a00e3002711|DETAIL:transition from DISCOVERING to MASTER
MSG:WARNING|SM:Intel 12200 GUID=0x00066a00e30027xx:port 0|COND:#1
Redundancy lost|NODE:Intel 12200 GUID=0x00066a00e30027xx:port
0:0x00066a00e3002711|DETAIL:SM redundancy not available
topology_loopTest: DONE
..................done
The SM Loop Test is being started
Loop Test is setup, but no packets have been injected and no traffic is running
Notes
Use this command to start the SM Loop Test with the specified number of 256-byte
packets. Valid values for the number of packets are 0-to-10 (default=0). If the number
of packets is 0, then no packets will be injected. If the SM has not been previously
started, this command will start the SM. Note that the Loop Test will only function if the
SM is in the Master state.
2.5.5.56smLooptestFastModeStart
Starts the SM Loop Test in fast mode.
Syntax
smLooptestFastModeStart [<packets>]
Options
<packets> – The number of 256-byte packets used when starting the SM Loop Test
in Fast Mode. Valid values are 0-to-10.
Sample Output
-> XEdge-> smLooptestFastModeStart
Waiting for SM to complete startup...Local LID changed to: 0
MSG:WARNING|SM:Intel 12200 GUID=0x00066a00e30027xx:port 0|COND:#1
Redundancy lost|NODE:Intel 12200 GUID=0x00066a00e3002711:port
0:0x00066a00e3002711|DETAIL:SM redundancy not available
topology_loopTest: DONE
..................done
The SM Loop Test is being started in Fast Mode
Notes
Use this command to start the SM Loop Test in Fast Mode with the specified number of
256-byte packets. Valid values for the number of packets are 0-to-10. The default is
four (that is, if the command is executed without any stated packets, it will start up and
inject 4 packets). If the number of packets is 0, then no packets will be injected. If the
SM has not been previously started, this command will start the SM. Note that the Loop
Test will only function if the SM is in the Master state.
2.5.5.57smLooptestStop
Stops the SM Loop Test.
Syntax
smLooptestStop
Options
None.
Sample Output
-> XEdge-> smLooptestStop
Waiting for SM to complete shutdownA|2011/09/15 14:21:46.500U: Thread "esm_Start"
(0x85738dd8)
ESM: SM Control: Initiating shutdown of the subnet manager. Some errors and
warnings are common during this process 0
MSG:NOTICE|SM:Intel 12200 GUID=0x00066a00e3002711:port 0|COND:#13 SM state
to inactive|NODE:Intel 12200 GUID=0x00066a00e3002711:port
0:0x00066a00e3002711|DETAIL:transition from MASTER to NOTACTIVE
Use this command to set the minimum number of loops (default=4) to include each ISL
for the SM Loop Test in Fast Mode. This command is only applicable if running the Loop
Test in Fast Mode.
2.5.5.63smLooptestShowLoopPaths
Displays the loop paths for the SM Loop Test.
Syntax
smLooptestShowLoopPaths [<node index>]
Options
<node index> – The node index of the node to print the loop paths.
This is an interactive command to configure log settings. This involves setting the log
levels that are active.
Definitions
July 2015Reference Guide
Order Number: G91931004US91
True Scale Fabric Switches 12000 Series CLI
• Preset: Enable or disable each log level that may be generated on the system. The
log presets act as a general filter. For example, if the Info logging level is disabled
in the presets, no Info messages will be shown on any output device, regardless of
Info log setting for a device.
• Device: Enable a device to display or process log messages of each level. The level
must also be active in Preset for log messages to be processed for a device.
• Syslog: Configure the syslog host ip address and port.
2.5.6.4logResetToDefaults
Restores the log file default settings.
Syntax
logResetToDefaults [-noprompt]
Options
-noprompt – Restore the defaults without prompting the user.
-h ip_address – Sets the host IP address in dotted decimal format
(xxx.xxx.xxx.xxx).
-p port – The host port number on which the syslog server is listening.
-f facility – The syslog facility to use in the messages.
-m mode – Determines whether the syslog is to be put into a special OEM mode.
Sample Output
-> logSyslogConfig -h 172.26.0.202
Successfully configured the syslog host
Notes
If configured the device can forward its log messages to a syslog host. This command
allows a user to configure the host and port to send messages to and the facility to use
in the messages. The facility value assignments are:
After entering this command a list of available keys will be displayed. The keys are
shown along with an associated number. At the prompt, enter the number of the key
you wish to remove.
• LinkWidth - The currently active link width on this port.
• LinkSpeed - The currently active link speed on this port. Port speed is LinkWidth *
LinkSpeed.
• SymblErrors - The number of times a 8B10B encoding violation, or a disparity
violation was detected. If multiple errors are detected simultaneously (in more than
one lane), the counter only increments by one.
• ErrRecovery - The number of times the link error recovery proccess happened
successfully.
• LinkDowned - The number of times the link error recovery process failed.
• RcvErrors - Number of errors received on the port.
• RmtPhysErr - Number of remote physical errors received on the port.
• TxDiscards - Number of port transmit discards.
• InPKeyViol - Number of times PKey inbound invalid.
• OutPKeyViol - Number of times PKey outbound invalid.
• InRawViol - Number of times raw inbound packet discarded.
• OutRawViol - Number of times raw outbound packet was discarded.
• LLIntegrity - Number of local link integrity errors.
• ExcesBufOvr - Number of excessive buffer overrun errors.
The -leaf and -spine options are only available on platforms with removable leaf and
spine modules.
ismPortStats will not return meaningful information until three things have occurred
1) The SM has configured a LID for the switches in the chassis
2) The chassis software has discovered that the switches have been assigned a LID and
has polled for port statistic information.
3) The management leaf is down or not installed.
July 2015Reference Guide
Order Number: G91931004US97
True Scale Fabric Switches 12000 Series CLI
2.5.8.2ismPortCounters
Displays a table comparision of transmit, receive and error counters cooresponding to
each port of the module.
• SymblErrors - The number of 8B10B encoding or disparity violations.
• ErrRecovery - The number of link error recovery proccess successes.
• LinkDowned - The number of link error recovery process failures.
• RcvErrors - Number of errors received on the port.
• RmtPhysErr - Number of remote physical errors received on the port.
• TxDiscards - Number of port transmit discards.
• InPKeyViol - Number of times PKey inbound invalid.
• OutPKeyViol - Number of times PKey outbound invalid.
• InRawViol - Number of times raw inbound packet discarded.
• OutRawViol - Number of times raw outbound packet was discarded.
• LLIntegrity - Number of local link integrity errors.
• ExcesBufOvr - Number of excessive buffer overrun errors.
The user is prompted to continue the output after each group of 24 ports are displayed.
This command is best displayed with a terminal width of at least 120 columns.
2.5.8.3ismLinearFwdb
Displays the entries in the linear forwarding table. LIDs and a cooresponding port are
shown. A packet addressed to a LID will be forwared to the cooresonding port listed in
the displayed table.
Syntax
ismLinearFwdb [switch]
Options
switch – switch number.
Sample Output
-> ismLinearFwdb
Switch Leaf 101 Linear Fwdb (LFTTOP = 0x27):
LID :: Port
0001 18 (L101P18)
0003 22 (L101P22S105BP15)
0004 21 (L101P21S105AP21)
0005 21 (L101P21S105AP21)
0006 21 (L101P21S105AP21)
0009 19 (L101P19S105BP18)
0014 0 ( )
001a 21 (L101P21S105AP21)
0027 20 (L101P20S105BP17)
Switch Leaf 102 Linear Fwdb (LFTTOP = 0x27):
LID :: Port
July 2015Reference Guide
Order Number: G91931004US99
True Scale Fabric Switches 12000 Series CLI
0001 19 (L102P19S105BP36)
0003 21 (L102P21S105BP34)
0004 25 (L102P25S105AP07)
0005 21 (L102P21S105BP34)
0006 21 (L102P21S105BP34)
0009 20 (L102P20S105BP35)
0014 21 (L102P21S105BP34)
001a 0 ( )
0027 15 (L102P15)
...
Notes
The 'set' option is not available on the Intel
2.5.8.4ismMultiFwdb
Displays the Multicast Forwarding database for the switch.