Dell PowerEdge FX2, PowerEdge FX2s User Manual

Dell PowerEdge FN I/O Aggregator

Command Line Reference Guide

9.6.(0.0)

Notes, Cautions, and Warnings

NOTE: A NOTE indicates important information that helps you make better use of your computer.

CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem.

WARNING: A WARNING indicates a potential for property damage, personal injury, or death.

Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws. Dell™ and the Dell logo are trademarks of Dell Inc. in the United States and/or other jurisdictions. All other marks and names mentioned herein may be trademarks of their respective companies.

2014–09

Rev. A01

Contents
1 About this Guide..................................................................................................	17
Objectives............................................................................................................................................	17
Audience..............................................................................................................................................	18
Conventions.........................................................................................................................................	18
2 Before You Start..................................................................................................	19
IOA Operational Modes.......................................................................................................................	19
Default Settings...................................................................................................................................	20
Other Auto-Configured Settings........................................................................................................	20
DCB Support........................................................................................................................................	21
FCoE Connectivity...............................................................................................................................	21
iSCSI Operation....................................................................................................................................	21
Link Aggregation.................................................................................................................................	22
Link Tracking.......................................................................................................................................	22
VLANs...................................................................................................................................................	22
Where to Go From Here.....................................................................................................................	23
3 CLI Basics.............................................................................................................	24
Accessing the Command Line............................................................................................................	24
Multiple Configuration Users..............................................................................................................	24
Navigating the CLI...............................................................................................................................	25
Obtaining Help....................................................................................................................................	26
Using the Keyword no Command......................................................................................................	27
Filtering show Commands..................................................................................................................	27
Command Modes...............................................................................................................................	28
4 File Management.................................................................................................	31
boot system gateway..........................................................................................................................	31
boot system stack-unit........................................................................................................................	31
cd.........................................................................................................................................................	32
copy.....................................................................................................................................................	32
copy running-config startup-config..................................................................................................	34
delete...................................................................................................................................................	34
dir.........................................................................................................................................................	35
format flash..........................................................................................................................................	35
[no] logging coredump stack-unit.....................................................................................................	36
pwd......................................................................................................................................................	36
rename.................................................................................................................................................	37

restore factory-defaults......................................................................................................................	37
show boot system...............................................................................................................................	39
show file..............................................................................................................................................	40
show file-systems...............................................................................................................................	40
show os-version..................................................................................................................................	41
show running-config..........................................................................................................................	42
show version.......................................................................................................................................	44
upgrade boot.......................................................................................................................................	45
upgrade system...................................................................................................................................	46
5 Control and Monitoring....................................................................................	48
asset-tag..............................................................................................................................................	48
clear alarms.........................................................................................................................................	48
clear command history.......................................................................................................................	49
configure.............................................................................................................................................	49
debug cpu-traffic-stats.......................................................................................................................	49
debug ifm trace-flags.........................................................................................................................	50
disable..................................................................................................................................................	51
enable...................................................................................................................................................	51
end.......................................................................................................................................................	52
exit........................................................................................................................................................	52
ftp-server enable.................................................................................................................................	52
ftp-server topdir..................................................................................................................................	53
ftp-server username...........................................................................................................................	54
hostname.............................................................................................................................................	54
ip telnet server enable.........................................................................................................................	55
ip telnet source-interface...................................................................................................................	55
line.......................................................................................................................................................	56
ping......................................................................................................................................................	56
reload...................................................................................................................................................	57
service timestamps..............................................................................................................................	57
show alarms........................................................................................................................................	58
show command-history.....................................................................................................................	59
show configuration lock.....................................................................................................................	60
show cpu-traffic-stats.........................................................................................................................	61
show debugging..................................................................................................................................	62
show diag............................................................................................................................................	62
show environment..............................................................................................................................	63
show inventory....................................................................................................................................	64
show memory.....................................................................................................................................	65
show processes cpu...........................................................................................................................	66
show processes ipc flow-control......................................................................................................	68

show processes memory....................................................................................................................	69
show revision.......................................................................................................................................	72
show server-interfaces........................................................................................................................	72
show system........................................................................................................................................	73
show tech-support..............................................................................................................................	75
show uplink brief.................................................................................................................................	78
show util-threshold cpu.....................................................................................................................	80
show util-threshold memory.............................................................................................................	80
ssh-peer-stack-unit............................................................................................................................	81
telnet....................................................................................................................................................	81
telnet-peer-stack-unit........................................................................................................................	82
terminal length....................................................................................................................................	82
terminal monitor.................................................................................................................................	83
terminal xml.........................................................................................................................................	83
trace route...........................................................................................................................................	84
undebug all..........................................................................................................................................	85
write.....................................................................................................................................................	85
6 u-Boot..................................................................................................................	86
boot change........................................................................................................................................	86
boot show net config retries..............................................................................................................	86
boot write net config retries...............................................................................................................	87
boot zero.............................................................................................................................................	87
default gateway...................................................................................................................................	87
enable..................................................................................................................................................	88
help......................................................................................................................................................	88
ignore enable password.....................................................................................................................	89
ignore startup-config..........................................................................................................................	89
interface management ethernet ip address.......................................................................................	89
[no] default gateway...........................................................................................................................	89
no interface management ethernet ip address.................................................................................	90
reload...................................................................................................................................................	90
show boot blc.....................................................................................................................................	90
show boot selection............................................................................................................................	91
show bootflash....................................................................................................................................	91
show bootvar......................................................................................................................................	92
show default gateway.........................................................................................................................	92
show interface management ethernet...............................................................................................	93
show interface management port config..........................................................................................	93
syntax help..........................................................................................................................................	94

7 Data Center Bridging (DCB)..............................................................................

95

