Page 1
Mellanox MLNX-OS™
Software Ver. 3.3.1000
Command Reference Guide for SX1018HP
Ethernet Managed Blade Switch
Rev 1.6.2
www.mellanox.com
Page 2
Rev 1.6.2
2
Mellanox Technologies
Document Number: 3454
Page 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
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
interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
ip address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
alias . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
duplex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
dhcp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
zeroconf. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36
ipv6 enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .37
ipv6 address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
show interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
hostname . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
ip name-server. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
ip domain-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
ip/ipv6 host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
ip/ipv6 map-hostname. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
show hosts. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
ip/ipv6 route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
ipv6 default-gateway. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
show ip/ipv6 route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
show ip/ipv6 default-gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
show ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
ipv6 neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
clear ipv6 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
show ipv6 neighbors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
ip dhcp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
show ip dhcp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
Rev 1.6.2
Mellanox Technologies
3
Page 4
ipv6 enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
traceroute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
tcpdump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .65
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
2.2 License Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 66
license . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .66
show licenses . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .68
2.3 NTP, Clock & Time Zones . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
clock set . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
clock timezone . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
ntp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
ntpdate. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
show clock . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
show ntp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
2.4 Software Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
image boot. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
boot next . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
image default-chip-fw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
image delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
image fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
image install . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
image move. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
image options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
show bootvar. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
show images . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
2.5 File Management. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
ftp-server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
show ftp-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
debug generate dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86
file debug-dump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
file stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 88
file tcpdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .89
show files debug-dump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .90
show files stats . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 91
show files system . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 92
show files tcpdump . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .93
configuration audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .94
configuration copy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .95
configuration delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .96
configuration fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .97
configuration jump-start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .98
configuration merge . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .99
configuration move . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 100
configuration new . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .101
configuration revert. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .102
configuration switch-to . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
configuration text fetch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .104
configuration text file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .105
Rev 1.6.2
Mellanox Technologies
4
Page 5
configuration text generate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .106
configuration upload . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
write . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .108
show configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .109
show running-config . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 110
2.6 Local and Remote Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
logging local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .111
logging local override . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .112
logging <syslog IP address> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114
logging receive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
logging format. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .117
logging fields . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .118
logging level . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .120
logging files delete . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .121
logging files rotation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .122
logging files upload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .124
show logging. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .125
show log . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .126
2.7 Maintenance Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
reload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .127
reset factory. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
2.8 User management and AAA . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
username . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .128
show usernames . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .130
show users. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .131
show whoami . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
aaa accounting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .132
aaa authentication login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .134
aaa authentication attempts track enable. . . . . . . . . . . . . . . . . . . . .135
aaa authentication attempts lockout . . . . . . . . . . . . . . . . . . . . . . . .136
aaa authentication attempts class-override . . . . . . . . . . . . . . . . . . .139
aaa authentication attempts reset . . . . . . . . . . . . . . . . . . . . . . . . . .140
clear aaa authentication attempts . . . . . . . . . . . . . . . . . . . . . . . . . .141
aaa authorization . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 142
show aaa . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 144
show aaa authentication attempts . . . . . . . . . . . . . . . . . . . . . . . . . .145
radius-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .146
radius-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .147
show radius . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .148
tacacs-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .149
tacacs-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .150
show tacacs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .152
ldap base-dn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .153
ldap bind-dn/bind-password . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .154
ldap group-attribute/group-dn. . . . . . . . . . . . . . . . . . . . . . . . . . . . .155
ldap host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .156
ldap login-attribute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 157
ldap port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .158
ldap referrals . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .159
Rev 1.6.2
Mellanox Technologies
5
Page 6
ldap scope . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .160
ldap ssl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .161
ldap timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .163
ldap version. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .164
show ldap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .165
2.9 Cryptographic (X.509, IPSec) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 165
crypto ipsec peer local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .166
crypto certificate ca-list. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .168
crypto certificate default-cert . . . . . . . . . . . . . . . . . . . . . . . . . . . . .169
crypto certificate generation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .170
crypto certificate name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .171
crypto certificate system-self-signed . . . . . . . . . . . . . . . . . . . . . . .173
show crypto certificate . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .174
show crypto ipsec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .176
2.10 CLI Session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 176
cli clear-history . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .177
cli default . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .178
cli session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .180
show cli . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 182
2.11 Banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 183
banner login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .183
banner login-local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
banner login-remote . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .184
banner motd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .185
show banner . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
2.12 SSH . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 186
ssh server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .186
ssh server host-key . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .188
ssh server listen. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .190
ssh server min-version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .191
ssh server ports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .192
ssh server x11-forwarding. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .193
ssh client global. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .194
ssh client user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .196
slogin. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 197
show ssh client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 198
show ssh server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .199
2.13 Remote Login . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 200
telnet-server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .200
show telnet-server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 201
2.14 XML Gateway . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 202
xml-gw enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .202
show xml-gw. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .203
2.15 Web Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203
web auto-logout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .204
web client cert-verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .205
web client ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .206
web enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .207
Rev 1.6.2
Mellanox Technologies
6
Page 7
web http. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .208
web httpd. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .210
web https . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 211
web session . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .213
web proxy auth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .214
web proxy host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .216
show web . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .217
2.16 SNMP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 218
snmp-server community . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .218
snmp-server contact . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .219
snmp-server enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .220
snmp-server host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 221
snmp-server listen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 223
snmp-server location. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .224
snmp-server notify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .225
snmp-server port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .226
snmp-server user . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 227
show snmp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .228
2.17 Scheduled Jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 229
job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .230
command. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 231
comment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .232
enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 233
execute . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .234
fail-continue . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 235
name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .236
schedule type. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .237
schedule <recurrence type> . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .238
show jobs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .239
2.18 Event Notification. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
email autosupport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 240
email autosupport ssl mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .241
email autosupport ssl cert-verify. . . . . . . . . . . . . . . . . . . . . . . . . . .242
email autosupport ssl ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 243
email dead-letter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .244
email domain. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .245
email mailhub . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .246
email mailhub-port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 247
email notify event . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .248
email notify recipient . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 249
email return-addr. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .250
email return-host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 251
email send-test . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .252
email ssl mode. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .253
email ssl cert-verify. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .254
email ssl ca-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .255
show email . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .256
2.19 Statistics and Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 257
stats alarm <alarm-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .257
Rev 1.6.2
Mellanox Technologies
7
Page 8
stats alarm <alarm-id> enable. . . . . . . . . . . . . . . . . . . . . . . . . . . . .258
stats alarm <alarm-id> event-repeat . . . . . . . . . . . . . . . . . . . . . . . .259
stats alarm <alarm-id> {rising | falling} . . . . . . . . . . . . . . . . . . . . . 260
stats alarm <alarm-id> rate-limit . . . . . . . . . . . . . . . . . . . . . . . . . .261
stats chd <chd-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .262
stats chd <chd-id> enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .263
stats chd <chd-id> compute time . . . . . . . . . . . . . . . . . . . . . . . . . .264
stats sample <sample-id> clear . . . . . . . . . . . . . . . . . . . . . . . . . . . .266
stats sample <sample-id> enable . . . . . . . . . . . . . . . . . . . . . . . . . .267
stats sample <sample-id> interval. . . . . . . . . . . . . . . . . . . . . . . . . .268
stats clear-all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .269
stats export . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .270
show stats alarm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .271
show stats chd . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .272
show stats cpu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .273
show stats sample . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .274
2.20 Chassis Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
health. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 274
power enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 276
usb eject . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .277
system profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 278
show fan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .279
show version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .280
show inventory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 281
show module . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 282
show memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 283
show asic-version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 284
show power . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 285
show power consumers. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .286
show temperature . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .287
show voltage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .288
show health-report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .289
show resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .290
show system profile . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .291
show system capabilities. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 292
show system mac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .293
show protocols . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .294
Chapter 3 Ethernet Switching. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
3.1 Interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 297
interface ethernet. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .297
flowcontrol . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .298
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .299
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .300
description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 301
speed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .302
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .303
show interfaces ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .304
show interfaces ethernet [<inf>] capabilities . . . . . . . . . . . . . . . . .305
show interfaces ethernet [<inf>] description . . . . . . . . . . . . . . . . .306
Rev 1.6.2
Mellanox Technologies
8
Page 9
show interfaces ethernet [<inf>] status. . . . . . . . . . . . . . . . . . . . . .307
show interfaces ethernet [<inf>] transceiver . . . . . . . . . . . . . . . . .308
module-type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .308
3.2 Link Aggregation Group (LAG) and LACP. . . . . . . . . . . . . . . . . . . . . . . 310
interface port-channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .310
lacp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .311
lacp system-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .312
lacp (interface) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .313
port-channel load-balance. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .314
channel-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .315
show lacp system-identifier . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .316
show lacp counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .317
show lacp interface ethernet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .318
show lacp interface neighbor . . . . . . . . . . . . . . . . . . . . . . . . . . . . .320
show lacp interfaces port-channel. . . . . . . . . . . . . . . . . . . . . . . . . .321
3.3 VLANs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 322
vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .322
name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .323
show vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .324
switchport mode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 325
switchport access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .326
switchport {hybrid, trunk} allowed vlan . . . . . . . . . . . . . . . . . . . .327
show interface switchport . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
3.4 MAC Address Table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 328
mac-address-table aging-time . . . . . . . . . . . . . . . . . . . . . . . . . . . . .328
mac-address-table static . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .330
clear mac-address-table dynamic . . . . . . . . . . . . . . . . . . . . . . . . . .331
show mac-address-table . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .332
show mac-address-table aging-time . . . . . . . . . . . . . . . . . . . . . . . .333
3.5 Spanning Tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
spanning-tree. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 334
spanning-tree (timers) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 335
spanning-tree port type (default global) . . . . . . . . . . . . . . . . . . . . .336
spanning-tree priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 337
spanning-tree port-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .338
spanning-tree cost . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .339
spanning-tree port type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .340
spanning-tree guard. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .341
spanning-tree bpdufilter . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .342
clear spanning-tree counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .343
show spanning-tree . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .344
3.6 IGMP Snooping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 345
ip igmp snooping (admin). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .345
ip igmp snooping (config). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .346
ip igmp snooping fast-leave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .348
ip igmp snooping static-group . . . . . . . . . . . . . . . . . . . . . . . . . . . .349
ip igmp snooping mrouter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .351
ip igmp snooping unregistered multicast . . . . . . . . . . . . . . . . . . . . 352
Rev 1.6.2
Mellanox Technologies
9
Page 10
show ip igmp snooping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 353
show ip igmp snooping groups . . . . . . . . . . . . . . . . . . . . . . . . . . . .354
show ip igmp snooping vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .355
show ip igmp snooping mrouter . . . . . . . . . . . . . . . . . . . . . . . . . . .356
show ip igmp snooping interfaces. . . . . . . . . . . . . . . . . . . . . . . . . .357
show ip igmp snooping statistics . . . . . . . . . . . . . . . . . . . . . . . . . .358
3.7 Link Layer Discovery Protocol (LLDP). . . . . . . . . . . . . . . . . . . . . . . . . . 359
lldp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .359
lldp reinit. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .360
lldp timer. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .361
lldp tx-delay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .362
lldp tx-hold-multiplier. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .363
lldp {receive | transmit} . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .364
lldp tlv-select. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .365
show lldp local . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 366
show lldp interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .367
show lldp interface ethernet <inf> remote . . . . . . . . . . . . . . . . . . .368
show lldp timers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .369
show lldp statistics global . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 370
show lldp statistics [interface ethernet <inf>]. . . . . . . . . . . . . . . . .371
3.8 Quality of Service . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 372
dcb ets enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .372
dcb ets tc bandwidth . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .373
vlan map-priority . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .374
show dcb ets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .375
show dcb ets interface. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .376
dcb priority-flow-control enable . . . . . . . . . . . . . . . . . . . . . . . . . . .378
dcb priority-flow-control priority . . . . . . . . . . . . . . . . . . . . . . . . . .379
dcb priority-flow-control mode on . . . . . . . . . . . . . . . . . . . . . . . . .380
show dcb priority-flow-control. . . . . . . . . . . . . . . . . . . . . . . . . . . .381
3.9 Access Control List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 382
ipv4/mac access-list . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .382
ipv4/mac port access-group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .383
deny/permit (MAC ACL rule) . . . . . . . . . . . . . . . . . . . . . . . . . . . .384
deny/permit (IPv4 ACL rule) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 385
deny/permit (IPv4 TCP/UDP ACL rule) . . . . . . . . . . . . . . . . . . . .386
access-list action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .387
vlan-map . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .388
show access-list action . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .389
show mac/ipv4 access-lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .390
show mac/ipv4 access-lists summary . . . . . . . . . . . . . . . . . . . . . . .391
Chapter 4 IP Routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
4.1 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 392
ip routing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .392
show ip routing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393
interface vlan. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .393
ip address . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .395
counters. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .396
Rev 1.6.2
Mellanox Technologies
10
Page 11
description. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 397
mtu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .398
shutdown. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .399
clear counters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .400
show interfaces vlan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .401
interface loopback. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .402
show interfaces loopback . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .402
ip route . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .403
ip load-sharing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .404
show ip route. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 405
show ip load-sharing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .406
ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .407
ip arp timeout . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 408
clear ip arp. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .409
show ip arp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .410
ping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .411
traceroute. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .412
tcpdump. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .415
Rev 1.6.2
Mellanox Technologies
11
Page 12
Document Revision History
Table 1 - Document Revision History - Ethernet
Rev 1.6.2
Document
Revision
Date Changes
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
12
Page 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 managing Mellanox Technologies’ MLNX-OS Switch Platforms.
Related Documentation
The following table lists the documents referenced in this user’s manual.
Table 2 - Reference Documents
Document Name Description
Rev 1.6.2
InfiniBand Architecture Specification, Vol. 1,
Release 1.2.1
SwitchX® Hardware Installation Guide Each Mellanox Technologies’ switch platform is
SwitchX® Hardware User Manual This document contains hardware descriptions, LED
Switch Errata For any possible errata due to hardware issues see the
MX-OS Software WebUI User’s Manual WebUI user’s manual for MX-OS.
Mellanox MLNX-OS SwitchX Software
User Manual
Mellanox MLNX-OS Software Configuration
Guide
The InfiniBand Architecture Specification that is provided by IBTA.
shipped with an Installation Guide document to
bring-up and initialize the switch platform.
assignments and hardware specifications among other
things.
switch support product page. This requires a customer
support login.
This document contains information regarding configuring and managing Mellanox Technologies'
SwitchX® Switch Platforms.
Configuration Guide for MLNX-OS displaying different configuration scenarios.
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.
Mellanox Technologies
13
Page 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}
Rev 1.6.2
Optional mutually exclusive parame-
[p1 | p2 | p3]
ters
Prompt of a command in Standard
hostname > sx10xx-1 >
mode
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
// // This is a comment
examples
Variables for which users supply spe-
Italic font enable
cific values
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
14
Page 15
Rev 1.6.2
Glossary
Table 4 - Glossary
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 IDentifier)
HA (High Availability) A system design protocol that provides redundancy of system components,
A 64-bit number that uniquely identifies a device or component in a subnet.
thus enables overcoming single or multiple failures in minimal downtime.
Mellanox Technologies
15
Page 16
Rev 1.6.2
Table 4 - Glossary
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 implements 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 LinkLayer 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 network service.
RDMA (Remote Direct Memory
Accessing memory in a remote side without involvement of the remote CPU.
Access)
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.
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.
Mellanox Technologies
16
Page 17
Rev 1.6.2
Table 4 - Glossary
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 proto-
col 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.
Mellanox Technologies
17
Page 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 configuration.
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 configuration to be changed. Its commands are a superset of those in
Standard mode. To return to Standard mode, enter “disable”.
Rev 1.6.2
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 commands to view anything, take any action, or change any configuration. 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
18
Page 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.
Table 6 - Syntax Conventions
Syntax Convention Description Example
Rev 1.6.2
< > Angled brackets Indicates a value/variable that
must be replaced.
[ ] Square brackets Encloses optional parameters.
However, only one parameter out
of the list of parameters listed can
be used. You cannot have a combination of the parameters unless
otherwise stated.
{ } Braces Encloses alternatives or variables
that are required for the parameter
in square brackets.
| Vertical bar Identifies mutually exclusive
choices.
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.
<1...65535> or <switch interface>
[destination-ip | destination-port |
destination-mac]
[mode {active | on | passive}]
active | on | passive
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.
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
switch [standalone: master] > ?
Mellanox Technologies
19
Page 20
Rev 1.6.2
cli Configure CLI shell options
enable Enter enable mode
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] >
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:
?
show ?
show c?
show clock?
show clock ?
show interfaces ? (from enable mode)
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:
switch [standalone: master] # c<tab>
clear cli configure
switch-1 [standalone: master] # c
(There are three commands that start with the letter “c”: clear, cli and configure.)
Mellanox Technologies
20
Page 21
1.4 Prompt and Response Conventions
The prompt always begins with the hostname of the system. What follows depends on what command 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:
switch [standalone: master] > (Standard mode)
switch [standalone: master] # (Enable mode)
switch [standalone: master] (config) # (Config mode)
The following session shows how to move between command modes:
switch [standalone: master] > (You start in Standard mode)
switch [standalone: master] > enable (Move to Enable mode)
switch [standalone: master] # (You are in Enable mode)
switch [standalone: master] # configure terminal (Move to Config mode)
switch [standalone: master] (config) # (You are in Config mode)
switch [standalone: master] (config) # exit (Exit Config mode)
switch [standalone: master] # (You are back in Enable mode)
switch [standalone: master] # disable (Exit Enable mode)
switch [standalone: master] > (You are back in Standard mode)
Rev 1.6.2
Commands that succeed do not print any response and simply show the command prompt after
you press <Enter>.
If an error is encountered in executing a command, the response will begin with “%”, followed by
some text describing the error.
1.5 User Roles (Capabilities)
There are two user roles or account types: admin and monitor. As “admin”, the user is privileged to
run all the available commands. As “monitor”, the user can run commands that show system configuration and status, or set terminal settings.
Table 7 - User Roles (Accounts) and Default Passwords
User Role Default Password
admin admin
monitor monitor
1.6 Using the Negation Form
Several Config mode commands offer the negation form using the keyword “no”. This no form
can be used to disable a function or to cancel certain command parameters or options. To re-enable
a function or to set cancelled command parameters or options, enter the command without the
“no” keyword (with parameter values if necessary).
Mellanox Technologies
21
Page 22
The following example performs the following:
1. Displays the current CLI session options.
2. Disables auto-logout.
3. Displays the new CLI session options (auto-logout is disabled).
4. Re-enables auto-logout (after 15 minutes).
5. Displays the final CLI session options (auto-logout is enabled).
// 1. Display the current CLI session options
switch-1 [standalone: master] (config) # show cli
CLI current session settings:
Maximum line size: 8192
Terminal width: 157 columns
Terminal length: 60 rows
Terminal type: xterm
Auto-logout: 15 minutes
Paging: enabled
Progress tracking: enabled
Prefix modes: enabled
...
// 2. Disable auto-logout
switch-1 [standalone: master] (config) # no cli session auto-logout
// 3. Display the new CLI session options
switch-1 [standalone: master] (config) # show cli
CLI current session settings:
Maximum line size: 8192
Terminal width: 157 columns
Terminal length: 60 rows
Terminal type: xterm
Auto-logout: disabled
Paging: enabled
Progress tracking: enabled
Prefix modes: enabled
...
// 4. Re-enable auto-logout after 15 minutes
switch-1 [standalone: master] (config) # cli session auto-logout 15
// 5. Display the final CLI session options
switch-1 [standalone: master] (config) # show cli
CLI current session settings:
Maximum line size: 8192
Terminal width: 157 columns
Terminal length: 60 rows
Terminal type: xterm
Auto-logout: 15 minutes
Paging: enabled
Progress tracking: enabled
Prefix modes: enabled
...
Rev 1.6.2
Mellanox Technologies
22
Page 23
1.7 Parameter Key
This section is a key to the meaning and format of all of the angle-bracketed parameters in all the
commands that are listed in this document.
<domain> A domain name, e.g. “mellanox.com”.
<hostname> A hostname, e.g. “switch-1”.
<ifname> An interface name, e.g. “mgmt0”, “mgmt1”, “lo” (loopback), etc.
<index> A number to be associated with aliased (secondary) IP addresses.
<IP address> An IPv4 address, e.g. “192.168.0.1”.
<log level> A syslog logging severity level. Possible values, from least to most severe, are:
<GUID> Globally Unique Identifier. A number that uniquely identifies a device or compo-
<MAC address> A MAC address. The segments may be 8 bits or 16 bits at a time, and may be
Rev 1.6.2
“debug”, “info”, “notice”, “warning”, “error”, “crit”, “alert”, “emerg”.
nent.
delimited by “:” or “.”. So you could say “11:22:33:44:55:66”, “1122:3344:5566”,
“11.22.33.44.55.66”, or “1122.3344.5566”.
<netmask> A netmask (e.g. “255.255.255.0”) or mask length prefixed with a slash (e.g. “/24”).
These two express the same information in different formats.
<network prefix> An IPv4 network prefix specifying a network. Used in conjunction with a netmask
to determine which bits are significant. e.g. “192.168.0.0”.
<regular expression> An extended regular expression as defined by the “grep” in the man page. (The
value you provide here is passed on to “grep -E”.)
<node id> ID of a node belonging to a cluster. This is a numerical value greater than zero.
<cluster id> A string specifying the name of a cluster.
<port> TCP/UDP port number.
<TCP port> A TCP port number in the full allowable range [0...65535].
<URL> A normal URL, using any protocol that wget supports, including http, https, ftp,
sftp,
and tftp; or a pseudo-URL specifying an scp file transfer. The scp pseudo-URL
format is scp://username:password@hostname/path/filename.
Note that the path is an absolute path. Paths relative to the user's home directory are
not currently supported. The implementation of ftp does not support authentication,
so use scp or sftp for that.
Note also that if you omit the “:password” part, you may be prompted for the password in a follow up prompt, where you can type it securely (without the characters
being echoed). This prompt will occur if the “cli default prompt empty-password”
setting is true; otherwise, the CLI will assume you do not want any password. If
you include the “:” character, this will be taken as an explicit declaration that the
password is empty, and you will not be prompted in any case.
Mellanox Technologies
23
Page 24
2 System Management
2.1 Management Interfaces
2.1.1 Interface
This chapter describes the commands should be used to configure and monitor the management
interface.
interface
interface {mgmt0 | mgmt1 | lo}
Enters a management interface context.
Syntax Description mgmt0 Management port 0 (out of band).
mgmt1 Management port 1 (out of band).
lo Loopback interface.
Rev 1.6.2
ib0 IP over IB in-band management, relevant only for
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
Related Commands show interfaces <ifname>
Note
switch (config) # interface mgmt0
switch (config interface mgmt0) #
InfiniBand switch systems.
Mellanox Technologies
24
Page 25
ip address
ip address <IP address> <netmask>
no ip address
Sets the IP address and netmask of this interface.
The no form of the command clears the IP address and netmask of this interface.
Syntax Description IP address IPv4 address
netmask Subnet mask of IP address
Default 0.0.0.0/0
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # interface mgmt0
switch (config interface mgmt0) # ip address 10.10.10.10 255.255.255.0
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 10.10.10.10
Netmask: 255.255.255.0
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment:
RX bytes: 2946769856 TX bytes: 467577486
RX packets: 44866091 TX packets: 1385520
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Related Commands show interfaces <ifname>
Note If DHCP is enabled on the specified interface, then the DHCP IP assignment will
hold until DHCP is disabled.
Mellanox Technologies
25
Page 26
Rev 1.6.2
alias
alias <index> ip address < IP address> <netmask>
no alias <index>
Adds an additional IP address to the specified interface. The secondary address will
appear in the output of “show interface” under the data of the primary interface along
with the alias.
The no form of the command removes the secondary address to the specified interface.
Syntax Description index A number that is to be aliased to (associated with) the
secondary IP.
IP address Additional IP address.
netmask Subnet mask of the IP address.
Default N/A
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Example
switch (config interface mgmt0) # alias 2 ip address 9.9.9.9
255.255.255.255
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
Secondary address: 9.9.9.9/32 (alias: 'mgmt0:2')
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment:
RX bytes: 2970074221 TX bytes: 468579522
RX packets: 44983023 TX packets: 1390539
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Mellanox Technologies
26
Page 27
Related Commands show interfaces <ifname>
Rev 1.6.2
Note
• If DHCP is enabled on the specified interface, then the DHCP IP assignment will hold until
DHCP is disabled
• More than one additional IP address can be added to the interface
Mellanox Technologies
27
Page 28
mtu
mtu <bytes>
no mtu <bytes>
Sets the Maximum Transmission Unit (MTU) of this interface.
The no form of the command resets the MTU to its default.
Syntax Description bytes The entry range is 68-1500.
Default 1500
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config interface mgmt0) # mtu 1500
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
Secondary address: 9.9.9.9/32 (alias: 'mgmt0:2')
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment:
RX bytes: 2970074221 TX bytes: 468579522
RX packets: 44983023 TX packets: 1390539
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Related Commands show interfaces <ifname>
Note
Mellanox Technologies
28
Page 29
Rev 1.6.2
duplex
duplex <duplex>
no duplex
Sets the interface duplex.
The no form of the command resets the duplex setting for this interface to its default
value.
Syntax Description duplex Sets the duplex mode of the interface. The following
are the possible values:
• half - half duplex
• full - full duplex
• auto - auto duplex sensing (half or full)
Default auto
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Example
switch (config interface mgmt0) # duplex auto
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
Secondary address: 9.9.9.9/32 (alias: 'mgmt0:2')
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment:
RX bytes: 2970074221 TX bytes: 468579522
RX packets: 44983023 TX packets: 1390539
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Mellanox Technologies
29
Page 30
Related Commands show interfaces <ifname>
Rev 1.6.2
Note
• Setting the duplex to “auto” also sets the speed to “auto”
• Setting the duplex to one of the settings “half” or “full” also sets the speed to a manual setting which is determined by querying the interface to find out its current auto-detected state
Mellanox Technologies
30
Page 31
Rev 1.6.2
speed
speed <speed>
no speed
Sets the interface speed.
The no form of the command resets the speed setting for this interface to its default
value.
Syntax Description speed Sets the speed of the interface. The following are the
possible values:
• 10 - fixed to 10Mbps
• 100 - fixed to 1000Mbps
• 1000 - fixed to 1000Mbps
• auto - auto speed sensing (10/100/1000Mbps)
Default auto
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Example
switch (config interface mgmt0) # speed auto
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
Secondary address: 9.9.9.9/32 (alias: 'mgmt0:2')
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment:
RX bytes: 2970074221 TX bytes: 468579522
RX packets: 44983023 TX packets: 1390539
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Mellanox Technologies
31
Page 32
Related Commands show interfaces <ifname>
Rev 1.6.2
Note
• Setting the speed to “auto” also sets the duplex to “auto”
• Setting the speed to one of the manual settings (generally “10”, “100”, or “1000”) also sets
the duplex to a manual setting which is determined by querying the interface to find out its
current auto-detected state
Mellanox Technologies
32
Page 33
Rev 1.6.2
dhcp
dhcp [renew]
no dhcp
Enables DHCP on the specified interface.
The no form of the command disables DHCP on the specified interface.
Syntax Description renew Forces a renewal of the IP address. A restart on the
DHCP client for the specified interface will be issued.
Default Could be enabled or disabled (per part number) manufactured with 3.2.0500
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Example
switch (config interface mgmt0) # dhcp
switch (config) # show interfaces mgmt0 configured
Interface mgmt0 configuration
Enabled: yes
DHCP: yes
Zeroconf: no
IP address:
Netmask:
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 0
Speed: auto
Duplex: auto
MTU: 1500
Comment:
Related Commands show interfaces <ifname> configured
Note
• When enabling DHCP, the IP address and netmask are received via DHCP hence, the static
IP address configuration is ignored
• Enabling DHCP disables zeroconf and vice versa
• Setting a static IP address and netmask does not disable DHCP. DHCP is disabled by using
the “no” form of this command, or by enabling zeroconf.
Mellanox Technologies
33
Page 34
shutdown
shutdown
no shutdown
Disables the specified interface.
The no form of the command enables the specified interface.
Syntax Description N/A
Default no shutdown
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config interface mgmt0) # no shutdown
switch (config) # show interfaces mgmt0 configured
Interface mgmt0 configuration
Enabled: yes
DHCP: yes
Zeroconf: no
IP address:
Netmask:
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 0
Speed: auto
Duplex: auto
MTU: 1500
Comment:
switch (config) #
Related Commands show interfaces <ifname> configured
Note
Mellanox Technologies
34
Page 35
zeroconf
zeroconf
no zeroconf
Enables zeroconf on the specified interface. It randomly chooses a unique link-local
IPv4 address from the 169.254.0.0/16 block. This command is an alternative to
DHCP.
The no form of the command disables the use of zeroconf on the specified interface.
Syntax Description N/A
Default no zeroconf
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config interface mgmt0) # zeroconf
switch (config) # show interfaces mgmt0 configured
Interface mgmt0 configuration
Enabled: yes
DHCP: no
Zeroconf: yes
IP address:
Netmask:
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 0
Speed: auto
Duplex: auto
MTU: 1500
Comment:
Related Commands show interfaces <ifname> configured
Note Enabling zeroconf disables DHCP and vice versa.
Mellanox Technologies
35
Page 36
Rev 1.6.2
comment
comment <comment>
no comment
Adds a comment for an interface.
The no form of the command removes a comment for an interface.
Syntax Description comment A free-form string that has no semantics other than
being displayed when the interface records are listed.
Default no comment
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Example
switch (config interface mgmt0) # comment my-interface
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment: my-interface
RX bytes: 962067812 TX bytes: 40658219
RX packets: 3738865 TX packets: 142345
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Related Commands N/A
Note
Mellanox Technologies
36
Page 37
ipv6 enable
ipv6 enable
no ipv6 enable
Enables all IPv6 addressing for this interface.
The no form of the command disables all IPv6 addressing for this interface.
Syntax Description N/A
Default IPv6 addressing is disabled
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config interface mgmt0) # ipv6 enable
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment: my-interface
RX bytes: 962067812 TX bytes: 40658219
RX packets: 3738865 TX packets: 142345
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Mellanox Technologies
37
Page 38
Related Commands ipv6 address
show interface <ifname>
Rev 1.6.2
Note
• The interface identifier is a 64-bit long modified EUI-64, which is based on the MAC
address of the interface
• If IPv6 is enabled on an interface, the system will automatically add a link-local address to
the interface. Link-local addresses can only be used to communicate with other hosts on the
same link, and packets with link-local addresses are never forwarded by a router.
• A link-local address, which may not be removed, is required for proper IPv6 operation. The
link-local addresses start with “fe80::”, and are combined with the interface identifier to
form the complete address.
Mellanox Technologies
38
Page 39
ipv6 address
ipv6 address {<IPv6 address/netmask> | autoconfig [default | privacy]}
no ipv6 {<IPv6 address/netmask> | autoconfig [default | privacy]}
Configures IPv6 address and netmask to this interface, static or autoconfig options
are possible.
The no form of the command removes the given IPv6 address and netmask or disables the autoconfig options.
Syntax Description IPv6 address/netmask Configures a static IPv6 address and netmask.
Format example: 2001:db8:1234::5678/64.
autoconfig Enables IPv6 stateless address auto configuration
(SLAAC) for this interface. An address will be automatically added to the interface based on an IPv6 prefix
learned from router advertisements, combined with an
interface identifier.
autoconfig default Enables default learning routes. The default route will
be discovered automatically, if the autoconfig is
enabled.
Rev 1.6.2
autoconfig privacy Uses privacy extensions for SLAAC to construct the
autoconfig address, if the autoconfig is enabled.
Default No IP address available, auto config is enabled
Modes/Context Config Interface Management
History 3.1.0000
Role admin
Mellanox Technologies
39
Page 40
Rev 1.6.2
Example
switch (config interface mgmt0) # ipv6 fe80::202:c9ff:fe5e:a5d8/64
switch (config interface mgmt0) # show interfaces mgmt0
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment: my-interface
RX bytes: 962067812 TX bytes: 40658219
RX packets: 3738865 TX packets: 142345
RX mcast packets: 0 TX discards: 0
RX discards: 0 TX errors: 0
RX errors: 0 TX overruns: 0
RX overruns: 0 TX carrier: 0
RX frame: 0 TX collisions: 0
TX queue len: 1000
switch (config interface mgmt0) #
Related Commands ipv6 enable
show interface <ifname>
Note
• Unlike IPv4, IPv6 can have multiple IPv6 addresses on a given interface
• For Ethernet, the default interface identifier is a 64-bit long modified EUI-64, which is
based on the MAC address of the interface
Mellanox Technologies
40
Page 41
show interface
show interface {<ifname> [configured | brief]}
Displays information about the specified interface, configuration status, and counters.
Syntax Description ifname The interface name e.g., “mgmt0”, “mgmt1”, “lo”
(loopback), etc.
configured Displays the interface configuration.
brief Displays a brief info on the interface configuration and
status.
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) #show interfaces mgmt0 configured
Interface mgmt0 configuration
Enabled: yes
DHCP: yes
Zeroconf: no
IP address:
Netmask:
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 0
Speed: auto
Duplex: auto
MTU: 1500
Comment: my-interface
switch (config) # show interfaces mgmt0 brief
Interface mgmt0 state
Admin up: yes
Link up: yes
IP address: 172.30.2.2
Netmask: 255.255.0.0
IPv6 enabled: yes
Autoconf enabled: no
Autoconf route: yes
Autoconf privacy: no
IPv6 addresses: 1
IPv6 address: fe80::202:c9ff:fe5e:a5d8/64
Speed: 1000Mb/s (auto)
Duplex: full (auto)
Interface type: ethernet
Interface ifindex: 2
Interface source: physical
MTU: 1500
HW address: 00:02:C9:5E:A5:D8
Comment: my-interface
switch (config) #
Mellanox Technologies
41
Page 42
Related Commands N/A
Note
Rev 1.6.2
Mellanox Technologies
42
Page 43
2.1.2 Hostname Resolution
hostname
hostname <hostname>
no hostname
Sets a static system hostname.
The no form of the command clears the system hostname.
Rev 1.6.2
Syntax Description
Default
Modes/Context
History
Role
Example
Related Commands
Note
hostname A free-form string.
Default hostname
Config
3.1.0000
admin
switch (config) # hostname my-switch-hostname
my-switch-hostname (config) #
show hosts
• Hostname may contain letters, numbers, periods ('.'), and hyphens ('-'), in any combination
• Hostname can’t contain other letters, such as ‘%’, ‘_’, etc.
• Hostname can’t begin with a hyphen.
• Hostname can be 1-63 characters long
Mellanox Technologies
43
Page 44
ip name-server
ip name-server <IPv4/IPv6 address>
no name-server <IPv4/IPv6 address>
Sets the static name server.
The no form of the command clears the name server.
Syntax Description IPv4/v6 address IPv4 or IPv6 address.
Default No server name
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ip name-server 9.9.9.9
switch (config) # show hosts
Hostname: switch
Name server: 9.9.9.9 (configured)
Name server: 10.211.0.121 (dynamic)
Name server: 172.30.0.126 (dynamic)
Name server: 10.4.0.135 (dynamic)
Domain name: lab.mtl.com (dynamic)
Domain name: vmlab.mtl.com (dynamic)
Domain name: yok.mtl.com (dynamic)
Domain name: mtl.com (dynamic)
IP 127.0.0.1 maps to hostname localhost
IPv6 ::1 maps to hostname localhost6
Automatically map hostname to loopback address: yes
Automatically map hostname to IPv6 loopback address: no
switch (config) #
Related Commands show hosts
Note
Mellanox Technologies
44
Page 45
ip domain-list
ip domain-list <domain-name>
no ip domain-list <domain-name>
Sets the static domain name.
The no form of the command clears the domain name.
Syntax Description domain-name The domain name in a string form.
A domain name is an identification string that defines a
realm of administrative autonomy, authority, or control
in the Internet. Domain names are formed by the rules
and procedures of the Domain Name System (DNS).
Default No static domain name
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ip domain-list mydomain.com
switch (config) # show hosts
Hostname: switch
Name server: 10.211.0.121 (dynamic)
Name server: 172.30.0.126 (dynamic)
Name server: 10.4.0.135 (dynamic)
Domain name: mydomain.com (configured)
Domain name: lab.mtl.com (dynamic)
Domain name: vmlab.mtl.com (dynamic)
Domain name: yok.mtl.com (dynamic)
Domain name: mtl.com (dynamic)
IP 1.1.1.1 maps to hostname p
IP 127.0.0.1 maps to hostname localhost
IPv6 ::1 maps to hostname localhost6
Automatically map hostname to loopback address: yes
Automatically map hostname to IPv6 loopback address: no
switch (config) #
Related Commands show hosts
Note
Mellanox Technologies
45
Page 46
ip/ipv6 host
{ip | ipv6} host <hostname> <IP Address>
no {ip | ipv6} host <hostname> <IP Address>
Configures the static hostname IPv4 or IPv6 address mappings.
The no form of the command clears the static mapping.
Syntax Description hostname The hostname in a string form.
IP Address The IPv4 or IPv6 address.
Default No static domain name.
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ip host my-host 2.2.2.2
switch (config) # ipv6 host my-ipv6-host 2001::8f9
switch (config) # show hosts
Hostname: switch
Name server: 9.9.9.9 (configured)
Name server: 10.211.0.121 (dynamic)
Name server: 172.30.0.126 (dynamic)
Name server: 10.4.0.135 (dynamic)
Domain name: mydomain.com (configured)
Domain name: lab.mtl.com (dynamic)
Domain name: vmlab.mtl.com (dynamic)
Domain name: yok.mtl.com (dynamic)
Domain name: mtl.com (dynamic)
IP 1.1.1.1 maps to hostname p
IP 127.0.0.1 maps to hostname localhost
IP 2.2.2.2 maps to hostname my-host
IPv6 2001::8f9 maps to hostname my-ipv6-host
IPv6 ::1 maps to hostname localhost6
Automatically map hostname to loopback address: yes
Automatically map hostname to IPv6 loopback address: yes
switch (config) #
Related Commands show hosts
Note
Mellanox Technologies
46
Page 47
ip/ipv6 map-hostname
{ip |ipv6} map-hostname
no {ip | ipv6} map-hostname
Maps between the currently-configured hostname and the loopback address
127.0.0.1.
The no form of the command clears the mapping.
Syntax Description N/A
Default IPv4 mapping is enabled by default
IPv6 mapping is disabled by default
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ip map-hostname
switch (config) # # show hosts
Hostname: switch
Name server: 9.9.9.9 (configured)
Name server: 10.211.0.121 (dynamic)
Name server: 172.30.0.126 (dynamic)
Name server: 10.4.0.135 (dynamic)
Domain name: mydomain.com (configured)
Domain name: lab.mtl.com (dynamic)
Domain name: vmlab.mtl.com (dynamic)
Domain name: yok.mtl.com (dynamic)
Domain name: mtl.com (dynamic)
IP 1.1.1.1 maps to hostname p
IP 127.0.0.1 maps to hostname localhost
IP 2.2.2.2 maps to hostname my-host
IPv6 2001::8f9 maps to hostname my-ipv6-host
IPv6 ::1 maps to hostname localhost6
Automatically map hostname to loopback address: yes
Automatically map hostname to IPv6 loopback address: yes
switch (config) #
switch (config) # ping my-host-name
PING localhost (127.0.0.1) 56(84) bytes of data.
64 bytes from localhost (127.0.0.1): icmp_seq=1 ttl=64 time=0.078 ms
64 bytes from localhost (127.0.0.1): icmp_seq=2 ttl=64 time=0.052 ms
64 bytes from localhost (127.0.0.1): icmp_seq=3 ttl=64 time=0.058 ms
Related Commands show hosts
Note
• If no mapping is configured, a mapping between the hostname and the IPv4 loopback
address 127.0.0.1 will be added
• The no form of the command maps the hostname to the IPv6 loopback address if there is no
statically configured mapping from the hostname to an IPv6 address (disabled by default)
• Static host mappings are preferred over DNS results. As a result, with this option set, you
will not be able to look up your hostname on your configured DNS server; but without it
set, some problems may arise if your hostname cannot be looked up in DNS.
Mellanox Technologies
47
Page 48
show hosts
show hosts
Displays hostname, DNS configuration, and static host mappings.
Syntax Description N/A
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands N/A
Note
2.1.3 Routing
switch (config) # show hosts
Hostname: my-host-name
Name server: 9.9.9.9 (configured)
Name server: 10.211.0.121 (dynamic)
Name server: 172.30.0.126 (dynamic)
Name server: 10.4.0.135 (dynamic)
Domain name: mydomain.com (configured)
Domain name: lab.mtl.com (dynamic)
Domain name: vmlab.mtl.com (dynamic)
Domain name: yok.mtl.com (dynamic)
Domain name: mtl.com (dynamic)
IP 1.1.1.1 maps to hostname p
IP 127.0.0.1 maps to hostname localhost
IP 2.2.2.2 maps to hostname my-host
IPv6 ::1 maps to hostname localhost6
Automatically map hostname to loopback address: yes
Automatically map hostname to IPv6 loopback address: no
switch (config) #
ip/ipv6 route
{ip | ipv6} route <network-prefix> <netmask> {<nexthop-address> | <ifname>}
no ip route <network-prefix> <netmask> {<nexthop-address> | <ifname>}
Sets a static route for a given IP.
The no form of the command deletes the static route.
Mellanox Technologies
48
Page 49
Syntax Description network-prefix IPv4 or IPv6 network prefix.
netmask IPv4 netmask formats are:
• /24
• 255.255.255.0
IPv6 netmask format is:
• /48 (as a part of the network prefix)
nexthop-address The IPv4 or IPv6 address of the next hope router for
this route.
ifname The interface name (e.g., mgmt0, mgmt1).
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ip route 20.20.20.0 255.255.255.0 mgmt0
switch (config) # show ip route
Destination Mask Gateway Interface Source
default 0.0.0.0 172.30.0.1 mgmt0 DHCP
10.10.10.10 255.255.255.255 0.0.0.0 mgmt0 static
20.10.10.10 255.255.255.255 172.30.0.1 mgmt0 static
20.20.20.0 255.255.255.0 0.0.0.0 mgmt0 static
172.30.0.0 255.255.0.0 0.0.0.0 mgmt0 interface
Related Commands show ip route
Note
Mellanox Technologies
49
Page 50
ipv6 default-gateway
ipv6 default-gateway {<ip-address> | <ifname>}
no ipv6 default-gateway
Sets a static default gateway.
The no form of the command deletes the default gateway.
Syntax Description ip address The default gateway IP address (IPv4 or IPv6).
ifname The interface name (e.g., mgmt0, mgmt1).
Default N/A
Modes/Context Config
History 3.1.0000 Initial version
3.2.0500 removed IPv4 configuration option
Role admin
Rev 1.6.2
Example
switch (config) # ip default-gateway ::1
switch (config) # show ip default-gateway static
Configured default gateways:
::1
switch (config) #
Related Commands show ip route
Note
• The configured default gateway will not be used if DHCP is enabled.
• In order to configure ipv4 default-gateway use ‘ip route’ command.
Mellanox Technologies
50
Page 51
show ip/ipv6 route
show {ip | ipv6} route [static]
Displays the routing table in the system.
Syntax Description static Filters the table with the static route entries.
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show ip route
Destination Mask Gateway Interface Source
default 0.0.0.0 172.30.0.1 mgmt0 DHCP
10.10.10.10 255.255.255.255 0.0.0.0 mgmt0 static
20.10.10.10 255.255.255.255 172.30.0.1 mgmt0 static
20.20.20.0 255.255.255.0 0.0.0.0 mgmt0 static
172.30.0.0 255.255.0.0 0.0.0.0 mgmt0 interface
switch (config) # show ipv6 route
Destination prefix
Gateway Interface Source
-----------------------------------------------------------------------
::/0
:: mgmt0 static
::1/128
:: lo local
2222:2222:2222::/64
:: mgmt1 interface
switch (config) #
Related Commands show ip default-gateway
Note
Mellanox Technologies
51
Page 52
Rev 1.6.2
show ip/ipv6 default-gateway
show {ip | ipv6} default-gateway [static]
Displays the default gateway.
Syntax Description static Displays the static configuration of the default gateway.
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Example
switch (config) # ip default-gateway 10.10.10.10
switch (config) # show ip default-gateway
Active default gateways:
172.30.0.1 (interface: mgmt0)
switch (config) # show ip default-gateway static
Configured default gateway: 10.10.10.10
Related Commands show ip default-gateway
Note The configured IPv4 default gateway will not be used if DHCP is enabled.
2.1.4 Network to Media Resolution (ARP & NDP)
IPv4 network use Address Resolution Protocol (ARP) to resolve IP address to MAC address,
while IPv6 network uses Network Discovery Protocol (NDP) that performs basically the same as
ARP.
ip arp
ip arp <IP address> <MAC address>
no ip arp <IP address> <MAC address>
Sets a static ARP entry.
The no form of the command deletes the static ARP.
Syntax Description IP address IPv4 address.
MAC address MAC address.
Default N/A
Modes/Context Config Interface Management
History 3.2.0500
Role admin
Mellanox Technologies
52
Page 53
Rev 1.6.2
Example
switch (config interface mgmt0) #ip arp 20.20.20.20 aa:aa:aa:aa:aa:aa
switch (config interface mgmt0) # show ip arp
ARP Timeout: 1500
Total number of entries: 6
Address Type MAC Address Interface
10.209.1.103 Dynamic 00:02:C9:11:A1:78 mgmt0
10.209.1.168 Dynamic 00:02:C9:5E:C3:28 mgmt0
10.209.1.104 Dynamic 00:02:C9:11:A1:E6 mgmt0
10.209.1.153 Dynamic 00:02:C9:11:A1:86 mgmt0
10.209.1.105 Dynamic 00:02:C9:5E:0B:56 mgmt0
10.209.0.1 Dynamic 00:00:5E:00:01:01 mgmt0
20.20.20.20 Static AA:AA:AA:AA:AA:AA mgmt0
switch (config interface mgmt0) #
Related Commands show ip arp
ip route
Note
•
Mellanox Technologies
53
Page 54
show ip arp
show ip arp [count]
Shows the ARP table
Syntax Description N/A
Default N/A
Modes/Context Any Command Mode
History 3.2.0500
Role admin
Rev 1.6.2
Example
switch (config) # show ip arp
ARP Timeout: 1500
Total number of entries: 9
Address Type MAC Address Interface
10.209.1.105 Dynamic 00:02:C9:5E:0B:56 mgmt0
10.209.1.168 Dynamic 00:02:C9:5E:C3:28 mgmt0
10.209.0.1 Dynamic 00:00:5E:00:01:01 mgmt0
10.209.1.226 Dynamic 00:02:C9:62:6A:54 mgmt0
1.1.1.1 Static 00:00:00:00:00:01 Vlan1
1.1.2.1 Static 00:00:00:00:00:02 Vlan1
1.1.3.1 Static 00:00:00:00:00:03 Vlan1
1.1.4.1 Static 00:00:00:00:00:04 Vlan1
1.1.5.1 Static 00:00:00:00:00:05 Vlan1
ARP Timeout: 1500
switch (config) # show ip arp count
ARP Table size: 9 (inband:5, out of band:4)
switch (config) #
Related Commands ip arp
Note
•
Mellanox Technologies
54
Page 55
ipv6 neighbor
ipv6 neighbor <IPv6 address> <ifname> <MAC address>
no ipv6 neighbor <IPv6 address> <ifname> <MAC address>
Adds a static neighbor entry.
The no form of the command deletes the static entry.
Syntax Description IPv6 address The IPv6 address.
ifname The management interface (i.e. mgmt0, mgmt1).
MAC address The MAC address.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ipv6 neighbor 2001:db8:701f::8f9 mgmt0
00:11:22:33:44:55
switch (config) #
Related Commands show ipv6 neighbor
ipv6 route
arp
clear ipv6 neighbors
Note
• ARP is used only with IPv4. In IPv6 networks, Neighbor Discovery Protocol (NDP) is
used similarly.
• Use The no form of the command to remove static entries. Dynamic entries can be cleared
via the “clear ipv6 neighbors” command.
Mellanox Technologies
55
Page 56
clear ipv6 neighbors
clear ipv6 neighbors
Clears the dynamic neighbors cache.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # clear ipv6 neighbors
switch (config) #
Related Commands ipv6 neighbor
show ipv6 neighbor
arp
Note
• Clearing Neighbor Discovery Protocol (NDP) cache removes only the dynamic entries
learned and not the static entries configured
• Use the no form of the ipv6 neighbor command to remove static entries
Mellanox Technologies
56
Page 57
show ipv6 neighbors
show ipv6 neighbors [static]
Displays the Neighbor Discovery Protocol (NDP) table.
Syntax Description static Filters only the table of the static entries.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands ipv6 neighbor
Note
2.1.5 DHCP
ip dhcp
switch (config) # show ipv6 neighbors
IPv6 Address Age MAC Address State Interf
------------------------------------- ----- ----------------- ---------- ---
2001::2 9428 AA:AA:AA:AA:AA:AA permanent mgmt0
switch (config) #
clear ipv6 neighbor
show ipv6
ip dhcp {default-gateway yield-to-static| hostname <hostname>| primary-intf
<ifname> | send-hostname }
no ip dhcp {default-gateway yield-to-static| hostname | | primary-intf | send-hostname}
Sets global DHCP configuration.
The no form of the command deletes the DHCP configuration.
Mellanox Technologies
57
Page 58
Rev 1.6.2
Syntax Description yield-to-static| Does not allow you to install a default gateway from
DHCP if there is already a statically configured one.
hostname Specifies the hostname to be sent during DHCP client
negotiation if send-hostname is enabled.
primary-intf <ifname> Sets the interface from which a non-interface-specific
configuration (resolver and routes) will be accepted via
DHCP.
send-hostname Enables the DHCP client to send a hostname during
negotiation.
Default no ip dhcp yield-to-static
no ip dhcp hostname
ip ip dhcp primary-intf mgmt0
no ip dhcp send-hostname
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # ip dhcp default-gateway yield-to-static
switch (config) # show ip dhcp
DHCP primary interface:
Configured: mgmt0
Active: mgmt0
DHCP: yield default gateway to static configuration: yes
DHCP Client Options:
Send Hostname: no
Client Hostname: switch (using system hostname)
switch (config) #
Related Commands show ip dhcp
dhcp [renew]
Note DHCP is supported for IPv4 networks only.
Mellanox Technologies
58
Page 59
show ip dhcp
show ip dhcp
Displays the DHCP configuration and status.
Syntax Description N/A
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show ip dhcp
DHCP primary interface:
Configured: mgmt0
Active: mgmt0
DHCP: yield default gateway to static configuration: yes
DHCP Client Options:
Send Hostname: no
Client Hostname: switch (using system hostname)
switch (config) #
Related Commands ip dhcp
dhcp [renew]
Note
2.1.6 General IPv6 Commands
ipv6 enable
ipv6 enable
no ipv6 enable
Enables IPv6 globally on the management interface.
The no form of the command disables IPv6 globally on the management interface.
Syntax Description N/A
Default IPv6 is disabled
Modes/Context Config
History 3.1.0000
Role admin
Mellanox Technologies
59
Page 60
Rev 1.6.2
Example
Related Commands ipv6 default-gateway
Note
2.1.7 IP Diagnostic Tools
switch (config) # ipv6 enable
switch (config) # show ipv6
IPv6 summary
IPv6 supported: yes
IPv6 admin enabled: yes
IPv6 interface count: 2
switch (config) #
ipv6 host
ipv6 map-hostname
ipv6 neighbor
ipv6 route
show ipv6
show ipv6 default-gateway
show ipv6 route
Mellanox Technologies
60
Page 61
ping
ping [-LRUbdfnqrvVaA] [-c count] [-i interval] [-w deadline] [-p pattern] [-s
packetsize] [-t ttl] [-I interface or address] [-M mtu discovery hint] [-S sndbuf] [T timestamp option ] [-Q tos ] [hop1 ...] destination
Sends ICMP echo requests to a specified host.
Syntax Description Linux Ping options http://linux.about.com/od/commands/l/
blcmdl8_ping.htm
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ping 172.30.2.2
PING 172.30.2.2 (172.30.2.2) 56(84) bytes of data.
64 bytes from 172.30.2.2: icmp_seq=1 ttl=64 time=0.703 ms
64 bytes from 172.30.2.2: icmp_seq=2 ttl=64 time=0.187 ms
64 bytes from 172.30.2.2: icmp_seq=3 ttl=64 time=0.166 ms
64 bytes from 172.30.2.2: icmp_seq=4 ttl=64 time=0.161 ms
64 bytes from 172.30.2.2: icmp_seq=5 ttl=64 time=0.153 ms
64 bytes from 172.30.2.2: icmp_seq=6 ttl=64 time=0.144 ms
^C
--- 172.30.2.2 ping statistics ---
6 packets transmitted, 6 received, 0% packet loss, time 5004ms
rtt min/avg/max/mdev = 0.144/0.252/0.703/0.202 ms
switch (config) #
Related Commands traceroutes
Note
Mellanox Technologies
61
Page 62
traceroute
Rev 1.6.2
traceroute [-46dFITUnrAV] [-f first_ttl] [-g gate,...] [-i device] [-m max_ttl] [-N
squeries] [-p port] [-t tos] [-l flow_label] [-w waittime] [-q nqueries] [-s src_addr]
[-z sendwait] host [packetlen]
Traces the route packets take to a destination.
Mellanox Technologies
62
Page 63
Syntax Description -4 Uses IPv4.
-6 Uses IPv6.
-d Enables socket level debugging.
-F Sets DF (do not fragment bit) on.
-I Uses ICMP ECHO for tracerouting.
-T Uses TCP SYN for tracerouting.
-U Uses UDP datagram (default) for tracerouting.
-n Does not resolve IP addresses to their domain names.
-r Bypasses the normal routing and send directly to a host
on an attached network.
-A Performs AS path lookups in routing registries and
print results directly after the corresponding addresses.
-V Prints version info and exit.
-f Starts from the first_ttl hop (instead from 1).
Rev 1.6.2
-g Routes packets throw the specified gateway (maximum
8 for IPv4 and 127 for IPv6).
-i Specifies a network interface to operate with.
-m Sets the max number of hops (max TTL to be reached).
Default is 30.
-N Sets the number of probes to be tried simultaneously
(default is 16).
-p Uses destination port. It is an initial value for the UDP
destination port (incremented by each probe, default is
33434), for the ICMP seq number (incremented as well,
default from 1), and the constant destination port for
TCP tries (default is 80).
-t Sets the TOS (IPv4 type of service) or TC (IPv6 traffic
class) value for outgoing packets.
-l Uses specified flow_label for IPv6 packets.
-w Sets the number of seconds to wait for response to a
probe (default is 5.0). Non-integer (float point) values
allowed too.
-q Sets the number of probes per each hop. Default is 3.
-s Uses source src_addr for outgoing packets.
-z Sets minimal time interval between probes (default is
0). If the value is more than 10, then it specifies a number in milliseconds, else it is a number of seconds (float
point values allowed too).
Mellanox Technologies
63
Page 64
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands
Note
switch (config) # traceroute 192.168.10.70
traceroute to 192.168.10.70 (192.168.10.70), 30 hops max, 40 byte packets
1 172.30.0.1 (172.30.0.1) 3.632 ms 2.849 ms 3.544 ms
2 10.222.128.46 (10.222.128.46) 3.176 ms 3.289 ms 3.656 ms
3 10.158.128.30 (10.158.128.30) 15.331 ms 15.819 ms 16.388 ms
4 10.158.128.65 (10.158.128.65) 20.468 ms 7.893 ms 12.27 ms
5 10.7.34.115 (10.7.34.115) 16.405 ms 11.985 ms 12.264 ms
6 192.168.10.70 (192.168.10.70) 16.377 ms 16.091 ms 20.475 ms
switch (config) #
Mellanox Technologies
64
Page 65
tcpdump
tcpdump [-aAdDeflLnNOpqRStuUvxX] [-c count] [ -C file_size ]
[ -E algo:secret ] [ -F file ] [ -i interface ] [ -M secret ]
[ -r file ] [ -s snaplen ] [ -T type ] [ -w file ]
[ -W filecount ] [ -y datalinktype ] [ -Z user ]
[ expression ]
Invokes standard binary, passing command line parameters straight through. Runs in
foreground, printing packets as they arrive, until the user hits Ctrl+C.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # tcpdump
......
09:37:38.678812 IP 192.168.10.7.ssh > 192.168.10.1.54155: P
1494624:1494800(176) ack 625 win 90
<nop,nop,timestamp 5842763 858672398>
09:37:38.678860 IP 192.168.10.7.ssh > 192.168.10.1.54155: P
1494800:1495104(304) ack 625 win 90
<nop,nop,timestamp 5842763 858672398>
...
9141 packets captured
9142 packets received by filter
0 packets dropped by kernel
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
65
Page 66
clear counters
clear counters [all | interface <type> <number>]
Clears switch counters.
Syntax Description all Clears all switch counters.
type A specific interface type (i.e. Ethernet, port-channel,
Pkey interface, VLAN interface).
number The interface number.
Default N/A
Modes/Context Config interface ethernet
Config Interface Port Channel
History 3.2.3000
Role admin
Rev 1.6.2
Example
Related Commands
Note
2.2 License Keys
license
switch (config) # clear counters
switch (config) #
license {delete <license number> | install <license key>}
no license install <license key>
Activates features using license keys.
The no form of the command uninstalls an existing license key. If the key specified
was not already installed, an error is returned.
Mellanox Technologies
66
Page 67
Rev 1.6.2
Syntax Description delete Uninstalls an existing license key. Note that this has the
same effect as the “no license install”, except that you
specify the license by its ID instead of by repeating the
license key.
install Installs a new license key. If the key is invalid (i.e. it
could never have been a valid license), an error message is printed and it is not added. If the license is valid
but there is something else wrong with it (i. e. it names
a nonexistent feature, it is expired, etc.) a warning message is printed but it is added.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # license install <license key>
switch (config) # show licenses
License 1: <license key>
Feature: SX_CONFIG
Valid: yes
Active: yes
switch (config) #
Related Commands show licenses
Note
Mellanox Technologies
67
Page 68
show licenses
show licenses
Displays a list of all installed licenses. For each license, the following is displayed:
• a unique ID which is a small integer
• the text of the license key as it was added
• whether or not it is valid and active
• which feature(s) it is activating
• a list of all licensable features specifying whether or not it is currently activated by a
license
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role monitor/admin
Rev 1.6.2
Example
switch (config) # show licenses
License 1: <license key>
Feature: SX_CONFIG
Valid: yes
Active: yes
switch (config) #
Related Commands license
Note
Mellanox Technologies
68
Page 69
2.3 NTP, Clock & Time Zones
clock set
clock set <hh:mm:ss> [<yyyy/mm/dd>]
Sets the time and date.
Syntax Description hh:mm:ss Time.
yyyy/mm/dd Date.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # clock set 23:23:23 2010/08/19
switch (config) # show clock
Time: 23:23:26
Date: 2010/08/19
Time zone: UTC
(Etc/UTC)
UTC offset: same as UTC
switch (config) #
Related Commands show clock
Note If not specified, the date will be left the same.
Mellanox Technologies
69
Page 70
Rev 1.6.2
clock timezone
clock timezone [<zone word> [<zone word> [<zone
word>] [<zone word>]]]
Sets the system time zone. The time zone may be specified in one of three ways:
• A nearby city whose time zone rules to follow. The system has a large list of cities which
can be displayed by the help and completion system. They are organized hierarchically
because there are too many of them to display in a flat list. A given city may be required to
be specified in two, three, or four words, depending on the city.
• An offset from UTC. This will be in the form UTC-offset UTC, UTC-offset UTC+<0-14>,
UTC-offset UTC-<1-12>.
• UTC (Universal Time, which is almost identical to GMT), and this is the default time zone
The no form of the command resets time zone to its default (GMT).
Syntax Description zone word The possible forms this could take include: continent,
city, continent, country, city, continent, region, country,
city, ocean, and/or island.
Default GMT
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # clock timezone America North United_States Other
New_York
switch (config) # show clock
Time: 04:21:44
Date: 2012/02/26
Time zone: America North United_States Other New_York
switch (config) #
Related Commands show clock
Note
Mellanox Technologies
70
Page 71
ntp
ntp {disable | enable | {peer | server} <IP address> [version <number> | disable]}
no ntp {disable | enable | {peer | server} <IP address> [disable]}
Configures NTP.
The no form of the command negates NTP options.
Syntax Description disable Disables NTP.
enable Enables NTP.
peer or server Configures an NTP peer or server node.
IP address IPv4 or IPv6 address.
version <number> Specifies the NTP version number of this peer. Possible
values are 3 or 4.
Default NTP is enabled.
NTP version number is 4.
Rev 1.6.2
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # no ntp peer 192.168.10.24 disable
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
71
Page 72
ntpdate
ntpdate <IP address>
Sets the system clock using the specified SNTP server.
Syntax Description IP address IP.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # ntpdate 192.168.10.10
26 Feb 17:25:40 ntpdate[15206]: adjust time server 192.168.10.10 offset
-0.000092 sec
switch (config) #
Related Commands N/A
Note This is a one-time operation and does not cause the clock to be kept in sync on an
ongoing basis. It will generate an error if SNTP is enabled since the socket it requires
will already be in use.
Mellanox Technologies
72
Page 73
show clock
show clock
Displays the current system time, date and time zone.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show clock
Time: 04:21:44‘
Date: 2012/02/26
Time zone: America North United_States Other New_York
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
73
Page 74
show ntp
show ntp
Displays the current NTP settings.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show ntp
NTP is enabled.
Clock is unsynchronized.
No NTP peers or servers configured.
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
74
Page 75
2.4 Software Management
This chapter displays all the relevant commands used to manage the system software image.
image boot
image boot {location <location ID> | next}
Specifies the default location where the system should be booted from.
Syntax Description location ID Specifies the default destination location. There can be
next Sets the boot location to be the next once after the one
Default N/A
Modes/Context enable/config
History 3.1.0000
Rev 1.6.2
up to 2 images on the system. The possible values are 1
or 2.
currently booted from, thus avoiding a cycle through all
the available locations.
Role admin
Example
Related Commands show images
Note
switch (config) # image boot location 2
switch (config) #
Mellanox Technologies
75
Page 76
boot next
boot next fallback-reboot enable
no boot next fallback-reboot enable
Sets the default setting for next boot. Normally, if the system fails to apply the configuration on startup (after attempting upgrades or downgrades, as appropriate), it will
reboot to the other partition as a fallback.
The no form of the command tells the system not to do that, only for the next boot.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.2.0506
Role admin
Rev 1.6.2
Example
switch (config) # boot fallback-reboot enable
switch (config) #
Related Commands show images
Note Normally, if the system fails to apply the configuration on startup (after attempting
upgrades or downgrades, as appropriate), it will reboot to the other partition as a fallback. The 'no' variant of this command tells the system NOT to do that, ONLY for
the next boot. Note that this setting is not persistent, and will go back to enabled automatically after every boot.
Note that if you are downgrading to an older software version which has never been
run yet on this system, the "fallback reboot" will ALWAYS happen, unless you use
"no boot next fallback-reboot enable" first. This is also true in some other cases, such
as when you have run the older software version before, but you have switched to a
different configuration file since upgrading. In general, a downgrade will only work
(without having the fallback reboot forcibly disabled) if it can find a snapshot of the
configuration file (by the same name as the currently active one) which was taken
when you earlier upgraded from the older software version. If it doesn't find this file,
it will do a fallback reboot in preference to falling back to the initial database, since
the latter will generally involve a loss of network connectivity, and avoid that is considered of paramount importance.
Mellanox Technologies
76
Page 77
image default-chip-fw
image default-chip-fw <file name>
Sets the default firmware package to be installed.
Syntax Description filename Specifies the firmware filename.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # image default-chip-fw image-SX_PPC_M460EX-ppc-m460ex20120122-084759.img
switch (config) #
Related Commands image install-chip fw
show images
Note
Mellanox Technologies
77
Page 78
image delete
image delete <image name>
Deletes the specified image file.
Syntax Description image name Specifies the image name.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # image delete image-MLXNX-OS-201140526-010145.img
switch (config) #
Related Commands show images
Note
Mellanox Technologies
78
Page 79
Rev 1.6.2
image fetch
image fetch <URL> [<filename>]
Downloads an image from the specified URL or via SCP.
Syntax Description URL HTTP, HTTPS, FTP, TFTP, SCP and SFTP are sup-
ported. Example: scp://username[:password]@hostname/path/filename.
filename Specifies a filename for this image to be stored as
locally.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # image fetch scp://<username>@192.168.10.125/var/www/
html/<image_name>
Password ******
100.0%[############################################################]
switch (config) #
Related Commands show images
Note
• Please delete the previously available image, prior to fetching the new image
• See section “Upgrading MLNX-OS SX Software,” in the Mellanox SwitchX® User Man-
ual for a full upgrade example
Mellanox Technologies
79
Page 80
image install
image install <image filename> [location <location ID>] | [progress <progoptions>] [verify <ver-options>]
Installs the specified image file.
Syntax Description image filename Specifies the image name.
location ID Specifies the image destination location.
Rev 1.6.2
prog-options
ver-options
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # image install SX_PPC_M460EX 3.0.0000-dev-HA 2012-0122 08:47:59 ppc
Step 1 of 4: Verify Image
100.0%
[################################################################]
Step 2 of 4: Uncompress Image
100.0%
[################################################################]
Step 3 of 4: Create Filesystems
100.0%
[################################################################]
Step 4 of 4: Extract Image
100.0%
[################################################################]
switch (config) #
• “no-track” overrides CLI default and does not track the
installation progress
• “track” overrides CLI default and tracks the installation
progress
• “check-sig” requires an image to have either a valid signature or no signature
• “ignore-sig” allows unsigned or invalidly signed images
to be installed
• “require-sig” requires from the installed image to have a
valid signature. If a valid signature is not found on the
image, the image cannot be installed.
Related Commands show images
Note
• The image cannot be installed on the “active” location (the one which is currently being
• On a two-location system, the location is chosen automatically if no location is specified
booted)
Mellanox Technologies
80
Page 81
image move
image move <src image name> <dest image name>
Renames the specified image file.
Syntax Description src image name Specifies the old image name.
dest image name Specifies the new image name.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # image move image1.img image2.img
switch (config) #
Related Commands show images
Note
Mellanox Technologies
81
Page 82
Rev 1.6.2
image options
image options require-sig
no image options require-sig
Requires from all the installed images a valid signature.
The no form of the command does not require a signature. However if one is present,
it must be valid.
Syntax Description require-sig Requires images to be signed by a trusted signature.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # image options require-sig
switch (config) #
Related Commands show images
Note
Mellanox Technologies
82
Page 83
show bootvar
show bootvar
Displays the installed system images and the boot parameters.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show bootvar
Installed images:
Partition 1:
SX_PPC_M460EX 3.0.0000-dev-HA 2012-01-22 08:47:59 ppc
Last dobincp: 2012/01/23 14:54:23
Partition 2:
SX_PPC_M460EX 3.0.0000-dev-HA 2012-01-18 09:52:41 ppc
Last dobincp: 2012/01/19 16:48:23
Last boot partition: 1
Next boot partition: 1
Boot manager password is set.
No image install currently in progress.
Image signing: trusted signature always required
Admin require signed images: yes
Settings for next boot only:
Fallback reboot on configuration failure: yes (default)
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
83
Page 84
show images
show image
Displays information about the system images and boot parameters.
Syntax Description N/A
Default N/A
Modes/Context Any Command Mode
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show images
Images available to be installed:
image-SX_PPC_M460EX-ppc-m460ex-20120122-084759.img
SX_PPC_M460EX 3.0.0000-dev-HA 2012-01-22 08:47:59 ppc
Installed images:
Partition 1:
SX_PPC_M460EX 3.0.0000-dev-HA 2012-01-22 08:47:59 ppc
Last dobincp: 2012/01/23 14:54:23
Partition 2:
SX_PPC_M460EX 3.0.0000-dev-HA 2012-01-18 09:52:41 ppc
Last dobincp: 2012/01/19 16:48:23
Last boot partition: 1
Next boot partition: 1
Boot manager password is set.
No image install currently in progress.
Image signing: trusted signature always required
Admin require signed images: yes
Settings for next boot only:
Fallback reboot on configuration failure: yes (default)
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
84
Page 85
2.5 File Management
2.5.1 File Transfer
ftp-server enable
Rev 1.6.2
ftp-server enable
no ftp-server enable
Enables the FTP server.
The no form of the command disables the FTP server.
Syntax Description
Default
Modes/Context
History
Role
Example
Related Commands
Note
N/A
The FTP server is disabled
Config
3.1.0000
admin
switch (config) # ftp-server enable
switch (config) # show ftp-server
FTP server enabled: yes
show ftp-server
Mellanox Technologies
85
Page 86
show ftp-server
show ftp-server
Displays FTP server settings.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands ftp-server enable
Note
2.5.2 File System
debug generate dump
Syntax Description
Default
Modes/Context
History
Role
switch (config) # show ftp-server
FTP server enabled: yes
switch (config) #
debug generate dump
Generates a debug dump.
N/A
N/A
Config
3.1.0000
admin
Example
Related Commands
Note
switch (config) # debug generate dump
Generated dump sysdump-switch-112104-201140526-091707.tgz
switch (config) #
file debug-dump
The dump can then be manipulated using the “file debug-dump...” commands.
Mellanox Technologies
86
Page 87
file debug-dump
file debug-dump {delete <filename> | email <filename> | upload {<filename> |
<URL>}}
Manipulates debug dump files.
Syntax Description delete <filename> Deletes a debug dump file.
email <filename> Emails a debug dump file to pre-configured recipients
for “informational events”, regardless of whether they
have requested to receive “detailed” notifications or
not.
upload <filename> Uploads a debug dump file to a remote host.
URL HTTP, HTTPS, FTP, TFTP, SCP and SFTP are sup-
ported. Example: scp://username[:password]@hostname/path/filename.
Default N/A
Rev 1.6.2
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # file debug-dump email sysdump-switch-112104-20114052-
091707.tgz
switch (config) #
Related Commands show files debug-dump
Note
Mellanox Technologies
87
Page 88
file stats
file stats {delete <filename> | move {<source filename> | <destination filename>}
| upload <filename> <URL>}
Manipulates statistics report files.
Syntax Description delete <filename> Deletes a stats report file.
Rev 1.6.2
move <source filename>
<destination filename>
upload <filename>
<URL>
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # file stats move memory-1.csv memory-2.csv
switch (config) #
Related Commands show files stats
show files stats <filename>
Note
Renames a stats report file.
Uploads a stats report file.
URL - HTTP, HTTPS, FTP, TFTP, SCP and SFTP are
supported. Example: scp://username[:password]@hostname/path/filename.
Mellanox Technologies
88
Page 89
file tcpdump
file tcpdump {delete <filename> | upload <filename> <URL>}
Manipulates tcpdump output files.
Syntax Description delete <filename> Deletes the specified tcpdump output file.
Rev 1.6.2
upload <filename>
<URL>
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # file tcmpdump delete my-tcpdump-file.txt
switch (config) #
Related Commands show files stats
tcpdump
Note
Uploads the specified tcpdump output file to the specified URL.
URL - HTTP, HTTPS, FTP, TFTP, SCP and SFTP are
supported. Example: scp://username[:password]@hostname/path/filename.
Mellanox Technologies
89
Page 90
show files debug-dump
show files debug-dump [<filename>]
Displays a list of debug dump files.
Syntax Description filename Displays a summary of the contents of a particular
debug dump file.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show files debug-dump sysdump-switch-112104-20114052-
091707.tgz
System information:
Hostname: switch-112104
Version: SX_PPC 3.1.0000 2011-05-25 13:59:00 ppc
Date: 2012-01-26 09:17:07
Uptime: 0d 18h 47m 48s
==================================================
Output of 'uname -a':
Linux switch-112104 2.6.27-MELLANOXuni-m405ex SX_PPC 3.1.0000 #1 201201-25 13:59:00 ppc ppc
ppc GNU/Linux
==================================================
..................................................
switch (config) #
Related Commands file debug-dump
Note
Mellanox Technologies
90
Page 91
Rev 1.6.2
show files stats
show files stats <filename>
Displays a list of statistics report files.
Syntax Description filename Display the contents of a particular statistics report file.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Example
switch (config) # show files stats
memory-201140524-111745.csv
switch (config) #
Related Commands file stats
Note
Mellanox Technologies
91
Page 92
show files system
show files system [detail]
Displays usage information of the file systems on the system.
Syntax Description detail Displays more detailed information on file-system.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show files system
Statistics for /config filesystem:
Bytes Total 100 MB
Bytes Used 3 MB
Bytes Free 97 MB
Bytes Percent Free 97%
Bytes Available 97 MB
Inodes Total 0
Inodes Used 0
Inodes Free 0
Inodes Percent Free 0%
Statistics for /var filesystem:
Bytes Total 860 MB
Bytes Used 209 MB
Bytes Free 651 MB
Bytes Percent Free 75%
Bytes Available 651 MB
Inodes Total 0
Inodes Used 0
Inodes Free 0
Inodes Percent Free 0%
switch (config) #
Related Commands N/A
Note
Mellanox Technologies
92
Page 93
show files tcpdump
show files tcpdump
Displays a list of statistics report files.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show files stats
test
dump3
switch (config) #
Related Commands file tcpdump
tcpdump
Note
Mellanox Technologies
93
Page 94
2.5.3 Configuration File
configuration audit
Rev 1.6.2
configuration audit max-changes <number>
Chooses settings related to configuration change auditing.
Syntax Description
Default
Modes/Context
History
Role
Example
Related Commands
Note
max-changes Set maximum number of audit messages to log per
change.
1000
Config
3.1.0000
admin
switch (config) # configuration audit max-changes 100
switch (config) # show configuration audit
Maximum number of changes to log: 100
switch (config) #
show configuration
N/A
Mellanox Technologies
94
Page 95
configuration copy
configuration copy <source name> <dest name>
Copies a configuration file.
Syntax Description source name Name of source file.
dest name Name of destination file. If the file of specified file-
name does not exist a new file will be created with said
filename.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands
Note
switch (config) # configuration copy initial.bak example
switch (config) #
• This command does not affect the current running configuration
• The active configuration file may not be the target of a copy. However, it may be the source
of a copy in which case the original remains active.
Mellanox Technologies
95
Page 96
configuration delete
configuration delete <filename>
Deletes a configuration file.
Syntax Description filename Name of file to delete.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show configuration files
example initial initial.bak initial.prev
switch (config) # configuration delete example
switch (config) # show configuration files
initial initial.bak initial.prev
switch (config) #
Related Commands show configuration
Note
• This command does not affect the current running configuration
• The active configuration file may not be deleted
Mellanox Technologies
96
Page 97
configuration fetch
configuration fetch <URL or scp or sftp://username:password@
hostname[:port]/path/filename> [<name>]
Downloads a configuration file from a remote host.
Syntax Description name The configuration file name.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # configuration fetch scp://root:password@
192.168.10.125/tmp/conf1
switch (config) #
Related Commands configuration switch-to
Note
• The downloaded file should not override the active configuration file, using the <name>
parameter
• If no name is specified for a configuration fetch, it is given the same name as it had on the
server
• No configuration file may have the name “active”
Mellanox Technologies
97
Page 98
configuration jump-start
configuration jump-start
Runs the initial-configuration wizard.
Syntax Description N/A
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # configuration jump-start
Mellanox configuration wizard
Step 1: Hostname? [switch-3cc29c]
Step 2: Use DHCP on mgmt0 interface? y
Step 3: Admin password (Enter to leave unchanged)?
You have entered the following information:
1. Hostname: switch-3cc29c
2. Use DHCP on mgmt0 interface: yes
3. Enable IPv6: yes
4. Enable IPv6 autoconfig (SLAAC) on mgmt0 interface: yes
53. Admin password (Enter to leave unchanged): (unchanged)
To change an answer, enter the step number to return to.
Otherwise hit <enter> to save changes and exit.
Choice:
Configuration changes saved.
switch (config) #
Related Commands N/A
Note
• The wizard is automatically invoked whenever the CLI is launched when the active config-
• This command invokes the wizard on demand – see chapter “Initializing the Switch for the
uration file is fresh (i.e. not modified from its initial contents)
First Time” in the Mellanox MLNX-OS SwitchX User Manual
Mellanox Technologies
98
Page 99
configuration merge
configuration merge <filename>
Merges the “shared configuration” from one configuration file into the running configuration.
Syntax Description filename Name of file from which to merge settings.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
Related Commands
Note
switch (config) # configuration merge new-config-file
switch (config) #
• No configuration files are modified during this process
• The configuration name must be a non-active configuration file
Mellanox Technologies
99
Page 100
configuration move
configuration move <source name> <dest name>
Moves a configuration file.
Syntax Description source name Old name of file to move.
dest name New name for moved file.
Default N/A
Modes/Context Config
History 3.1.0000
Role admin
Rev 1.6.2
Example
switch (config) # show configuration files
example1 initial initial.bak initial.prev
switch (config) # configuration move example1 example2
switch (config) # show configuration files
example2 initial initial.bak initial.prev
switch (config) #
Related Commands show configuration
Note
• This command does not affect the current running configuration
• The active configuration file may not be the target of a move
Mellanox Technologies
100
Loading...