Mellanox Technologies Mellanox SX1018 Operating manual

www.mellanox.com
Mellanox MLNX-OS®
Command Reference Guide for SX1018HP
Ethernet Managed Blade Switch
Rev 1.6.9
Software Version 3.3.4100
Mellanox® Technologies Confidential

Document Number: 3454
Rev 1.6.9
Mellanox Technologies
2
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 3
Table of Contents
Table of Contents . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Document Revision History . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
About this Manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Chapter 1 Using the Command Line Interface . . . . . . . . . . . . . . . . . . . . . 18
1.1 CLI Modes - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 18
1.2 Syntax Conventions - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19
1.3 Getting Help - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 19
1.4 Prompt and Response Conventions- - - - - - - - - - - - - - - - - - - - - - - - 20
1.5 User Roles (Capabilities) - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21
1.6 Using the Negation Form - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 21
1.7 Parameter Key - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 23
Chapter 2 System Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
2.1 Management Interfaces - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 24
2.1.1 Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
interface vlan create . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
ip address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
duplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
dhcp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
zeroconf. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
ipv6 enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
show interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .42
2.1.2 Hostname Resolution . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
hostname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
ip name-server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
ip domain-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
ip/ipv6 host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
ip/ipv6 map-hostname. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
show hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
2.1.3 Routing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
ip/ipv6 route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
ipv6 default-gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
show ip/ipv6 route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
show ip/ipv6 default-gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
2.1.4 Network to Media Resolution (ARP & NDP) . . . . . . . . . . . . . . . . . . . 54
ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
ip arp timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 4
show ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
ipv6 neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
clear ipv6 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
show ipv6 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
2.1.5 DHCP. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
ip dhcp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
show ip dhcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
2.1.6 General IPv6 Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62
ipv6 enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
2.1.7 IP Diagnostic Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63
ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .63
traceroute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .64
tcpdump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .67
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
2.2 License Keys - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 69
license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
show licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
2.3 NTP, Clock & Time Zones - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 71
clock set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
clock timezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
ntp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
ntpdate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
show clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
show ntp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
2.4 Software Management - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 77
image boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
boot next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
image default-chip-fw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
image delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
image fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
image install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
image move. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
image options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
show bootvar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
show images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
2.5 File Management- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 87
2.5.1 File System. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 87
debug generate dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
file debug-dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .88
file stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
file tcpdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
show files debug-dump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .91
show files stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .92
show files system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
show files tcpdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
2.5.2 Configuration File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 95
configuration audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
configuration copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
configuration delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 5
configuration fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
configuration jump-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
configuration merge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .100
configuration move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
configuration new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
configuration revert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .103
configuration switch-to . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
configuration text fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
configuration text file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
configuration text generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .107
configuration upload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108
write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
show configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .110
show running-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
2.6 Local and Remote Logging - - - - - - - - - - - - - - - - - - - - - - - - - - - - 112
logging local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
logging local override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .113
logging <syslog IP address> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .115
logging receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
logging format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
logging fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .119
logging level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
logging files delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
logging files rotation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .123
logging files upload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
logging monitor. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
show logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
show log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
2.7 Maintenance Tools - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 130
reload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
reset factory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
2.8 mDNS - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 132
ha dns enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
2.9 User Management and AAA - - - - - - - - - - - - - - - - - - - - - - - - - - - 133
2.9.1 User Accounts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 133
username . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .133
show usernames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .135
show users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .136
show whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .137
2.9.2 AAA Methods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
aaa accounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .138
aaa authentication login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .139
aaa authentication attempts track enable. . . . . . . . . . . . . . . . . . . . .140
aaa authentication attempts lockout . . . . . . . . . . . . . . . . . . . . . . . .141
aaa authentication attempts class-override . . . . . . . . . . . . . . . . . . .144
aaa authentication attempts reset . . . . . . . . . . . . . . . . . . . . . . . . . .145
clear aaa authentication attempts . . . . . . . . . . . . . . . . . . . . . . . . . .146
aaa authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
show aaa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 6
show aaa authentication attempts . . . . . . . . . . . . . . . . . . . . . . . . . .150
2.9.3 RADIUS. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
radius-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .151
radius-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
show radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
2.9.4 TACACS+ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
tacacs-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154
tacacs-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
show tacacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .157
2.9.5 LDAP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 158
ldap base-dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
ldap bind-dn/bind-password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
ldap group-attribute/group-dn. . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
ldap host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
ldap login-attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .162
ldap port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
ldap referrals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
ldap scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
ldap ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
ldap timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
ldap version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
show ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
2.10 Cryptographic (X.509, IPSec) - - - - - - - - - - - - - - - - - - - - - - - - - 171
crypto ipsec peer local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
crypto certificate ca-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
crypto certificate default-cert . . . . . . . . . . . . . . . . . . . . . . . . . . . . .175
crypto certificate generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176
crypto certificate name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
crypto certificate system-self-signed . . . . . . . . . . . . . . . . . . . . . . .179
show crypto certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
show crypto ipsec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .182
2.11 CLI Session - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 183
cli clear-history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
cli default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
cli session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
show cli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
2.12 Banner - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 189
banner login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .189
banner login-local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
banner login-remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
banner motd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
show banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
2.13 SSH- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 194
ssh server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194
ssh server host-key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .195
ssh server listen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .197
ssh server min-version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .198
ssh server ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199
ssh server x11-forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 7
ssh client global. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .201
ssh client user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
slogin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204
show ssh client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
show ssh server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
2.14 Remote Login - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 207
telnet-server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
show telnet-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
2.15 XML Gateway - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 209
xml-gw enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .209
show xml-gw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
2.16 Web Server- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 211
web auto-logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .211
web client cert-verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .212
web client ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
web enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
web http. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .215
web httpd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
web https . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
web session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
web proxy auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .221
web proxy host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .223
show web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
2.17 SNMP - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 225
snmp-server auto-refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
snmp-server community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
snmp-server contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .227
snmp-server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
snmp-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .229
snmp-server listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .231
snmp-server location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
snmp-server notify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .233
snmp-server port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
snmp-server user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .235
show snmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
show snmp auto-refresh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
2.18 Scheduled Jobs - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 238
job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .240
enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241
execute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .242
fail-continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .243
name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244
schedule type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245
schedule <recurrence type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
show jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .247
2.19 Event Notification - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 248
email autosupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 8
email autosupport ssl mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .249
email autosupport ssl cert-verify. . . . . . . . . . . . . . . . . . . . . . . . . . .250
email autosupport ssl ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .251
email dead-letter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252
email domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253
email mailhub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
email mailhub-port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
email notify event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
email notify recipient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
email return-addr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
email return-host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .259
email send-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .260
email ssl mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .261
email ssl cert-verify. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262
email ssl ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
show email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .264
2.20 Statistics and Alarms - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 265
stats alarm <alarm-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .265
stats alarm <alarm-id> enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
stats alarm <alarm-id> event-repeat . . . . . . . . . . . . . . . . . . . . . . . .267
stats alarm <alarm-id> {rising | falling} . . . . . . . . . . . . . . . . . . . . .268
stats alarm <alarm-id> rate-limit . . . . . . . . . . . . . . . . . . . . . . . . . .269
stats chd <chd-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270
stats chd <chd-id> enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
stats chd <chd-id> compute time . . . . . . . . . . . . . . . . . . . . . . . . . .272
stats sample <sample-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
stats sample <sample-id> enable . . . . . . . . . . . . . . . . . . . . . . . . . .275
stats sample <sample-id> interval. . . . . . . . . . . . . . . . . . . . . . . . . .276
stats clear-all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
stats export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .278
show stats alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
show stats chd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
show stats cpu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .281
show stats sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .282
2.21 Chassis Management - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 283
health. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .283
power enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .284
usb eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .285
system profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286
show fan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287
show version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288
show inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289
show module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290
show memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291
show asic-version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .292
show power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293
show power consumers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
show temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .295
show voltage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .296
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 9
show health-report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .297
show resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298
show system profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
show system capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300
show system mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .301
show protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
Chapter 3 Ethernet Switching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 304
3.1 Interface- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 304
interface ethernet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
flowcontrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .305
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .306
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .307
description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308
speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .309
load-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
show interfaces ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
show interfaces ethernet [<inf>] capabilities . . . . . . . . . . . . . . . . .313
show interfaces ethernet [<inf>] description . . . . . . . . . . . . . . . . .314
show interfaces ethernet [<inf>] status. . . . . . . . . . . . . . . . . . . . . .315
show interfaces ethernet [<inf>] transceiver . . . . . . . . . . . . . . . . .316
3.1.1 Brake-Out Cables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 317
module-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
3.2 Link Aggregation Group (LAG) and LACP - - - - - - - - - - - - - - - - - 318
interface port-channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318
lacp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .319
lacp system-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320
lacp (interface) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .321
port-channel load-balance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322
channel-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
show lacp system-identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
show lacp counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .325
show lacp interface ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
show lacp interface neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . .327
show lacp interfaces port-channel. . . . . . . . . . . . . . . . . . . . . . . . . .328
show interfaces port-channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . .329
3.3 VLANs - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 330
vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .331
show vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
switchport mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .333
switchport access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .334
switchport {hybrid, trunk} allowed vlan . . . . . . . . . . . . . . . . . . . .335
show interface switchport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .336
3.4 MAC Address Table - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 337
mac-address-table aging-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . .337
mac-address-table static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
clear mac-address-table dynamic . . . . . . . . . . . . . . . . . . . . . . . . . .339
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 10
show mac-address-table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
show mac-address-table aging-time . . . . . . . . . . . . . . . . . . . . . . . .341
3.5 Spanning Tree- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 342
spanning-tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
spanning-tree (timers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
spanning-tree port type (default global) . . . . . . . . . . . . . . . . . . . . .344
spanning-tree priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
spanning-tree port-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
spanning-tree cost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .347
spanning-tree port type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
spanning-tree guard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .349
spanning-tree bpdufilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .350
clear spanning-tree counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .351
show spanning-tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .352
3.6 IGMP Snooping - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 353
ip igmp snooping (admin). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .353
ip igmp snooping (config). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .354
ip igmp snooping fast-leave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .356
ip igmp snooping static-group . . . . . . . . . . . . . . . . . . . . . . . . . . . .357
ip igmp snooping mrouter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .358
ip igmp snooping unregistered multicast . . . . . . . . . . . . . . . . . . . .359
show ip igmp snooping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .360
show ip igmp snooping groups . . . . . . . . . . . . . . . . . . . . . . . . . . . .361
show ip igmp snooping vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .362
show ip igmp snooping mrouter . . . . . . . . . . . . . . . . . . . . . . . . . . .363
show ip igmp snooping interfaces. . . . . . . . . . . . . . . . . . . . . . . . . .364
show ip igmp snooping statistics . . . . . . . . . . . . . . . . . . . . . . . . . .365
3.7 Link Layer Discovery Protocol (LLDP) - - - - - - - - - - - - - - - - - - - 366
lldp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .366
lldp reinit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .367
lldp timer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .368
lldp tx-delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369
lldp tx-hold-multiplier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .370
lldp {receive | transmit} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .371
lldp tlv-select. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .372
show lldp local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .373
show lldp interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .374
show lldp interfaces ethernet <inf> remote . . . . . . . . . . . . . . . . . .375
show lldp timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .376
show lldp statistics global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .377
show lldp statistics [interface ethernet <inf>]. . . . . . . . . . . . . . . . .378
3.8 Quality of Service - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 379
3.8.1 Enhanced Transmission Selection (ETS). . . . . . . . . . . . . . . . . . . . . . 379
dcb ets enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .379
dcb ets tc bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .380
vlan map-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .381
show dcb ets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .382
show dcb ets interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .383
3.8.2 Priority Flow Control (PFC) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 11
dcb priority-flow-control enable . . . . . . . . . . . . . . . . . . . . . . . . . . .385
dcb priority-flow-control priority . . . . . . . . . . . . . . . . . . . . . . . . . .386
dcb priority-flow-control mode on . . . . . . . . . . . . . . . . . . . . . . . . .387
show dcb priority-flow-control. . . . . . . . . . . . . . . . . . . . . . . . . . . .388
3.9 Access Control List (ACL) - - - - - - - - - - - - - - - - - - - - - - - - - - - - 389
ipv4/mac access-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .389
ipv4/mac port access-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .390
deny/permit (MAC ACL rule) . . . . . . . . . . . . . . . . . . . . . . . . . . . .391
deny/permit (IPv4 ACL rule) . . . . . . . . . . . . . . . . . . . . . . . . . . . . .392
deny/permit (IPv4 TCP/UDP ACL rule) . . . . . . . . . . . . . . . . . . . .393
access-list action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .394
vlan-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395
show access-list action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .396
show mac/ipv4 access-lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .397
show mac/ipv4 access-lists summary . . . . . . . . . . . . . . . . . . . . . . .398
3.10 Port Mirroring - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 399
3.10.1 Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 399
monitor session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .399
3.10.2 Config Monitor Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 400
destination interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .400
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401
add source interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .402
header-format . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .403
truncate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .404
congestion . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .405
3.10.3 Show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 406
show monitor session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .406
show monitor session summary . . . . . . . . . . . . . . . . . . . . . . . . . . .407
3.11 sFlow- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 408
3.11.1 Config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
protocol sflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .408
sflow enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409
sflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .410
3.11.2 Config sFlow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 411
sampling-rate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .411
max-sample-size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .412
counter-poll-interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .413
max-datagram-size . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .414
collector-ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .415
agent-ip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .416
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .417
sflow enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .418
3.11.3 Show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 419
show sflow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .419
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 12
Document Revision History
Table 1 - Document Revision History – Ethernet
Document
Revision Date Description
Rev 1.6.9 Aug. 2013 Updated the command “destination interface” on page 400
Rev 1.6.8 Aug. 2013 No Ethernet changes.
Rev 1.6.7 Jul. 2013 Updated the command “file debug-dump”
Updated the command “show interfaces ethernet”
Updated the command “congestion”
Rev 1.6.6 Apr. 2013 Updated the command “ip arp timeout”
Rev 1.6.5 Apr. 2013 Added Section 4.2, “OSPF,” on page 448
Rev 1.6.4 Mar. 2013 Added Section 3.10, “Port Mirroring,” on page 402
Added Section 3.11, “sFlow,” on page 411
Updated the command “show ip route” under IP Routing
Rev 1.6.3 Jan. 2013 Added the command “load-interval”
Added the command “snmp-server auto-refresh”
Updated the output of the command “show interfaces ethernet”
Rev. 1.6.2 Jan. 2013 Added command “banner login-local”
Added command “banner login-remote”
Added “force” option to commands “dcb priority-flow-control mode on”,
“flowcontrol”, and “mtu <size>”
Rev. 1.6.1 Nov. 2012 Updated interface port-channel command with range options
Updated interface ethernet command with range option
Rev. 1.5.4 Sep. 2012 Added “boot next” command
Rev. 1.5.3 Aug. 2012 Removed “ip default-gateway” command
Rev 1.5.2 June 2012 Added command “igmp snooping unregistered multicast”
Update command “switchport access”
Rev 1.5.1 May 2012 Added LLDP commands
Rev 1.5.0 May 2012 Initial version
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 13
About this Manual
This manual provides general information concerning MLNX-OS® Command Line Interface.
Intended Audience
This manual is intended for network administrators who are responsible for configuring and man-
aging Mellanox Technologies’ MLNX-OS Switch Platforms.
Related Documentation
The following table lists the documents referenced in this user’s manual.
All of these documents can be found on the Mellanox website. They are available either through
the product pages or through the support page with a login and password.
Table 2 - Reference Documents
Document Name Description
InfiniBand Architecture Specification, Vol. 1,
Release 1.2.1
The InfiniBand Architecture Specification that is pro-
vided by IBTA.
SwitchX® Hardware Installation Guide Each Mellanox Technologies’ switch platform is
shipped with an Installation Guide document to
bring-up and initialize the switch platform.
SwitchX® Hardware User Manual This document contains hardware descriptions, LED
assignments and hardware specifications among other
things.
Switch Product Release Notes Please look up the relevant SwitchX®-based switch
system/series release note file
MX-OS Software WebUI User’s Manual WebUI user’s manual for MX-OS.
Mellanox MLNX-OS SwitchX Software
User Manual
This document contains information regarding con-
figuring and managing Mellanox Technologies'
SwitchX® Switch Platforms.
Mellanox MLNX-OS Software Configuration
Guide
Configuration Guide for MLNX-OS displaying dif-
ferent configuration scenarios.
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 14
Documentation Conventions
Typographical Conventions
Table 3 - Typographical Conventions
Description Convention Example
File names file.extension
Directory names directory
Commands and their parameters command param1 sx10xx-1 > show hosts
Required item < >
Optional item [ ]
Mutually exclusive parameters {p1, p2, p3} or {p1 | p2 |
p3}
Optional mutually exclusive parame-
ters
[p1 | p2 | p3]
Prompt of a command in Standard
mode
hostname > sx10xx-1 >
Prompt of a command in Enable mode hostname # sx10xx-1 #
Prompt of a command in Config mode hostname (config) # sx10xx-1 (config) #
Comments to explain command
examples
// // This is a comment
Variables for which users supply spe-
cific values
Italic font enable
Emphasized words Italic font These are emphasized words
Note <text> This is a note.
Warning <text> Make sure to connect to the
RS-232 RJ-45 port of the
switch and not to the MGT
port.
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 15
Glossary
Table 4 - Glossary
Term Description
AAA Authentication, Authorization, and Accounting:
• Authentication - verifies user credentials (username and password)
• Authorization - grants or refuses privileges to a user/client for accessing specific
services
• Accounting - tracks network resources consumption by users
ARP Address Resolution Protocol. A protocol that translates IP addresses into
MAC addresses for communication over a local area network (LAN).
BOARD_MONITOR Board temperature sensor for the selected Leaf or Spine module.
CA (Channel Adapter) A device which terminates an Infiniband link, and executes transport level
functions.
CLI Command Line Interface. A user interface in which you type commands at the
prompt.
DCB Data Center Bridging.
DCBX DCBX protocol is an extension of the Link Layer Discovery Protocol
(LLDP). DCBX end points exchange request and acknowledgment messages.
For flexibility, parameters are coded in a type-length-value (TLV) format.
DHCP The Dynamic Host Configuration Protocol (DHCP) is an automatic configura-
tion protocol used on IP networks.
Director Class Switch A high density InfiniBand chassis switch system.
DMA (Direct Memory Access) Allowing Hardware to move data blocks directly to the memory, bypassing
the CPU.
DNS Domain Name System. A hierarchical naming system for devices in a com-
puter network.
Edge Switch A switch system with a 1RU form factor.
ETS ETS provides a common management framework for assignment of band-
width to traffic classes.
Fabric Management The use of a set of tools (APIs) to configure, discover, and manage and a
group of devices organized as a connected fabric.
FTP File Transfer Protocol (FTP) is a standard network protocol used to transfer
files from one host to another over a TCP-based network, such as the Internet.
Gateway A network node that interfaces with another network using a different network
protocol.
GID (Global IDentifier) A 128-bit number used to identify a Port on a network adapter (see below), a
port on a Router, or a Multicast Group.
GUID (Globally Unique IDenti-
fier)
A 64-bit number that uniquely identifies a device or component in a subnet.
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 16
HA (High Availability) A system design protocol that provides redundancy of system components,
thus enables overcoming single or multiple failures in minimal downtime.
IB InfiniBand.
LACP Link Aggregation Control Protocol (LACP) provides a method to control the
bundling of several physical ports together to form a single logical channel.
LACP allows a network device to negotiate an automatic bundling of links by
sending LACP packets to the peer (directly connected device that also imple-
ments LACP).
LDAP The Lightweight Directory Access Protocol is an application protocol for
reading and editing directories over an IP network.
LID (Local IDentifier) A 16 bit address assigned to end nodes by the subnet manager
Each LID is unique within its subnet.
LLDP Link Layer Discovery Protocol (LLDP) is an industry standard protocol
designed to supplant proprietary Link-Layer protocols such as Extreme's EDP
(Extreme Discovery Protocol) and CDP (Cisco Discovery Protocol). The goal
of LLDP is to provide an inter-vendor compatible mechanism to deliver Link-
Layer notifications to adjacent network devices.
MAC A Media Access Control address (MAC address) is a unique identifier
assigned to network interfaces for communications on the physical network
segment. MAC addresses are used for numerous network technologies and
most IEEE 802 network technologies including Ethernet.
MTU (Maximum Transfer Unit) The maximum size of a packet payload (not including headers) that can be
sent /received from a port.
PFC/FC Priority Based Flow Control applies pause functionality to traffic classes OR
classes of service on the Ethernet link.
QoS or Quality of Service Quality of service is the ability to manage different applications or users by
priority such that a required bit rate, delay, packet dropping probability, and/or
other measures may be guaranteed.
QSFP_AMBIENT_TEMP Ambient temperature sensor of the QSFP cage for the selected Leaf or Spine
module
RADIUS Remote Authentication Dial In User Service. A networking protocol that
enables AAA centralized management for computers to connect and use a net-
work service.
RDMA (Remote Direct Memory
Access)
Accessing memory in a remote side without involvement of the remote CPU.
RSTP Rapid Spanning Tree Protocol. A spanning-tree protocol used to prevent loops
in bridge configurations. RSTP is not aware of VLANs and blocks ports at the
physical level.
SA (Subnet Administrator) The interface for querying and manipulating subnet management data.
Table 4 - Glossary
Term Description
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 17
SCP Secure Copy or SCP is a means of securely transferring computer files
between a local and a remote host or between two remote hosts. It is based on
the Secure Shell (SSH) protocol.
SM (Subnet Manager) An entity that configures and manages the subnet, discovers the network
topology, assign LIDs, determines the routing schemes and sets the routing
tables. There is only one master SM and possible several slaves (Standby
mode) at a given time. The SM administers switch routing tables thereby
establishing paths through the fabric.
SNMP Simple Network Management Protocol. A network protocol for the manage-
ment of a network and the monitoring of network devices and their functions.
SNTP Network Time Protocol. A protocol for synchronizing computer clocks in a
network.
SSH Secure Shell. A protocol (program) for securely logging in to and running pro-
grams on remote machines across a network. The program authenticates
access to the remote machine and encrypts the transferred information through
the connection.
syslog A standard for forwarding log messages in an IP network.
TACACS+ Terminal Access Controller Access-Control System Plus. A networking pro-
tocol that enables access to a network of devices via one or more centralized
servers. TACACS+ provides separate AAA services.
TCA (Target Channel Adapter) A Channel Adapter that is not required to support verbs, usually used in I/O
devices.
WebUI Web User Interface. A user interface in which you select commands from
drop down menus or by clicking on icons.
XML Gateway Extensible Markup Language Gateway. Provides an XML request-response
protocol for setting and retrieving HW management information.
Table 4 - Glossary
Term Description
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 18
1 Using the Command Line Interface
This chapter explains how to use the command line interface (CLI) of MLNX-OS SwitchX®.
1.1 CLI Modes
The CLI can be in one of three modes, and each mode makes available a certain group (or level) of
commands for execution. The different CLI configuration modes are:
Table 5 - CLI Modes and Config Context
Mode/Context Description
Standard When the CLI is launched, it begins in Standard mode. This is
the most restrictive mode and only has commands to query a
restricted set of state information. Users cannot take any actions
that directly affect the system, nor can they change any configu-
ration.
Enable The “enable” command moves the user to Enable mode. This
mode offers commands to view all state information and take
actions like rebooting the system, but it does not allow any con-
figuration to be changed. Its commands are a superset of those in
Standard mode. To return to Standard mode, enter “disable”.
Config The “configure terminal” command moves the user from Enable
mode to Config mode. Config mode is allowed only for user
accounts in the “admin” role (or capabilities) – see “User Roles
(Capabilities)”. This mode has a full unrestricted set of com-
mands to view anything, take any action, or change any configu-
ration. Its commands are a superset of those in Enable mode. To
return to Enable mode, enter “exit” or “no configure”. Note that
moving directly from/to Standard mode to/from Config mode is
not possible.
Config Interface Management Configuration mode for management interface mgmt0, mgmt1
and loopback.
Config Interface Ethernet Configuration mode for Ethernet interface.
Config Interface Port Channel Configuration mode for Port channel (LAG).
Config Vlan Configuration mode for VLAN.
Any Command Mode Several commands such as “show” can be applied within any
context.
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 19
1.2 Syntax Conventions
To help you identify the parts of a CLI command, this section uses conventions to show the syntax of
commands.
1.3 Getting Help
You may request context-sensitive help at any time by pressing “?” on the command line. This will
show a list of choices for the word you are on, or a list of top-level commands if you have not
typed anything yet.
For example, if you are in Standard mode and you type “?” at the command line, then you will get
the following list of available commands.
Table 6 - Syntax Conventions
Syntax Convention Description Example
< > Angled brackets Indicates a value/variable that
must be replaced.
<1...65535> or <switch inter-
face>
[ ] Square brackets Encloses optional parameters.
However, only one parameter out
of the list of parameters listed can
be used. You cannot have a com-
bination of the parameters unless
otherwise stated.
[destination-ip | destination-port |
destination-mac]
{ } Braces Encloses alternatives or variables
that are required for the parameter
in square brackets.
[mode {active | on | passive}]
| Vertical bar Identifies mutually exclusive
choices.
active | on | passive
Do not enter the angled or square brackets, vertical bar, or braces in command lines.
This guide uses these symbols only to show the types of entries.
CLI commands and options are in lowercase and are case-sensitive.
For example, when you enter the enable command, enter it all in lowercase, not
ENABLE or Enable. Text entries you create are also case-sensitive. For example, if you
set a LAG name to Lag1, enter it exactly, not lag1 or LAG1.
switch [standalone: master] > ?
cli Configure CLI shell options
enable Enter enable mode
Mellanox® Technologies Confidential

Rev 1.6.9
Mellanox Technologies 20
If you type a legal string and then you press “?” without a space character before it, then you will
either get a description of the command that you have typed so far or the possible command/
parameter completions. If you press “?” after a space character and “<cr>” is shown, this means
that what you have entered so far is a complete command, and that you may press Enter (carriage
return) to execute it.
Try the following to get started:
You can also enter “help” to view a description of the interactive help system.
Note also that the CLI supports command and/or parameter tab-completions and their shortened
forms. For example, you can enter “en” instead of the “enable” command, or “cli cl” instead of “cli
clear-history”. In case of ambiguity (more than one completion option is available, that is), then
you can click double tabs to obtain the disambiguation options. Thus, if you are in Enable mode
and you wish to learn which commands start with the letter “c”, type “c” and click twice on the tab
key to get the following:
(There are three commands that start with the letter “c”: clear, cli and configure.)
1.4 Prompt and Response Conventions
The prompt always begins with the hostname of the system. What follows depends on what com-
mand mode the user is in. To demonstrate by example, and assuming the machine name is
“switch-1”, the prompts for each of the modes are:
exit Log out of the CLI
help View description of the interactive help system
no Negate or clear certain configuration options
ping Send ICMP echo requests to a specified host
show Display system configuration or statistics
slogin Log into another system securely using ssh
switch Configure switch on system
telnet Log into another system using telnet
terminal Set terminal parameters
traceroute Trace the route packets take to a destination
switch-11a596 [standalone: master] >
?
show ?
show c?
show clock?
show clock ?
show interfaces ? (from enable mode)
switch [standalone: master] # c<tab>
clear cli configure
switch-1 [standalone: master] # c
switch [standalone: master] > (Standard mode)
switch [standalone: master] # (Enable mode)
Mellanox® Technologies Confidential