clear dcbx counters............................................................................................................................	95
clear ets counters................................................................................................................................	96
clear pfc counters...............................................................................................................................	96
dcb enable auto-detect on-next-reload...........................................................................................	97
dcbx version......................................................................................................................................	100
show dcb...........................................................................................................................................	101
show interface dcbx detail................................................................................................................	101
show interface ets.............................................................................................................................	104
show interface pfc.............................................................................................................................	107
show interface pfc statistics..............................................................................................................	110
show qos dcb-map...........................................................................................................................	110
8 Dynamic Host Configuration Protocol.........................................................	112
clear ip dhcp client statistics.............................................................................................................	112
debug ip dhcp client events..............................................................................................................	113
debug ip dhcp client packets............................................................................................................	113
ip address dhcp..................................................................................................................................	114
release dhcp interface.......................................................................................................................	114
renew dhcp interface........................................................................................................................	115
show ip dhcp client statistics............................................................................................................	116
show ip dhcp lease............................................................................................................................	116
9 FIP Snooping......................................................................................................	118
clear fip-snooping statistics..............................................................................................................	118
debug fip-snooping...........................................................................................................................	118
show fip-snooping config................................................................................................................	120
show fip-snooping enode................................................................................................................	120
show fip-snooping fcf.......................................................................................................................	121
show fip-snooping sessions.............................................................................................................	122
show fip-snooping statistics.............................................................................................................	123
show fip-snooping system...............................................................................................................	126
show fip-snooping vlan....................................................................................................................	126
10 HTTP Copy via CLI..........................................................................................	128
copy http...........................................................................................................................................	128
11 Internet Group Management Protocol (IGMP).........................................	129
IGMP Commands..............................................................................................................................	129
clear ip igmp groups.........................................................................................................................	129
debug ip igmp...................................................................................................................................	130
ip igmp snooping flood.....................................................................................................................	130
show ip igmp groups.........................................................................................................................	131

show ip igmp interface......................................................................................................................	132
show ip igmp snooping mrouter......................................................................................................	133
12 Interfaces.........................................................................................................	134
Port Interface Commands................................................................................................................	134
Port Channel Commands.................................................................................................................	135
Time Domain Reflectometer (TDR) Commands..............................................................................	135
Virtual LAN (VLAN) Commands.........................................................................................................	135
auto vlan............................................................................................................................................	136
clear counters....................................................................................................................................	136
clear mac-address-table dynamic....................................................................................................	137
default vlan-id....................................................................................................................................	137
description.........................................................................................................................................	138
interface range..................................................................................................................................	139
interface vlan.....................................................................................................................................	140
monitor interface...............................................................................................................................	141
stack-unit port-group port mode ethernet.....................................................................................	143
name..................................................................................................................................................	144
negotiation auto................................................................................................................................	145
show config (INTERFACE mode)......................................................................................................	146
show config (from INTERFACE RANGE mode)................................................................................	146
show config (from INTERFACE VLAN mode)...................................................................................	147
show config (from PROTOCOL LLDP mode)..................................................................................	147
show interfaces.................................................................................................................................	148
show interfaces configured...............................................................................................................	151
show interfaces description..............................................................................................................	152
show interfaces port-channel..........................................................................................................	153
show interfaces stack-unit................................................................................................................	156
show interfaces status.......................................................................................................................	157
show interfaces switchport...............................................................................................................	158
show tdr.............................................................................................................................................	159
show vlan..........................................................................................................................................	160
shutdown...........................................................................................................................................	162
speed (for 1000/10000 interfaces)...................................................................................................	163
tdr-cable-test....................................................................................................................................	163
vlan tagged (CMC).............................................................................................................................	164
vlan untagged (CMC)........................................................................................................................	165
13 IPv4 Routing....................................................................................................	167

clear tcp statistics..............................................................................................................................	167
debug ip dhcp....................................................................................................................................	167
debug ip icmp...................................................................................................................................	168

ip route..............................................................................................................................................	169
management route...........................................................................................................................	170
show arp.............................................................................................................................................	171
show ip interface...............................................................................................................................	173
show ip management-route.............................................................................................................	175
show ip multicast-cam stack-unit....................................................................................................	175
show ip route.....................................................................................................................................	177
show tcp statistics.............................................................................................................................	179
14 iSCSI Optimization.........................................................................................	182
show iscsi..........................................................................................................................................	182
show iscsi sessions............................................................................................................................	183
show iscsi sessions detailed..............................................................................................................	183
15 Isolated Networks...........................................................................................	185
io-aggregator isolated-network vlan...............................................................................................	185
show io-aggregator isolated-networks ..........................................................................................	185
16 Link Aggregation Control Protocol (LACP)...............................................	187
auto-lag enable.................................................................................................................................	187
clear lacp counters............................................................................................................................	187
debug lacp.........................................................................................................................................	188
io-aggregator auto-lag enable.........................................................................................................	189
show io-aggregator auto-lag status................................................................................................	189
show lacp..........................................................................................................................................	190
show port-channel-flow...................................................................................................................	191
show link-bundle-distribution port-channel...................................................................................	192
17 Layer 2...............................................................................................................	194
MAC Addressing Commands............................................................................................................	194
Virtual LAN (VLAN) Commands........................................................................................................	194
clear mac-address-table dynamic...................................................................................................	194
description.........................................................................................................................................	195
show cam mac stack-unit................................................................................................................	195
18 Link Layer Discovery Protocol (LLDP).........................................................	197
clear lldp counters.............................................................................................................................	197
debug lldp interface..........................................................................................................................	198
protocol lldp (Configuration)............................................................................................................	199
protocol lldp (Interface)....................................................................................................................	199
show lldp neighbors..........................................................................................................................	199
show lldp statistics............................................................................................................................	200

