Supermicro SSH-C48Q User manual

SSH-C48Q
Top-of-Rack Omni-Path Switch
CLI User’s Guide
Revison 1.0

ii
The information in this User’s Manual has been carefully reviewed and is believed to be accurate. The
vendor assumes no responsibility for any inaccuracies that may be contained in this document, makes no
commitment to update or to keep current the information in this manual, or to notify any person or
organization of the updates. Please Note: For the most up-to-date version of this manual, please see
our web site at www.supermicro.com.
Super Micro Computer, Inc. ("Supermicro") reserves the right to make changes to the product described
in this manual at any time and without notice. This product, including software and documentation, is the
property of Supermicro and/or its licensors, and is supplied only under a license. Any use or reproduction
of this product is not allowed, except as expressly permitted by the terms of said license.
IN NO EVENT WILL SUPERMICRO BE LIABLE FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL,
SPECULATIVE OR CONSEQUENTIAL DAMAGES ARISING FROM THE USE OR INABILITY TO USE
THIS PRODUCT OR DOCUMENTATION, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES. IN PARTICULAR, SUPERMICRO SHALL NOT HAVE LIABILITY FOR ANY HARDWARE,
SOFTWARE, OR DATA STORED OR USED WITH THE PRODUCT, INCLUDING THE COSTS OF
REPAIRING, REPLACING, INTEGRATING, INSTALLING OR RECOVERING SUCH HARDWARE,
SOFTWARE, OR DATA.
Any disputes arising between manufacturer and customer shall be governed by the laws of Santa Clara
County in the State of California, USA. The State of California, County of Santa Clara shall be the
exclusive venue for the resolution of any such disputes. Super Micro's total liability for all claims will not
exceed the price paid for the hardware product.
FCC Statement: This equipment has been tested and found to comply with the limits for a Class A digital
device pursuant to Part 15 of the FCC Rules. These limits are designed to provide reasonable protection
against harmful interference when the equipment is operated in a commercial environment. This
equipment generates, uses, and can radiate radio frequency energy and, if not installed and used in
accordance with the manufacturer’s instruction manual, may cause harmful interference with radio
communications. Operation of this equipment in a residential area is likely to cause harmful interference,
in which case you will be required to correct the interference at your own expense.
California Best Management Practices Regulations for Perchlorate Materials: This Perchlorate warning
applies only to products containing CR (Manganese Dioxide) Lithium coin cells. “Perchlorate
Material-special handling may apply. See www.dtsc.ca.gov/hazardouswaste/perchlorate”
WARNING: HANDLING OF LEAD SOLDER MATERIALS USED IN THIS
PRODUCT MAY EXPOSE YOU TO LEAD, A CHEMICAL KNOWN TO
THE STATE OF CALIFORNIA TO CAUSE BIRTH DEFECTS AND
OTHER REPRODUCTIVE HARM.
SSH-C48Q CLI User’s Guide
Release Date: February 5, 2016
Unless you request and receive written permission from Super Micro Computer, Inc., you may not copy
any part of this document.
Information in this document is subject to change without notice. Other products and companies referred
to herein are trademarks or registered trademarks of their respective companies or mark holders.
Copyright © 2016 by Super Micro Computer, Inc.
All rights reserved.
Printed in the United States of America

iii
Preface
This manual is part of the documentation set for the Intel®Omni-Path
Fabric (Intel®OP Fabric), which is an end-to-end solution consisting
of adapters, edge switches, director switches and fabric management
and development tools.
The Intel®OP Fabric delivers a platform for the next generation of
High-Performance Computing (HPC) systems that is designed to
cost-effectively meet the scale, density, and reliability requirements of
large-scale HPC clusters.
Both the Intel®OP Fabric and standard InfiniBand* are able to send
Internet Protocol (IP) traffic over the fabric, or IPoFabric. In this
document, however, it is referred to as IP over IB or IPoIB. From a
software point of view, IPoFabric and IPoIB behave the same way
and, in fact, use the same ib_ipoib driver to send IP traffic over the
ib0 and/or ib1 ports.

