JG727A

Aruba JG727A User guide

  • Hello! I've reviewed the HPE FlexFabric 5940 & 5930 Switch Series Layer 2 LAN Switching Command Reference. This document details various commands for configuring and managing your switches, covering areas like MAC address tables, Ethernet interfaces, VLANs, and link aggregation. I'm ready to help answer any questions you have about using these commands to configure your device.
  • What is the command to display the MAC address table?
    How do I configure link aggregation?
    What command is used to display interface information?
    How can I enable or disable MAC address learning?
HPE FlexFabric 5940 & 5930 Switch Series
Layer 2—LAN Switching Command Reference
P
art number: 5200-6391b
Software
version: Release 2702 and later
Document version: 6W101-20230412
© Copyright 2023 Hewlett Packard Enterprise Development LP
The information contained herein is subject to change without notice. The only warranties for Hewlett Packard
Enterprise products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional warranty. Hewlett
Packard Enterprise shall not be liable for technical or editorial errors or omissions contained herein.
Confidential computer software. Valid license from Hewlett Packard Enterprise required for possession, use, or
copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software
Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor’s
standard commercial license.
Links to third-party websites take you outside the Hewlett Packard Enterprise website. Hewlett Packard
Enterprise has no control over and is not responsible for information outside the Hewlett Packard Enterprise
website.
Acknowledgments
Intel®, Itanium®, Pentium®, Intel Inside®, and the Intel Inside logo are trademarks of Intel Corporation in the
United States and other countries.
Microsoft® and Windows® are either registered trademarks or trademarks of Microsoft Corporation in the
United States and/or other countries.
Adobe® and Acrobat® are trademarks of Adobe Systems Incorporated.
Java and Oracle are registered trademarks of Oracle and/or its affiliates.
UNIX® is a registered trademark of The Open Group.
i
Contents
MAC address table commands ··························································· 1
display mac-address ············································································································ 1
display mac-address aging-time ····························································································· 3
display mac-address mac-learning ·························································································· 3
display mac-address mac-move ····························································································· 4
display mac-address statistics ································································································ 5
mac-address (interface view) ································································································· 6
mac-address (system view) ··································································································· 8
mac-address multiport vsi ··································································································· 10
mac-address mac-learning enable ························································································ 12
mac-address mac-learning priority ························································································ 13
mac-address mac-move fast-update ······················································································ 14
mac-address mac-roaming enable ························································································ 15
mac-address max-mac-count ······························································································· 15
mac-address max-mac-count enable-forwarding ······································································ 16
mac-address notification mac-move ······················································································ 17
mac-address notification mac-move suppression (interface view) ················································ 18
mac-address notification mac-move suppression (system view) ·················································· 19
mac-address static source-check enable ················································································ 20
mac-address timer ············································································································· 20
snmp-agent trap enable mac-address ···················································································· 21
MAC Information commands ···························································· 23
mac-address information enable (interface view) ······································································ 23
mac-address information enable (system view) ········································································ 24
mac-address information interval ·························································································· 24
mac-address information mode ···························································································· 25
mac-address information queue-length ·················································································· 25
Bulk interface configuration commands ··············································· 27
display interface range ······································································································· 27
interface range ·················································································································· 27
interface range name ········································································································· 29
Ethernet interface commands ··························································· 31
Common Ethernet interface commands ························································································ 31
bandwidth ························································································································ 31
broadcast-suppression ······································································································· 31
dampening ······················································································································· 33
default ····························································································································· 34
description ······················································································································· 35
display counters ················································································································ 35
display counters rate ·········································································································· 36
display ethernet statistics ···································································································· 38
display interface ················································································································ 40
display interface link-info ····································································································· 51
display interface main ········································································································· 53
display link-flap protection ··································································································· 56
display packet-drop ············································································································ 57
display priority-flow-control ·································································································· 58
duplex ····························································································································· 59
flow-control ······················································································································ 60
flow-control receive enable ·································································································· 61
flow-interval ······················································································································ 61
interface ·························································································································· 62
jumboframe enable ············································································································ 62
link-delay ························································································································· 63
ii
link-fault-signal enable ········································································································ 64
link-flap protect enable ·························································································· 65
loopback ·························································································································· 66
multicast-suppression ········································································································· 66
port fast-retrain enable ······································································································· 67
port link-flap protect enable ······················································································ 68
port link-mode ··················································································································· 69
port up-mode ···················································································································· 70
priority-flow-control (Ethernet interface view) ··········································································· 71
priority-flow-control (system view) ························································································· 72
priority-flow-control deadlock auto-recover action ····································································· 73
priority-flow-control deadlock auto-recover cos ········································································ 73
priority-flow-control deadlock cos ·························································································· 74
priority-flow-control deadlock enable ······················································································ 75
priority-flow-control deadlock precision ··················································································· 76
priority-flow-control deadlock recover ····················································································· 77
priority-flow-control deadlock recover-mode ············································································ 77
priority-flow-control deadlock threshold ·················································································· 78
priority-flow-control dot1p headroom ······················································································ 79
priority-flow-control dot1p ingress-buffer dynamic ····································································· 80
priority-flow-control dot1p ingress-buffer static ········································································· 81
priority-flow-control dot1p ingress-threshold-offset ···································································· 82
priority-flow-control dot1p reserved-buffer ··············································································· 82
priority-flow-control headroom ······························································································ 83
priority-flow-control no-drop dot1p (Ethernet interface view) ························································ 84
priority-flow-control no-drop dot1p (system view) ······································································ 85
reset counters interface ······································································································ 86
reset ethernet statistics ······································································································· 87
reset packet-drop interface ·································································································· 87
shutdown ························································································································· 88
speed ····························································································································· 88
unicast-suppression ··········································································································· 89
using fortygige ·················································································································· 91
using hundredgige ············································································································· 91
using tengige ···················································································································· 92
Layer 2 Ethernet interface commands ·························································································· 93
display storm-constrain ······································································································· 93
mdix-mode ······················································································································· 94
port bridge enable ············································································································· 95
port connection-distance ····································································································· 96
port-type ·························································································································· 96
storm-constrain ················································································································· 97
storm-constrain control ······································································································· 99
storm-constrain enable log ································································································ 100
storm-constrain enable trap ······························································································· 100
storm-constrain interval ···································································································· 101
virtual-cable-test ·············································································································· 101
Layer 3 Ethernet interface or subinterface commands ···································································· 102
mac-address ·················································································································· 102
mtu······························································································································· 103
traffic-statistic enable ······································································································· 104
Ethernet link aggregation commands ················································ 106
bandwidth ······················································································································ 106
default ··························································································································· 106
description ····················································································································· 107
display interface ·············································································································· 108
display lacp system-id ······································································································ 112
display link-aggregation load-sharing mode ··········································································· 113
display link-aggregation load-sharing path ············································································ 116
display link-aggregation member-port ·················································································· 118
display link-aggregation summary ······················································································· 121
iii
display link-aggregation verbose ························································································· 122
interface bridge-aggregation ······························································································ 125
interface route-aggregation ································································································ 126
interface schannel-bundle ································································································· 127
jumboframe enable ·········································································································· 128
lacp default-selected-port disable ························································································ 128
lacp edge-port ················································································································ 129
lacp mode ······················································································································ 129
lacp period short ············································································································· 130
lacp select speed ············································································································ 131
lacp system-mac ············································································································· 132
lacp system-number ········································································································· 132
lacp system-priority ·········································································································· 133
lacp transparent enable ···································································································· 134
link-aggregation bfd ipv4 ··································································································· 134
link-aggregation global load-sharing algorithm ······································································· 135
link-aggregation global load-sharing minm ············································································ 136
link-aggregation global load-sharing mode ············································································ 137
link-aggregation global load-sharing offset ············································································ 139
link-aggregation global load-sharing seed ············································································· 139
link-aggregation global load-sharing tunnel ··········································································· 140
link-aggregation ignore speed ···························································································· 141
link-aggregation ignore vlan ······························································································· 142
link-aggregation lacp traffic-redirect-notification enable ···························································· 142
link-aggregation load-sharing ignore ···················································································· 143
link-aggregation load-sharing mode ····················································································· 145
link-aggregation load-sharing mode local-first ········································································ 146
link-aggregation management-port ······················································································ 147
link-aggregation management-subnet ·················································································· 147
link-aggregation management-vlan ····················································································· 148
link-aggregation mode ······································································································ 149
link-aggregation port-priority ······························································································ 149
link-aggregation selected-port maximum ·············································································· 150
link-aggregation selected-port minimum ··············································································· 151
link-delay ······················································································································· 152
mac-address ·················································································································· 153
mtu······························································································································· 154
port bridge enable ··········································································································· 155
port link-aggregation group ································································································ 155
port s-mlag group ············································································································ 157
reset counters interface ···································································································· 157
reset lacp statistics ·········································································································· 158
shutdown ······················································································································· 159
traffic-statistic enable ······································································································· 159
DRNI commands ·········································································· 161
display drni consistency ···································································································· 161
display drni drcp statistics ································································································· 163
display drni keepalive ······································································································· 164
display drni mad verbose ·································································································· 166
display drni role ··············································································································· 167
display drni summary ······································································································· 168
display drni system ·········································································································· 169
display drni verbose ········································································································· 170
drni auto-recovery reload-delay ·························································································· 172
drni consistency-check disable ··························································································· 173
drni drcp period short ······································································································· 173
drni keepalive { ip | ipv6 } ·································································································· 174
drni keepalive hold-time ···································································································· 175
drni keepalive interval ······································································································· 176
drni mad exclude interface ································································································ 177
drni restore-delay ············································································································ 178
iv
drni role priority ··············································································································· 179
drni system-mac ·············································································································· 179
drni system-number ········································································································· 180
drni system-priority ·········································································································· 181
port drni group ················································································································ 182
port drni intra-portal-port ··································································································· 182
reset drni drcp statistics ···································································································· 183
Port isolation commands ································································ 185
display port-isolate group ·································································································· 185
port-isolate enable ··········································································································· 186
port-isolate group ············································································································ 186
VLAN commands ········································································· 188
Basic VLAN commands ··········································································································· 188
bandwidth ······················································································································ 188
block outbound ··············································································································· 188
default ··························································································································· 189
description ····················································································································· 189
display interface vlan-interface ··························································································· 190
display vlan ···················································································································· 193
display vlan brief ············································································································· 194
interface vlan-interface ····································································································· 195
mac-address ·················································································································· 196
mtu······························································································································· 196
name ···························································································································· 197
reset counters interface vlan-interface·················································································· 197
service ·························································································································· 198
shutdown ······················································································································· 199
vlan ······························································································································ 199
Port-based VLAN commands ··································································································· 200
display port ···················································································································· 200
port ······························································································································ 201
port access vlan ·············································································································· 202
port hybrid pvid ··············································································································· 203
port hybrid vlan ··············································································································· 204
port link-type ·················································································································· 205
port trunk permit vlan ······································································································· 205
port trunk pvid ················································································································· 206
MAC-based VLAN commands ·································································································· 207
display mac-vlan ············································································································· 207
display mac-vlan interface ································································································· 208
mac-vlan enable ·············································································································· 209
mac-vlan mac-address ····································································································· 209
mac-vlan trigger enable ···································································································· 210
port pvid forbidden ··········································································································· 211
vlan precedence ·············································································································· 212
IP subnet-based VLAN commands ···························································································· 212
display ip-subnet-vlan interface ·························································································· 212
display ip-subnet-vlan vlan ································································································ 214
ip-subnet-vlan ················································································································· 214
port hybrid ip-subnet-vlan ·································································································· 215
Protocol-based VLAN commands ······························································································ 216
display protocol-vlan interface ···························································································· 216
display protocol-vlan vlan ·································································································· 217
port hybrid protocol-vlan ··································································································· 218
protocol-vlan ·················································································································· 220
VLAN group commands ·········································································································· 221
display vlan-group ··········································································································· 221
vlan-group ····················································································································· 222
vlan-list ························································································································· 223
v
Super VLAN commands ································································ 225
display supervlan ············································································································ 225
subvlan ························································································································· 227
supervlan ······················································································································· 228
Private VLAN commands ······························································· 229
display private-vlan ·········································································································· 229
port private-vlan host ········································································································ 231
port private-vlan promiscuous ···························································································· 232
port private-vlan trunk promiscuous ····················································································· 235
port private-vlan trunk secondary ························································································ 237
private-vlan (VLAN interface view) ······················································································ 240
private-vlan (VLAN view) ··································································································· 242
private-vlan community ····································································································· 243
private-vlan isolated ········································································································· 244
private-vlan primary ········································································································· 246
Voice VLAN commands ································································· 247
display voice-vlan mac-address ·························································································· 247
display voice-vlan state ····································································································· 247
voice-vlan aging ·············································································································· 248
voice-vlan enable ············································································································ 249
voice-vlan mac-address ···································································································· 250
voice-vlan mode auto ······································································································· 251
voice-vlan qos ················································································································ 252
voice-vlan qos trust ·········································································································· 252
voice-vlan security enable ································································································· 253
voice-vlan track lldp ········································································································· 254
MVRP commands ········································································ 255
display mvrp running-status ······························································································· 255
display mvrp state ··········································································································· 256
display mvrp statistics ······································································································ 257
mrp timer join ················································································································· 259
mrp timer leave ··············································································································· 260
mrp timer leaveall ············································································································ 261
mrp timer periodic ············································································································ 262
mvrp enable ··················································································································· 263
mvrp global enable ·········································································································· 263
mvrp gvrp-compliance enable ···························································································· 264
mvrp registration ············································································································· 264
reset mvrp statistics ········································································································· 265
Loopback, null, and inloopback interface commands ···························· 267
bandwidth ······················································································································ 267
default ··························································································································· 267
description ····················································································································· 268
display interface inloopback ······························································································· 269
display interface loopback ································································································· 271
display interface null ········································································································ 273
interface loopback ··········································································································· 275
interface null ··················································································································· 275
reset counters interface loopback ······················································································· 276
reset counters interface null ······························································································· 276
shutdown ······················································································································· 277
QinQ commands ·········································································· 278
display qinq ···················································································································· 278
qinq enable ···················································································································· 279
qinq ethernet-type (interface view) ······················································································ 279
qinq ethernet-type (system view) ························································································ 280
vi
qinq transparent-vlan ······································································································· 282
VLAN mapping commands ····························································· 283
display vlan mapping ········································································································ 283
vlan mapping ·················································································································· 284
vlan mapping egress ········································································································ 287
PBB commands ··········································································· 288
bvlan ···························································································································· 288
display l2vpn minm connection ··························································································· 288
display l2vpn minm forwarding ··························································································· 289
display l2vpn vsi ·············································································································· 290
display pbb connection ····································································································· 292
encapsulation ················································································································· 293
l2vpn enable ··················································································································· 294
pbb i-sid ························································································································ 294
pbb uplink ······················································································································ 295
reset pbb connection ········································································································ 296
vsi ································································································································ 297
Loop detection commands ····························································· 299
display loopback-detection ································································································ 299
loopback-detection action ·································································································· 299
loopback-detection enable ································································································· 301
loopback-detection global action ························································································· 301
loopback-detection global enable ························································································ 302
loopback-detection interval-time ························································································· 303
Spanning tree commands ······························································ 304
active region-configuration ································································································ 304
bpdu-drop any ················································································································ 304
check region-configuration ································································································ 305
display stp ····················································································································· 306
display stp abnormal-port ·································································································· 313
display stp bpdu-statistics ································································································· 314
display stp down-port ······································································································· 316
display stp history ············································································································ 317
display stp region-configuration ·························································································· 318
display stp root ··············································································································· 319
display stp tc ·················································································································· 320
instance ························································································································ 321
region-name ··················································································································· 322
reset stp ························································································································ 323
revision-level ·················································································································· 324
snmp-agent trap enable stp ······························································································· 324
stp bpdu-protection ·········································································································· 325
stp bridge-diameter ·········································································································· 326
stp compliance ················································································································ 327
stp config-digest-snooping ································································································· 328
stp cost ························································································································· 328
stp dispute-protection ······································································································· 330
stp edged-port ················································································································ 330
stp enable ······················································································································ 331
stp global config-digest-snooping ························································································ 332
stp global enable ············································································································· 333
stp global mcheck ············································································································ 334
stp ignore-pvid-inconsistency ····························································································· 334
stp log enable tc ·············································································································· 335
stp loop-protection ··········································································································· 335
stp max-hops ·················································································································· 336
stp mcheck ···················································································································· 337
stp mode ······················································································································· 338
vii
stp no-agreement-check ··································································································· 339
stp pathcost-standard ······································································································· 339
stp point-to-point ············································································································· 340
stp port bpdu-protection ···································································································· 341
stp port priority ················································································································ 342
stp port shutdown permanent ····························································································· 343
stp port-log ····················································································································· 344
stp priority ······················································································································ 345
stp pvst-bpdu-protection ··································································································· 345
stp region-configuration ···································································································· 346
stp role-restriction ············································································································ 347
stp root primary ··············································································································· 347
stp root secondary ··········································································································· 348
stp root-protection ··········································································································· 349
stp tc-protection ·············································································································· 350
stp tc-protection threshold ································································································· 350
stp tc-restriction ·············································································································· 351
stp tc-snooping ··············································································································· 352
stp timer forward-delay ····································································································· 352
stp timer hello ················································································································· 353
stp timer max-age ············································································································ 354
stp timer-factor ················································································································ 355
stp transmit-limit ·············································································································· 356
stp transparent enable ······································································································ 357
stp vlan enable ··············································································································· 357
vlan-mapping modulo ······································································································· 358
LLDP commands ········································································· 360
cdp voice-vlan ················································································································ 360
dcbx version ··················································································································· 360
display lldp local-information ······························································································ 361
display lldp neighbor-information ························································································ 367
display lldp statistics ········································································································ 376
display lldp status ············································································································ 378
display lldp tlv-config ········································································································ 381
lldp admin-status ············································································································· 384
lldp check-change-interval ································································································· 385
lldp compliance admin-status cdp ······················································································· 386
lldp compliance cdp ········································································································· 387
lldp enable ····················································································································· 388
lldp encapsulation snap ···································································································· 388
lldp fast-count ················································································································· 389
lldp global enable ············································································································ 390
lldp global tlv-enable basic-tlv management-address-tlv ··························································· 390
lldp hold-multiplier ··········································································································· 392
lldp ignore-pvid-inconsistency ···························································································· 393
lldp management-address ································································································· 393
lldp management-address-format string ··············································································· 395
lldp max-credit ················································································································ 396
lldp mode ······················································································································· 396
lldp neighbor-identity chassis-id ·························································································· 397
lldp neighbor-identity port-id ······························································································· 398
lldp neighbor-protection aging ···························································································· 399
lldp neighbor-protection validation ······················································································· 400
lldp notification med-topology-change enable ········································································ 400
lldp notification remote-change enable ················································································· 401
lldp source-mac vlan ········································································································ 402
lldp timer fast-interval ······································································································· 403
lldp timer notification-interval ······························································································ 403
lldp timer reinit-delay ········································································································ 404
lldp timer rx-timeout ········································································································· 404
lldp timer tx-interval ·········································································································· 405
viii
lldp tlv-enable ················································································································· 406
reset lldp statistics ··········································································································· 412
L2PT commands ·········································································· 414
display l2protocol statistics ································································································ 414
l2protocol tunnel dot1q ····································································································· 415
l2protocol tunnel-dmac ····································································································· 417
reset l2protocol statistics ··································································································· 417
Service loopback group commands ·················································· 418
display service-loopback group ·························································································· 418
port service-loopback group ······························································································· 418
service-loopback group ····································································································· 419
Cut-through Layer 2 forwarding commands ········································ 421
cut-through enable ··········································································································· 421
Document conventions and icons ···················································· 422
Conventions ························································································································· 422
Network topology icons ··········································································································· 423
Support and other resources ·························································· 424
Accessing Hewlett Packard Enterprise Support ············································································ 424
Accessing updates ················································································································· 424
Websites ······················································································································· 425
Customer self repair ········································································································· 425
Remote support ·············································································································· 425
Documentation feedback ·································································································· 425
Index ························································································· 427
1
MAC address table commands
This document covers the configuration of unicast MAC address entries, including static, dynamic,
blackhole, and multiport unicast MAC address entries. For more information about configuring static
multicast MAC address entries, see IGMP snooping and IPv6 multicast routing and forwarding in IP
Multicast Configuration Guide. For more information about MAC address table configuration in
VPLS, see MPLS Configuration Guide.
display mac-address
Use display mac-address to display MAC address entries.
Syntax
display mac-address [ mac-address [ vlan vlan-id ] | [ [ dynamic | static ]
[ interface interface-type interface-number ] | blackhole | multiport ]
[ vlan vlan-id ] [ count ] | nickname nickname ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
mac-address: Specifies a MAC address in the format of H-H-H. When entering a MAC address,
you can omit the leading zeros in each H section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.
dynamic: Displays dynamic MAC address entries.
static: Displays static MAC address entries.
interface interface-type interface-number: Specifies an interface by its type and
number.
blackhole: Displays blackhole MAC address entries.
multiport: Displays multiport unicast MAC address entries.
count: Displays only the number of MAC address entries that match all entry attributes you specify
in the command. Detailed information about MAC address entries is not displayed. For example, you
can use the display mac-address vlan 20 dynamic count command to display the number
of dynamic entries for VLAN 20. If you do not specify an entry attribute, the command displays the
number of entries in the MAC address table. If you do not specify this keyword, the command
displays detailed information about the specified MAC address entries.
nickname nickname: Specifies an egress RB by its nickname. The value range for the
nickname argument is 1 to fffe in hexadecimal format.
Usage guidelines
A MAC address entry includes a destination MAC address, an outgoing interface, and a VLAN ID.
If you do not specify any parameters, the command displays all MAC address entries.
This command displays dynamic MAC address entries for an aggregate interface only when the
aggregate interface has a minimum of one Selected member port.
2
Multiport unicast MAC address entries have no impact on the MAC address learning. When
receiving a frame whose source MAC address matches a multiport unicast entry, the device can still
learn the MAC address of the frame and generate a dynamic entry. However, the generated dynamic
entry has lower priority. The device prefers to use the multiport unicast entry to forward frames
destined for the MAC address in the entry.
Examples
# Display MAC address entries for VLAN 100.
<Sysname> display mac-address vlan 100
MAC Address VLAN ID State Port/Nickname Aging
0001-0101-0101 100 Multiport XGE1/0/1 N
XGE1/0/2
0033-0033-0033 100 Blackhole N/A N
0000-0000-0002 100 Static XGE1/0/3 N
00e0-fc00-5829 100 Learned XGE1/0/4 Y
# Display the number of MAC address entries.
<Sysname> display mac-address count
1 mac address(es) found.
# Display the MAC address entries of the egress RB with the nickname 0x8c81.
<Sysname> display mac-address nickname 8c81
MAC Address VLAN ID State Port/Nickname Aging
0000-3300-0001 10 Learned 0x8c81 Y
0000-3300-0002 10 Learned 0x8c81 Y
0000-3300-0003 10 Learned 0x8c81 Y
Table 1 Command output
Field Description
VLAN ID ID of the VLAN to which the outgoing interface of the MAC address entry
belongs.
State
MAC address entry state:
• Static—Static MAC address entry.
• Learned—Dynamic MAC address entry. Dynamic entries can be
learned or manually configured.
• Blackhole—Blackhole MAC address entry.
• Multiport—Multiport unicast MAC address entry.
• OpenFlow—MAC address entry for an OpenFlow instance.
• Block—MAC address entry for a user who failed MAC authentication.
Port/Nickname
When the field displays an interface name, the field indicates the outgoing
interface for packets that are destined for the MAC address. This field
displays N/A for a blackhole MAC address entry.
When the field displays a 16-bit number in hexadecimal format (for example,
0x12ab), it indicates the RB through which the packets leave the TRILL
network. For information about RBs and TRILL, see TRILL Configuration
Guide.
Aging Whether the entry can age out:
• Y—The entry can age out.
•
N
—The entry never ages out.
mac address(es) found Number of matching MAC address entries.
3
Related commands
mac-address
mac-address timer
display mac-address aging-time
Use display mac-address aging-time to display the aging timer for dynamic MAC address
entries.
Syntax
display mac-address aging-time
Views
Any view
Predefined user roles
network-admin
network-operator
Examples
# Display the aging timer for dynamic MAC address entries.
<Sysname> display mac-address aging-time
MAC address aging time: 300s.
Related commands
mac-address timer
display mac-address mac-learning
Use display mac-address mac-learning to display the global MAC address learning status
and the MAC learning status of the specified interface or all interfaces.
Syntax
display mac-address mac-learning [ interface interface-type
interface-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
interface interface-type interface-number: Specifies an interface by its type and
number. If you do not specify an interface, the command displays the global MAC address learning
status and the MAC address learning status of all interfaces.
Examples
# Display the global MAC address learning status and the MAC learning status of all interfaces.
<Sysname> display mac-address mac-learning
Global MAC address learning status: Enabled.
4
Port Learning Status
XGE1/0/1 Enabled
XGE1/0/2 Enabled
Table 2 Command output
Field Description
Global MAC address learning status Global MAC address learning status:
• Enabled.
• Disabled.
Learning Status MAC address learning status of an interface:
• Enabled.
• Disabled.
Related commands
mac-address mac-learning enable
display mac-address mac-move
Use display mac-address mac-move to display the MAC address move records after the
device is started.
Syntax
display mac-address mac-move [ slot slot-number ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
slot slot-number: Specifies an IRF member device by its member ID. If you do not specify a
member device, the command displays MAC address move records for all IRF member devices.
Usage guidelines
When a MAC address frequently moves between the specified two interfaces, Layer 2 loops might
occur in the network. To discover and locate loops, you can view the MAC address move records.
In the MAC address move records, records with the same MAC address, VLAN, source port, and
current port are considered to be one record.
An IRF member device can generate a maximum of 200 MAC address move records.
Examples
# Display the MAC address move records for a slot.
<Sysname> display mac-address mac-move slot 1
MAC address VLAN Current port Source port Last time Times
0000-0001-002c 1 XGE1/0/1 XGE1/0/2 2013-05-20 13:40:52 1
0000-0001-002c 1 XGE1/0/2 XGE1/0/1 2013-05-20 13:41:30 1
--- 2 MAC address moving records found ---
5
# Display the MAC address move records for all slots.
<Sysname> display mac-address mac-move
MAC address VLAN Current port Source port Last time Times
0000-0001-002c 1 XGE1/0/1 XGE1/0/2 2013-05-20 13:40:52 20
0000-0001-002c 1 XGE1/0/2 XGE1/0/1 2013-05-20 13:41:32 20
0000-0094-0001 1 XGE1/0/3 XGE1/0/4 2013-05-20 13:42:22 13
0000-0094-0001 1 XGE1/0/4 XGE1/0/3 2013-05-20 13:42:21 12
--- 4 MAC address moving records found ---
Table 3 Command output
Field
Description
VLAN VLAN to which the outgoing interface of the MAC address entry
belongs.
Current port Interface to which the MAC address was moved.
Source port Interface from which the MAC address was moved.
Last time Last time when the MAC address was moved.
Times
Number of MAC address moves after the device is started. For a MAC
address record, the number of MAC address moves is increased by 1
when a new MAC address move has the same MAC address, VLAN,
Current Port
, and
Source Port
fields as the MAC address record.
Related commands
mac-address notification mac-move
display mac-address statistics
Use display mac-address statistics to display MAC address table statistics.
Syntax
display mac-address statistics
Views
Any view
Predefined user roles
network-admin
network-operator
Usage guidelines
This command displays the number of MAC address entries per type and the maximum number of
MAC address entries allowed for each type.
Examples
# Display MAC address table statistics.
<Sysname> display mac-address statistics
MAC Address Count:
Dynamic Unicast Address (Learned) Count: 3
Dynamic Unicast Address (Security-service-defined) Count: 4
Static Unicast Address (User-defined) Count: 0
Static Unicast Address (System-defined) Count: 3
6
Total Unicast MAC Addresses In Use: 10
Total Unicast MAC Addresses Available: 32768
Multicast and Multiport MAC Address Count: 1
Static Multicast and Multiport MAC Address (User-defined) Count: 1
Total Multicast and Multiport MAC Addresses Available: 256
Table 4 Command output
Field Description
Dynamic Unicast Address (Learned) Count Number of dynamic unicast MAC address entries
triggered by packets.
Dynamic Unicast Address
(Security-service-defined) Count Number of dynamic unicast MAC address entries
triggered by the security service.
Static Unicast Address (User-defined) Count Number of static unicast MAC address entries added
by users.
Static Unicast Address (System-defined) Count Number of static unicast MAC address entries added
by the system.
Total Unicast MAC Addresses In Use Number of unicast MAC address entries.
Total Unicast MAC Addresses Available Maximum number of unicast MAC address entries
allowed.
Multicast and Multiport MAC Address Count Number of multicast and multiport unicast MAC
address entries.
Static Multicast and Multiport MAC Address
(User-defined) Count Number of static multicast and multiport unicast MAC
address entries added by users.
Total Multicast and Multiport MAC Addresses
Available Maximum number of multicast and multiport unicast
MAC address entries allowed.
mac-address (interface view)
Use mac-address to add or modify a MAC address entry on an interface.
Use undo mac-address to delete a MAC address entry on an interface.
Syntax
Layer 2 Ethernet interface view and Layer 2 aggregate interface view:
mac-address { dynamic | multiport | static } mac-address vlan vlan-id
undo mac-address { dynamic | multiport | static } mac-address vlan vlan-id
S-channel interface view, S-channel aggregate interface view, and S-channel bundle interface view:
mac-address { dynamic | static } mac-address vlan vlan-id
undo mac-address { dynamic | static } mac-address vlan vlan-id
Default
An interface is not configured with MAC address entries.
Views
Layer 2 Ethernet interface view
Layer 2 aggregate interface view
S-channel interface view
7
S-channel aggregate interface view
S-channel bundle interface view
Predefined user roles
network-admin
Parameters
dynamic: Specifies dynamic MAC address entries.
static: Specifies static MAC address entries.
multiport: Specifies multiport unicast MAC address entries. A frame whose destination MAC
address matches a multiport unicast MAC address entry is sent out of multiple ports.
mac-address: Specifies a MAC address in the format of H-H-H, excluding multicast, all-zero, and
all-F MAC addresses. When entering a MAC address, you can omit the leading zeros in each H
section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies an existing VLAN to which the specified interface belongs. The value
range for the vlan-id argument is 1 to 4094.
Usage guidelines
Typically, the device automatically builds the MAC address table by learning the source MAC
addresses of incoming frames on each interface. However, you can manually configure static MAC
address entries. For a MAC address, a manually configured static entry takes precedence over a
dynamically learned entry. To improve the security for the user device connected to an interface,
manually configure a static entry to bind the user device to the interface. Then, the frames destined
for the user device (for example, Host A) are always sent out of the interface. Other hosts using the
forged MAC address of Host A cannot obtain the frames destined for Host A.
The MAC address entry configuration cannot survive a reboot unless you save it. The dynamic MAC
address entries, however, are lost upon reboot whether or not you save the configuration.
Examples
# Add a static entry for MAC address 000f-e201-0101 on Ten-GigabitEthernet 1/0/1 that belongs to
VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mac-address static 000f-e201-0101 vlan 2
# Add a static entry for MAC address 000f-e201-0101 on Bridge-Aggregation 1 that belongs to VLAN
1.
<Sysname> system-view
[Sysname] interface bridge-aggregation 1
[Sysname-Bridge-Aggregation1] mac-address static 000f-e201-0102 vlan 1
# Add a static entry for MAC address 000f-e201-0102 on S-Channel 1/0/1:10 that belongs to VLAN
1.
<Sysname> system-view
[Sysname] interface s-channel 1/0/1:10
[Sysname-S-Channel1/0/1:10] mac-address static 000f-e201-0102 vlan 1
# Add a static entry for MAC address 000f-e201-0102 on Schannel-Aggregation 1:2 that belongs to
VLAN 1.
<Sysname> system-view
[Sysname] interface schannel-aggregation 1:2
[Sysname-Schannel-Aggregation1:2] mac-address static 000f-e201-0102 vlan 1
8
# Add a multiport unicast MAC address entry for MAC address 0001-0001-0101 on
Ten-GigabitEthernet 1/0/1 and Ten-GigabitEthernet 1/0/2 that belong to VLAN 2.
<Sysname> system-view
[Sysname] interface ten-gigabitethernet 1/0/1
[Sysname-Ten-GigabitEthernet1/0/1] mac-address multiport 0001-0001-0101 vlan 2
[Sysname-Ten-GigabitEthernet1/0/1] quit
[Sysname] interface ten-gigabitethernet 1/0/2
[Sysname-Ten-GigabitEthernet1/0/2] mac-address multiport 0001-0001-0101 vlan 2
Related commands
display mac-address
mac-address (system view)
mac-address (system view)
Use mac-address to add or modify a MAC address entry.
Use undo mac-address to delete one or all MAC address entries.
Syntax
mac-address { dynamic | static } mac-address interface interface-type
interface-number vlan vlan-id
mac-address blackhole mac-address vlan vlan-id
mac-address multiport mac-address interface interface-list vlan vlan-id
undo mac-address [ [ dynamic | static ] mac-address interface interface-type
interface-number vlan vlan-id ]
undo mac-address [ blackhole | dynamic | static ] [ mac-address ] vlan vlan-id
undo mac-address [ dynamic | static ] interface interface-type
interface-number
undo mac-address multiport mac-address interface interface-list vlan
vlan-id
undo mac-address [ multiport ] [ [ mac-address ] vlan vlan-id ]
undo mac-address nickname nickname
undo mac-address mac-address nickname nickname vlan vlan-id
Default
The system is not configured with MAC address entries.
Views
System view
Predefined user roles
network-admin
Parameters
dynamic: Specifies dynamic MAC address entries.
static: Specifies static MAC address entries.
blackhole: Specifies blackhole MAC address entries. Packets whose source or destination MAC
addresses match blackhole MAC address entries are dropped.
9
multiport: Specifies multiport unicast MAC address entries. A frame whose destination MAC
address matches a multiport unicast MAC address entry is sent out of multiple ports.
mac-address: Specifies a MAC address in the format of H-H-H, excluding multicast, all-zero, and
all-F MAC addresses. When entering a MAC address, you can omit the leading zeros in each H
section. For example, enter f-e2-1 for 000f-00e2-0001.
vlan vlan-id: Specifies an existing VLAN to which the interface belongs. The value range for the
vlan-id argument is 1 to 4094.
interface interface-type interface-number: Specifies an outgoing interface by its type
and number.
interface interface-list: Specifies a list of up to four interface items. Each interface item
can be an individual interface in the format of interface-type interface-number or a range
of interfaces in the format of interface-type interface-number1 to interface-type
interface-number2. The interfaces can only be Layer 2 Ethernet interfaces or Layer 2
aggregate interfaces. The value for the interface-number2 argument cannot be lower than the
value for the interface-number1 argument.
nickname nickname: Specifies an RB (through which the packets leave the TRILL network) by its
nickname. The nickname is a hexadecimal number in the range of 1 to fffe.
Usage guidelines
You can use this command to configure the following types of MAC address entries:
• Dynamic entries.
Dynamic entries include manually configured dynamic entries and automatically learned
dynamic entries.
• Static entries.
For a MAC address, a manually configured static entry takes precedence over a dynamic entry.
To improve the security for the user device connected to an interface, manually configure a
static entry to bind the user device to the interface. Then, the frames destined for the user
device (for example, Host A) are always sent out of the interface. Other hosts using the forged
MAC address of Host A cannot obtain the frames destined for Host A.
• Blackhole entries.
To drop frames with the specified source MAC addresses or destination MAC addresses, you
can configure blackhole entries.
• Multiport unicast entries.
To send frames with a specific destination MAC address out of multiple ports, configure a
multiport unicast entry. When you execute this command for the first time, the command adds
an entry. When you execute the command again with the same MAC address and VLAN but
with different interfaces, this command adds the specified interfaces for this entry.
A static or blackhole entry can overwrite a dynamic entry, but not vice versa.
If you execute the undo mac-address command without specifying any parameters, this
command deletes all unicast MAC address entries and static multicast MAC address entries.
You can delete all the MAC address entries (including unicast and static multicast MAC address
entries) from the specified VLAN. You can also delete only one type (dynamic, static, blackhole, or
multiport unicast) of MAC address entries. You can single out an interface and delete the unicast
MAC address entries on it, but not the static multicast MAC address entries. You can single out an
RB through which the packets leave the TRILL network and delete the corresponding unicast MAC
address entries.
The MAC address entry configuration cannot survive a reboot unless you save it. The dynamic MAC
address entries, however, are lost upon reboot whether or not you save the configuration.
10
Examples
# Add a static entry for MAC address 000f-e201-0101. Then, all frames that are destined for this
MAC address are sent out of Ten-GigabitEthernet 1/0/1, which belongs to VLAN 2.
<Sysname> system-view
[Sysname] mac-address static 000f-e201-0101 interface ten-gigabitethernet 1/0/1 vlan 2
# Add a multiport unicast MAC address entry for MAC address 000f-e201-0101. Then, all frames that
are destined for this MAC address are sent out of Ten-GigabitEthernet 1/0/1 through
Ten-GigabitEthernet 1/0/3, which belong to VLAN 2.
<Sysname> system-view
[Sysname] mac-address multiport 000f-e201-0101 interface ten-gigabitethernet 1/0/1 to
ten-gigabitethernet 1/0/3 vlan 2
Related commands
display mac-address
mac-address (interface view)
mac-address multiport vsi
Use mac-address multiport vsi to configure a multiport unicast MAC address entry for
VXLAN.
Use undo mac-address multiport vsi to delete a multiport unicast MAC address entry for
VXLAN or delete outgoing interfaces for such an entry.
Syntax
For local multiport unicast MAC address entries:
mac-address multiport mac-address { interface { interface-type
interface-number service-instance instance-id }&<1-4> } vsi vsi-name
undo mac-address multiport [ mac-address [ interface { interface-type
interface-number service-instance instance-id }&<1-4> ]] vsi vsi-name
For remote multiport unicast MAC address entries:
mac-address multiport mac-address { interface { tunnel tunnel-number1 [ to
tunnel tunnel-number2 ] }&<1-4> } vsi vsi-name
undo mac-address multiport [ mac-address [ interface { tunnel
tunnel-number1 [ to tunnel tunnel-number2 ] }&<1-4> ] ] vsi vsi-name
Default
No multiport unicast MAC address entries exist.
Views
System view
Predefined user roles
network-admin
Parameters
mac-address: Specifies a MAC address in the format of H-H-H, excluding the all-zero MAC
address. When entering a MAC address, you can omit the leading zeros in each H section. For
example, enter f-e2-1 for 000f-00e2-0001.
interface { interface-type interface-number service-instance
instance-id }&<1-4>: Specifies a space-separated list of up to four Ethernet service instances.
/