19 Port Monitoring..............................................................................................	202
description........................................................................................................................................	203
monitor session................................................................................................................................	203
show config......................................................................................................................................	204
show monitor session......................................................................................................................	204
show running-config monitor session............................................................................................	205
source (port monitoring)..................................................................................................................	206
20 Quality of Service (QoS)................................................................................	207
Policy-Based QoS Commands.........................................................................................................	207
show qos dcb-map...........................................................................................................................	207
show qos dot1p-queue-mapping....................................................................................................	208
21 Security............................................................................................................	209
AAA Accounting Commands...........................................................................................................	209
aaa accounting...........................................................................................................................	209
aaa accounting suppress............................................................................................................	210
accounting...................................................................................................................................	211
aaa authorization commands......................................................................................................	211
aaa authorization config-commands.........................................................................................	212
aaa authorization exec................................................................................................................	213
show accounting.........................................................................................................................	214
Authentication and Password Commands.......................................................................................	215
aaa authentication enable...........................................................................................................	215
aaa authentication login..............................................................................................................	216
banner exec.................................................................................................................................	217
banner login.................................................................................................................................	218
debug radius................................................................................................................................	219
debug tacacs+............................................................................................................................	220
exec-banner................................................................................................................................	220
ip radius source-interface..........................................................................................................	220
ip tacacs source-interface..........................................................................................................	221
login authentication....................................................................................................................	221
RADIUS Commands..........................................................................................................................	222
radius-server deadtime...............................................................................................................	222
radius-server host.......................................................................................................................	223
radius-server retransmit..............................................................................................................	224
radius-server timeout..................................................................................................................	225
radius-server key.........................................................................................................................	225
show privilege.............................................................................................................................	226
Suppressing AAA Accounting for Null Username Sessions.............................................................	226

TACACS+ Commands......................................................................................................................	226
tacacs-server host.......................................................................................................................	227
tacacs-server key........................................................................................................................	227
TACACS+ Accounting.................................................................................................................	228
timeout login response...............................................................................................................	229
SSH Server and SCP Commands......................................................................................................	230
enable password.........................................................................................................................	230
enable restricted..........................................................................................................................	231
service password-encryption.....................................................................................................	232
show ip ssh..................................................................................................................................	232
show ip ssh client-pub-keys.......................................................................................................	233
show ip ssh rsa-authentication..................................................................................................	233
show users...................................................................................................................................	234
ssh................................................................................................................................................	235
username.....................................................................................................................................	235
22 Simple Network Management Protocol (SNMP) and Syslog..................	237
SNMP Commands.............................................................................................................................	237
Syslog Commands............................................................................................................................	237
clear logging.....................................................................................................................................	238
logging buffered...............................................................................................................................	238
logging console................................................................................................................................	239
logging hostname.............................................................................................................................	240
logging monitor................................................................................................................................	240
logging source-interface..................................................................................................................	241
show logging.....................................................................................................................................	241
show snmp........................................................................................................................................	243
show snmp engineID........................................................................................................................	244
show snmp group.............................................................................................................................	245
show snmp user................................................................................................................................	245
snmp-server community..................................................................................................................	246
terminal monitor...............................................................................................................................	246
23 Storm Control.................................................................................................	247
io-aggregator broadcast storm-control..........................................................................................	247
show io-aggregator broadcast storm-control status.....................................................................	247
24 Stacking Commands.....................................................................................	249
power-cycle stack-unit....................................................................................................................	249
reset stack-unit.................................................................................................................................	250
show system stack-ports..................................................................................................................	251
stack-unit iom-mode.......................................................................................................................	253

show system stack-unit iom-mode.................................................................................................	253
show system stack-unit stack-group..............................................................................................	254
stack-unit priority..............................................................................................................................	255
stack-unit renumber.........................................................................................................................	256
25 System Time....................................................................................................	257
ntp server...........................................................................................................................................	257
show clock........................................................................................................................................	258
clock set............................................................................................................................................	258
clock summer-time date..................................................................................................................	259
clock summer-time recurring..........................................................................................................	260
clock timezone.................................................................................................................................	262
26 Uplink Failure Detection (UFD)....................................................................	263
defer-timer........................................................................................................................................	263
enable................................................................................................................................................	263
27 Virtual Link Trunking (VLT)...........................................................................	265
show vlt backup-link.........................................................................................................................	265
show vlt brief.....................................................................................................................................	266
show vlt detail...................................................................................................................................	266
show vlt role......................................................................................................................................	267
show vlt statistics..............................................................................................................................	267
stack-unit iom-mode.......................................................................................................................	268
28 Debugging and Diagnostics.........................................................................	270
Offline Diagnostic Commands.........................................................................................................	270
Hardware Commands......................................................................................................................	270
clear hardware stack-unit.................................................................................................................	271
diag stack-unit...................................................................................................................................	271
offline stack-unit...............................................................................................................................	273
show diag..........................................................................................................................................	273
show hardware stack-unit................................................................................................................	277
show hardware system-flow............................................................................................................	283
29 NPIV Proxy Gateway......................................................................................	288
show fcoe-map................................................................................................................................	288
show fc sw........................................................................................................................................	290
show npiv devices.............................................................................................................................	291
show running-config fcoe-map......................................................................................................	294

30 PMUX Mode of the I/O Aggregator............................................................

295