SSH-C48Q Switch CLI User’s Guide
iv
Intended Audience
The intended audience for the Intel®Omni-Path (Intel®OP)
document set is network administrators and other qualified personnel.
Documentation Conventions
This guide uses the following documentation conventions:
•Note: provides additional information.
•Caution: indicates the presence of ahazard that has the potential
of causing damage to data or equipment.
•Warning:indicates thepresenceofahazardthathas thepotential
of causing personal injury.
• Text in blue font indicates a hyperlink (jump) to a figure, table, or
section in this guide. Links to Web sites are also shown in blue.
For example:
See License Agreements for more information.
For more information, visit www.supermicro.com.
•Textinboldfontindicates userinterfaceelementssuchas amenu
items, buttons, check boxes, or column headings. For example:
Click the Start button, point to Programs, point to Accessories,
and then click Command Prompt.
•TextinCourier font indicates a file name, directory path, or
command line text. For example:
Enter the following command: sh ./install.bin
• Key names and key strokes are shown in underlined bold upper-
case letters. For example:
Press CTRL+P and then press the UP ARROW key.
•Textinitalics indicates terms, emphasis, variables, or document
titles.

v
Table of Contents
Preface ..................................................iii
Intended Audience ...............................................iv
Documentation Conventions ....................................... iv
Introduction ...........................................1
CLI Overview ....................................................... 1
Commands and Functional Groups ...................... 3
Online Help .......................................................... 5
Keyboard Shortcuts .............................................. 6
Accessing the CLI ................................................ 6
Standardized Warning Statements .....9
Warning Definition .......................................................9
Installation Instructions ...............................................11
Circuit Breaker ............................................................12
Power Disconnection Warning ...................................14
Equipment Installation ................................................16
Restricted Area ...........................................................17
Battery Handling .........................................................18
Redundant Power Supplies .........................................20

SSH-C48Q Switch CLI User’s Guide
vi
Backplane Voltage ......................................................21
Comply with Local and National Electrical Codes ....22
Product Disposal .........................................................23
Hot Swap Fan Warning ...............................................24
Power Cable and AC Adapter ....................................26
Groups and Commands ......................29
General ............................................................... 29
help ..............................................................................29
list ................................................................................31
history .........................................................................32
reboot ..........................................................................33
killCliSession ..............................................................34
who ..............................................................................34
broadcast .....................................................................35
swapBsDel ..................................................................36
setTermWidth .............................................................36
getTermWidth .............................................................37
prompt .........................................................................37
case ..............................................................................38
showLastRetCode .......................................................38
echo .............................................................................39
logout ..........................................................................39

vii
Table of Contents
user ..............................................................................39
passwd .........................................................................40
userAdd .......................................................................40
userRem ......................................................................41
userListShow ..............................................................42
sshKey .........................................................................42
loginMode ...................................................................43
setldapSvrIpAddr ........................................................44
setldapSvrPort .............................................................44
idleTimeoutGet ...........................................................45
idleTimeoutSet ............................................................45
sessionTimeoutDisable ...............................................46
sessionTimeoutEnable ................................................46
loginMsgGet ...............................................................47
loginMsgSet ................................................................47
loginNameGet .............................................................48
loginNameSet ..............................................................48
serialAuthGet ..............................................................49
serialAuthSet ...............................................................49
uiConfig ......................................................................50
genPost ........................................................................52
exit ..............................................................................53
Chassis ................................................................ 54

SSH-C48Q Switch CLI User’s Guide
viii
hwCheck .....................................................................54
hwMonitor ..................................................................56
showNodeDesc ...........................................................60
setNodeDesc ...............................................................60
setNodeDescFormat ....................................................60
fruInfo .........................................................................61
chassisQuery ...............................................................63
showInventory ............................................................64
setBeacon ....................................................................65
setSystemContact ........................................................66
setSystemName ...........................................................66
setSystemLocation ......................................................67
Network .............................................................. 67
ifShow .........................................................................67
routeShow ...................................................................68
ping .............................................................................69
ping6 ...........................................................................71
showChassisIpAddr ....................................................71
setChassisIpAddr ........................................................72
setChassisIpv6Addr ....................................................72
delChassisIpv6Addr ....................................................73
showChassisIpv6Addr ................................................73
autoConfIPv6Enable ...................................................74

ix
Table of Contents
autoConfIPv6Disable ..................................................74
autoConfIPv6Disable ..................................................74
autoConfIPv6Show .....................................................75
ndpShow .....................................................................75
showDefaultRoute ......................................................76
setDefaultRoute ..........................................................76
arpShow ......................................................................77
hostShow .....................................................................77
dhcpEnable ..................................................................78
dhcpDisable ................................................................78
dhcpShow ....................................................................78
dnsParamsShow ..........................................................79
dnsParamsSet ..............................................................79
IpoStlConfigShow ......................................................80
IpoStlConfigEnable ....................................................81
IpoStlConfigDisable ...................................................81
IpoStlAddressShow ....................................................81
IpoStlAddressSet ........................................................82
IpoStlAddressSetIPv6 .................................................82
IpoStlAddressShowIPv6 .............................................83
Firmware ............................................................. 84
fwUpdate .....................................................................84
fwUpdateSlot ..............................................................85