Data Center Bridging (DCB).............................................................................................................	295
advertise dcbx-appln-tlv.............................................................................................................	295
advertise dcbx-tlv.......................................................................................................................	296
clear dcbx counters....................................................................................................................	296
clear ets counters........................................................................................................................	297
clear pfc counters.......................................................................................................................	297
dcb-enable..................................................................................................................................	297
dcb enable pfc-queues..............................................................................................................	298
dcb-map......................................................................................................................................	298
dcb-map stack-unit all stack-ports all.......................................................................................	299
dcbx port-role.............................................................................................................................	300
dcbx version................................................................................................................................	300
debug dcbx..................................................................................................................................	301
fcoe-map....................................................................................................................................	302
fcoe priority-bits.........................................................................................................................	303
iscsi priority-bits..........................................................................................................................	303
priority-group bandwidth pfc....................................................................................................	304
priority-pgid................................................................................................................................	305
show dcb.....................................................................................................................................	306
show interface dcbx detail..........................................................................................................	307
show interface ets.......................................................................................................................	310
show interface pfc.......................................................................................................................	313
show interface pfc statistics........................................................................................................	316
show qos dcb-map.....................................................................................................................	317
show stack-unit stack-ports ets details......................................................................................	318
show stack-unit stack-ports pfc details.....................................................................................	319
Dynamic Host Configuration Protocol............................................................................................	319
clear ip dhcp client statistics......................................................................................................	320
debug ip dhcp client...................................................................................................................	320
ip address dhcp............................................................................................................................	321
show ip dhcp client statistics......................................................................................................	321
show ip dhcp lease......................................................................................................................	321
File Management...............................................................................................................................	322
boot system gateway..................................................................................................................	322
boot system stack-unit...............................................................................................................	322
cd.................................................................................................................................................	323
copy.............................................................................................................................................	323
copy running-config startup-config..........................................................................................	325
delete...........................................................................................................................................	325
dir.................................................................................................................................................	326
format flash.................................................................................................................................	326
[no] logging coredump stack-unit.............................................................................................	327

pwd..............................................................................................................................................	327
rename........................................................................................................................................	328
restore factory-defaults..............................................................................................................	328
show boot system.......................................................................................................................	330
show file......................................................................................................................................	330
show file-systems........................................................................................................................	331
show os-version..........................................................................................................................	332
show running-config..................................................................................................................	333
show version...............................................................................................................................	334
upgrade boot...............................................................................................................................	335
upgrade system...........................................................................................................................	336
FIP Snooping.....................................................................................................................................	338
clear fip-snooping statistics.......................................................................................................	338
feature fip-snooping...................................................................................................................	338
fip-snooping enable....................................................................................................................	339
fip-snooping fc-map..................................................................................................................	339
fip-snooping port-mode fcf.......................................................................................................	339
iSCSI Optimization............................................................................................................................	340
advertise dcbx-app-tlv...............................................................................................................	340
iscsi aging time...........................................................................................................................	340
iscsi cos........................................................................................................................................	341
iscsi enable..................................................................................................................................	342
iscsi priority-bits..........................................................................................................................	342
iscsi profile-compellent..............................................................................................................	342
iscsi target port............................................................................................................................	343
Interfaces...........................................................................................................................................	343
Basic Interface Commands........................................................................................................	344
clear counters.............................................................................................................................	344
description..................................................................................................................................	344
feature fc.....................................................................................................................................	345
flowcontrol..................................................................................................................................	345
interface.......................................................................................................................................	347
interface ManagementEthernet.................................................................................................	348
interface range............................................................................................................................	349
interface vlan...............................................................................................................................	351
intf-type cr4 autoneg..................................................................................................................	351
keepalive......................................................................................................................................	352
mtu...............................................................................................................................................	352
stack-unit port-group port mode ethernet...............................................................................	354
negotiation auto..........................................................................................................................	354
portmode hybrid.........................................................................................................................	356
Port Channel Commands...........................................................................................................	358

channel-member........................................................................................................................	358
interface port-channel................................................................................................................	359
minimum-links..................................................................................................................................	360
Internet Group Management Protocol (IGMP)................................................................................	361
IGMP Commands........................................................................................................................	361
IGMP Snooping Commands.......................................................................................................	363
IPv4 Routing......................................................................................................................................	366
ip route........................................................................................................................................	366
show ip route..............................................................................................................................	367
Layer 2...............................................................................................................................................	369
MAC Addressing Commands.....................................................................................................	369
mac-address-table aging-time..................................................................................................	369
mac-address-table static............................................................................................................	369
mac-address-table station-move refresh-arp..........................................................................	370
show mac-address-table............................................................................................................	370
Link Aggregation Control Protocol (LACP)......................................................................................	373
lacp long-timeout.......................................................................................................................	373
lacp port-priority.........................................................................................................................	374
port-channel mode.....................................................................................................................	374
port-channel-protocol lacp.......................................................................................................	375
Link Layer Discovery Protocol (LLDP)..............................................................................................	375
advertise dot3-tlv........................................................................................................................	376
advertise management-tlv..........................................................................................................	376
clear lldp counters.......................................................................................................................	377
clear lldp neighbors.....................................................................................................................	377
debug lldp interface....................................................................................................................	378
disable..........................................................................................................................................	379
hello.............................................................................................................................................	379
multiplier......................................................................................................................................	379
NPIV Proxy Gateway.........................................................................................................................	380
dcb-map.....................................................................................................................................	380
description (for FCoE maps).......................................................................................................	381
feature fc......................................................................................................................................	381
fabric-id vlan...............................................................................................................................	382
fc-map.........................................................................................................................................	382
fcoe-map.....................................................................................................................................	383
fcf-priority...................................................................................................................................	384
fka-adv-period............................................................................................................................	385
keepalive......................................................................................................................................	386
show fcoe-map..........................................................................................................................	386
show fc sw..................................................................................................................................	389
show npiv devices.......................................................................................................................	389

show interfaces status................................................................................................................	392
show qos dcb-map.....................................................................................................................	393
Quality of Service (QoS)...................................................................................................................	394
Per-Port QoS Commands..........................................................................................................	394
dot1p-priority..............................................................................................................................	394
service-class dynamic dot1p......................................................................................................	395
service-class dot1p-mapping.....................................................................................................	396
service-class bandwidth-percentage.........................................................................................	397
Policy-Based QoS Commands...................................................................................................	397
bandwidth-percentage...............................................................................................................	397
description..................................................................................................................................	398
policy-aggregate.........................................................................................................................	398
policy-map-output.....................................................................................................................	399
qos-policy-output......................................................................................................................	400
rate-shape...................................................................................................................................	400
service-policy output..................................................................................................................	401
service-queue.............................................................................................................................	401
show qos qos-policy-output.....................................................................................................	402
trust.............................................................................................................................................	403
Security.............................................................................................................................................	404
AAA Accounting Commands.....................................................................................................	404
Authentication and Password Commands................................................................................	407
RADIUS Commands....................................................................................................................	414
Stacking Commands...................................................................................................................	418
Suppressing AAA Accounting for Null Username Sessions.......................................................	425
TACACS+ Commands................................................................................................................	426
SSH Server and SCP Commands................................................................................................	428
Simple Network Management Protocol (SNMP) and Syslog..........................................................	434
SNMP Commands.......................................................................................................................	434
Syslog Commands......................................................................................................................	438
Storm Control...................................................................................................................................	444
show storm-control unknown-unicast.....................................................................................	444
storm-control broadcast (Interface)..........................................................................................	445
storm-control multicast (Interface)...........................................................................................	445
storm-control unknown-unicast (Interface).............................................................................	446
Uplink Failure Detection (UFD).........................................................................................................	446
clear ufd-disable.........................................................................................................................	446
debug uplink-state-group..........................................................................................................	447
description..................................................................................................................................	448
enable..........................................................................................................................................	448
downstream................................................................................................................................	448
downstream auto-recover.........................................................................................................	449

downstream disable links...........................................................................................................	450
show running-config uplink-state-group..................................................................................	451
show uplink-state-group............................................................................................................	451
uplink-state-group......................................................................................................................	452
upstream......................................................................................................................................	453
Virtual Link Trunking (VLT)................................................................................................................	454
back-up destination....................................................................................................................	455
clear vlt statistics.........................................................................................................................	455
lacp ungroup member-independent.........................................................................................	456
peer-link port-channel...............................................................................................................	457
show vlt mismatch......................................................................................................................	457
system-mac................................................................................................................................	458
unit-id..........................................................................................................................................	458
vlt domain....................................................................................................................................	459
vlt-peer-lag port-channel..........................................................................................................	459
A Internet Control Message Protocol (ICMP) Message Types.....................	461

1

About this Guide

This book provides information about the Dell Networking OS command line interface (CLI) on the Dell PowerEdge FN I/O Aggregator.

This book also includes information about the protocols and features found in the Dell Networking OS and on the Dell Networking systems supported by the Dell Networking OS.

References

For more information about your system, refer to the following documents:

•Dell PowerEdge FN I/O Aggregator Configuration Guide

•Dell PowerEdge FN I/O Aggregator Getting Started Guide

•Release Notes for the Dell PowerEdge FN I/O Aggregator

Objectives

This book is intended as a reference guide for the Aggregator CLI commands, with detailed syntax statements, along with usage information and sample output.

This guide contains an Appendix with a list of the request for comment (RFCs) and management information base files (MIBs) supported.

NOTE: For more information about when to use the CLI commands, refer to the Dell PowerEdge FN I/O Aggregator Configuration Guide for your system.

17

Audience

This book is intended for system administrators who are responsible for configuring or maintaining networks. This guide assumes that you are knowledgeable in Layer 2 and Layer 3 networking technologies.

Conventions

This book uses the following conventions to describe command syntax.

Keyword	Keywords are in Courier font and must be entered in the CLI as listed.
parameter	Parameters are in italics and require a number or word to be entered in the CLI.
{X}	Keywords and parameters within braces must be entered in the CLI.
[X]	Keywords and parameters within brackets are optional.
x|y	Keywords and parameters separated by a bar require you to choose one option.
x||y	Keywords and parameters separated by a double bar allows you to choose any or
	all of the options.

18

2

Before You Start

By following the instructions in the Dell PowerEdge FN I/O Aggregator Getting Started Guide that is shipped with the product, you install the Aggregator in a Dell PowerEdge FX2 server chassis.

The Aggregator installs with zero-touch configuration. After you power it on, an Aggregator boots up with default settings and auto-configures with software features enabled. This chapter describes the default settings and software features that are automatically configured at startup. Use the tasks described in the other chapters to reconfigure the Aggregator for customized network operation.

IOA Operational Modes

IOA supports three operational modes. Select the operational mode that meets your deployment needs. To enable a new operational mode, configure the new mode and reload the switch.

Standalone mode

stack-unit unit iom-mode standalone

CONFIGURATION mode

Dell(conf)#stack-unit 0 iom-mode standalone

This is the default mode for IOA. It is a fully automated zero-touch mode that allows you to configure VLAN memberships. (Supported in CMC)

VLT mode

stack-unit unit iom-mode vlt

CONFIGURATION mode

Dell(conf)#stack-unit 0 iom-mode vlt

Select this mode to multi-home server interfaces to different IOA modules. This is a low-touch mode where all configuration except VLAN membership is automated. To enable VLAN, you must configure the VLANs at the server port level. In this mode, port 9 link, which is associated with LAG-127, is dedicated to VLT interconnect.

Programmable MUX mode

stack-unit unit iom-mode programmable-mux

CONFIGURATION mode

19

Dell(conf)#stack-unit 0 iom-mode programmable-mux

Select this mode to configure PMUX mode CLI commands.