SSH-C48Q Switch CLI User’s Guide
x
fwUpdateChassis ........................................................86
fwListFiles ..................................................................87
fwShowUpdateParams ................................................88
fwSetUpdateParams ....................................................88
showCapability ...........................................................89
showLastScpRetCode .................................................90
fwVersion ....................................................................90
bootQuery ...................................................................91
bootSelect ....................................................................91
Fabric Management ............................................ 93
pmResetCounters ........................................................93
pmShowCounters ........................................................93
pmShowRunningTotals ..............................................95
smAdaptiveRouting ....................................................95
smControl ....................................................................96
smConfig .....................................................................96
smPKeys .....................................................................97
smForceSweep ............................................................98
smResetCounters ........................................................98
smRestorePriority .......................................................98
smLogLevel ................................................................99
smLogMode ..............................................................100
smLogMask ..............................................................101

xi
Table of Contents
smPmStart .................................................................102
smShowConfig ..........................................................103
smShowLids ..............................................................104
smShowMcMember ..................................................105
smShowServices .......................................................106
smShowInform ..........................................................106
smShowCounters ......................................................107
smShowLidMap ........................................................108
smShowTopology .....................................................109
smShowVFInfo .........................................................110
smLooptestStart ........................................................110
smLooptestFastModeStart ........................................110
smLooptestStop ........................................................111
smLooptestInjectPackets ..........................................112
smLooptestInjectAtNode ..........................................112
smLooptestInjectEachSweep ....................................113
smLooptestPathLength .............................................113
smLooptestMinISLRedundancy ...............................114
smLooptestShowLoopPaths ......................................114
smLooptestShowSwitchLft .......................................115
smLooptestShowTopology .......................................116
smLooptestShowConfig ............................................119

SSH-C48Q Switch CLI User’s Guide
xii
Log .................................................................... 120
logShow ....................................................................120
logClear .....................................................................121
logConfigure .............................................................122
logResetToDefaults ..................................................123
logSyslogConfig .......................................................124
logShowConfig .........................................................127
logSyslogTest ............................................................128
Interconnect Switch Management (ISM) ......... 129
ismPortStats ..............................................................129
ismPortCounters ........................................................131
ismLinearFwdb .........................................................134
ismMultiFwdb ...........................................................134
ismSwitchInfoLid .....................................................137
ismPortStatLid ..........................................................137
ismPortInfoLid ..........................................................137
ismNodeInfoLid ........................................................138
ismPortSetWidth .......................................................138
ismChassisSetWidth .................................................141
ismModuleSetWidth .................................................143
ismIslSetWidth ..........................................................145
ismPortSetLWDS ......................................................147
ismChassisSetLWDS ................................................149

xiii
Table of Contents
ismModuleSetLWDS ................................................152
ismIslSetLWDS ........................................................154
ismPortSetFmEnabled ..............................................156
ismChassisSetFmEnabled .........................................157
ismPortSetCrcMode ..................................................158
ismChassisSetCrcMode ............................................160
ismModuleSetCrcMode ............................................162
ismIslSetCrcMode ....................................................163
ismPortSetVCU ........................................................164
ismChassisSetVCU ...................................................166
ismModuleSetVCU ...................................................166
ismIslSetVCU ...........................................................167
ismChassisSetMtu .....................................................168
ismModuleSetMtu ....................................................170
ismPortEnable ...........................................................172
ismChassisSetEnable ................................................172
ismModuleSetEnable ................................................173
ismPortDisable ..........................................................174
ismChassisSetSpeed ..................................................175
ismModuleSetSpeed .................................................175
ismIslSetSpeed ..........................................................176
ismPortSetSpeed .......................................................177
ismPortSetBeacon .....................................................178