For more information on the PMUX mode, refer to PMUX Mode of the IO Aggregator.

Stacking mode

stack-unit unit iom-mode stack

CONFIGURATION mode

Dell(conf)#stack-unit 0 iom-mode stack

Select this mode to configure Stacking mode CLI commands.

For more information on the Stacking mode, refer to Stacking Commands.

Default Settings

The I/O Aggregator provides zero-touch configuration with the following default configuration settings:

•Default user name (root)

•Password (calvin)

•VLAN (vlan1) and IP address for in-band management (DHCP-assigned)

•IP address for out-of-band (OOB) management (DHCP-assigned)

•Read-only SNMP community name (public)

•Broadcast storm control (enabled)

•Unregistered Multicast Packets flooding (enabled)

•IGMP snooping in all VLANs except the default VLAN (enabled)

•VLAN configuration (all ports belong to all VLANs)

You can change any of these default settings using the CLI. Refer to the appropriate chapter for details.

NOTE: You can also change many of the default settings using the chassis management controller (CMC) interface. For information about how to access the CMC to configure an Aggregator, refer to the Dell Chassis Management Controller (CMC) User’s Guide on the Dell Support website at http:// support.dell.com/support/edocs/systems/pem/en/index.htm.

Other Auto-Configured Settings

After the Aggregator powers on, it auto-configures and is operational with software features enabled, including:

•VLANs: All ports are configured as members of all (4094) VLANs. All VLANs are up and can send or receive layer 2 traffic. For more information, refer to VLANs.

•Data Center Bridging Capability Exchange Protocol (DCBX)

20

•Fibre Channel over Ethernet (FCoE) connectivity

•FCoE Initiation Protocol (FIP) snooping

•Hybrid ports: Ports are administratively up and auto-configured to operate as hybrid ports to transmit tagged and untagged VLAN traffic.

•iSCSI optimization

•IGMP snooping

•Jumbo frames: Ports are set to a maximum MTU of 12,000 bytes by default.

•Link aggregation: All uplink ports are configured in a single LAG (LAG 128).

•Link Layer Discovery Protocol (LLDP): Enabled on all ports.

•Link tracking: Enables server-facing links to be brought up only if the uplink port-channel (LAG 128) is up.

DCB Support

DCB enhancements for data center networks are supported to eliminate packet loss and provision links with required bandwidth.

The Aggregator provides zero-touch configuration for DCB. The Aggregator auto-configures DCBX port roles to match the DCBX configuration in the ToR switches to which it connects through its uplink ports.

The Aggregator supports Auto DCB only in standalone mode.

FCoE Connectivity

Many data centers use Fibre Channel (FC) in storage area networks (SANs). Fibre Channel over Ethernet (FCoE) encapsulates Fibre Channel frames over Ethernet networks.

On an Aggregator, the internal ports support FCoE connectivity and connect to the converged network adapter (CNA) in blade servers. FCoE allows Fibre Channel to use 10-Gigabit Ethernet networks while preserving the Fibre Channel protocol.

The Aggregator also provides zero-touch configuration for FCoE configuration. The Aggregator autoconfigures to match the FCoE settings used in the ToR switches to which it connects through its uplink ports.

iSCSI Operation

Support for iSCSI traffic is turned on by default when the Aggregator powers up. No configuration is required.

When the Aggregator powers up, it monitors known TCP ports for iSCSI storage devices on all interfaces. When a session is detected, an entry is created and monitored as long as the session is active.

The Aggregator also detects iSCSI storage devices on all interfaces and auto-configures to optimize performance. Performance optimization operations, such as Jumbo frame size support, and disabling

21

storm control on interfaces connected to an iSCSI equallogic (EQL) storage device, are applied automatically.

CLI configuration is necessary only when the configuration includes iSCSI storage devices that cannot be automatically detected and when non-default QoS handling is required.

Link Aggregation

In Standalone, and VLT modes, all uplink ports (except port 9 in VLT mode) are configured in a single LAG (LAG 128). There can be multiple uplink LAGs in programmable-mux mode. Server-facing ports are autoconfigured as part of link aggregation groups if the corresponding server is configured for LACP-based NIC teaming. Static LAGs are supported in PMUX mode.

NOTE: The recommended LACP timeout is Long-Timeout mode.

Link Tracking

By default, all server-facing ports are tracked by the operational status of the uplink LAG. If the uplink LAG goes down, the Aggregator loses its connectivity and is no longer operational; all server-facing ports are brought down.

NOTE: If installed servers do not have connectivity to a ToR switch, check the Link Status LED of uplink ports on the Aggregator. If all LEDs are ON, check the LACP configuration on the ToR switch that is connected to the Aggregator to ensure the LACP is correctly configured.

VLANs

By default, all Aggregator ports belong to all 4094 VLANs and are members of untagged VLAN 1. You can use the CLI or CMC interface to configure only the required VLANs on a port.

When you configure VLANs on server-facing interfaces (ports 1 to 8), you can assign VLANs to a port or a range of ports by entering the vlan tagged or vlan untagged commands in interface configuration mode; for example:

Dell(conf)# interface tengigabitethernet 0/2 - 4

Dell(conf-if-range-te-0/2-4)# vlan tagged 5,7,10-12

Dell(conf-if-range-te-0/2-4)# vlan untagged 3

NOTE: You can also use the CMC interface to configure VLANs.

Uplink LAG

The tagged VLAN membership of the uplink LAG is automatically configured based on the tagged and untagged VLAN configuration of all server-facing ports (ports 1 to 8).

The untagged VLAN used for the uplink LAG is always the default VLAN.

22

Server-Facing LAGs

The tagged VLAN membership of a server-facing LAG is automatically configured based on the serverfacing ports that are members of the LAG.

The untagged VLAN of a server-facing LAG is configured based on the untagged VLAN to which the lowest numbered server-facing port in the LAG belongs.

NOTE: Dell Networking recommends that you configure the same VLAN membership on all LAG member ports.

To restore the default auto-VLAN mode of operation (in which all ports are members of all 4094 VLANs) on a port, enter the auto vlan command:

Dell(conf)# interface tengigabitethernet 0/2

Dell(conf-if-te-0/2)# auto vlan

The auto vlan command is applicable only in Standalone mode.

To get the default standalone mode configurations:

1.Delete the startup-config file and reboot the system.

2.Restore to factory default settings.

Where to Go From Here

You can customize the Aggregator for use in your data center network as necessary. To perform additional switch configuration, do one of the following:

•For remote out-of-band management, enter the OOB management interface IP address into a Telnet or SSH client and log in to the switch using the user ID and password to access the CLI.

•For local management using the CLI, use the attached console connection.

•For remote in-band management from a network management station, enter the VLAN IP address of the management port and log in to the switch to access the CLI.

In case of a Dell Networking OS upgrade, you can check to see that an Aggregator is running the latest Dell Networking OS version by entering the show version command. To download a Dell Networking OS version, go to http://support.dell.com.

Refer to the appropriate chapter for detailed information on how to configure specific software settings.

23

3

CLI Basics

This chapter describes the command line interface (CLI) structure and command modes. The Dell operating system commands are in a text-based interface that allows you to use the launch commands, change command modes, and configure interfaces and protocols.

Accessing the Command Line

When the system boots successfully, you are positioned on the command line in EXEC mode and not prompted to log in. You can access the commands through a serial console port or a Telnet session. When you Telnet into the switch, you are prompted to enter a login name and password.

Example	telnet 172.31.1.53
	Trying 172.31.1.53...
	Connected to 172.31.1.53.
	Escape character is '^]'.
	Login: username
	Password:
	Dell>

After you log in to the switch, the prompt provides you with the current command-level information. For example:

Prompt	CLI Command Mode
Dell>	EXEC
Dell#	EXEC Privilege
Dell(conf)#	CONFIGURATION

NOTE: For a list of all the command mode prompts, refer to the Command Modes Modes section.

Multiple Configuration Users

When a user enters CONFIGURATION mode and another user is already in CONFIGURATION mode, the Dell operating system generates an alert warning message similar to the following:

Dell#conf

% Warning: The following users are currently configuring the system:

User "" on line		console0
User	"admin" on	line vty0 ( 123.12.1.123 )
User	"admin" on	line vty1 ( 123.12.1.123 )

24

User "Irene" on line vty3 ( 123.12.1.321 )

Dell#conf

When another user enters CONFIGURATION mode, the Dell Networking OS sends a message similar to the following:

% Warning: User "admin" on line vty2 "172.16.1.210" is in configuration

In this case, the user is “admin” on vty2.

Navigating the CLI

The Dell Networking OS displays a CLI prompt comprised of the host name and CLI mode.

•Host name is the initial part of the prompt and is “Dell” by default. You can change the host name with the hostname command.

•CLI mode is the second part of the prompt and reflects the current CLI mode. For a list of the Dell Networking OS command modes, refer to the command mode list in the Accessing the Command Line section.

The CLI prompt changes as you move up and down the levels of the command structure. Starting with CONFIGURATION mode, the command prompt adds modifiers to further identify the mode. For more information about command modes, refer to the Command Modes section.

Prompt	CLI Command Mode
Dell>	EXEC
Dell#	EXEC Privilege
Dell(conf)#	CONFIGURATION
Dell(conf-if-te-0/0)#	INTERFACE
Dell(conf-if-vl-1)#
Dell(conf-if-ma-0/0)#
Dell(conf-if-range)#
Dell(conf-line-console)#	LINE
Dell(conf-line-vty)#
Dell(conf-mon-sess)#	MONITOR SESSION

25

Obtaining Help

As soon as you are in a command mode there are several ways to access help.

To obtain a list of keywords at any command mode:

To obtain a list of keywords with a brief functional description:

To obtain a list of available options:

To obtain a list of partial keywords using a partial keyword:

Example

Type a ? at the prompt or after a keyword. There must always be a space before the ?.

Type help at the prompt.

Type a keyword and then type a space and a ?.

Type a partial keyword and then type a ?.

The following is an example of typing ip ? at the prompt:

Dell(conf)#ip ?

igmp	Internet Group	Management Protocol
route	Establish static routes
telnet	Specify telnet	options

When entering commands, you can take advantage of the following timesaving features:

•The commands are not case-sensitive.

•You can enter partial (truncated) command keywords. For example, you can enter int tengig int

for the interface tengigabitethernet interface command.

•To complete keywords in commands, use the TAB key.

•To display the last enabled command, use the up Arrow key.

•To erase the previous character, use either the Backspace key or Delete key.

•To navigate left or right in the Dell Networking OS command line, use the left and right Arrow keys.

The shortcut key combinations at the Dell Networking OS command line are as follows:

Key Combination	Action
CNTL-A	Moves the cursor to the beginning of the command line.
CNTL-B	Moves the cursor back one character.
CNTL-D	Deletes the character at the cursor.
CNTL-E	Moves the cursor to the end of the line.
CNTL-F	Moves the cursor forward one character.
CNTL-I	Completes a keyword.

26

Key Combination	Action
CNTL-K	Deletes all the characters from the cursor to the end of the command line.
CNTL-L	Re-enters the previous command.
CNTL-N	Returns to the more recent commands in the history buffer after recalling
	commands with Ctrl-P or the up Arrow key.