SSH-C48Q Switch CLI User’s Guide
xiv
ismPortQsfpInfo ........................................................179
ismChassisBounce ....................................................182
ismModuleBounce ....................................................182
ismIslBounce ............................................................182
ismPortBounce ..........................................................183
ismRemoveStateDump .............................................183
ismShowStateDump ..................................................184
ismTakeStateDump ...................................................184
ismShowArConfig ....................................................185
ismShowArMoves ....................................................185
Time Management ............................................ 186
time ...........................................................................186
timeZoneConf ...........................................................187
timeDSTConf ............................................................188
timeNtpTimeout ........................................................192
timeNtpRefreshTime ................................................193
SNMP ............................................................... 194
snmpCommunityConf ...............................................194
snmpTargetAddr .......................................................194
snmpTargetParams ....................................................197
snmpNotifyProfile ....................................................198
snmpNotifyFilter .......................................................199

xv
Table of Contents
snmpNotify ...............................................................199
snmpSystem ..............................................................200
snmpUsrSec ..............................................................201
CaptureInfo ....................................................... 203
capture .......................................................................203
showAllConfig ..........................................................203
captureFw ..................................................................204
captureSm .................................................................204
captureIsm .................................................................204
captureChassis ..........................................................205
captureNetwork .........................................................205
captureLog ................................................................205
captureMisc ...............................................................206
captureSnmp .............................................................206
captureShell ..............................................................206

xvi
Notes

1
Introduction
This manual describes the command line interface (CLI) task
information for the Supermicro SSH-C48Q Switch family.
This manual is organized as follows:
• This section provides an overview of the CLI, including the
command groups, online help, and keyboard shortcuts.
• Groups and Commands describes the CLI commands.
CLI Overview
This section details the usage of the Command Line Interface (CLI)
feature for the Supermicro SSH-C48Q Switch family. The CLI allows
you to perform remote configuration and management tasks that
mirror the functionality of the Intel®Omni-Path Fabric Chassis Viewer
GUI.
The CLI is accessed via a terminal attached to the USB port or via the
OOB (out of band) management port using Telnet and secure shell
(SSH).
Accessing the CLI through the serial port does not require a login and
password (unless configured to do so) and defaults to administrator
privileges. Using the serial port allows permanent access to the
switch, even if Telnet and SSH are not functioning.
For a standalone switch, you can 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 are
required. There are two user modes, operator and administrator, with
the following access privileges:

SSH-C48Q Switch CLI User’s Guide
2
Operator:
• Read only access.
Administrator:
• Read and write access.
• Reboot access.
• Change operator and administrator passwords.
• Disable user login and passwords, which allows all users adminis-
trator-level access without the need for a user name or password.
• View all current user sessions.
• Access all of the commands executed from any open operator
session.
• Log out any open user sessions.
• Send messages to the open user sessions.
The CLI allows multiple users to be logged in simultaneously.
However, some commands are locked to a user(s) if another user
is executing the same command.

3
Introduction
Commands and Functional Groups
The CLI commands are grouped into functional areas as shown in the
following table.
Type list -noprompt to display the list of command groups.
Table 1: Command Groups
Group Description
General General
General commands for user management and CLI
configuration.
Chassis Chassis
Chassis management commands, such as FRU info, fan/power
supply state, and others.
Network Network
Ethernet interface management commands.
Firmware Firmware
Commands that display or modify firmware revision levels.
Fm Fabric Management
Commands used for Subnet Manager (SM), Subnet
Administration (SA), Performance Manager (PM), and Fabric
Executive (FE) configuration and operation.
Log Log
Commands for viewing log files as well as configuring logging
parameters.
Ism Interconnect Switch Management (ISM)
Port configuration and statistics commands.
Tm Time Management
Commands for retrieving and setting the current system time,
setting the time zone, and setting daylight saving time
parameters.

SSH-C48Q Switch CLI User’s Guide
4
To list commands within a functional group, simply type the functional
group name. For example, to list all of the firmware commands, type
list Firmware. The system displays information similar to the
following:
-> list firmware
fwUpdate Used to update firmware.
fwListFiles Used to display the set of
files in the firmware ramdisk.
fwShowUpdateParams Used to display the firmware
default update parameters.
fwSetUpdateParams Used to configure firmware
default update parameters.
showCapability Used to display the
capabilities/features.
showLastScpRetCode Used to display the return
code from the last SCP Firmware or
XML Config Push.
fwVersion Used to display the firmware
revisions.
bootQuery Used to display firmware boot
image information.
bootSelect Used to modify the boot
selection.
Snmp SNMP
Commands for configuring trap destinations and security
parameters required to access the switch from an SNMP
manager.
CaptureInfo CaptureInfo
Analysis and debugging commands for capturing
switch-specific information.
Group Description