CNTL-P	Recalls commands, beginning with the last command.
CNTL-U	Deletes the line.
CNTL-W	Deletes the previous word.
CNTL-X	Deletes the line.
CNTL-Z	Comes back to EXEC mode from any CONFIGURATION mode.
Esc B	Moves the cursor back one word.
Esc F	Moves the cursor forward one word.
Esc D	Deletes all the characters from the cursor to the end of the word.

Using the Keyword no Command

To disable, delete or return to default values, use the no form of the commands.

For most commands, if you type the keyword no in front of the command, you disable that command or delete it from the running configuration. In this guide, the no form of the command is described in the Syntax portion of the command description. For example:

Syntax

Defaults

Command

Modes

Command

History

no {boot | default | enable | ftp-server | hardware | hostname | ip | line | logging | monitor | service | io-aggregator broadcast storm-control | snmp-server | username}

None

CONFIGURATION

Version 9.4(0.0) Supported on the FN I/O aggregator.

Filtering show Commands

To find specific information, display certain information only or begin the command output at the first instance of a regular expression or phrase, you can filter the display output of a show command.

When you execute a show command, and then enter a pipe ( | ), one of the following parameters, and a regular expression, the resulting output either excludes or includes those parameters.

27

NOTE: The Dell Networking OS accepts a space before or after the pipe, no space before or after the pipe, or any combination. For example: Dell#command | grep TenGig|except regularexpression | find regular-expression.

except	displays only the text that does not match the pattern (or regular expression)
find	searches for the first occurrence of a pattern
grep	displays text that matches a pattern.
no-more	does not paginate the display output
save	copies the output to a file for future use

The grep command option has an ignore-case sub-option that makes the search case-insensitive. For example, the commands:

•show run | grep Ethernet returns a search result with instances containing a capitalized “Ethernet,” such as interface TenGigabitEthernet 0/1.

•show run | grep ethernet does not return the search result above because it only searches for instances containing a non-capitalized “ethernet”.

•show run | grep Ethernet ignore-case returns instances containing both “Ethernet” and “ethernet”.

Displaying All Output

To display the output all at once (not one screen at a time), use the no-more option after the pipe. This operation is similar to the terminal length screen-length command except that the no-more option affects the output of just the specified command. For example:

Dell#show running-config|no-more

Filtering the Command Output Multiple Times

You can filter a single command output multiple times. To filter a command output multiple times, place the save option as the last filter. For example:

Dell# command | grep regular-expression | except regular-expression | grep other-regular-expression | find regular-expression | no-more | save

Command Modes

To navigate and launch various CLI modes, use specific commands. Navigation to these modes is described in the following sections.

EXEC Mode

When you initially log in to the switch, by default, you are logged in to EXEC mode. This mode allows you to view settings and enter EXEC Privilege mode, which is used to configure the device.

When you are in EXEC mode, the > prompt is displayed following the host name prompt, which is “Dell” by default. You can change the host name prompt using the hostname command.

28

LINE Mode

To configure the console or virtual terminal parameters, use LINE mode. To enter LINE mode:

Dell(conf-if- range)#

Designated interface range (used for bulk configuration)

Dell(conf-if- ma-0/0)#

Management Ethernet interface then slot/port information

Dell(conf-if- vl-1)#

VLAN Interface then VLAN number (range 1–4094)

The prompt changes to include the designated interface and slot/port number. For example: Prompt Interface Type

Dell(conf-if- Ten-Gigabit Ethernet interface then slot/port information te-0/1)#

NOTE: Each mode prompt is preceded by the host name.

EXEC Privilege Mode

The enable command accesses EXEC Privilege mode. If an administrator has configured an “Enable” password, you are prompted to enter it.

EXEC Privilege mode allows you to access all the commands accessible in EXEC mode, plus other commands, such as to clear address resolution protocol (ARP) entries and IP addresses. In addition, you can access CONFIGURATION mode to configure interfaces, routes and protocols on the switch. While you are logged in to EXEC Privilege mode, the # prompt displays.

CONFIGURATION Mode

In EXEC Privilege mode, use the configure command to enter CONFIGURATION mode and configure routing protocols and access interfaces.

To enter CONFIGURATION mode:

1.Verify that you are logged in to EXEC Privilege mode.

2.Enter the configure command. The prompt changes to include (conf).

From this mode, you can enter INTERFACE mode by using the interface command.

INTERFACE Mode

To configure interfaces or IP services on those interfaces, use INTERFACE mode. An interface can be physical (for example, a TenGigabit Ethernet port) or virtual (for example, the VLAN interface).

To enter INTERFACE mode:

1.Verify that you are logged in to CONFIGURATION mode.

2.Enter the interface command and then enter an interface type and interface number that is available on the switch.

29

1.Verify that you are logged in to CONFIGURATION mode.

2.Enter the line command. Include the keywords console or vty and their line number available on the switch. The prompt changes to include (config-line-console) or (config-line-vty).

You can exit this mode by using the exit command.

MONITOR SESSION Mode

In CONFIGURATION mode, use the monitor session command to enter MONITOR SESSION mode and configure port monitoring.

To enter MONITOR SESSION mode:

1.Verify that you are logged in to CONFIGURATION mode.

2.Use the monitor session command. Include the monitor session ID. The prompt changes to

Dell(conf-mon-sess-1)#.

You can return to CONFIGURATION mode by using the exit command.

PROTOCOL LLDP Mode

In CONFIGURATION mode, use the protocol lldp command to enter PROTOCOL LLDP mode and configure the LLDP protocol.

To enter PROTOCOL LLDP mode:

1.Verify that you are logged in to CONFIGURATION mode.

2.Enter the protocol lldp command. The prompt changes to include (config-lldp).

You can return to CONFIGURATION mode by using the exit command.

30