Transcript
HP 6127XLG Blade Switch Series Layer 2 - LAN Switching Command Reference
Part number: 797704-001 Software version: Release 2418P03 Document version: 6W100-20150806
Legal and notice information © Copyright 2015 Hewlett-Packard Development Company, L.P. No part of this documentation may be reproduced or transmitted in any form or by any means without prior written consent of Hewlett-Packard Development Company, L.P. The information contained herein is subject to change without notice. HEWLETT-PACKARD COMPANY MAKES NO WARRANTY OF ANY KIND WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Hewlett-Packard shall not be liable for errors contained herein or for incidental or consequential damages in connection with the furnishing, performance, or use of this material. The only warranties for HP 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. HP shall not be liable for technical or editorial errors or omissions contained herein.
Contents Ethernet interface commands ······································································································································ 1 Common Ethernet interface commands ·························································································································· 1 bandwidth ································································································································································· 1 default ········································································································································································ 1 description ································································································································································· 2 display counters ························································································································································ 3 display counters rate ················································································································································ 4 display ethernet statistics ········································································································································· 5 display interface ······················································································································································· 8 display packet-drop··············································································································································· 19 display priority-flow-control ·································································································································· 20 duplex ····································································································································································· 21 flow-control ····························································································································································· 21 flow-control receive enable ·································································································································· 22 flow-interval ···························································································································································· 23 interface ·································································································································································· 24 jumboframe enable ··············································································································································· 24 link-delay ································································································································································ 25 loopback ································································································································································ 26 port link-mode ························································································································································ 27 port up-mode ·························································································································································· 27 priority-flow-control ················································································································································ 28 priority-flow-control no-drop dot1p ······················································································································ 29 reset counters interface ········································································································································· 31 reset ethernet statistics ··········································································································································· 31 reset packet-drop interface ··································································································································· 32 shutdown ································································································································································ 32 speed ······································································································································································ 33 using fortygige ······················································································································································· 34 using tengige ························································································································································· 35 Layer 2 Ethernet interface commands ·························································································································· 36 broadcast-suppression ·········································································································································· 36 display storm-constrain ········································································································································· 37 multicast-suppression ············································································································································· 38 port bridge enable ················································································································································ 39 storm-constrain ······················································································································································· 40 storm-constrain control ·········································································································································· 42 storm-constrain enable log ··································································································································· 42 storm-constrain enable trap ·································································································································· 43 storm-constrain interval ········································································································································· 43 unicast-suppression ················································································································································ 44 Layer 3 Ethernet interface and subinterface commands ···························································································· 45 mtu ·········································································································································································· 45 Loopback, null, and inloopback interface commands····························································································· 47 bandwidth ······························································································································································ 47 default ····································································································································································· 47 description ······························································································································································ 48 display interface inloopback ································································································································ 49 i
display interface loopback ··································································································································· 51 display interface null ············································································································································· 54 interface loopback ················································································································································ 56 interface null··························································································································································· 56 reset counters interface loopback ························································································································ 57 reset counters interface null ·································································································································· 58 shutdown ································································································································································ 58
Bulk interface configuration commands ··················································································································· 60 display interface range ········································································································································· 60 interface range ······················································································································································ 60 interface range name ············································································································································ 62 MAC address table commands································································································································· 64 display mac-address ············································································································································· 64 display mac-address nickname ···························································································································· 65 display mac-address aging-time ·························································································································· 66 display mac-address mac-learning ······················································································································ 66 display mac-address mac-move ··························································································································· 67 display mac-address statistics ······························································································································ 68 mac-address (interface view)································································································································ 70 mac-address (system view) ··································································································································· 71 mac-address mac-learning enable ······················································································································· 73 mac-address mac-learning priority ······················································································································ 75 mac-address mac-roaming enable······················································································································· 76 mac-address max-mac-count ································································································································ 76 mac-address max-mac-count enable-forwarding ································································································ 77 mac-address mac-move fast-update ····················································································································· 78 mac-address notification mac-move ···················································································································· 78 mac-address notification mac-move suppression ······························································································· 79 mac-address notification mac-move suppression interval·················································································· 80 mac-address notification mac-move suppression threshold ·············································································· 81 mac-address static source-check enable ············································································································· 81 mac-address timer ················································································································································· 82 snmp-agent trap enable mac-address ················································································································· 83 MAC Information commands ···································································································································· 84 mac-address information enable (interface view) ······························································································ 84 mac-address information enable (system view) ·································································································· 85 mac-address information interval ························································································································· 85 mac-address information mode···························································································································· 86 mac-address information queue-length················································································································ 86 Ethernet link aggregation commands ······················································································································· 88 bandwidth ······························································································································································ 88 default ····································································································································································· 88 description ······························································································································································ 89 display interface ···················································································································································· 90 display lacp system-id ··········································································································································· 94 display link-aggregation load-sharing mode ······································································································ 95 display link-aggregation load-sharing path ········································································································ 98 display link-aggregation member-port ················································································································ 99 display link-aggregation summary····················································································································· 101 display link-aggregation verbose ······················································································································ 103 interface bridge-aggregation ····························································································································· 105 interface route-aggregation ································································································································ 106 ii
interface schannel-bundle ··································································································································· 107 lacp edge-port······················································································································································ 108 lacp mode ···························································································································································· 108 lacp period short ················································································································································· 109 lacp system-priority ·············································································································································· 110 link-aggregation bfd ipv4 ··································································································································· 110 link-aggregation global load-sharing algorithm ······························································································· 111 link-aggregation global load-sharing minm ······································································································ 112 link-aggregation global load-sharing mode ····································································································· 113 link-aggregation global load-sharing seed ······································································································· 114 link-aggregation ignore vlan ······························································································································ 115 link-aggregation lacp traffic-redirect-notification enable ················································································· 116 link-aggregation load-sharing mode ················································································································· 117 link-aggregation load-sharing mode local-first ································································································· 118 link-aggregation mode ········································································································································ 118 link-aggregation port-priority ······························································································································ 119 link-aggregation selected-port maximum ·········································································································· 120 link-aggregation selected-port minimum ··········································································································· 121 mtu ········································································································································································ 121 port link-aggregation group ······························································································································· 122 reset counters interface ······································································································································· 123 reset lacp statistics ··············································································································································· 124 shutdown ······························································································································································ 124
Port isolation commands ········································································································································· 125 display port-isolate group ··································································································································· 125 port-isolate enable ··············································································································································· 126 port-isolate group ················································································································································ 127 Spanning tree commands ······································································································································· 128 active region-configuration ································································································································· 128 bpdu-drop any ····················································································································································· 128 check region-configuration ································································································································· 129 display stp ···························································································································································· 130 display stp abnormal-port ··································································································································· 137 display stp bpdu-statistics ··································································································································· 138 display stp down-port ·········································································································································· 140 display stp history ················································································································································ 141 display stp region-configuration ························································································································ 142 display stp root ···················································································································································· 143 display stp tc ························································································································································ 144 instance ································································································································································ 145 region-name ························································································································································· 146 reset stp ································································································································································ 147 revision-level ························································································································································· 148 stp bpdu-protection ·············································································································································· 149 stp bridge-diameter ············································································································································· 149 stp compliance ····················································································································································· 150 stp config-digest-snooping ·································································································································· 151 stp cost ·································································································································································· 152 stp edged-port ······················································································································································ 153 stp enable ····························································································································································· 154 stp global config-digest-snooping ······················································································································ 155 stp global enable················································································································································· 156 stp global mcheck ··············································································································································· 156 iii
stp loop-protection ··············································································································································· 157 stp max-hops ························································································································································ 158 stp mcheck···························································································································································· 158 stp mode ······························································································································································· 159 stp no-agreement-check ······································································································································ 160 stp pathcost-standard ·········································································································································· 161 stp point-to-point ·················································································································································· 162 stp port priority ···················································································································································· 163 stp port-log ··························································································································································· 164 stp priority ···························································································································································· 165 stp region-configuration ······································································································································ 166 stp role-restriction················································································································································· 166 stp root primary ··················································································································································· 167 stp root secondary ··············································································································································· 168 stp root-protection ················································································································································ 169 stp tc-protection ···················································································································································· 170 stp tc-protection threshold ··································································································································· 170 stp tc-restriction ···················································································································································· 171 stp tc-snooping ····················································································································································· 171 stp timer forward-delay ······································································································································· 172 stp timer hello······················································································································································· 173 stp timer max-age ················································································································································ 174 stp timer-factor ····················································································································································· 175 stp transmit-limit ··················································································································································· 176 stp vlan enable ···················································································································································· 177 vlan-mapping modulo ········································································································································· 178
Loop detection commands ······································································································································ 179 display loopback-detection································································································································· 179 loopback-detection action ·································································································································· 180 loopback-detection enable ································································································································· 181 loopback-detection global action ······················································································································ 182 loopback-detection global enable ····················································································································· 182 loopback-detection interval-time ························································································································ 183 VLAN commands ···················································································································································· 185 Basic VLAN commands ··············································································································································· 185 bandwidth ···························································································································································· 185 default ··································································································································································· 185 description ···························································································································································· 186 display interface vlan-interface ·························································································································· 187 display vlan ·························································································································································· 190 display vlan brief ················································································································································· 192 interface vlan-interface ········································································································································ 192 mtu ········································································································································································ 193 name ····································································································································································· 194 service ··································································································································································· 195 shutdown ······························································································································································ 196 vlan ······································································································································································· 196 Port-based VLAN commands ······································································································································ 197 display port ·························································································································································· 197 port ········································································································································································ 198 port access vlan ··················································································································································· 199 port hybrid pvid ··················································································································································· 200 port hybrid vlan ··················································································································································· 201 iv
port link-type ························································································································································ 202 port trunk permit vlan ·········································································································································· 202 port trunk pvid ····················································································································································· 203 MAC-based VLAN commands ···································································································································· 204 display mac-vlan ·················································································································································· 204 display mac-vlan interface ·································································································································· 205 mac-vlan enable ·················································································································································· 206 mac-vlan mac-address ········································································································································· 206 mac-vlan trigger enable ······································································································································ 207 port pvid forbidden ············································································································································· 208 vlan precedence ·················································································································································· 209 IP subnet-based VLAN commands ······························································································································ 210 display ip-subnet-vlan interface ·························································································································· 210 display ip-subnet-vlan vlan ································································································································· 211 ip-subnet-vlan ······················································································································································· 212 port hybrid ip-subnet-vlan ··································································································································· 213 Protocol-based VLAN commands ······························································································································· 214 display protocol-vlan interface ··························································································································· 214 display protocol-vlan vlan··································································································································· 215 port hybrid protocol-vlan ···································································································································· 216 protocol-vlan ························································································································································ 217 VLAN group commands ·············································································································································· 219 display vlan-group ··············································································································································· 219 vlan-group ···························································································································································· 220 vlan-list ·································································································································································· 220
Super VLAN commands·········································································································································· 222 display supervlan ················································································································································ 222 subvlan ································································································································································· 224 supervlan ······························································································································································ 225 Private VLAN commands ········································································································································ 227 display private-vlan ············································································································································· 227 port private-vlan host ··········································································································································· 229 port private-vlan promiscuous ···························································································································· 231 port private-vlan trunk promiscuous ··················································································································· 233 port private-vlan trunk secondary ······················································································································ 235 private-vlan (VLAN interface view) ···················································································································· 239 private-vlan (VLAN view) ···································································································································· 241 private-vlan community ······································································································································· 242 private-vlan isolated ············································································································································ 243 private-vlan primary ············································································································································ 244 Voice VLAN commands ·········································································································································· 246 cdp voice-vlan ······················································································································································ 246 display voice-vlan mac-address ························································································································· 246 display voice-vlan state ······································································································································· 247 voice-vlan aging ·················································································································································· 248 voice-vlan enable················································································································································· 249 voice-vlan mac-address ······································································································································· 249 voice-vlan mode auto ·········································································································································· 251 voice-vlan qos ······················································································································································ 251 voice-vlan qos trust ·············································································································································· 252 voice-vlan security enable··································································································································· 253 voice-vlan track lldp ············································································································································ 253 v
MVRP commands ···················································································································································· 255 display mvrp running-status ································································································································ 255 display mvrp state ··············································································································································· 257 display mvrp statistics ········································································································································· 258 mrp timer join······················································································································································· 260 mrp timer leave ···················································································································································· 261 mrp timer leaveall ················································································································································ 262 mrp timer periodic ··············································································································································· 262 mvrp enable ························································································································································· 263 mvrp global enable ············································································································································· 264 mvrp gvrp-compliance enable···························································································································· 265 mvrp registration·················································································································································· 265 reset mvrp statistics ·············································································································································· 266 QinQ commands····················································································································································· 267 display qinq ························································································································································· 267 qinq enable ·························································································································································· 268 qinq ethernet-type customer-tag ························································································································· 268 qinq ethernet-type service-tag····························································································································· 269 qinq transparent-vlan ·········································································································································· 270 VLAN mapping commands ···································································································································· 272 display vlan mapping ········································································································································· 272 vlan mapping ······················································································································································· 273 PBB commands ························································································································································ 276 bvlan ····································································································································································· 276 display l2vpn minm connection ························································································································· 276 display l2vpn minm forwarding ························································································································· 277 display l2vpn vsi·················································································································································· 279 display pbb connection ······································································································································ 281 encapsulation ······················································································································································· 282 pbb i-sid································································································································································ 282 pbb uplink ···························································································································································· 283 reset pbb connection··········································································································································· 284 LLDP commands ······················································································································································· 286 dcbx version························································································································································· 286 display lldp local-information ····························································································································· 286 display lldp neighbor-information ······················································································································ 292 display lldp statistics ··········································································································································· 301 display lldp status ················································································································································ 303 display lldp tlv-config ·········································································································································· 305 lldp admin-status ·················································································································································· 309 lldp check-change-interval ·································································································································· 310 lldp compliance admin-status cdp ····················································································································· 311 lldp compliance cdp ··········································································································································· 311 lldp enable ··························································································································································· 312 lldp encapsulation snap ······································································································································ 313 lldp fast-count ······················································································································································· 314 lldp global enable ··············································································································································· 314 lldp hold-multiplier ··············································································································································· 315 lldp ignore-pvid-inconsistency ···························································································································· 316 lldp management-address-format string ············································································································ 316 lldp max-credit ····················································································································································· 317 lldp mode ····························································································································································· 318 vi
lldp lldp lldp lldp lldp lldp lldp
notification med-topology-change enable ································································································· 318 notification remote-change enable ············································································································· 319 timer fast-interval ·········································································································································· 320 timer notification-interval ····························································································································· 320 timer reinit-delay ·········································································································································· 321 timer tx-interval ············································································································································· 321 tlv-enable ······················································································································································· 322
Service loopback group commands ······················································································································ 328 display service-loopback group ························································································································· 328 port service-loopback group ······························································································································ 328 service-loopback group ······································································································································ 329 Cut-through forwarding commands ······················································································································· 331 cut-through enable ··············································································································································· 331 Support and other resources ·································································································································· 332 Contacting HP ······························································································································································ 332 Subscription service ············································································································································ 332 Related information ······················································································································································ 332 Documents ···························································································································································· 332 Websites······························································································································································· 332 Conventions ·································································································································································· 333 Index ········································································································································································ 335
vii
Ethernet interface commands Common Ethernet interface commands bandwidth Use bandwidth to configure the expected bandwidth of an interface. Use undo bandwidth to restore the default.
Syntax bandwidth bandwidth-value undo bandwidth
Default The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views Ethernet interface view, Ethernet subinterface view
Predefined user roles network-admin
Parameters bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines The expected bandwidth of an interface affects the following items: •
Bandwidth assignment with CBQ. For more information, see ACL and QoS Configuration Guide.
•
Link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.
Examples # Set the expected bandwidth of interface FortyGigE 1/1/1 to 1000 kbps. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] bandwidth 1000
Related commands speed
default Use default to restore the default settings for an Ethernet interface.
1
Syntax default
Views Ethernet interface view, Ethernet subinterface view
Predefined user roles network-admin
Usage guidelines CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you use it in a live network. This command might fail to restore the default settings for some commands for reasons such as command dependencies or system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples # Restore the default settings for interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] default
description Use description to change the description of an interface. Use undo description to restore the default.
Syntax description text undo description
Default The description of an interface is the interface name plus Interface (for example, FortyGigE1/1/1 Interface).
Views Ethernet interface view, Ethernet subinterface view
Predefined user roles network-admin
Parameters text: Specifies the interface description, a case-sensitive string of 1 to 255 characters.
Examples # Change the description of interface FortyGigE 1/1/1 to lanswitch-interface. system-view
2
[Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] description lanswitch-interface
display counters Use display counters to display interface traffic statistics.
Syntax display counters { inbound | outbound } interface [ interface-type [ interface-number | interface-number.subnumber ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters inbound: Displays inbound traffic statistics. outbound: Displays outbound traffic statistics. interface-type: Specifies an interface type. interface-number: Specifies an interface number. interface-number.subnumber: Specifies a subinterface number, where interface-number is an interface number, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Usage guidelines This command displays traffic statistics within a statistics polling interval specified by the flow-interval command. To clear the Ethernet interface traffic statistics, use the reset counters interface command. For more information, see "reset counters interface." If you do not specify an interface type, this command displays traffic statistics for all interfaces that have traffic counters. If you specify an interface type but do not specify an interface number, this command displays traffic statistics for all interfaces of the specified type. If you specify an interface type and an interface number, this command displays traffic statistics of the specified interface.
Examples # Display inbound traffic statistics for all FortyGigE interfaces. display counters inbound interface fortygige Interface
Total (pkts)
Broadcast (pkts)
Multicast (pkts)
Err (pkts)
FGE1/1/1
100
100
0
0
FGE1/1/2
0
0
0
0
FGE1/1/3
Overflow
Overflow
Overflow
Overflow
FGE1/1/4
0
0
0
0
3
Overflow: More than 14 digits (7 digits for column "Err"). --: Not supported.
Table 1 Command output Field
Description
Interface
Abbreviated interface name.
Total (pkts)
Total number of packets received or sent through the interface.
Broadcast (pkts)
Total number of broadcast packets received or sent through the interface.
Multicast (pkts)
Total number of multicast packets received or sent through the interface.
Err (pkts)
Total number of error packets received or sent through the interface.
Overflow: More than 14 digits (7 digits for column "Err")
The command displays Overflow if any of the following cases applies:
• The data length of an Err field value is greater than 7 decimal digits. • The data length of a non-Err field value is greater than 14 decimal digits.
--: Not supported
The statistical item is not supported.
Related commands •
flow-interval
•
reset counters interface
display counters rate Use display counters rate to display traffic rate statistics of interfaces in up state over the last statistics polling interval.
Syntax display counters rate { inbound | outbound } interface [ interface-type [ interface-number | interface-number.subnumber ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters inbound: Displays inbound traffic rate statistics. outbound: Displays outbound traffic rate statistics. interface-type: Specifies an interface type. interface-number: Specifies an interface number. interface-number.subnumber: Specifies a subinterface number, where interface-number is an interface number, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
4
Usage guidelines The statistics cover only interfaces in up state. If you specify an interface type, this command displays traffic rate statistics for all up interfaces of the specified type over the last statistics polling interval. If you do not specify an interface type, this command displays traffic rate statistics for all up interfaces that have traffic counters over the last statistics polling interval. If an interface which is always down over the last statistics polling interval is specified, the system prompts that the interface does not support the command. You can use the flow-interval command to set the statistics polling interval.
Examples # Display the inbound traffic rate statistics for all FortyGigE interfaces. display counters rate inbound interface fortygige Usage: Bandwidth utilization in percentage Interface
Usage (%)
Total (pps)
Broadcast (pps)
Multicast (pps)
FGE1/1/1
3
200
--
--
FGE1/1/2
5
0
--
--
FGE1/1/3
5
0
--
--
Overflow: More than 14 digits. --: Not supported.
Table 2 Command output Field
Description
Interface
Abbreviated interface name.
Usage (%)
Bandwidth usage (in percentage) of the interface during the statistics polling interval.
Total (pkts/sec)
Average rate (in pps) of receiving or sending packets during the statistics polling interval.
Broadcast (pkts/sec)
Average rate (in pps) of receiving or sending broadcast packets during the statistics polling interval.
Multicast (pkts/sec)
Average rate (in pps) of receiving or sending multicast packets during the statistics polling interval.
Overflow: more than 14 decimal digits
The command displays Overflow if the data length of a statistical item is greater than 14 decimal digits.
--: not supported
The statistical item is not supported.
Related commands •
flow-interval
•
reset counters interface
display ethernet statistics Use display ethernet statistics to display the Ethernet module statistics. 5
Syntax display ethernet statistics slot slot-number
Views User view
Predefined user roles network-admin network-operator
Parameters slot slot-number: Displays the Ethernet module statistics on the specified IRF member device. The slot-number argument represents the ID of the IRF member device.
Examples # Display the Ethernet module statistics on IRF member 1. display ethernet statistics slot 1 ETH receive packet statistics: Totalnum
: 28259
ETHIINum
: 22328
SNAPNum
: 0
RAWNum
: 0
LLCNum
: 5931
UnknownNum
: 0
ForwardNum
: 22922
ARP
: 0
MPLS
: 0
ISIS
: 0
ISIS2
: 0
IP
: 0
IPV6
: 0
ETH receive error statistics: NullPoint
: 0
ErrIfindex
: 0
ErrIfcb
: 0
IfShut
: 0
ErrAnalyse
: 0
ErrSrcMAC
: 0
ErrHdrLen
: 0
ETH send packet statistics: L3OutNum
: 412
VLANOutNum
: 0
FastOutNum
: 181
L2OutNum
: 6351
ETH send error statistics: MbufRelayNum
: 0
NullMbuf
: 0
ErrAdjFwd
: 0
ErrPrepend
: 0
ErrHdrLen
: 0
ErrPad
: 0
ErrQosTrs
: 0
ErrVLANTrs
: 0
ErrEncap
: 0
ErrTagVLAN
: 0
IfShut
: 0
IfErr
: 0
Table 3 Command output Field
Description
ETH receive packet statistics
Statistics about the Ethernet packets received on the Ethernet module.
6
Field
Description Total number of received packets:
• • • • • •
ETHIINum—Number of packets encapsulated by using Ethernet-II.
• • • • • • •
ForwardNum—Number of packets forwarded at Layer 2 or sent to the CPU.
Totalnum
SNAPNum—Number of packets encapsulated by using SNAP. RAWNum—Number of packets encapsulated by using RAW. ISIS—Number of packets encapsulated by using IS-IS. LLCNum—Number of packets encapsulated by using LLC. UnknownNum—Number of packets encapsulated by using unknown methods. ARP—Number of ARP packets. MPLS—Number of MPLS packets. ISIS—Number of IS-IS packets. ISIS2—Number of large 802.3/802.2 frames encapsulated by using IS-IS. IP—Number of IP packets. IPv6—Number of IPv6 packets.
Statistics about the error Ethernet packets in the outbound direction on the Ethernet module. Errors might be included in packets or occur during the receiving process. The items include:
ETH receive error statistics
• • • •
NullPoint—Number of packets that include null pointers. ErrIfindex—Number of packets that include incorrect interface indexes. ErrIfcb—Number of packets that include incorrect interface control blocks. IfShut—Number of packets that are being received when the interface is shut down.
• ErrAnalyse—Number of packets that include packet parsing errors. • ErrSrcMAC—Number of packets that include incorrect source MAC addresses.
• ErrHdrLen—Number of packets that include header length errors. Statistics about the Ethernet packets sent by the Ethernet module:
ETH send packet statistics
• • • • •
L3OutNum—Number of packets sent out of Layer 3 Ethernet interfaces. VLANOutNum—Number of packets sent out of VLAN interfaces. FastOutNum—Number of packets fast forwarded. L2OutNum—Number of packets sent out of Layer 2 Ethernet interfaces. MbufRelayNum—Number of packets transparently sent.
7
Field
Description Statistics about the error Ethernet packets in the outbound direction on the Ethernet module:
ETH send error statistics
• • • • • • • •
NullMbuf—Number of packets with null pointers. ErrAdjFwd—Number of packets with adjacency table errors. ErrPrepend—Number of packets with extension errors. ErrHdrLen—Number of packets with header length errors. ErrPad—Number of packets with padding errors. ErrQosTrs—Number of packets that failed to be sent by QoS. ErrVLANTrs—Number of packets that failed to be sent in VLANs. ErrEncap—Number of packets that failed to be sent due to link header encapsulation failures.
• ErrTagVLAN—Number of packets that failed to be sent due to VLAN tag encapsulation failures.
• IfShut—Number of packets that are being sent when the interface is shut down.
• IfErr—Number of packets with incorrect outgoing interfaces.
Related commands reset ethernet statistics
display interface Use display interface to display Ethernet interface information.
Syntax display interface [ interface-type ] [ brief [ down ] ] display interface [ interface-type [ interface-number | interface-number.subnumber ] ] [ brief [ description ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-type: Specifies an interface type. interface-number: Specifies an interface number. interface-number.subnumber: Specifies a subinterface number, where interface-number is an interface number, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information. down: Displays information about interfaces in the down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states. 8
description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions.
Usage guidelines If you do not specify an interface type, this command displays information about all interfaces. If you specify an interface type but do not specify an interface number, this command displays information about all interfaces of that type. If you specify both the interface type and interface number, this command displays information about the specified interface.
Examples # Display information about Layer 3 interface FortyGigE 1/1/1. display interface fortygige 1/1/1 Current state: DOWN Line protocol state: DOWN Description: FortyGigE1/1/1 Interface Bandwidth: 40000000kbps Maximum Transmit Unit: 1500 Internet protocol processing: disabled IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 00e0-fc11-19c0 IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 00e0-fc11-19c0 Media type is not sure, Port hardware type is no connector Port priority: 0 Unknown-speed mode, unknown-duplex mode Link speed type is autonegotiation, link duplex type is autonegotiation Flow-control is not enabled The Maximum Frame Length is 10000 Last clearing of counters: Never Peak value of input: 0 bytes/sec, at 2011-01-01 01:22:10 Peak value of output: 0 bytes/sec, at 2011-01-01 01:22:10 Last 300 seconds input: Last 300 seconds output: Input (total):
0 packets/sec 0 bytes/sec -% 0 packets/sec 0 bytes/sec -%
0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Input (normal):
0 packets, - bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Input:
0 input errors, 0 runts, 0 giants, 0 throttles 0 CRC, 0 frame, - overruns, 0 aborts - ignored, - parity errors
Output (total): 0 packets, 0 bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Output (normal): 0 packets, - bytes 0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Output: 0 output errors, - underruns, - buffer failures 0 aborts, 0 deferred, 0 collisions, 0 late collisions 0 lost carrier, - no carrier
9
Table 4 Command output Field
Description State of the interface:
• Administratively DOWN—The Ethernet interface was shut down with the shutdown command. The interface is administratively down.
Current state
• DOWN—The Ethernet interface is administratively up but
physically down. There might not be a physical link present or the link has failed.
• UP—The Ethernet interface is both administratively and physically up.
Link layer state of the interface. The state is determined through parameter negotiation on the link layer.
• UP—The interface is up at the data link layer. • UP (spoofing)—The link layer protocol of an interface is UP, but its link is an on-demand link or not present at all. This attribute is typical of Null interfaces and loopback interfaces.
• DOWN—The interface is down at the data link layer. • DOWN (DLDP DOWN)—The link layer protocol of the interface is down because DLDP detected that the link was unidirectional.
• DOWN (LAGG DOWN)—The link layer protocol of the interface is Line protocol state
down because the aggregate interface does not have Selected ports.
• DOWN (OAM DOWN)—The link layer of the interface is down because OAM detected remote link failures.
• DOWN (DLDP and LAGG DOWN)—The link layer of the interface is shut down by DLDP and LAGG.
• DOWN (DLDP and OAM DOWN)—The link layer of the interface is shut down by DLDP and OAM.
• DOWN (OAM and LAGG DOWN)—The link layer of the interface is shut down by OAM and LAGG.
• DOWN (DLDP, OAM and LAGG DOWN)—The link layer of the interface is shut down by DLDP, OAM, and LAGG.
Hold timer is
Link-up or link-down event suppression interval.
Bandwidth
Expected bandwidth of the interface.
Internet protocol processing: disabled
Indicates that the interface cannot process IP packets.
Last clearing of counters
Time when the reset counters interface command was last used to clear the interface statistics. Never indicates the reset counters interface command has never been used on the interface since the device's startup.
Last 300 seconds input rate
Average input rate over the last 300 seconds in Bps, bps, and pps.
Last 300 seconds output rate
Average output rate over the last 300 seconds in Bps, bps, and pps.
# Display detailed information about Layer 2 interface FortyGigE 1/1/1. display interface fortygige 1/1/1 FortyGigE1/1/1 Current state: UP
10
Line protocol state: UP IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 00e0-fc00-58a5 Description: FortyGigE1/1/1 Interface Bandwidth: 40000000kbps Loopback is not set Media type is stack wire,Port hardware type is STACK_QSFP_PLUS 40Gbps-speed mode, full-duplex mode Link speed type is autonegotiation, link duplex type is autonegotiation Flow-control is not enabled The Maximum Frame Length is 10000 Allow jumbo frame to pass Broadcast MAX-ratio: 100% Multicast MAX-ratio: 100% Unicast MAX-ratio: 100% PVID: 1 Mdi type: automdix Port link-type: access Tagged Vlan:
none
UnTagged Vlan: 1 Port priority: 0 Last clearing of counters: Never Peak value of input: 0 bytes/sec, at 2011-01-01 05:08:32 Peak value of output: 1 bytes/sec, at 2011-01-01 05:08:32 Last 300 seconds input: Last 300 seconds output: Input (total):
0 packets/sec 0 bytes/sec -% 0 packets/sec 1 bytes/sec -%
0 packets, 0 bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Input (normal):
0 packets, - bytes
0 unicasts, 0 broadcasts, 0 multicasts, 0 pauses Input:
0 input errors, 0 runts, 0 giants, 0 throttles 0 CRC, 0 frame, - overruns, 0 aborts - ignored, - parity errors
Output (total): 2 packets, 436 bytes 0 unicasts, 0 broadcasts, 2 multicasts, 0 pauses Output (normal): 2 packets, - bytes 0 unicasts, 0 broadcasts, 2 multicasts, 0 pauses Output: 0 output errors, - underruns, - buffer failures 0 aborts, 0 deferred, 0 collisions, 0 late collisions 0 lost carrier, - no carrier
11
Table 5 Command output Field
Description State of the Ethernet interface:
• Administratively DOWN—The Ethernet interface was shut down with the shutdown command. The interface is administratively down.
Current state
• DOWN—The Ethernet interface is administratively up but
physically down (possibly because no physical link is present or the link has failed).
• UP—The Ethernet interface is both administratively and physically up.
Link layer state of the interface. The state is determined through parameter negotiation on the link layer.
• UP—The interface is up at the data link layer. • UP (spoofing)—The link layer protocol of an interface is UP, but
its link is an on-demand link or not present at all. This attribute is typical of Null interfaces and loopback interfaces.
• DOWN—The interface is down at the data link layer. • DOWN (DLDP DOWN)—The link layer protocol of the interface
is down because DLDP detected that the link was unidirectional.
• DOWN (LAGG DOWN)—The link layer protocol of the interface Line protocol state
is down because the aggregate interface does not have Selected ports.
• DOWN (OAM DOWN)—The link layer of the interface is down because OAM detected remote link failures.
• DOWN (DLDP and LAGG DOWN)—The link layer of the interface is shut down by DLDP and LAGG.
• DOWN (DLDP and OAM DOWN)—The link layer of the interface is shut down by DLDP and OAM.
• DOWN (OAM and LAGG DOWN)—The link layer of the interface is shut down by OAM and LAGG.
• DOWN (DLDP, OAM and LAGG DOWN)—The link layer of the interface is shut down by DLDP, OAM, and LAGG.
IP Packet Frame Type
Ethernet framing format. PKTFMT_ETHNT_2 indicates that the frames are encapsulated in Ethernet II framing format.
Hardware Address
MAC address of the interface.
Bandwidth
Expected bandwidth of the interface.
Loopback is set internal
An internal loopback test is running on the Ethernet interface.
Loopback is set external
An external loopback test is running on the Ethernet interface.
Loopback is not set
No loopback test is running on the Ethernet interface.
10Mbps-speed mode
The interface is operating at 10 Mbps.
100Mbps-speed mode
The interface is operating at 100 Mbps.
1000Mbps-speed mode
The interface is operating at 1000 Mbps.
10Gbps-speed mode
The interface is operating at 10 Gbps.
40Gbps-speed mode
The interface is operating at 40 Gbps.
12
Field
Description
Unknown-speed mode
The speed of the interface is unknown because the speed negotiation fails or the interface is physically disconnected.
half-duplex mode
The interface is operating in half duplex mode.
full-duplex mode
The interface is operating in full duplex mode.
unknown-duplex mode
The duplex mode of the interface is unknown because the duplex mode negotiation fails or the interface is physically disconnected.
Link speed type is autonegotiation
The interface is configured with the speed auto command.
Link speed type is force link
The interface is configured with a speed by using the speed command.
link duplex type is autonegotiation
The interface is configured with the duplex auto command.
link duplex type is force link
The interface is configured with a duplex mode by using the duplex command.
The Maximum Frame Length
Maximum Ethernet frame length allowed on the interface.
Allow jumbo frame to pass
The interface allows jumbo frames to pass through.
Broadcast MAX-
Broadcast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Multicast MAX-
Multicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
Unicast MAX-
Unicast storm suppression threshold in ratio, pps, or kbps. The unit of the threshold depends on your configuration.
PVID
Port VLAN ID (PVID) of the Ethernet interface. Cable type (depending on your configuration):
Mdi type
• automdix. • mdi. • mdix. Link type of the interface (depending on your configuration):
Port link-type
• access. • trunk. • hybrid.
Tagged VLAN ID
VLANs for which the interface sends packets without removing VLAN tags.
Untagged VLAN ID
VLANs for which the interface sends packets after removing VLAN tags.
Port priority
Priority of the interface.
Last clearing of counters: Never
Time when the reset counters interface command was last used to clear statistics on the interface. Never indicates that the reset counters interface command was never used since the device was started.
Peak value of input
Peak rate of inbound traffic in Bps, and the time when the peak inbound traffic rate occurred.
Peak value of output
Peak rate of outbound traffic in Bps, and the time when the peak outbound traffic rate occurred. 13
Field
Description
Last 300 seconds input
Average rate of inbound traffic in the last 300 seconds, in pps and Bps, and the ratio of the actual rate to the maximum interface rate. A hyphen (-) indicates that the statistical item is not supported.
Last 300 seconds output
Average rate of outbound traffic in the last 300 seconds, in pps and Bps, and the ratio of the actual rate to the maximum interface rate. A hyphen (-) indicates that the statistical item is not supported. Inbound traffic statistics (in packets and bytes) for the interface. All inbound normal and abnormal packets and normal pause frames were counted.
Input(total)
Number of inbound unicast packets, number of inbound broadcasts, number of inbound multicasts, and number of inbound pause frames. A hyphen (-) indicates that the statistical item is not supported. Inbound normal traffic and pause frame statistics (in packets and bytes) for the interface.
Input(normal)
Number of inbound normal unicast packets, number of inbound normal broadcasts, number of inbound normal multicasts, and number of inbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
input errors
Statistics of incoming error packets.
runts
Number of inbound frames shorter than 64 bytes, in correct format, and containing valid CRCs. Number of inbound frames larger than the maximum frame length supported on the interface.
• For an Ethernet interface that does not permit jumbo frames, giants
giants refer to frames larger than 1536 bytes (without VLAN tags) or 1540 bytes (with VLAN tags).
• For an Ethernet interface that permits jumbo frames, giants refer to frames larger than the maximum length of Ethernet frames that are allowed to pass through, which is configured when you configure jumbo frame support on the interface.
throttles
Number of inbound frames that had a non-integer number of bytes.
CRC
Total number of inbound frames that had a normal length, but contained CRC errors.
frame
Total number of inbound frames that contained CRC errors and a non-integer number of bytes.
overruns
Number of packets dropped because the input rate of the port exceeded the queuing capability.
14
Field
Description Total number of illegal inbound packets:
• Fragment frames—CRC error frames shorter than 64 bytes. The length can be an integral or non-integral value.
• Jabber frames—CRC error frames greater than the maximum frame length supported on the Ethernet interface (with an integral or non-integral length). {
aborts
{
For an Ethernet interface that does not permit jumbo frames, jabber frames refer to CRC error frames greater than 1536 bytes (without VLAN tags) or 1540 bytes (with VLAN tags). For an Ethernet interface that permits jumbo frames, jabber frames refer to CRC error frames greater than the maximum length of Ethernet frames that are allowed to pass through the interface.
• Symbol error frames—Frames that contained at least one undefined symbol.
• Unknown operation code frames—Non-pause MAC control frames.
• Length error frames—Frames whose 802.3 length fields did not match the actual frame length (46 to 1500 bytes).
ignored
Number of inbound frames dropped because the receive buffer of the port ran low.
parity errors
Total number of frames with parity errors. Outbound traffic statistics (in packets and bytes) for the interface. All outbound normal and abnormal packets and normal pause frames were counted.
Output(total)
Number of outbound unicast packets, number of outbound broadcasts, number of outbound multicasts, and number of outbound pause frames. A hyphen (-) indicates that the statistical item is not supported. Outbound normal traffic and pause frame statistics (in packets and bytes) for the interface.
Output(normal)
Number of outbound normal unicast packets, number of outbound normal broadcasts, number of outbound normal multicasts, and number of outbound normal pause frames. A hyphen (-) indicates that the statistical item is not supported.
output errors
Number of outbound packets with errors.
underruns
Number of packets dropped because the output rate of the interface exceeded the output queuing capability. This is a low-probability hardware anomaly.
buffer failures
Number of packets dropped because the transmit buffer of the interface ran low.
aborts
Number of packets that failed to be transmitted, for example, because of Ethernet collisions.
deferred
Number of frames that the interface deferred to transmit because of detected collisions.
15
Field
Description
collisions
Number of frames that the interface stopped transmitting because Ethernet collisions were detected during transmission.
late collisions
Number of frames that the interface deferred to transmit after transmitting their first 512 bits because of detected collisions.
lost carrier
Number of carrier losses during transmission. This counter increases by one when a carrier is lost, and applies to serial WAN interfaces.
no carrier
Number of times that the port failed to detect the carrier when attempting to send frames. This counter increases by one when a port failed to detect the carrier, and applies to serial WAN interfaces.
# Display brief information about all interfaces. display interface brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
FGE1/1/1
DOWN DOWN
--
InLoop0
UP
UP(s)
--
Loop5
UP
UP(s)
--
M-GE0/0/0
UP
UP
192.168.0.65
NULL0
UP
UP(s)
--
REG0
DOWN --
--
Vlan1
UP
--
UP
Description
Brief information on interface(s) under bridge mode: Link: ADM - administratively down; Stby - standby Speed or Duplex: (a)/A - auto; H - half; F - full Type: A - access; T - trunk; H - hybrid Interface
Link Speed
Duplex Type PVID Description
BAGG1
DOWN auto
A
A
1
FGE1/1/2
DOWN auto
A
A
1
FGE1/1/3
UP
F(a)
A
1
FGE1/1/4
DOWN auto
A
A
1
40G(a)
# Display brief information about interface FortyGigE 1/1/3, including the complete interface description. display interface fortygige 1/1/3 brief description Brief information on interface(s) under bridge mode: Link: ADM - administratively down; Stby - standby Speed or Duplex: (a)/A - auto; H - half; F - full Type: A - access; T - trunk; H - hybrid Interface
Link Speed
Duplex Type PVID Description
FGE1/1/3
UP
F(a)
40G(a)
A
1
aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
# Display information about interfaces in DOWN state and the causes. 16
display interface brief down Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Interface
Link Cause
REG0
DOWN Not connected
FGE1/1/1
DOWN Not connected
Brief information on interface(s) under bridge mode: Link: ADM - administratively down; Stby - standby Interface
Link Cause
FGE1/1/2
DOWN Not connected
FGE1/1/4
DOWN Not connected
Table 6 Command output Field
Description
Brief information of interface(s) under route mode:
Brief information about Layer 3 interfaces.
• ADM—The interface has been shut down by the network Link: ADM - administratively down; Stby - standby
administrator. To recover its physical layer state, run the undo shutdown command.
• Stby—The interface is a standby interface.
Protocol: (s) – spoofing
If the data link layer protocol of an interface is up, but its link is an on-demand link or not present at all, this field displays UP (s), where s represents the spoofing flag. This attribute is typical of interface Null 0 and loopback interfaces.
Interface
Interface name. Physical link state of the interface:
Link
• UP—The link is up. • DOWN—The link is physically down. • ADM—The link has been administratively shut down. To recover its physical state, run the undo shutdown command.
• Stby—The interface is a standby interface. Link layer protocol state of the interface: Protocol
• UP. • DOWN. • UP(s)—The link of the interface is an on-demand link or not present at all.
Main IP
Primary IP address of the interface. A hyphen (-) indicates that the interface is not configured with an IP address. Partial or complete interface description configured by using the description command:
Description
• If you do not specify the description keyword for the display interface brief command, the Description field displays only the first 27 characters of the interface description.
• If you specify the description keyword for the display interface brief command, the field displays the complete interface description.
17
Field
Description
The brief information of interface(s) under bridge mode:
Brief information about Layer 2 interfaces. If the speed of an interface is automatically negotiated, its speed attribute includes the autonegotiation flag, indicated by the letter a in parentheses.
Speed or Duplex: (a)/A - auto; H half; F – full
If the duplex mode of an interface is automatically negotiated, its duplex mode attribute includes the following options:
• (a)/A—Autonegotiation. • H—Half negotiation. • F—Full negotiation. Type: A - access; T - trunk; H – hybrid
Link type options for Ethernet interfaces.
Speed
Interface rate, in bps. Duplex mode of the interface:
Duplex
• • • • •
A—Autonegotiation. F—Full duplex. F(a)—Autonegotiated full duplex. H—Half duplex. H(a)—Autonegotiated half duplex.
Link type of the interface: Type
PVID
• A—Access. • H—Hybrid. • T—Trunk. Port VLAN ID. Cause for the physical link state of an interface to be DOWN:
• Administratively—The port is manually shut down by using the shutdown command. To restore the physical state of the interface, use the undo shutdown command.
• DOWN ( Link-Aggregation interface down )—When an aggregate interface is shut down, the physical state of all member ports of the aggregate interface becomes DOWN.
• DOWN (Loopback detection down)—The port is shut down because the loopback detection module has detected loops.
• DOWN ( Monitor-Link uplink down )—The port is shut down because Cause
the monitor link module has detected that the uplink is down.
• MAD ShutDown—After an IRF split, the state of all interfaces except the excluded ports in the IRF in recovery state is set to DOWN.
• Not connected—No physical connection exists (possibly because the network cable is disconnected or faulty).
• Storm-Constrain—The port is shut down because the unknown
unicast traffic, multicast traffic, or broadcast traffic exceeds the upper limit.
• STP DOWN—The port is shut down by the STP BPDU guard function. • Port Security Disabled—The port is shut down by the intrusion detection mechanism because the port receives illegal packets.
• Standby—The interface is in the Standby state. 18
Related commands reset counters interface
display packet-drop Use display packet-drop to display information about packets dropped on an interface or multiple interfaces.
Syntax display packet-drop { interface [ interface-type [ interface-number ] ] | summary }
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-type: Specifies an interface type. If you do not specify an interface type, this command displays information about dropped packets on all the interfaces on the device. interface-number: Specifies an interface number. If you specify an interface type only, this command displays information about dropped packets on the specified type of interfaces. summary: Displays the summary of dropped packets on all interfaces.
Examples # Display information about dropped packets on FortyGigE 1/1/1. display packet-drop interface fortygige 1/1/1 FortyGigE1/1/1: Packets dropped due to full GBP or insufficient bandwidth: 301 Packets dropped due to Fast Filter Processor (FFP): 261 Packets dropped due to STP non-forwarding state: 321
# Display the summary of dropped packets on all interfaces. display packet-drop summary All interfaces: Packets dropped due to full GBP or insufficient bandwidth: 301 Packets dropped due to Fast Filter Processor (FFP): 261 Packets dropped due to STP non-forwarding state: 321
Table 7 Command output Field
Description
Packets dropped due to full GBP or insufficient bandwidth
Packets that are dropped because the buffer is used up or the bandwidth is insufficient.
Packets dropped due to Fast Filter Processor (FFP)
Packets that are filtered out.
Packets dropped due to STP non-forwarding state
Packets that are dropped because STP is in the non-forwarding state.
19
display priority-flow-control Use display priority-flow-control to display the PFC information for an interface.
Syntax display priority-flow-control interface [ interface-type [ interface-number ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-type: Specifies an interface type. If you do not specify an interface type, the command displays the PFC information for all Ethernet interfaces. interface-number: Specifies an interface number. If you do not specify an interface number, the command displays the PFC information for all Ethernet interfaces of the specified type.
Examples # Display the PFC information for all Ethernet interfaces. display priority-flow-control interface Interface
AdminMode
OperMode
Dot1pList
Prio
Recv
Send
-------------------------------------------------------------------------------FGE1/1/1
Disabled
Disabled
0,2-3,5-6
FGE1/1/2
Auto
Enabled
0-1,3-4,6-7 0
FGE1/1/3
FGE1/1/4
Enabled
Auto
Enabled
Disabled
0-2,4-5,7
4294967295 4294967295
5
23
0
7
5
0
0
178
43
1
234
112
4
13
0
5
1572
0
7
110
0
1-2,4-5,7
Table 8 Command output Field
Description
Interface
Abbreviated name of the interface.
AdminMode
• Disabled—PFC is disabled for the interface. • Auto—The interface is configured to autonegotiate the PFC status with
Administrative PFC status:
the remote end.
• Enabled—PFC is enabled for the interface. Operative PFC status: OperMode
• Disabled—PFC is disabled. • Enabled—PFC is enabled.
20
Field
Description
Dot1pList
802.1p priorities that are enabled with PFC. 802.1p priority values 0 through 7 are available.
Prio
An 802.1p priority is displayed only when the 802.1p priority is enabled with PFC and the interface has received or sent packets with the 802.1p priority.
Recv
Number of received frames.
Send
Number of sent frames.
duplex Use duplex to set the duplex mode for an Ethernet interface. Use undo duplex to restore the default duplex mode of the Ethernet interface.
Syntax duplex { auto | full } undo duplex
Default Ethernet interfaces autonegotiate the duplex mode.
Views Ethernet interface view
Predefined user roles network-admin
Parameters auto: Configures the interface to autonegotiate the duplex mode with the peer. full: Configures the interface to operate in full duplex mode, so that the interface can receive and transmit packets at the same time.
Examples # Configure interface FortyGigE 1/1/1 to operate in full duplex mode. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] duplex full
flow-control CAUTION: Configuring generic flow control on an Ethernet interface will cause link-up and link-down events before the interface finally stays up. Use flow-control to enable TxRx mode generic flow control on an Ethernet interface. Use undo flow-control to disable generic flow control on the Ethernet interface. 21
Syntax flow-control undo flow-control
Default Generic flow control is disabled on an Ethernet interface.
Views Ethernet interface view
Predefined user roles network-admin
Usage guidelines To implement flow control on a link, enable the generic flow control function at both ends of the link. TxRx mode generic flow control enables an Ethernet interface to perform the following actions: •
Receive common pause frames from its peer.
•
Send common pause frames to notify its peer of congestions.
With the flow-control command configured, an interface can both send and receive flow control frames: •
When congested, the interface sends a flow control frame to its peer.
•
Upon receiving a flow control frame from the peer, the interface suspends sending packets.
Examples # Enable TxRx mode generic flow control on the interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] flow-control
flow-control receive enable CAUTION: Configuring generic flow control on an Ethernet interface will cause link-up and link-down events before the interface finally stays up. Use flow-control receive enable to enable Rx mode generic flow control on an Ethernet port. Use undo flow-control to disable generic flow control on an Ethernet interface.
Syntax flow-control receive enable undo flow-control
Default Rx flow control is disabled on Ethernet interfaces.
Views Ethernet interface view
22
Predefined user roles network-admin
Usage guidelines With the flow-control receive enable command configured, an interface can receive, but not send, flow control frames. When the interface receives a flow control frame from its peer, it suspends sending packets to the peer. When traffic congestion occurs on the interface, it cannot send flow control frames to the peer. To handle unidirectional traffic congestion on a link, configure the flow-control receive enable command at one end, and the flow-control command at the other. To enable both ends of the link to handle traffic congestion, configure the flow-control command at both ends.
Examples # Enable Rx mode generic flow control on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] flow-control receive enable
Related commands flow-control
flow-interval Use flow-interval to set the interface statistics polling interval. Use undo flow-interval to restore the default interval.
Syntax flow-interval interval undo flow-interval
Default The interface statistics polling interval is 300 seconds.
Views Ethernet interface view
Predefined user roles network-admin
Parameters interval: Sets the statistics polling interval, in seconds. The interval is in the range of 5 to 300 and must be a multiple of 5.
Examples # Set the statistics polling interval to 100 seconds on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] flow-interval 100
23
interface Use interface to enter interface or subinterface view. If the subinterface does not exist, the command creates the subinterface and leads you to its view.
Syntax interface interface-type { interface-number | interface-number.subnumber }
Views System view
Predefined user roles network-admin
Parameters interface-type: Specifies an interface type. interface-number: Specifies an interface number. interface-number.subnumber: Specifies a subinterface number, where interface-number is an interface number, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Examples # Enter FortyGigE 1/1/1 interface view. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1]
# Create Ethernet subinterface FortyGigE 1/1/1.1 and enter its view. system-view [Sysname] interface fortygige 1/1/1.1 [Sysname-FortyGigE1/1/1.1]
jumboframe enable Use jumboframe enable to allow jumbo frames within the specified length to pass through. Use undo jumboframe enable to prevent jumbo frames from passing through.
Syntax jumboframe enable [ value ] undo jumboframe enable
Default The device allows jumbo frames within 10000 bytes to pass through.
Views Ethernet interface view
Predefined user roles network-admin
24
Parameters value: Sets the maximum length of Ethernet frames that are allowed to pass through. The value range is 1536 to 10000 bytes.
Usage guidelines If you set the value argument multiple times, the most recent configuration takes effect.
Examples # Enable jumbo frames to pass through FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] jumboframe enable
link-delay Use link-delay to set the physical state change suppression interval on an Ethernet interface. Use undo link-delay to restore the default.
Syntax link-delay [ msec ] delay-time [ mode { up | updown } ] undo link-delay
Default Each time the physical link of a port goes up or comes down, the interface immediately reports the change to the CPU.
Views Ethernet interface view
Predefined user roles network-admin
Parameters msec: Enables the physical state change suppression interval to be accurate to milliseconds. If you do not specify this keyword, the suppression interval is accurate to seconds. delay-time: Sets the physical state change suppression interval on the Ethernet interface. A value of 0 indicates that physical state changes are immediately reported to the CPU and are not suppressed. •
If you do not specify the msec keyword, the value range for this argument is 0 to 30 seconds.
•
If you specify the msec keyword, the value range for this argument is 0 to 10000 milliseconds, and the value must be a multiple of 100.
mode up: Suppresses the link-up events. mode updown: Suppresses both the link-up and link-down events.
Usage guidelines When the link-delay delay-time command is configured: •
The link-down event is not reported to the CPU unless the interface is still down when the suppression interval (delay-time) expires.
•
The link-up event is immediately reported. 25
When the link-delay delay-time mode up command is configured: •
The link-up event is not reported to the CPU unless the interface is still up when the suppression interval (delay-time) expires.
•
The link-down event is immediately reported.
When the link-delay delay-time mode updown command is configured: •
The link-down event is not reported to the CPU unless the interface is still down when the suppression interval (delay-time) expires.
•
The link-up event is not reported to the CPU unless the interface is still up when the suppression interval (delay-time) expires.
On a port, if you configure the link-delay command multiple times, the most recent configuration takes effect. Do not configure this command on a port with RRPP, MSTP, or Smart Link enabled.
Examples # Set the link-down event suppression interval to 8 seconds on interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] link-delay 8
# Set the link-up event suppression interval to 800 milliseconds on interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] link-delay msec 800 mode up
loopback Use loopback to perform a loopback test on an Ethernet interface.
Syntax loopback { external | internal }
Views Ethernet interface view
Predefined user roles network-admin
Parameters external: Performs an external loopback test on the Ethernet interface. internal: Performs an internal loopback test on the Ethernet interface.
Usage guidelines If an Ethernet interface does not work correctly, you can perform a loopback test on it to identify the problem. An Ethernet interface in a loopback test does not forward data traffic. On an administratively shut down Ethernet interface (displayed as in ADM or Administratively DOWN state), you cannot perform an internal or external loopback test. The speed, duplex, mdix-mode, and shutdown commands are not available during a loopback test. 26
During a loopback test, the Ethernet interface operates in full duplex mode. When the loopback test is complete, the port returns to its duplex setting.
Examples # Perform an internal loopback test on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] loopback internal Loop internal succeeded!
port link-mode Use port link-mode to change the link mode of an Ethernet interface. Use undo port link-mode to restore the default.
Syntax port link-mode { bridge | route } undo port link-mode
Default Ethernet interfaces operate in bridge mode.
Views Ethernet interface view
Predefined user roles network-admin
Parameters bridge: Specifies the Layer 2 mode. route: Specifies the Layer 3 mode.
Usage guidelines Interfaces on the device can operate either as Layer 2 or Layer 3 Ethernet interfaces. You can use commands to set the link mode to bridge or route. After you change the link mode of an Ethernet interface, all the commands (except the shutdown command) on the Ethernet interface are restored to their defaults in the new link mode.
Examples # Configure FortyGigE 1/1/1 to operate in bridge mode. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] port link-mode bridge
port up-mode Use port up-mode to forcibly bring up a fiber port. Use undo port up-mode to restore the default. 27
Syntax port up-mode undo port up-mode
Default Fiber ports are not forcibly brought up. The physical state of the fiber port is determined by the physical state of the optical fibers.
Views Ethernet interface view
Predefined user roles network-admin
Usage guidelines CAUTION: The following operations on a fiber port will cause link updown events before the port finally stays up: • Configure the port up-mode command and the speed or duplex command at the same time. • Install or remove fiber links or transceiver modules after you forcibly bring up the fiber port. You can use this command to forcibly bring up a fiber Ethernet port, and enable the port to forward packets unidirectionally over a single link. In this way, transmission links are well utilized. After you forcibly bring up an Ethernet fiber port, the fiber port stays physically up whether or not a transceiver module or fiber connections are present for the port. Copper ports do not support this command. The port up-mode command is mutually exclusive with either of the shutdown and loopback commands.
Examples # Forcibly bring up the fiber port FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] port up-mode
priority-flow-control Use priority-flow-control to enable PFC on an Ethernet interface through automatic negotiation or forcibly. Use undo priority-flow-control to disable PFC on the interface.
Syntax priority-flow-control { auto | enable } undo priority-flow-control
Default PFC is disabled on Ethernet interfaces.
Views Ethernet interface view 28
Predefined user roles network-admin
Parameters auto: Specifies PFC in auto mode. In this mode, the Ethernet interface automatically negotiates the PFC status with its peer. enable: Forcibly enables PFC.
Usage guidelines If you enable PFC and configure the priority-flow-control no-drop dot1p dot1p-list command on both ends, the local port processes a received packet as follows when network congestion occurs: •
If PFC is enabled for the 802.1p priority carried in the packet, the local port perform the following tasks: { {
•
Accepts the packet. Notifies the peer to stop sending packets carrying the 802.1p priority until the congestion is removed.
If PFC is disabled for the 802.1p priority carried in the packet, the local port drops the packet.
Examples # Configure FortyGigE 1/1/1 to automatically negotiate with its peer to enable PFC. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] priority-flow-control auto
Related commands priority-flow-control no-drop dot1p
priority-flow-control no-drop dot1p Use priority-flow-control no-drop dot1p to enable PFC for 802.1p priorities on an Ethernet interface. Use undo priority-flow-control no-drop dot1p to restore the default.
Syntax priority-flow-control no-drop dot1p dot1p-list undo priority-flow-control no-drop dot1p
Default PFC is disabled for all 802.1p priorities.
Views Ethernet interface view
Predefined user roles network-admin
Parameters dot1p-list: Specifies an 802.1p priority (or dot1p priority) list to identify flows that are subject to PFC(for example: 1,3-5). A hyphen (-) connects two numeric values, which together indicate a continuous value
29
range. Different values or value ranges are separated with commas (,). You can configure up to 16 characters for this argument.
Usage guidelines You can enable PFC for certain 802.1p priorities at the two ends of a link. When network congestion occurs, the local device checks the PFC status for the 802.1p priority carried in each arriving packet. The device processes the packet depending on the PFC status as follows: •
If PFC is enabled for the 802.1p priority, the local device accepts the packet and sends a PFC pause frame to the peer. The peer stops sending packets carrying this 802.1p priority for an interval as specified in the PFC pause frame. This process is repeated until the congestion is removed.
•
If PFC is disabled for the 802.1p priority, the local port drops the packet.
The relationship between the PFC function and the generic flow control function is shown in Table 9. Table 9 The relationship between the PFC function and the generic flow control function flow-control
Unconfigurable
priority-flowcontrol enable Configured
priority-flow-cont rol no-drop dot1p
Remarks
Configured
You cannot enable flow control by using the flow-control command on a port where PFC is enabled and PFC is enabled for the specified 802.1p priority values.
• On a port configured with the flow-control command, you can enable PFC, but you cannot enable PFC for specific 802.1p priorities.
Configured
Configurable
Unconfigurable
• Enabling both generic flow control and PFC on a port disables the port from sending common or PFC pause frames to inform the peer of congestion conditions. However, the port can still handle common and PFC pause frames from the peer.
When you configure PFC, follow these guidelines: •
To ensure correct operations of IRF and other protocols, HP recommends not enabling PFC for 802.1p priorities 0, 6, and 7.
•
Perform the same PFC configuration on all ports that traffic travels through.
For more information about the 802.1p priority, priority trust mode, and port priority, see ACL and QoS Configuration Guide.
Examples # Configure FortyGigE 1/1/1 to automatically negotiate with the peer port to enable PFC, and enable PFC for 802.1p priority 5. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] priority-flow-control auto [Sysname-FortyGigE1/1/1] priority-flow-control no-drop dot1p 5
Related commands •
priority-flow-control 30
•
flow-control
•
flow-control receive enable
reset counters interface Use reset counters interface to clear the Ethernet interface statistics.
Syntax reset counters interface [ interface-type [ interface-number | interface-number.subnumber ] ]
Views User view
Predefined user roles network-admin
Parameters interface-type: Specifies an interface type. interface-number: Specifies an interface number. interface-number.subnumber: Specifies a subinterface number, where interface-number is an interface number, and subnumber is the number of a subinterface created under the interface. The value range for the subnumber argument is 1 to 4094.
Usage guidelines Use this command to clear history statistics if you want to collect traffic statistics for a specific time period. If you do not specify an interface type, this command clears statistics for all interfaces. If you specify only the interface type, this command clears statistics for all interfaces of that type. If you specify both the interface type and the interface number, this command clears statistics for the specified interface.
Examples # Clear the statistics of FortyGigE 1/1/1. reset counters interface fortygige 1/1/1
Related commands •
display interface
•
display counters interface
•
display counters rate interface
reset ethernet statistics Use reset ethernet statistics to clear the Ethernet module statistics.
Syntax reset ethernet statistics slot slot-number
Views User view 31
Predefined user roles network-admin network-operator
Parameters slot slot-number: Clears the Ethernet module statistics on the specified IRF member device. The slot-number argument represents the ID of the IRF member device.
Examples # Clear the Ethernet module statistics on IRF member 6. reset ethernet statistics slot 6
reset packet-drop interface Use reset packet-drop interface to clear the dropped packet statistics on an interface or multiple interfaces.
Syntax reset packet-drop interface [ interface-type [ interface-number ] ]
Views User view
Predefined user roles network-admin
Parameters interface-type: Specifies an interface type. If you do not specify an interface type, this command clears dropped packet statistics on all the interfaces on the device. interface-number: Specifies an interface number. If you do not specify this argument, the command clears dropped packet statistics on all interfaces of the specified type.
Examples # Clear dropped packet statistics on FortyGigE 1/1/1. reset packet-drop interface fortygige 1/1/1
# Clear dropped packet statistics on all interfaces. reset packet-drop interface
Related commands display packet-drop
shutdown Use shutdown to shut down an Ethernet interface or subinterface. Use undo shutdown to bring up an Ethernet interface or subinterface.
Syntax shutdown undo shutdown 32
Default Ethernet interfaces and subinterfaces are in up state.
Views Ethernet interface view, Ethernet subinterface view
Predefined user roles network-admin
Usage guidelines You might need to shut down and then bring up an Ethernet interface to make some interface configurations take effect.
Examples # Shut down and then bring up FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] shutdown [Sysname-FortyGigE1/1/1] undo shutdown
speed Use speed to set the speed of an Ethernet interface. Use undo speed to restore the default.
Syntax speed { 10 | 100 | 1000 | 10000 | 40000 | auto } undo speed
Default An Ethernet interface negotiates a speed with its peer.
Views Ethernet interface view
Predefined user roles network-admin
Parameters 10: Sets the interface speed to 10 Mbps. 100: Sets the interface speed to 100 Mbps. 1000: Sets the interface speed to 1000 Mbps. 10000: Sets the interface speed to 10000 Mbps. 40000: Sets the interface speed to 40000 Mbps. auto: Enables the interface to negotiate a speed with its peer.
Usage guidelines A 10-GE SFP+ interface supports only keywords 1000, 10000, and auto. 33
A 10-GE copper port supports only keywords 100, 1000, 10000, and auto. A 40-GE QSFP+ interface supports only keywords 40000 and auto. For an Ethernet copper port, use the speed command to set its speed to match the speed of the peer interface. For a fiber port, use the speed command to set its speed to match the rate of a transceiver module.
Examples # Configure FortyGigE 1/1/1 to autonegotiate the speed. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] speed auto
Related commands speed auto
using fortygige Use using fortygige to combine four 10-GE breakout interfaces that are split from a 40-GE interface into a 40-GE interface. Use undo using fortygige to cancel the configuration.
Syntax using fortygige undo using fortygige
Default A 40-GE interface is not split and operates as a single interface.
Views 10-GE breakout interface view
Predefined user roles network-admin
Usage guidelines If you need higher bandwidth, you can combine four 10-GE breakout interfaces that are split from a 40-GE interface into a 40-GE interface. To make this command take effect on the four 10-GE breakout interfaces, execute this command on only one of the 10-GE breakout interfaces. After this command is successfully configured, the system deletes the four 10-GE breakout interfaces and creates the combined 40-GE interface. You can view the 40-GE interface by using the display interface brief command.
Examples # Combine 10-GE breakout interfaces Ten-GigabitEthernet 1/1/1:1 through Ten-GigabitEthernet 1/1/1:4 into a 40-GE interface. system-view [System] interface ten-gigabitethernet1/1/1:1 [System-Ten-GigabitEthernet1/1/1:1] using fortygige
34
The interfaces Ten-GigabitEthernet1/1/1:1 through Ten-GigabitEthernet1/1/1:4 will be deleted. Continue? [Y/N]:y
Related commands using tengige
using tengige Use using tengige to split a high-bandwidth interface into multiple 10-GE breakout interfaces. Use undo using tengige to cancel the configuration.
Syntax using tengige undo using tengige
Default A high-bandwidth interface is not split and operates as a single interface.
Views 40-GE interface view
Predefined user roles network-admin
Usage guidelines To improve the port density, reduce the cost, and improve the network flexibility, you can split a high-bandwidth interface into multiple 10-GE breakout interfaces. The 10-GE breakout interfaces support the same configuration and attributes as common 10-GE interfaces, except that they are numbered in a different way. After this command is successfully configured, the system deletes the 40-GE interface and creates four 10-GE breakout interfaces. You can view the four 10-GE breakout interfaces by using the display interface brief command.
Examples # Split 40-GE interface FortyGigE 1/1/1 into four 10-GE breakout interfaces. system-view [System] interface fortygige 1/1/1 [System-FortyGigE1/1/1] using tengige The interface FortyGigE1/1/1 will be deleted. Continue? [Y/N]:y [System-FortyGigE1/1/1] [System]
Related commands using fortygige
35
Layer 2 Ethernet interface commands broadcast-suppression Use broadcast-suppression to enable broadcast suppression and set the broadcast suppression threshold. Use undo broadcast-suppression to restore the default.
Syntax broadcast-suppression { ratio | pps max-pps | kbps max-kbps } undo broadcast-suppression
Default Ethernet interfaces do not suppress broadcast traffic.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters ratio: Sets the broadcast suppression threshold as a percentage of the maximum interface rate. The value range for this argument is 0 to 100. The smaller the percentage, the less broadcast traffic is allowed to pass through. pps max-pps: Specifies the maximum number of broadcast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the maximum interface rate. For example, the value range for this argument is 0 to 59524000 on a 40-GE interface. kbps max-kbps: Specifies the maximum number of kilobits of broadcast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the maximum interface rate.
Usage guidelines You can use the broadcast storm suppression function to limit the size of broadcast traffic on an interface. When the broadcast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold. Both storm-constrain and broadcast-suppression can suppress broadcast storm on a port. The storm-constrain command uses software to suppress broadcast traffic, and it affects the device performance to a certain extent. The broadcast-suppression command uses the chip to physically suppress broadcast traffic, and it has less influence on the device performance than the storm-constrain command. Do not configure the storm constrain command and the broadcast-suppression command at the same time. Otherwise, the traffic suppression result is not determined. When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows: •
If the configured value is smaller than 64, the value of 64 takes effect.
•
If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.
To determine the suppression threshold that takes effect, see the prompts on the device. 36
Examples # Set the broadcast suppression threshold to 10000 kbps on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] broadcast-suppression kbps 10000
Related commands •
multicast-suppression
•
unicast-suppression
display storm-constrain Use display storm-constrain to display storm control settings and statistics.
Syntax display storm-constrain [ broadcast | multicast | unicast ] [ interface interface-type interface-number ]
Views Any view
Predefined user roles network-admin network-operator
Parameters broadcast: Displays broadcast storm control settings and statistics. multicast: Displays multicast storm control settings and statistics. unicast: Displays unknown unicast storm control settings and statistics. interface interface-type interface-number: Specifies an interface by its type and number.
Usage guidelines If you do not specify any keywords, this command displays all storm control settings on all storm control-enabled interfaces.
Examples # Display the storm control settings on all storm control-enabled ports. display storm-constrain Abbreviation: BC - broadcast; MC - multicast; UC – unicast FW - forwarding Flow Statistic Interval: 5 (in seconds) Port
Type
Lower
Upper
Unit
CtrlMode
Status
Trap
Log
SwitchNum
------------------------------------------------------------------------------------FGE1/1/1
BC
12345
3456
pps
block
FW
on
off
0
FGE1/1/2
MC
43
100
ratio
block
block
on
off
1
FGE1/1/3
MC
100
200
kbps
shutdown
shutdown
off
on
10
FGE1/1/4
UC
200
300
kbps
shutdown
normal
off
on
33
37
Table 10 Command output Field
Description
Flow Statistic Interval
Traffic polling interval (in seconds) of the storm control module.
Port
Abbreviated port name. Type of traffic subjected to storm control:
Type
• BC—Broadcast packets. • MC—Multicast packets. • UC—Unknown unicast packets.
Lower
Lower storm control threshold, in pps, kbps, or percentage.
Upper
Upper storm control threshold, in pps, kbps, or percentage. Storm control threshold unit:
Unit
CtrlMode
• pps. • kbps. • percentage. Protective action (block or shutdown) taken on the port when the upper threshold is reached. N/A indicates that no protective action is configured. Packet forwarding status:
Status
• FW—The port is forwarding traffic correctly. • shutdown—The port has been shut down. • block—The port drops the type of traffic. Status of the storm control threshold event trap switch:
Trap
• on—The port sends threshold event traps. • off—The port does not send threshold event traps. Status of the storm control threshold event log switch:
Log
SwitchNum
• on—The port sends threshold event log messages. • off—The port does not send threshold event log messages. Number of forwarding state changes of the interface. When the SwitchNum count reaches 65535, it resets automatically.
multicast-suppression Use multicast-suppression to enable multicast storm suppression and set the multicast storm suppression threshold. Use undo multicast-suppression to restore the default.
Syntax multicast-suppression { ratio | pps max-pps | kbps max-kbps } undo multicast-suppression
Default Ethernet interfaces do not suppress multicast traffic.
38
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters ratio: Sets the multicast suppression threshold as a percentage of the maximum interface rate. The value range for this argument (in percentage) is 0 to 100. The smaller the percentage, the less multicast traffic is allowed to pass through. pps max-pps: Specifies the maximum number of multicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the maximum interface rate. For example, the value range for this argument is 0 to 59524000 on a 40-GE interface. kbps max-kbps: Specifies the maximum number of kilobits of multicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the maximum interface rate.
Usage guidelines You can use the multicast storm suppression function to limit the size of multicast traffic on an interface. When the multicast traffic on the interface exceeds this threshold, the system drops packets until the traffic drops below this threshold. Both the storm-constrain and multicast-suppression can suppress multicast storm on a port. The storm-constrain command uses software to suppress traffic, and it affects the device performance to a certain extent. The multicast-suppression command uses the chip to physically suppress multicast traffic, and it has less influence on the device performance than the storm-constrain command. Do not configure the storm constrain command and the multicast-suppression command at the same time. Otherwise, the traffic suppression result is not determined. When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows: •
If the configured value is smaller than 64, the value of 64 takes effect.
•
If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.
To determine the suppression threshold that takes effect, see the prompts on the device.
Examples # Set the multicast storm suppression threshold to 10000 kbps on FortyGigE 1/1/1. [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] multicast-suppression kbps 10000 The actual value is 10048 on port FortyGigE1/1/1 currently.
Related commands •
broadcast-suppression
•
unicast-suppression
port bridge enable Use port bridge enable to enable bridging on a Layer 2 Ethernet interface. Use undo port bridge enable to disable bridging on a Layer 2 Ethernet interface. 39
Syntax port bridge enable undo port bridge enable
Default Bridging is disabled on Layer 2 Ethernet interfaces.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Usage guidelines When a packet arrives at an interface, the device looks up the destination MAC address of the packet in the MAC address table. If an entry is found and the outgoing interface is the same as the incoming interface, the device drops the packet. After you configure this command on the Ethernet interface, the device forwards such packets rather than drop them.
Examples # Enable bridging on Layer 2 Ethernet interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige1/1/1 [Sysname-FortyGigE1/1/1] port bridge enable
storm-constrain Use storm-constrain to enable broadcast, multicast, or unknown unicast storm control on an Ethernet port. Use undo storm-constrain to disable storm control.
Syntax storm-constrain { broadcast | multicast | unicast } { pps | kbps | ratio } upperlimit lowerlimit undo storm-constrain { all | broadcast | multicast | unicast }
Default Traffic storm control is disabled.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters all: Disables storm control for all types of packets: broadcast, multicast, and unknown unicast. broadcast: Enables or disables broadcast storm control. multicast: Enables or disables multicast storm control. 40
unicast: Enables or disables unknown unicast storm control. pps: Sets storm control thresholds in pps. kbps: Sets storm control thresholds in kbps. ratio: Sets storm control thresholds as a percentage of the transmission capacity of the interface. upperlimit: Sets the upper threshold, in pps, kbps, or percentage. lowerlimit: Sets the lower threshold, in pps, kbps, or percentage.
Usage guidelines After you configure this command, the device collects the statistics of a particular type of traffic at the specified interval, which can be configured by using the storm-constrain interval command. When a particular type of traffic exceeds its upper threshold, the interface takes a certain action, which can be configured by using the storm-constrain control command. The storm-constrain, broadcast-suppression, commands can suppress storm on a port.
multicast-suppression,
and
unicast-suppression
•
The storm-constrain command uses software to suppress traffic, and affects the device performance to a certain extent.
•
The broadcast-suppression, multicast-suppression, and unicast-suppression commands use the chip to physically suppress traffic, and have less influence on the device performance than the storm-constrain command.
On the same type of traffic, do not configure the storm constrain command and either of the broadcast-suppression, multicast-suppression, and unicast-suppression commands at the same time. Otherwise, the traffic suppression result is not determined. When configuring this command, make sure upperlimit is greater than lowerlimit.
Examples # Enable unknown unicast storm control on FortyGigE 1/1/1, setting the upper and lower thresholds to 200 pps and 150 pps. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] storm-constrain unicast pps 200 150
# Enable broadcast storm control on FortyGigE 1/1/2, setting the upper and lower thresholds to 2000 kbps and 1500 kbps. system-view [Sysname] interface fortygige 1/1/2 [Sysname-FortyGigE1/1/2] storm-constrain broadcast kbps 2000 1500
# Enable multicast storm control on FortyGigE 1/1/3, setting the upper and lower thresholds to 80% and 15%. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] storm-constrain multicast ratio 80 15
Related commands •
storm-constrain control
•
storm-constrain interval
41
storm-constrain control Use storm-constrain control to set the protective action to take on an Ethernet interface when a type of traffic (unknown unicast, multicast, or broadcast) exceeds the upper storm control threshold. Use undo storm-constrain control to restore the default.
Syntax storm-constrain control { block | shutdown } undo storm-constrain control
Default No action is taken on an Ethernet interface when a type of traffic exceeds the upper storm control threshold.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters block: Blocks this type of traffic, while forwarding other types of traffic. Even though the interface does not forward the blocked traffic, it still counts the traffic. When the blocked traffic is detected dropping below the lower threshold, the port begins to forward the traffic. shutdown: Shuts down automatically. The interface shuts down automatically and stops forwarding any traffic. When the blocked traffic is detected dropping below the lower threshold, the port does not forward the traffic. To bring up the interface, use the undo shutdown command or disable the storm control function.
Examples # Configure FortyGigE 1/1/1 to block the traffic detected crossing the upper storm control threshold. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] storm-constrain control block
Related commands •
storm-constrain
•
storm-constrain control
storm-constrain enable log Use storm-constrain enable log to enable an Ethernet interface to log storm control threshold events. Use undo storm-constrain enable log to disable log sending.
Syntax storm-constrain enable log undo storm-constrain enable log
42
Default An interface generates logs when monitored traffic exceeds the upper threshold or falls below the lower threshold.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Examples # Enable FortyGigE 1/1/1 to generate logs when it detects storm control threshold events. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] storm-constrain enable log
storm-constrain enable trap Use storm-constrain enable trap to enable an Ethernet interface to send storm control threshold event traps. Use undo storm-constrain enable trap to disable trap sending.
Syntax storm-constrain enable trap undo storm-constrain enable trap
Default An interface sends out traps when monitored traffic exceeds the upper threshold or falls below the lower threshold.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Examples # Enable FortyGigE 1/1/1 to send traps when it detects storm control threshold events. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] storm-constrain enable trap
storm-constrain interval Use storm-constrain interval to set the traffic polling interval of the storm control module. Use undo storm-constrain interval to restore the default.
Syntax storm-constrain interval seconds 43
undo storm-constrain interval
Default The storm control module polls traffic statistics every 10 seconds.
Views System view
Predefined user roles network-admin
Parameters seconds: Sets the traffic polling interval of the storm control module. The value range is 1 to 300 seconds.
Usage guidelines The interval set by the storm-constrain interval command is specific to storm control. To set the statistics polling interval of an interface, use the flow-interval command. For network stability, use the default or a higher polling interval.
Examples # Set the traffic statistics polling interval of the storm control module to 60 seconds. system-view [Sysname] storm-constrain interval 60
Related commands •
storm-constrain
•
storm-constrain control
unicast-suppression Use unicast-suppression to enable unicast storm suppression and set the unicast storm suppression threshold. Use undo unicast-suppression to restore the default.
Syntax unicast-suppression { ratio | pps max-pps | kbps max-kbps } undo unicast-suppression
Default Ethernet interfaces do not suppress unicast traffic.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters ratio: Sets the unicast suppression threshold as a percentage of the maximum interface rate. The value range for this argument (in percentage) is 0 to 100. The smaller the percentage, the less unicast traffic is allowed to pass through. 44
pps max-pps: Specifies the maximum number of unicast packets that the interface can forward per second. The value range for the max-pps argument (in pps) is 0 to 1.4881 × the maximum interface rate. For example, the value range for the argument is 0 to 59524000 on a 40-GE interface. kbps max-kbps: Specifies the maximum number of kilobits of unicast traffic that the Ethernet interface can forward per second. The value range for this argument (in kbps) is 0 to the maximum interface rate.
Usage guidelines You can use the unicast storm suppression function to limit the size of unicast traffic on an interface. When the unicast traffic on the interface exceeds this threshold, the system discards packets until the unicast traffic drops below this threshold. Both the storm-constrain and unicast-suppression can suppress unicast storm on a port. •
The storm-constrain command uses software to suppress unicast traffic, and it affects the device performance to a certain extent.
•
The unicast-suppression command use the chip to physically suppress unicast traffic, and it has less influence on the device performance than the storm-constrain command.
Do not configure the storm constrain command and the unicast-suppression command at the same time. Otherwise, the unicast traffic suppression result is not determined. When you configure the suppression threshold in kbps, the actual suppression threshold might be different from the configured one as follows: •
If the configured value is smaller than 64, the value of 64 takes effect.
•
If the configured value is greater than 64 but not an integer multiple of 64, the integer multiple of 64 that is greater than and closest to the configured value takes effect.
To determine the suppression threshold that takes effect, see the prompts on the device.
Examples # Set the unicast storm suppression threshold to 10000 kbps on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] unicast-suppression kbps 10000 The actual value is 10048 on port FortyGigE1/1/1 currently.
Related commands •
broadcast-suppression
•
multicast-suppression
Layer 3 Ethernet interface and subinterface commands mtu Use mtu to set the MTU for an Ethernet interface or subinterface. Use undo mtu to restore the default.
Syntax mtu size 45
undo mtu
Default The MTU of an Ethernet interface or subinterface is 1500 bytes.
Views Layer 3 Ethernet interface view, Layer 3 Ethernet subinterface view
Predefined user roles network-admin
Parameters size: Sets the maximum transmission unit (MTU) in bytes, in the range of 128 to 1560.
Usage guidelines The MTU configured on an interface takes effect only on packets sent to the CPU for software forwarding (for example, packets sourced from or destined for the interface). Configure the MTU as appropriate for interfaces in the network to avoid fragmentation. As the MTU size decreases, the number of fragments grows. When you set the MTU for an interface, consider QoS queue lengths to prevent a too small MTU from causing packet drops in QoS queuing. For example, consider that the default FIFO queue length is 75.
Examples # Set the MTU to 1430 bytes for Layer 3 Ethernet interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mtu 1430
46
Loopback, null, and inloopback interface commands bandwidth Use bandwidth to configure the expected bandwidth of an interface. Use undo bandwidth to restore the default.
Syntax bandwidth bandwidth-value undo bandwidth
Default The expected bandwidth of a loopback interface is 0 kbps.
Views Loopback interface view
Predefined user roles network-admin
Parameters bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines The expected bandwidth of an interface affects the following items: •
Bandwidth assignment with CBQ. For more information, see ACL and QoS Configuration Guide.
•
Link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.
Examples # Set the expected bandwidth of Loopback 1 to 1000 kbps. system-view [Sysname] interface loopback 1 [Sysname-LoopBack1] bandwidth 1000
default Use default to restore the default settings for a loopback or null interface.
Syntax default
Views Loopback interface view, null interface view 47
Predefined user roles network-admin
Usage guidelines CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command before using it on a live network. This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples # Restore the default settings for interface loopback 1. system-view [Sysname] interface loopback 1 [Sysname-LoopBack1] default
description Use description to set a description for an interface. Use undo description to restore the default.
Syntax description text undo description
Default The description of a loopback or null interface is the interface name plus Interface (for example, LoopBack1 Interface).
Views Loopback interface view, null interface view
Predefined user roles network-admin
Parameters text: Specifies an interface description, a case-sensitive string of 1 to 255 characters.
Usage guidelines Configure a description for an interface for easy identification and management purposes. You can use the display interface command to view the configured description.
Examples # Set the description to for RouterID for interface loopback 1. system-view [Sysname] interface loopback 1 [Sysname-LoopBack1] description for RouterID
48
display interface inloopback Use display interface inloopback to display information about the inloopback interface.
Syntax display interface [ inloopback [ 0 ] ] [ brief [ description ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters 0: Specifies interface Inloopback 0. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information. description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions. The description of an inloopback interface is always InLoopBack0 Interface and cannot be configured.
Usage guidelines If the inloopback keyword is not specified, the command displays information about all interfaces of the device. If the inloopback keyword is specified but the 0 keyword is not specified, the command displays information about interface Inloopback 0. This is because the device has only one inloopback interface Inloopback 0.
Examples # Display detailed information about interface Inloopback 0. display interface inloopback 0 InLoopBack0 Current state: UP Line protocol state: UP (spoofing) Description: InLoopBack0 Interface Bandwidth: 0kbps Maximum Transmit Unit: 1536 Physical: InLoopBack Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Input: 0 packets, 0 bytes, 0 drops Output: 0 packets, 0 bytes, 0 drops
Table 11 Command output Field
Description
Current state
Physical layer state of the interface, which is always UP, meaning that the inloopback interface can receive and transmit packets.
49
Field
Description
Line protocol state
Data link layer protocol state of the interface, which is always UP (spoofing). UP (spoofing) means that the data link layer protocol state of the interface is up, but the link is an on-demand link or is not present.
Description
Description string of the interface, which is always InLoopBack0 Interface and cannot be configured.
Bandwidth
Expected bandwidth of the interface.
Maximum Transmit Unit
MTU of the interface, which is always 1536 and cannot be configured
Physical: InLoopBack
The physical type of the interface is inloopback. Average input rate during the last 300 seconds:
• bytes/sec—Average number of bytes received per second. • bits/sec—Average number of bits received per second. • packets/sec—Average number of packets received per second.
Last 300 seconds input: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Average output rate over the last 300 seconds:
• bytes/sec—Average number of bytes sent per second. • bits/sec—Average number of bits sent per second. • packets/sec—Average number of packets sent per second.
Last 300 seconds output: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops
Total number and size (in bytes) of incoming packets of the interface and the number of dropped packets.
Output: 0 packets, 0 bytes, 0 drops
Total number and size (in bytes) of outgoing packets of the interface and the number of dropped packets.
# Display brief information about interface Inloopback 0. display interface inloopback 0 brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
InLoop0
UP
UP(s)
Description
--
# Display brief information about interface Inloopback 0, including the complete description of the inloopback interface. display interface inloopback 0 brief description Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
InLoop0
UP
UP(s)
Description
--
Table 12 Command output Field
Description
Brief information on interface(s) under route mode:
Brief information about the inloopback interface.
50
Field
Description Explains the Link field values:
Link: ADM - administratively down; Stby - standby
• ADM—The interface has been shut down by the network
administrator. To recover its physical layer state, run the undo shutdown command.
• Stby—The interface is a standby interface. Explains the Protocol field value. Protocol: (s) - spoofing
(s)—Represents spoofing. If the data link layer protocol of an interface is up, but the link is an on-demand link or is not present, the Protocol field displays UP(s). This attribute is typical of interface Null 0, Inloopback 0, and loopback interfaces.
Interface
Interface name.
Link
Physical layer state of the interface, which is always UP, meaning that the link is physically up.
Protocol
Data link layer protocol state of the interface, which is always UP(s). IP address of the interface.
Main IP
Because inloopback interfaces do not support CLI configuration, this field does not display a value. Interface description configured by using the description command.
Description
Because inloopback interfaces do not support CLI configuration, this field does not display a value.
display interface loopback Use display interface loopback to display information about the specified or all existing loopback interfaces.
Syntax display interface [ loopback ] [ brief [ down ] ] display interface [ loopback [ interface-number ] ] [ brief [ description ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-number: Specifies a loopback interface by its number, which can be the number of any existing loopback interface. If you do not specify this argument, the command displays information about all existing loopback interfaces on the device. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information.
51
down: Displays information about interfaces in down state and the causes. If you do not specify this keyword, the command displays information about interfaces in all states. description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions.
Usage guidelines This command is supported only after a loopback interface is created. If the loopback keyword is not specified, the command displays information about all interfaces of the device. If the loopback keyword is specified but the interface-number argument is not specified, the command displays information about all existing loopback interfaces.
Examples # Display detailed information about interface loopback 0. display interface loopback 0 LoopBack0 Current state: UP Line protocol state: UP (spoofing) Description: LoopBack0 Interface Bandwidth: 0kbps Maximum Transmit Unit: 1536 Internet protocol processing: disabled Physical: Loopback Last clearing of counters: Last 300 seconds input: Last 300 seconds output:
Never
0 bytes/sec, 0 bits/sec, 0 packets/sec 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops Output: 0 packets, 0 bytes, 0 drops
Table 13 Command output Field
Description Physical layer state of the loopback interface:
Current state
• UP—The loopback interface can receive and transmit packets. • Administratively DOWN—The interface was manually shut down by using the shutdown command.
Line protocol state
Data link layer protocol state of the interface. UP (spoofing) means that the data link layer protocol state of the interface is up, but the link is an on-demand link or is not present.
Description
Description string of the interface.
Bandwidth
Expected bandwidth of the interface.
Maximum Transmit Unit
MTU of the interface.
Internet protocol processing: disabled
Indicates that the interface cannot process Layer 3 packets (displayed when the interface is not configured with an IP address).
Internet Address is 1.1.1.1/32 Primary
Primary IP address of the interface (displayed when the interface is configured with a primary IP address).
Physical: Loopback
The physical type of the interface is loopback. 52
Field
Description Time when statistics on the logical interface were last cleared by using the reset counters interface command.
Last clearing of counters
If the statistics of the interface have never been cleared by using the reset counters interface command since the device started, this field displays Never. Average input rate during the last 300 seconds:
• bytes/sec—Average number of bytes received per second. • bits/sec—Average number of bits received per second. • packets/sec—Average number of packets received per second.
Last 300 seconds input: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Average output rate over the last 300 seconds:
• bytes/sec—Average number of bytes sent per second. • bits/sec—Average number of bits sent per second. • packets/sec—Average number of packets sent per second.
Last 300 seconds output: 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops
Total number and size (in bytes) of incoming packets of the interface and the number of dropped packets.
Output: 0 packets, 0 bytes, 0 drops
Total number and size (in bytes) of outgoing packets of the interface and the number of dropped packets.
# Display brief information about all loopback interfaces. display interface loopback brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
Description
Loop1
UP
aaaaaaaaaaaaaaaaaaaaaaaaaaa
UP(s)
--
# Display brief information about all existing loopback interfaces, including the complete description of each loopback interface. display interface loopback brief description Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
Description
Loop1
UP
aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
UP(s)
--
Aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
# Display information about all loopback interfaces in down state and the causes. display interface loopback brief down Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Interface
Link Cause
Loop1
ADM
Administratively
Table 14 Command output Field
Description
Brief information on interface(s) under route mode:
Brief information about loopback interfaces. 53
Field
Description Explains the Link field values:
Link: ADM - administratively down; Stby - standby
• ADM—The interface has been shut down by the network
administrator. To recover its physical layer state, run the undo shutdown command.
• Stby—The interface is a standby interface. Explains the Protocol field value. Protocol: (s) - spoofing
Interface
(s)—Represents spoofing. If the data link layer protocol of an interface is is up, but the link is an on-demand link or is not present, the Protocol field displays UP(s). This attribute is typical of interface Null 0, Inloopback 0, and loopback interfaces. Interface name. Physical layer state of the interface:
• UP—The interface is up. • DOWN—The interface is physically down. • ADM—The interface has been administratively shut down. To recover
Link
its physical state, run the undo shutdown command.
• Stby—The interface is a standby interface. Protocol
Data link layer protocol state of the interface.
Description
Interface description configured by using the description command. If the description keyword is not specified in the display interface brief command, the Description field allows a maximum of 27 characters. If the description keyword is specified in the display interface brief command, the field displays the complete interface description.
Cause
Cause of the interface down event. If the interface has been shut down by using the shutdown command, this field displays Administratively. To restore the physical state of the interface, execute the undo shutdown command.
Related commands •
interface loopback
•
reset counters interface loopback
display interface null Use display interface null to display information about the null interface.
Syntax display interface [ null [ 0 ] ] [ brief [ description ] ]
Views Any view
Predefined user roles network-admin 54
network-operator
Parameters 0: Specifies interface Null 0. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information. description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of interface descriptions.
Usage guidelines If the null keyword is not specified, the command displays information about all interfaces of the device. If the null keyword is specified but the 0 keyword is not specified, the command displays information about interface Null 0. This is because the device has only one null interface Null 0.
Examples # Display detailed information about interface Null 0. display interface null 0 NULL0 Current state: UP Line protocol state: UP (spoofing) Description: NULL0 Interface Bandwidth: 0kbps Maximum Transmit Unit: 1500 Internet protocol processing: disabled Physical: NULL DEV Last clearing of counters: Never Last 300 seconds input: Last 300 seconds output:
0 bytes/sec, 0 bits/sec, 0 packets/sec 0 bytes/sec, 0 bits/sec, 0 packets/sec
Input: 0 packets, 0 bytes, 0 drops Output: 0 packets, 0 bytes, 0 drops
# Display brief information about interface Null 0. display interface null 0 brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
Description
NULL0
UP
aaaaaaaaaaaaaaaaaaaaaaaaaaa
UP(s)
--
# Display brief information about interface Null 0, including the complete description of the null interface. display interface null 0 brief description Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
Description
NULL0
UP
aaaaaaaaaaaaaaaaaaaaaaaaaaaaa
UP(s)
--
aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
For the command output, see Table 13 and Table 14. 55
Related commands •
interface null
•
reset counters interface null
interface loopback Use interface loopback to create a loopback interface and enter loopback interface view. Use undo interface loopback to remove a loopback interface.
Syntax interface loopback interface-number undo interface loopback interface-number
Default No loopback interface exists.
Views System view
Predefined user roles network-admin
Parameters interface-number: Specifies a loopback interface by its number in the range of 0 to 127.
Usage guidelines The physical layer state and link layer protocols of a loopback interface are always up unless the loopback interface is manually shut down. You can use a loopback interface to achieve the following purposes: •
Prevent the connection from being affected by the physical state of the interface.
•
Improve the reliability of the connection.
For example, you can: •
Configure a loopback interface as the source interface for establishing an FTP connection.
•
Use the loopback interface address as the Router ID in BGP.
Examples # Create interface loopback 1. system-view [Sysname] interface loopback 1 [Sysname-LoopBack1]
interface null Use interface null to enter null interface view.
Syntax interface null 0
56
Default A device has only one null interface (Null 0), which cannot be created or deleted.
Views System view
Predefined user roles network-admin
Parameters 0: Specifies interface Null 0. The null interface number is always 0.
Examples # Enter Null 0 interface view. system-view [Sysname] interface null 0 [Sysname-NULL0]
reset counters interface loopback Use reset counters interface loopback to clear the statistics on the specified or all loopback interfaces.
Syntax reset counters interface loopback [ interface-number ]
Views User view
Predefined user roles network-admin
Parameters interface-number: Specifies a loopback interface by its number, which can be the number of any existing loopback interface. If you do not specify the interface-number argument, the command clears the statistics on all loopback interfaces.
Usage guidelines To determine whether a loopback interface works correctly within a period by collecting the traffic statistics within that period, first use the reset counters interface [ loopback [ interface-number ] ] command to clear the statistics. Then have the interface automatically collect the statistics. This command is available only if at least one loopback interface has been created.
Examples # Clear the statistics on loopback interface Loopback 1. reset counters interface loopback 1
Related commands display interface loopback
57
reset counters interface null Use reset counters interface null to clear the statistics on the null interface.
Syntax reset counters interface [ null [ 0 ] ]
Views User view
Predefined user roles network-admin
Parameters 0: Specifies the number of the null interface, which is always 0.
Usage guidelines To determine whether the null interface works correctly within a period by collecting the traffic statistics within that period, first use the reset counters interface [ null [ 0 ] ] command to clear the statistics. Then have the interface automatically collect the statistics.
Examples # Clear the statistics on interface Null 0. reset counters interface null 0
Related commands display interface null
shutdown Use shutdown to shut down a loopback interface. Use undo shutdown to bring up a loopback interface.
Syntax shutdown undo shutdown
Default A loopback interface is up.
Views Loopback interface view
Predefined user roles network-admin
Usage guidelines Use the shutdown command with caution, because the command disconnects the connection of the interface and disables the interface from communicating.
58
Examples # Shut down interface loopback 1. system-view [Sysname] interface loopback 1 [Sysname-LoopBack1] shutdown
59
Bulk interface configuration commands display interface range Use display interface range to display information about the interface ranges created by using the interface range name command.
Syntax display interface range [ name name ]
Views Any view
Predefined user roles network-admin network-operator
Parameters name name: Specifies an interface range by its name, a case-sensitive string of 1 to 32 characters. If you do not specify an interface range name, the command displays information about the interface ranges created by using the interface range name command.
Examples # Display information about all existing interface ranges created by using the interface range name command. display interface range Interface range name t2 FortyGigE1/1/1 FortyGigE1/1/2 Interface range name test FortyGigE1/1/3 FortyGigE1/1/4
The output shows the following information: •
Interfaces FortyGigE 1/1/1 and FortyGigE 1/1/2 are added to interface range named t2.
•
Interfaces FortyGigE 1/1/3 and FortyGigE 1/1/4 are added to interface range named test.
Related commands interface range name
interface range Use interface range to create an interface range and enter the interface range view.
Syntax interface range interface-list
Views System view
Predefined user roles network-admin 60
Parameters interface-list: Specifies a space-separated list of up to 24 interface items. Each item specifies an interface by its type and number or a range of interfaces in the form of interface-type interface-number to interface-type interface-number. When you specify the to keyword in interface-type interface-number1 to interface-type interface-number2, the last-tier value of the interface number before to must not be greater than the one after to. The values of the other tiers of the interface number before to must be the same as the one after to.
Usage guidelines Use the command to enter interface range view to bulk configure multiple interfaces with the same feature instead of configuring them one by one. For example, run the shutdown command in interface range view to shut down a range of interfaces. In interface range view, only the commands supported by the first interface are available. The first interface is specified with the interface range command. To view these commands in the interface range, enter the interface range view, and then enter ? at the prompt. After a command is executed in interface range view, one of the following situations might occur: •
The system stays in interface range view and does not display an error message. It means that the execution succeeded on all member interfaces in the interface range.
•
The system displays an error message and stays in interface range view. It means that the execution failed on member interfaces in the interface range. {
{
•
If the execution failed on the first member interface in the interface range, the command is not executed on any member interfaces. If the execution failed on non-first member interfaces, the command takes effect on the other member interfaces.
The system returns to system view. It means that: { {
{
The command is supported in both system view and interface view. The execution failed on a member interface in interface range view and succeeded in system view. The command is not executed on the subsequent member interfaces.
You can use the display this command to verify the configuration in interface view of each member interface. In addition, if the configuration in system view is not needed, use the undo form of the command to remove the configuration. To verify the configuration of the first interface in the interface range, execute the display this command in interface range view. To bulk configure interfaces, follow these guidelines: •
You cannot enter the view of some interfaces by using the interface interface-type interface-number command. Do not configure any of these interfaces as the first interface in the interface range.
•
Do not assign both an aggregate interface and any of its member interfaces to an interface range. Some commands, after being executed on both an aggregate interface and its member interfaces, can break up the aggregation.
•
No limit is set on the maximum number of interfaces in an interface range. The more interfaces in an interface range, the longer the command execution time.
Examples # Shut down interfaces FortyGigE 1/1/1 through FortyGigE 1/1/4 and VLAN-interface 2. system-view
61
[Sysname] interface range fortygige 1/1/1 to fortygige 1/1/4 vlan-interafce 2 [Sysname-if-range] shutdown
interface range name Use interface range name name interface interface-list to create an interface range, configure a name for the interface range, and enter the interface range view. Use interface range name name without the interface keyword to enter the view of an interface range with the specified name. Use undo interface range name to delete the interface range with the specified name.
Syntax interface range name name [ interface interface-list ] undo interface range name name
Views System view
Predefined user roles network-admin
Parameters name: Specifies an interface range name, a case-sensitive string of 1 to 32 characters. interface-list: Specifies a space-separated list of up to 24 interface items. Each item specifies an interface by its type and number or a range of interfaces in the form of interface-type interface-number to interface-type interface-number. When you specify the to keyword in interface-type interface-number1 to interface-type interface-number2, the last-tier value of the interface number before to must not be greater than the one after to. The values of the other tiers of the interface number before to must be the same as the one after to.
Usage guidelines You can use the command to assign a name to an interface range and can specify this name rather than the interface range to enter the interface range view. In interface range view, only the commands supported by the first interface are available. The first interface is specified with the interface range command. To view the commands supported by the first interface in the interface range, enter the interface range view and enter a question mark (?) at the command line interface prompt. After a command is executed in interface range view, one of the following situations might occur: •
The system stays in interface range view and does not display an error message. It means that the execution succeeded on all member interfaces in the interface range.
•
The system displays an error message and stays in interface range view. It means that the execution failed on member interfaces in the interface range. {
{
•
If the execution failed on the first member interface in the interface range, the command is not executed on any member interfaces. If the execution failed on non-first member interfaces, the command takes effect on the other member interfaces.
The system returns to system view. It means that: 62
{ {
{
The command is supported in both system view and interface view. The execution failed on a member interface in interface range view and succeeded in system view. The command is not executed on the subsequent member interfaces.
You can use the display this command to verify the configuration in interface view of each member interface. In addition, if the configuration in system view is not needed, use the undo form of the command to remove the configuration. To verify the configuration of the first interface in the interface range, execute the display this command in interface range view. To view the member interfaces of an interface range, use the display interface range command. When you bulk configure interfaces, follow these guidelines: •
You cannot enter the view of some interfaces by using the interface interface-type interface-number command. Do not configure any of these interfaces as the first interface in the interface range.
•
Do not assign both an aggregate interface and any of its member interfaces to an interface range. Some commands, after being executed on both an aggregate interface and its member interfaces, can break up the aggregation.
•
No limit is set on the maximum number of interfaces in an interface range. The more interfaces in an interface range, the longer the command execution time.
•
The maximum number of interface range names is limited only by the system resources. To guarantee bulk interface configuration performance, HP recommends configuring fewer than 1000 interface range names.
Examples # Add FortyGigE 1/1/1 through FortyGigE 1/1/4 to interface range named myEthPort, and enter the interface range view. system-view [Sysname] interface range name myEthPort interface fortygige 1/1/1 to fortygige 1/1/4 [Sysname-if-range-myEthPort]
# Enter the view of interface range named myEthPort. system-view [Sysname] interface range name myEthPort [Sysname-if-range-myEthPort]
Related commands display interface range
63
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 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 ] ]
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.
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 at least one Selected member port. 64
Examples # Display MAC address entries for VLAN 100. display mac-address vlan 100 MAC Address
VLAN ID
State
Port/NickName
0001-0101-0101
100
Multiport
FGE1/1/1
Aging N
FGE1/1/2 0033-0033-0033
100
Blackhole
N/A
N
0000-0000-0002
100
Static
FGE1/1/3
N
00e0-fc00-5829
100
Learned
FGE1/1/4
Y
# Display the number of MAC address entries. display mac-address count 1 mac address(es) found.
Table 15 Command output Field
Description
VLAN ID
ID of the VLAN to which the outgoing interface of the MAC address entry belongs. MAC address entry state:
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.
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 Nickname 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. Whether the entry can age out:
Aging
• Y—The entry can age out. • N—The entry never ages out.
n mac address(es) found
Number of matching MAC address entries.
Related commands •
mac-address
•
mac-address timer
display mac-address nickname Use display mac-address nickname to display the MAC address information of the egress RB specified by its nickname.
Syntax display mac-address nickname nickname
65
Views Any view
Predefined user roles network-admin network-operator
Parameters nickname nickname: Specifies an egress RB by its nickname. The value range for the nickname argument is 0x1 to 0xFFFE in hexadecimal format.
Examples # Display the MAC address entries of the egress RB with the nickname 0x8c81. display mac-address nickname 8c81 MAC Address
VLAN
IDState
Port/NickName
Aging
0000-3300-0001
10
Learned
0x8c81
Y
0000-3300-0002
10
Learned
0x8c81
Y
0000-3300-0003
10
Learned
0x8c81
Y
0000-3300-0004
10
Learned
0x8c81
Y
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. 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 ]
66
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. display mac-address mac-learning Global MAC address learning status: Enabled. Port
Learning Status
FGE1/1/1
Enabled
FGE1/1/2
Enabled
FGE1/1/3
Enabled
FGE1/1/4
Enabled
Table 16 Command output Field
Description
Global MAC address learning status
• Enabled. • Disabled.
Port
Interface name.
Global MAC address learning status:
MAC address learning status of an interface: Learning Status
• 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
67
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 of all IRF member devices.
Usage guidelines When MAC address moves for a MAC address always occur 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 as to be one record.
•
An IRF member device can save a maximum of 20 MAC address move records. When the number of MAC address move records exceeds 20, the most recent record will override the oldest record based on the last MAC address move time.
Examples # Display the MAC address move records on the IRF member device 2. display mac-address mac-move slot 2 MAC address
VLAN
Current port
Source port
Last time
Times
0000-0001-002c 1
FGE1/1/1
FGE1/1/2
2013-05-20 13:40:52 1
0000-0001-002c 1
FGE1/1/2
FGE1/1/1
2013-05-20 13:41:30 1
---
2 MAC address moving records found
---
Table 17 Command output Field
Description
MAC address
MAC address.
VLAN
VLAN that 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 68
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. display mac-address statistics MAC Address Count: Dynamic Unicast Address (Learned) Count:
0
Dynamic Unicast Address (Security-service-defined) Count:
0
Static Unicast Address (User-defined) Count:
2
Static Unicast Address (System-defined) Count:
3
Total Unicast MAC Addresses In Use:
5
Total Unicast MAC Addresses Available:
294912
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 18 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.
69
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, 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 and all-zero 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.
70
Examples # Add a static entry for MAC address 000f-e201-0101 on interface FortyGigE 1/1/1 that belongs to VLAN 2. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address static 000f-e201-0101 vlan 2
# Add a static entry for MAC address 000f-e201-0101 on Layer 2 aggregate interface Bridge-Aggregation 1 that belongs to VLAN 1. 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 interface S-Channel 1/1/1:10 that belongs to VLAN 1. system-view [Sysname] interface s-channel 1/1/1:10 [Sysname-S-Channel1/1/1:10] mac-address static 000f-e201-0102 vlan 1
# Add a static entry for MAC address 000f-e201-0102 on interface Schannel-Aggregation 1:2 that belongs to VLAN 1. system-view [Sysname] interface schannel-aggregation 1:2 [Sysname-Schannel-Aggregation1:2] mac-address static 000f-e201-0102 vlan 1
# Add a multiport unicast MAC address entry for MAC address 0001-0001-0101 on FortyGigE 1/1/1 and FortyGigE 1/1/2 that belong to VLAN 2. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address multiport 0001-0001-0101 vlan 2 [Sysname-FortyGigE1/1/1] quit [Sysname] interface fortygige 1/1/2 [Sysname-FortyGigE1/1/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 ] 71
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. 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 and all-zero 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 interfaces in the format of { interface-type interface-number [ to interface-type interface-number ] } &<1-n>. The interface can only be a Layer 2 Ethernet interface or Layer 2 aggregate interface. &<1-4> specifies that you can configure a maximum of 4 interfaces or interface ranges. 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 0x1 to 0xFFFE.
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. To drop frames with the specified source MAC addresses or destination MAC addresses, you can configure blackhole MAC address entries. 72
To send frames with a specific destination MAC address out of multiple ports, configure a multiport unicast MAC address entry. When you execute this command for the first time, the command adds a MAC address 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 MAC address entry can overwrite a dynamic MAC address 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 MAC address entries and static multicast MAC address entries) of a 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 corresponding unicast MAC address entries, but not the corresponding 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.
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 interface FortyGigE 1/1/1, which belongs to VLAN 2. system-view [Sysname] mac-address static 000f-e201-0101 interface fortygige 1/1/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 FortyGigE 1/1/1 through FortyGigE 1/1/3, which belong to VLAN 2. system-view [Sysname] mac-address multiport 000f-e201-0101 interface fortygige 1/1/1 to fortygige 1/1/3 vlan 2
Related commands •
display mac-address
•
mac-address (interface view)
mac-address mac-learning enable Use mac-address mac-learning enable to enable MAC address learning globally, on an interface, or on a VLAN. Use undo mac-address mac-learning enable to disable MAC address learning globally, on an interface, or on a VLAN.
Syntax mac-address mac-learning enable undo mac-address mac-learning enable
Default MAC address learning is enabled.
73
Views System view Layer 2 Ethernet interface view, Layer 2 aggregate interface view S-channel interface view, S-channel aggregate interface view, S-channel bundle interface view VLAN view
Predefined user roles network-admin
Usage guidelines To prevent the MAC address table from becoming saturated, you can disable MAC address learning. For example, a number of packets with different source MAC addresses reaching a device can affect the MAC address table update. To avoid such attacks, you can disable MAC address learning by following these guidelines: •
You can disable MAC address learning on a per-interface basis. If you disable MAC address learning globally, MAC address learning is disabled for all interfaces. The device then stops learning MAC addresses and cannot dynamically update the MAC address table.
•
Because disabling MAC address learning can result in broadcast storms, enable broadcast storm suppression after you disable MAC address learning on an interface. For more information about broadcast storm suppression, see Layer 2—LAN Switching Configuration Guide.
•
With MAC address learning enabled globally, you can disable MAC address learning for an interface or VLAN.
This command does not take effect in a TRILL network, in a VPLS VSI, or for an S-channel. For information about TRILL, see TRILL Configuration Guide. For information about VSIs, see MPLS Configuration Guide. For information about S-channels, see EVB Configuration Guide. When MAC address learning is disabled, the device immediately deletes the existing dynamic MAC address entries.
Examples # Disable MAC address learning globally. system-view [Sysname] undo mac-address mac-learning enable
# Disable MAC address learning for VLAN 10. system-view [Sysname] vlan 10 [Sysname-vlan10] undo mac-address mac-learning enable
# Disable MAC address learning on interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] undo mac-address mac-learning enable
# Disable MAC address learning on interface Bridge-Aggregation 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] undo mac-address mac-learning enable
# Disable MAC address learning on interface S-Channel 1/1/1:10. 74
system-view [Sysname] interface s-channel 1/1/1:10 [Sysname-S-Channel1/1/1:10] undo mac-address mac-learning enable
# Disable MAC address learning on interface Schannel-Aggregation 1:2. system-view [Sysname] interface schannel-aggregation 1:2 [Sysname-Schannel-Aggregation1:2] undo mac-address mac-learning enable
Related commands display mac-address mac-learning
mac-address mac-learning priority Use mac-address mac-learning priority to assign MAC learning priority to an interface. Use undo mac-address mac-learning priority to restore the default.
Syntax mac-address mac-learning priority { high | low } undo mac-address mac-learning priority
Default Low MAC address learning priority is used.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters high: Assigns high MAC learning priority. low: Assigns low MAC learning priority.
Usage guidelines The MAC address learning priority values can be high and low. An interface with high MAC address learning priority can learn any MAC address. An interface with low MAC address learning priority can learn only the MAC addresses that have not been learned by high-priority interfaces. The MAC learning priority mechanism can help defend your network against MAC address spoofing attacks. To prevent the downlink interface from learning the MAC address of an upper layer device (for example, the gateway), you can perform the following tasks: •
Assign high MAC learning priority to an uplink interface.
•
Assign low MAC learning priority to a downlink interface .
Examples # Assign high MAC learning priority to interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address mac-learning priority high
75
# Assign high MAC learning priority to interface Bridge-Aggregation 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] mac-address mac-learning priority high
mac-address mac-roaming enable Use mac-address mac-roaming enable to enable MAC address synchronization. Use undo mac-address mac-roaming enable to restore the default.
Syntax mac-address mac-roaming enable undo mac-address mac-roaming enable
Default MAC address synchronization is disabled.
Views System view
Predefined user roles network-admin
Usage guidelines If ports on different IRF member devices are Selected ports from the same aggregation group, MAC address entries are synchronized among these IRF member devices. They are synchronized whether or not MAC address synchronization is enabled for the IRF fabric. For more information about aggregation groups, see Layer 2—LAN Switching Configuration Guide. The MAC address table size might vary by IRF member device. With MAC address synchronization enabled, MAC address entries exceeding the table size of an IRF member device cannot be synchronized to the MAC address table.
Examples # Enable MAC address synchronization. system-view [Sysname] mac-address mac-roaming enable
mac-address max-mac-count Use mac-address max-mac-count to set the MAC learning limit on an interface. Use undo mac-address max-mac-count to restore the default.
Syntax mac-address max-mac-count count undo mac-address max-mac-count
Default The maximum number of MAC addresses that can be learned on an interface is not set.
76
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Parameters count: Sets the maximum number of MAC addresses that can be learned on an interface. The value range is 0 to 4096. When the argument is set to 0, the interface is not allowed to learn MAC addresses.
Usage guidelines When the number of MAC address entries learned by an interface reaches the limit, the interface stops learning MAC address entries.
Examples # Configure interface FortyGigE 1/1/1 to learn a maximum of 600 MAC address entries. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address max-mac-count 600
Related commands •
mac-address
•
mac-address max-mac-count enable-forwarding
mac-address max-mac-count enable-forwarding Use mac-address max-mac-count enable-forwarding to enable the device to forward unknown frames received on an interface after the MAC learning limit on the interface is reached. Use undo mac-address max-mac-count enable-forwarding to disable the device from forwarding unknown frames received on an interface after the MAC learning limit on the interface is reached.
Syntax mac-address max-mac-count enable-forwarding undo mac-address max-mac-count enable-forwarding
Default When the MAC learning limit on an interface is reached, the device can forward unknown frames received on the interface.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines In this document, unknown frames refer to frames whose source MAC addresses are not in the MAC address table.
Examples # Configure FortyGigE 1/1/1 to learn a maximum of 600 MAC address entries. 77
system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address max-mac-count 600
# Disable the device from forwarding unknown frames received on FortyGigE 1/1/1 after the MAC learning limit on FortyGigE 1/1/1 is reached. [Sysname-FortyGigE1/1/1] undo mac-address max-mac-count enable-forwarding
Related commands •
mac-address
•
mac-address max-mac-count
mac-address mac-move fast-update Use mac-address mac-move fast-update to enable ARP fast update for MAC address moves. Use undo mac-address mac-move fast-update to restore the default.
Syntax mac-address mac-move fast-update undo mac-address mac-move fast-update
Default ARP fast update is disabled for MAC address moves.
Views System view
Predefined user roles network-admin
Examples # Enable ARP fast update for MAC address moves. system-view [Sysname] mac-address mac-move fast-update
mac-address notification mac-move Use mac-address notification mac-move to enable MAC address move notifications and optionally specify a MAC move detection interval. Use undo mac-address notification mac-move to restore the default.
Syntax mac-address notification mac-move [ interval interval-value ] undo mac-address notification mac-move
Default MAC address move notifications are disabled, and the MAC move detection interval for MAC address moves is 1 minute.
78
Views System view
Predefined user roles network-admin
Parameters interval interval-value: Sets a detection interval for MAC address moves, in the range of 1 to 60 minutes. If you do not specify this option, the default setting of 1 minute is used.
Usage guidelines With MAC address move notifications enabled, the system displays the MAC address move logs when it detects MAC address moves. Each record of the MAC address move logs contains the following information: •
MAC address.
•
VLAN ID of the MAC address entry.
•
Current port and source port of the MAC address moves.
•
Number of MAC address moves within a MAC move detection interval.
After you execute this command: •
If the snmp-agent trap enable mac-address command is also executed, the system sends SNMP information to the SNMP module of the device.
•
If the snmp-agent trap enable mac-address command is not executed, the system sends syslog messages to the information center module.
Within a detection interval, an IRF member device can display a maximum of 20 MAC address move records. The latest record will override the oldest one.
Examples # Enable MAC address move notifications. system-view [Sysname] mac-address notification mac-move [Sysname] %May 14 17:16:45:688 2013 HP MAC/4/MAC_FLAPPING: MAC address 0000-0012-0034 in VLAN 500 has moved from port FGE1/1/1 to port FGE1/1/2 for 1 times
The output shows that: •
The VLAN ID of which MAC address 0000-0012-0034 is VLAN 500.
•
The MAC address moved from port FortyGigE 1/1/1 to port FortyGigE 1/1/2.
•
The MAC address has moved once within the last 1 minute (the default interval).
Related commands display mac-address mac-move
mac-address notification mac-move suppression Use mac-address notification mac-move suppression to enable MAC address move suppression. Use undo mac-address notification mac-move suppression to restore the default.
79
Syntax mac-address notification mac-move suppression undo mac-address notification mac-move suppression
Default MAC address moves are not suppressed.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines This feature shuts an interface down when a MAC address has been moved from the interface more than the specified suppression threshold within a MAC move detection interval. You can use the shutdown command and then the undo shutdown command to bring up the interface. Also, the interface can automatically come up after a suppression interval.
Examples # Enable MAC address move suppression on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address notification mac-move suppression
mac-address notification mac-move suppression interval Use mac-address notification mac-move suppression interval to set a suppression interval for MAC address moves. Use undo mac-address notification mac-move suppression interval to restore the default.
Syntax mac-address notification mac-move suppression interval interval-value undo mac-address notification mac-move suppression
Default The suppression interval for MAC address moves is 30 seconds.
Views System view
Predefined user roles network-admin
Parameters interval interval-value: Sets the MAC address move suppression interval in the range of 30 to 86400 seconds. If you do not specify this option, the default suppression interval of 30 seconds is used.
Examples # Set the suppression interval to 100 seconds for MAC address moves. system-view
80
[Sysname] mac-address notification mac-move suppression interval 100
mac-address notification mac-move suppression threshold Use mac-address notification mac-move suppression threshold to set a threshold for MAC address moves sourced from an interface within a detection interval. Use undo mac-address notification mac-move suppression threshold to restore the default.
Syntax mac-address notification mac-move suppression threshold threshold-value undo mac-address notification mac-move suppression threshold
Default The threshold is 3.
Views System view
Predefined user roles network-admin
Parameters threshold-value: Sets the threshold for MAC address moves sourced from an interface within a detection interval. The value range for this argument is 0 to 1024.
Usage guidelines The system shuts down the interface when the following conditions exist: •
The interface is enabled with MAC address move suppression.
•
The number of MAC address moves from the interface within a detection interval exceeds the threshold.
After the suppression interval elapses, the interface comes up automatically. You can also use the undo shutdown command to manually bring up the interface. If the threshold is set to 0, the system shuts down an interface if a MAC address moves from the interface.
Examples # Set the threshold to 1 for MAC address moves sourced from an interface within a detection interval. system-view [Sysname] mac-address notification mac-move suppression threshold 1
mac-address static source-check enable Use mac-address static source-check enable to enable the static source check feature. Use undo mac-address static source-check enable to disable the static source check feature.
Syntax mac-address static source-check enable undo mac-address static source-check enable
81
Default The static source check feature is enabled.
Views Layer 2 Ethernet interface view, Layer 3 Ethernet interface/subinterface view Layer 2 aggregate interface view, Layer 3 aggregate interface /subinterface view
Predefined user roles network-admin
Examples # Disable the static source check feature. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] undo mac-address static source-check enable
mac-address timer Use mac-address timer to set the aging timer for dynamic MAC address entries. Use undo mac-address timer to restore the default.
Syntax mac-address timer { aging seconds | no-aging } undo mac-address timer
Default The aging timer is 300 seconds for dynamic MAC address entries.
Views System view
Predefined user roles network-admin
Parameters aging seconds: Sets an aging timer (in seconds) for dynamic MAC address entries, in the range of 10 to 1000000 seconds. no-aging: Configures dynamic MAC address entries not to age.
Usage guidelines To set the aging timer appropriately, follow these guidelines: •
A long aging interval causes the MAC address table to retain outdated entries and fail to accommodate the most recent network changes.
•
A short aging interval results in removal of valid entries. Then, unnecessary broadcasts packets appear and affect device performance.
Examples # Set the aging time to 500 seconds for dynamic MAC address entries. system-view
82
[Sysname] mac-address timer aging 500
Related commands display mac-address aging-time
snmp-agent trap enable mac-address Use snmp-agent trap enable mac-address to enable SNMP notifications for the MAC address table. Use undo snmp-agent trap enable mac-address to disable SNMP notifications for the MAC address table.
Syntax snmp-agent trap enable mac-address [ mac-move ] undo snmp-agent trap enable mac-address [ mac-move ]
Default SNMP notifications for the MAC address table are enabled.
Views System view
Predefined user roles network-admin
Parameters mac-move: Enables SNMP notifications about the MAC address moves for the MAC address table. If you do not specify this keyword, the command enables all types of SNMP notifications for the MAC address table.
Usage guidelines When SNMP notifications are disabled for the MAC address table, MAC address moves are reported in syslog messages. The MAC address table supports only SNMP notifications about MAC address moves. When you enable or disable SNMP notifications about MAC address moves, you enable or disable all types of SNMP notifications for the MAC address table.
Examples # Disable SNMP notifications about MAC address moves for the MAC address table. system-view [Sysname] undo snmp-agent trap enable mac-address mac-move
Related commands mac-address notification mac-move
83
MAC Information commands mac-address information enable (interface view) Use mac-address information enable to enable MAC Information on an interface. Use undo mac-address information enable to disable MAC Information on an interface.
Syntax mac-address information enable { added | deleted } undo mac-address information enable { added | deleted }
Default MAC Information is disabled on an interface.
Views Layer 2 Ethernet interface view S-channel interface view, S-channel aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters added: Enables the device to record MAC change information when a new MAC address is learned on an interface. deleted: Enables the device to record MAC change information when an existing MAC address is deleted.
Usage guidelines Before you enable MAC Information on an interface, enable MAC Information globally.
Examples # Enable MAC Information on FortyGigE 1/1/1 to enable the interface to record MAC change information when learning a new MAC address. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] mac-address information enable added
# Enable MAC Information on S-Channel 1/1/1:10 to the interface to record MAC change information when learning a new MAC address. system-view [Sysname] interface s-channel 1/1/1:10 [Sysname-S-Channel1/1/1:10] mac-address information enable added
# Enable MAC Information on Schannel-Aggregation 1:2 to enable the interface to record MAC change information when learning a new MAC address. system-view [Sysname] interface schannel-aggregation 1:2
84
[Sysname-Schannel-Aggregation1:2] mac-address information enable added
Related commands mac-address information enable (system view)
mac-address information enable (system view) Use mac-address information enable to enable MAC Information globally. Use undo mac-address information enable to disable MAC Information globally.
Syntax mac-address information enable undo mac-address information enable
Default MAC Information is disabled globally.
Views System view
Predefined user roles network-admin
Usage guidelines Before you enable MAC Information on an interface, enable MAC Information globally.
Examples # Enable MAC Information globally. system-view [Sysname] mac-address information enable
Related commands mac-address information enable (interface view)
mac-address information interval Use mac-address information interval to set the MAC change notification interval. Use undo mac-address information interval to restore the default.
Syntax mac-address information interval interval-time undo mac-address information interval
Default The MAC change notification interval is 1 second.
Views System view
85
Predefined user roles network-admin
Parameters interval-time: Sets the MAC change notification interval in the range of 1 to 20000 seconds.
Usage guidelines To prevent syslog messages or SNMP notifications from being sent too frequently, set the MAC change notification interval to a larger value.
Examples # Set the MAC change notification interval to 200 seconds. system-view [Sysname] mac-address information interval 200
mac-address information mode Use mac-address information mode to set the MAC Information mode. The MAC Information mode specifies the type of messages (syslog messages or SNMP notifications) used to notify MAC changes. Use undo mac-address information mode to restore the default.
Syntax mac-address information mode { syslog | trap } undo mac-address information mode
Default SNMP notifications are sent to notify MAC changes.
Views System view
Predefined user roles network-admin
Parameters syslog: Specifies that the device sends syslog messages to notify MAC changes. trap: Specifies that the device sends SNMP notifications to notify MAC changes.
Examples # Set the MAC Information mode to trap. system-view [Sysname] mac-address information mode trap
mac-address information queue-length Use mac-address information queue-length to set the MAC Information queue length. Use undo mac-address information queue-length to restore the default.
Syntax mac-address information queue-length value 86
undo mac-address information queue-length
Default The MAC Information queue length is 50.
Views System view
Predefined user roles network-admin
Parameters value: Sets the MAC Information queue length in the range of 0 to 1000. The MAC Information queue length indicates the number of MAC change messages.
Usage guidelines If the MAC Information queue length is 0, the device sends a syslog message or SNMP notification immediately after learning or deleting a MAC address. If the MAC Information queue length is not 0, the device stores MAC changes in the queue: •
•
The device overwrites the oldest MAC change written into the queue with the most recent MAC change when the following conditions exist: {
The MAC change notification interval does not expire.
{
The queue has been exhausted.
The device sends syslog messages or SNMP notifications only if the MAC change notification interval expires.
Examples # Set the MAC Information queue length to 600. system-view [Sysname] mac-address information queue-length 600
87
Ethernet link aggregation commands You can use the port link-mode command to configure an Ethernet port as a Layer 2 or Layer 3 interface (see Layer 2—LAN Switching Configuration Guide).
bandwidth Use bandwidth to set the expected bandwidth for an interface. Use undo bandwidth to restore the default.
Syntax bandwidth bandwidth-value undo bandwidth
Default The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles network-admin
Parameters bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines The expected bandwidth of an interface affects the following items: •
Bandwidth assignment with CBQ. For more information, see ACL and QoS Configuration Guide.
•
Link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.
Examples # Set the expected bandwidth to 10000 kbps for Layer 2 aggregate interface Bridge-Aggregation 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] bandwidth 10000
default Use default to restore the default settings for an aggregate interface.
Syntax default
88
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles network-admin
Usage guidelines CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impacts of this command when you execute it on a live network. This command might fail to restore the default settings for some commands for reasons such as command dependencies and system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples # Restore the default settings for Layer 2 aggregate interface 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] default
description Use description to set a description for an interface. Use undo description to restore the default.
Syntax description text undo description
Default The description of an interface is the interface-name plus Interface. For example, the default description of Bridge-Aggregation 1 is Bridge-Aggregation1 Interface.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles network-admin
Parameters text: Specifies the interface description, a string of 1 to 255 characters.
Examples # Set the description to connect to the lab for Layer 2 aggregate interface Bridge-Aggregation 1. system-view [Sysname] interface bridge-aggregation 1
89
[Sysname-Bridge-Aggregation1] description connect to the lab
display interface Use display interface to display aggregate interface information.
Syntax display interface [ bridge-aggregation | route-aggregation | schannel-bundle ] [ brief [ down | description ] ] display interface [ { bridge-aggregation | route-aggregation | schannel-bundle } [ interface-number ] ] [ brief [ description ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters bridge-aggregation: Specifies Layer 2 aggregate interfaces. route-aggregation: Specifies Layer 3 aggregate interfaces. schannel-bundle: Specifies S-channel bundle interfaces. interface-number: Specifies an existing aggregate interface number. The value range for the interface-number argument is the set of all existing aggregate interface numbers. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information. down: Displays information about interfaces in the down state and the causes for the down state. If you do not specify this keyword, the command displays information about interfaces in all states. description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
Usage guidelines If you do not specify the bridge-aggregation, route-aggregation, and schannel-bundle keywords, the command displays information about all interfaces. If you specify the bridge-aggregation, route-aggregation, or schannel-bundle keyword and do not specify an interface number, the command displays information about all aggregate interfaces of the specified type. If you specify the bridge-aggregation interface-number, route-aggregation interface-number, or schannel-bundle interface-number option, the command displays information about the specified aggregate interface.
Examples # Display detailed information about Layer 2 aggregate interface Bridge-Aggregation 1. display interface bridge-aggregation 1 Bridge-Aggregation1 Current state: UP
90
IP Packet Frame Type: PKTFMT_ETHNT_2, Hardware Address: 000f-e207-f2e0 Description: Bridge-Aggregation1 Interface Bandwidth: 0kbps 2Gbps-speed mode, full-duplex mode Link speed type is autonegotiation, link duplex type is autonegotiation PVID: 1 Port link-type: access Tagged Vlan:
none
UnTagged Vlan: 1 Last clearing of counters: Last 300 seconds input: Last 300 seconds output: Input (total):
Never
6900 packets/sec 885160 bytes/sec
-%
3150 packets/sec 404430 bytes/sec
-%
5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses Input (normal):
5364747 packets, 686688416 bytes
2682273 unicasts, 1341137 broadcasts, 1341337 multicasts, 0 pauses Input:
0 input errors, 0 runts, 0 giants, 0 throttles 0 CRC, 0 frame, 0 overruns, 0 aborts 0 ignored, 0 parity errors
Output (total): 1042508 packets, 133441832 bytes 1042306 unicasts, 0 broadcasts, 202 multicasts, 0 pauses Output (normal): 1042508 packets, 133441832 bytes 1042306 unicasts, 0 broadcasts, 202 multicasts, 0 pauses Output: 0 output errors, 0 underruns, 0 buffer failures 0 aborts, 0 deferred, 0 collisions, 0 late collisions 0 lost carrier, 0 no carrier
# Display detailed information about Layer 3 aggregate interface Route-Aggregation 1. display interface route-aggregation 1 Route-Aggregation1 Current state: UP Line protocol state: UP Description: Route-Aggregation1 Interface Bandwidth: 0kbps Maximum Transmit Unit: 1500 Internet protocol processing: disabled IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000 IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000 Last clearing of counters: Never Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 drops 0 packets output, 0 bytes, 0 drops
# Display detailed information about S-channel bundle interface Schannel-Bundle 1. display interface schannel-bundle 1 Schannel-Bundle1 Current state: UP Line protocol state: UP Description: Route-Aggregation1 Interface
91
Bandwidth: 0kbps Maximum Transmit Unit: 1500 Internet protocol processing: disabled IP Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000 IPv6 Packet Frame Type:PKTFMT_ETHNT_2, Hardware Address: 0000-0000-0000 Last clearing of counters: Never Last 300 seconds input rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec Last 300 seconds output rate: 0 bytes/sec, 0 bits/sec, 0 packets/sec 0 packets input, 0 bytes, 0 drops 0 packets output, 0 bytes, 0 drops
# Display brief information about Layer 2 aggregate interface Bridge-Aggregation 1. display interface bridge-aggregation 1 brief Brief information on interface(s) under bridge mode: Link: ADM - administratively down; Stby - standby Speed or Duplex: (a)/A - auto; H - half; F - full Type: A - access; T - trunk; H - hybrid Interface
Link Speed
Duplex Type PVID Description
BAGG1
UP
A
auto
A
1
# Display brief information about Layer 3 aggregate interface Route-Aggregation 1. display interface route-aggregation 1 brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
RAGG1
UP
UP
Description
--
# Display brief information about S-channel bundle interface Schannel-Bundle 1. display interface schannel-bundle 1 brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Speed or Duplex: (a)/A - auto; H - half; F - full Type: A - access; T - trunk; H - hybrid Interface
Link Speed
Duplex Type PVID Description
SCH-B1
DOWN --
--
A
1
Table 19 Command output Field
Description
Bridge-Aggregation1
Layer 2 aggregate interface name.
Route-Aggregation1
Layer 3 aggregate interface name.
Schannel-Bundle 1
S-channel bundle interface name.
92
Field
Description Aggregate interface status:
• DOWN (Administratively down)—The interface is administratively shut down with the shutdown command.
Current state
• DOWN—The interface is administratively up but
physically down (possibly because no physical link is present or the link has failed).
• UP—The Ethernet interface is both administratively and physically up.
IPv4 packet frame format. IP Packet Frame Type
The value PKTFMT_ETHNT_2 indicates that packets are encapsulated in Ethernet II format. Partial or complete interface description configured by using the description command.
• If the description keyword is not specified in the
display interface brief command, this field displays only the first 27 characters of the interface description.
Description
• If the description keyword is specified in the
display interface brief command, this field displays the complete interface description.
Bandwidth
Expected bandwidth of the interface.
Unknown-speed mode, unknown-duplex mode
The interface speed and duplex mode are unknown.
PVID
Port VLAN ID (PVID).
Port link-type
Port link type: access, trunk, or hybrid. Packets from the specified VLANs are sent out of this interface with a VLAN tag:
• Tagged Vlan: none—All packets are sent out of this interface without a VLAN tag.
Tagged Vlan
• Tagged Vlan: 1—Packets from VLAN 1 are sent out of this interface with a VLAN tag.
This field is displayed when the port link type is access or hybrid. Packets from the specified VLANs are sent out of this interface without a VLAN tag:
• Untagged Vlan: none—All packets are sent out of this interface with a VLAN tag.
Untagged Vlan
• Untagged Vlan: 1—Packets from VLAN 1 are sent out of this interface without a VLAN tag.
This field is displayed when the port link type is access or hybrid. Time when the reset counters interface command was last used to clear the interface statistics. Last clearing of counters
Never indicates the reset counters interface command has never been used on the interface since the device startup.
93
Field
Description
Last 300 seconds input/output rate
Average input/output rate over the last 300 seconds.
Input/Output (total)
Statistics of all packets received/sent on the interface.
Input/Output (normal)
Statistics of all normal packets received/sent on the interface.
Line protocol state
Link layer state of the interface. IP packet processing. Disabled indicates that IP packets cannot be processed.
Internet protocol processing
For an interface configured with an IP address, this field changes to Internet Address is. Brief information on interface(s) under route mode
Brief information about Layer 3 interfaces.
Brief information on interface(s) under bridge mode
Brief information about Layer 2 interfaces. Link status:
• ADM—The interface has been administratively Link: ADM - administratively down; Stby - standby
shut down. To recover its physical layer state, run the undo shutdown command.
• Stby—The interface is operating as a backup interface.
If the speed of an interface is automatically negotiated, the speed attribute of the interface includes the auto negotiation flag (the letter a in parentheses). If an interface is configured to autonegotiate its speed but the autonegotiation has not started, its speed attribute is displayed as auto.
Speed or Duplex: (a)/A - auto; H - half; F - full
If the duplex mode of an interface is automatically negotiated, the duplex mode attribute of the interface includes the letter a in parentheses or a capital A. H indicates the half duplex mode. F indicates the full duplex mode. Type: A - access; T - trunk; H - hybrid
Port link type options for interfaces.
Protocol: (s) - spoofing
If the data link layer protocol state of an interface is shown as UP, but its link is an on-demand link or not present, its protocol attribute includes the spoofing flag (the letter s in parentheses).
Interface
Abbreviated interface name.
Link
Physical link state of the interface.
Speed
Interface speed, in bps.
Cause
Cause of a DOWN physical link.
display lacp system-id Use display lacp system-id to display the system ID of the local system. 94
Syntax display lacp system-id
Views Any view
Predefined user roles network-admin network-operator
Usage guidelines You can use the lacp system-priority command to change the LACP priority of the local system. The LACP priority value is specified in decimal format in the lacp system-priority command. However, it is displayed as a hexadecimal value in the output from the display lacp system-id command.
Examples # Display the local system ID. display lacp system-id Actor System ID: 0x8000, 0000-fc00-6504
Table 20 Command output Field
Description
Actor System ID: 0x8000, 0000-fc00-6504
Local system ID, which contains the system LACP priority (0x8000 in this sample output) and the system MAC address (0000-FC00-6504 in this sample output).
Related commands lacp system-priority
display link-aggregation load-sharing mode Use display link-aggregation load-sharing mode to display global or group-specific link-aggregation load sharing modes.
Syntax display link-aggregation load-sharing mode [ interface [ { bridge-aggregation | route-aggregation | schannel-bundle } interface-number ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters bridge-aggregation: Specifies Layer 2 aggregate interfaces. route-aggregation: Specifies Layer 3 aggregate interfaces. schannel-bundle: Specifies S-channel bundle interfaces. 95
interface-number: Specifies an existing aggregate interface number.
Usage guidelines If you do not specify the interface keyword, the command displays the global link-aggregation load sharing modes. If you specify the interface keyword, but do not specify an interface, the command displays all group-specific load sharing modes. If you specify the bridge-aggregation interface-number, route-aggregation interface-number, or schannel-bundle interface-number option, the command displays the load sharing mode of the specified aggregation group. The bridge-aggregation, route-aggregation, or schannel-bundle keyword is available only when the corresponding aggregate interfaces exist on the device.
Examples # Display the default global link-aggregation load sharing modes. display link-aggregation load-sharing mode MAC-in-MAC traffic load-sharing mode: Default Link-Aggregation Load-Sharing Algorithm: Default Link-Aggregation Load-Sharing Seed: Default Link-Aggregation Load-Sharing Mode: Layer 2 traffic: packet type-based sharing Layer 3 traffic: packet type-based sharing
# Display the set global link-aggregation load sharing mode. display link-aggregation load-sharing mode MAC-in-MAC traffic load-sharing mode: inner Link-Aggregation Load-Sharing Algorithm: Algorithm 2 Link-Aggregation Load-Sharing Seed: 0x3ff Link-Aggregation Load-Sharing Mode: destination-mac address
source-mac address
# Display the default link-aggregation load sharing modes of Layer 2 aggregation group 10. display link-aggregation load-sharing mode interface bridge-aggregation 10 Bridge-Aggregation10 Load-Sharing Mode: Layer 2 traffic: packet type-based sharing Layer 3 traffic: packet type-based sharing
# Display the set link-aggregation load sharing mode of Layer 2 aggregation group 10. display link-aggregation load-sharing mode interface bridge-aggregation 10 Bridge-Aggregation10 Load-Sharing Mode: destination-mac address
source-mac address
96
Table 21 Command output Field
Description Global load sharing mode for MAC-in-MAC traffic.
MAC-in-MAC traffic load-sharing mode
Link-Aggregation Load-Sharing Algorithm
By default, this field displays Default. If you have set the global load sharing mode for MAC-in-MAC traffic, this field displays the set mode. Per-flow load sharing algorithm for Ethernet link aggregation. By default, this field displays Default. If you have configured the load sharing algorithm, this field displays the configured algorithm. Per-flow load sharing algorithm seed for Ethernet link aggregation.
Link-Aggregation Load-Sharing Seed
By default, this field displays Default. If you have configured the load sharing algorithm seed, this field displays the configured seed. Global link-aggregation load sharing mode.
• By default, this field displays the link-aggregation load sharing Link-Aggregation Load-Sharing Mode
modes for Layer 2 traffic and Layer 3 traffic.
• If you have set the global link-aggregation load sharing mode, this field displays the set mode.
Link-aggregation load sharing mode of Layer 2 aggregation group 10. Bridge-Aggregation10 Load-Sharing Mode
• By default, this field displays the global link-aggregation load sharing modes.
• If you have set a link-aggregation load sharing mode for this aggregation group, this field displays the set mode.
Link-aggregation load sharing mode of Layer 3 aggregation group 10. Route-Aggregation10 Load-Sharing Mode
• By default, this field displays the global link-aggregation load sharing modes.
• If you have set a link-aggregation load sharing mode for this aggregation group, this field displays the set mode.
Link-aggregation load sharing mode of S-channel bundle group 1. Schannel-Bundle1 load-sharing mode
By default, this field displays the global link-aggregation load sharing modes. If you have set a link-aggregation load sharing mode for this bundle group, this field displays the set mode.
Layer 2 traffic: packet type-based sharing
Default link-aggregation load sharing mode for Layer 2 traffic. In this sample output, Layer 2 traffic is load shared based on the packet type.
Layer 3 traffic: packet type-based sharing
Default link-aggregation load sharing mode for Layer 3 traffic. In this sample output, Layer 3 traffic is load shared based on the packet type.
destination-mac address, source-mac address
User-configured link-aggregation load sharing mode. In this sample output, traffic is load shared based on source and destination MAC addresses.
Related commands •
link-aggregation global load-sharing algorithm 97
•
link-aggregation global load-sharing mode
•
link-aggregation global load-sharing seed
•
link-aggregation load-sharing mode
display link-aggregation load-sharing path Use display link-aggregation load-sharing path to display forwarding information for the specified traffic flow.
Syntax display link-aggregation load-sharing path interface { bridge-aggregation | route-aggregation } interface-number ingress-port interface-type interface-number [ route ] { { destination-ip ip-address | destination-ipv6 ipv6-address } | { source-ip ip-address | source-ipv6 ipv6-address } | destination-mac mac-address | destination-port port-id | ethernet-type type-number | ip-protocol protocol-id | source-mac mac-address | source-port port-id | vlan vlan-id }*
Views Any view
Predefined user roles network-admin network-operator
Parameters bridge-aggregation: Specifies Layer 2 aggregate interfaces. route-aggregation: Specifies Layer 3 aggregate interfaces. interface-number: Specifies an existing aggregate interface by its number. ingress-port interface-type interface-number: Specifies an ingress port by its type and number. The ingress port must be a physical port. route: Displays forwarding information for Layer 3 traffic. If you do not specify this keyword, the command displays forwarding information for Layer 2 traffic. destination-ip ip-address: Specifies a destination IPv4 address. destination-ipv6 ipv6-address: Specifies a destination IPv6 address. source-ip ip-address: Specifies a source IPv4 address. source-ipv6 ipv6-address: Specifies a source IPv6 address. destination-mac mac-address: Specifies a destination MAC address in H-H-H format. destination-port port-id: Specifies a destination port number in the range of 1 to 65535. ethernet-type type-number: Specifies an Ethernet type code in the range of 1 to 65535. ip-protocol protocol-id: Specifies an IP protocol by its ID in the range of 0 to 255. source-mac mac-address: Specifies a source MAC address in H-H-H format. source-port port-id: Specifies a source port number in the range of 1 to 65535. vlan vlan-id: Specifies a VLAN by its ID in the range of 1 to 4094.
98
Usage guidelines A parameter specified in the command might not be used for selecting the egress port. The Load sharing parameters field displays the parameters that are used in egress port selection. For example, you can specify both the destination-mac mac-address and destination-ip ip-address options. If only the destination MAC address is used for selecting the egress port, the Load sharing parameters field does not display the destination-ip parameter. If a parameter required for selecting the egress port is not specified, the default value of the parameter is used. If the parameter does not have any default values, the parameter is set to 0.
Examples # Display forwarding information for the specified traffic flow to be sent out of Layer 2 aggregate interface Bridge-Aggregation 1. display link-aggregation load-sharing path interface bridge-aggregation 1 ingress-port fortygige 1/1/1 destination-mac 0000-fc00-0001 source-mac 0000-fc00-0002 source-ip 10.100.0.2 destination-ip 10.100.0.1 Load sharing mode: destination-mac, source-mac Unspecified parameters are set to 0. Load sharing parameters: Ingress port: FortyGigE1/1/1 Destination MAC: 0000-fc00-0001 Source MAC: 0000-fc00-0002 Destination IP: 10.100.0.1 Source IP: 10.100.0.2 Egress port: FortyGigE1/1/3
Table 22 Command output Field
Description The set load sharing mode for the aggregation group. The load sharing mode can be the following types:
• destination-mac—Traffic is load shared based on destination MAC addresses.
• source-mac—Traffic is load shared based on source MAC Load sharing mode:
addresses.
• destination-ip—Traffic is load shared based on destination IP addresses.
• • • •
source-ip—Traffic is load shared based on source IP addresses. destination-port—Traffic is load shared based on destination ports. source-port—Traffic is load shared based on source ports. ingress-port—Traffic is load shared based on ingress ports.
Load sharing parameters
Parameters that are used in egress port selection.
Egress port
Egress port of the specified traffic flow. If no egress port is found, this field displays N/A.
display link-aggregation member-port Use display link-aggregation member-port to display detailed link aggregation information for the specified member ports. 99
Syntax display link-aggregation member-port [ interface-list ]
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number.
Usage guidelines A member port in a static aggregation group is unaware of information about the peer group. For such member ports, the command displays the port number, port priority, and operational key of only the local end.
Examples # Display detailed link aggregation information for FortyGigE 1/1/1, which is a member port of a static aggregation group. display link-aggregation member-port fortygige 1/1/1 Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation, D -- Synchronization, E -- Collecting, F -- Distributing, G -- Defaulted, H -- Expired
FortyGigE1/1/1: Aggregate Interface: Bridge-Aggregation1 Port Number: 1 Port Priority: 32768 Oper-Key: 1
# Display detailed link aggregation information for FortyGigE 1/1/2, which is a member port of a dynamic aggregation group. display link-aggregation member-port fortygige 1/1/2 Flags: A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation, D -- Synchronization, E -- Collecting, F -- Distributing, G -- Defaulted, H -- Expired
FortyGigE1/1/2: Aggregate Interface: Bridge-Aggregation10 Local: Port Number: 2 Port Priority: 32768 Oper-Key: 2 Flag: {ACDEF} Remote: System ID: 0x8000, 000f-e267-6c6a
100
Port Number: 26 Port Priority: 32768 Oper-Key: 2 Flag: {ACDEF} Received LACP Packets: 5 packet(s) Illegal: 0 packet(s) Sent LACP Packets: 7 packet(s)
Table 23 Command output Field
Description LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. The letter is present when its bit is 1 and absent when its bit is 0.
• A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled.
• B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout.
• C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no.
Flags
• D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no.
• E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no.
• F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no.
• G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no.
• H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no.
Aggregate Interface
Aggregate interface to which the member port belongs.
Local
Information about the local end.
Oper-key
Operational key.
Flag
LACP protocol state flag.
Remote
Information about the peer end.
System ID
Peer system ID, containing the system LACP priority and the system MAC address.
Received LACP Packets
Total number of LACP packets received.
Illegal
Total number of illegal packets.
Sent LACP Packets
Total number of LACP packets sent.
display link-aggregation summary Use display link-aggregation summary to display brief information about all aggregation groups.
Syntax display link-aggregation summary
101
Views Any view
Predefined user roles network-admin network-operator
Usage guidelines Static link aggregation groups are unaware of information about the peer groups. As a result, the Partner ID field displays None for a static link aggregation group.
Examples # Display brief information about all aggregation groups. display link-aggregation summary Aggregation Interface Type: BAGG -- Bridge-Aggregation, RAGG -- Route-Aggregation Aggregation Mode: S -- Static, D -- Dynamic Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing Actor System ID: 0x8000, 000f-e267-6c6a AGG
AGG
Interface
Mode
Partner ID
Selected
Unselected
Individual
Share
Ports
Ports
Ports
Type
-------------------------------------------------------------------------------RAGG10
S
None
1
0
0
NonS
BAGG20
D
0x8000,00e0-fcff-ff01
2
0
0
Shar
SCH-B1
S
None
0
0
0
NonS
Table 24 Command output Field
Description Aggregate interface type:
Aggregation Interface Type
• BAGG—Layer 2. • RAGG—Layer 3. • SCH-B—S-channel bundle. Aggregation group type:
Aggregation Mode
• S—Static. • D—Dynamic. Load sharing type:
Loadsharing Type
• Shar—Load sharing. • NonS—Non-load sharing.
Actor System ID
Local system ID, which contains the local system LACP priority and the local system MAC address.
AGG Interface
Type and number of the aggregate interface.
AGG Mode
Aggregation group type.
Partner ID
System ID of the peer system, which contains the peer system LACP priority and the peer system MAC address.
Selected Ports
Total number of Selected ports. 102
Field
Description
Unselected Ports
Total number of Unselected ports.
Individual Ports
Total number of Individual ports.
Share Type
Load sharing type.
display link-aggregation verbose Use display link-aggregation verbose to display detailed information about the aggregation groups that correspond to the specified aggregate interfaces.
Syntax display link-aggregation verbose [ { bridge-aggregation | route-aggregation | schannel-bundle } [ interface-number ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters bridge-aggregation: Specifies Layer 2 aggregate interfaces. route-aggregation: Specifies Layer 3 aggregate interfaces. schannel-bundle: Specifies S-channel bundle interfaces. interface-number: Specifies an existing aggregate interface by its number.
Usage guidelines If you specify only the bridge-aggregation, route-aggregation, or schannel-bundle keyword, the command displays detailed information about all aggregation groups of the specified type. If you do not specify an aggregate interface type, the command displays detailed information about all aggregation groups. The bridge-aggregation, route-aggregation, or schannel-bundle keyword is available only when the corresponding aggregate interfaces exist on the device.
Examples # Display detailed information about Layer 2 aggregation group 10, which is a dynamic aggregation group. display link-aggregation verbose bridge-aggregation 10 Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing Port Status: S -- Selected, U -- Unselected, I -- Individual Flags:
A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation, D -- Synchronization, E -- Collecting, F -- Distributing, G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation10
103
Aggregation Mode: Dynamic Loadsharing Type: Shar System ID: 0x8000, 000f-e267-6c6a Local: Port
Status
Priority Oper-Key
Flag
-------------------------------------------------------------------------------FGE1/1/1
S
32768
2
{ACDEF}
FGE1/1/2
S
32768
2
{ACDEF}
Remote: Actor
Partner Priority Oper-Key
SystemID
Flag
-------------------------------------------------------------------------------FGE1/1/1
1
32768
2
0x8000, 000f-e267-57ad {ACDEF}
FGE1/1/2
2
32768
2
0x8000, 000f-e267-57ad {ACDEF}
# Display detailed information about Layer 2 aggregation group 20, which is a static aggregation group. display link-aggregation verbose bridge-aggregation 20 Loadsharing Type: Shar -- Loadsharing, NonS -- Non-Loadsharing Port Status: S -- Selected, U -- Unselected, I -- Individual Flags:
A -- LACP_Activity, B -- LACP_Timeout, C -- Aggregation, D -- Synchronization, E -- Collecting, F -- Distributing, G -- Defaulted, H -- Expired
Aggregate Interface: Bridge-Aggregation20 Aggregation Mode: Static Loadsharing Type: Shar Port
Status
Priority Oper-Key
-------------------------------------------------------------------------------FGE1/1/1
U
32768
1
FGE1/1/2
U
32768
1
FGE1/1/3
U
32768
1
Table 25 Command output Field
Description Load sharing type:
Loadsharing Type
• Shar—Load sharing. • NonS—Non-load sharing.
Port Status
Port state: Selected, Unselected, or Individual.
104
Field
Description LACP state flags. This field is one byte long, represented by ABCDEFGH from the least significant bit to the most significant bit. The letter is present when its bit is 1 and absent when its bit is 0.
• A—Indicates whether LACP is enabled. 1 indicates enabled, and 0 indicates disabled.
• B—Indicates the LACP short or long timeout. 1 indicates short timeout, and 0 indicates long timeout.
• C—Indicates whether the sending system considers that the link is aggregatable. 1 indicates yes, and 0 indicates no.
Flags
• D—Indicates whether the sending system considers that the link is synchronized. 1 indicates yes, and 0 indicates no.
• E—Indicates whether the sending system considers that the incoming frames are collected. 1 indicates yes, and 0 indicates no.
• F—Indicates whether the sending system considers that the outgoing frames are distributed. 1 indicates yes, and 0 indicates no.
• G—Indicates whether the sending system receives frames in the default state. 1 indicates yes, and 0 indicates no.
• H—Indicates whether the sending system receives frames in the expired state. 1 indicates yes, and 0 indicates no.
Aggregate Interface
Name of the aggregate interface. Aggregation group type:
Aggregation Mode
System ID
• S—Static. • D—Dynamic. Local system ID, containing the local system LACP priority and the local system MAC address. Information about the local end:
Local
• • • • •
Port—Port type and number. Status—Port state, which can be Selected or Unselected. Priority—Port priority. Oper-Key—Operational key. Flag—LACP state flag.
NOTE: For static aggregation groups, the Flag field is not displayed. Information about the peer end:
Remote
• • • • • •
Actor—Type and number of the local port. Partner—Index of the peer port. Priority—Priority of the peer port. Oper-Key—Operational key of the peer port. System ID—System ID of the peer end. Flag—LACP state flag of the peer end.
interface bridge-aggregation Use interface bridge-aggregation to create a Layer 2 aggregate interface and enter the Layer 2 aggregate interface view. 105
Use undo interface bridge-aggregation to delete a Layer 2 aggregate interface.
Syntax interface bridge-aggregation interface-number undo interface bridge-aggregation interface-number
Default No Layer 2 aggregate interface is created.
Views System view
Predefined user roles network-admin
Parameters interface-number: Specifies a Layer 2 aggregate interface number in the range of 1 to 1024.
Usage guidelines When you create a Layer 2 aggregate interface, the system automatically creates a Layer 2 aggregation group with the same number. The aggregation group operates in static aggregation mode by default. Deleting a Layer 2 aggregate interface also deletes the Layer 2 aggregation group. At the same time, the member ports of the aggregation group, if any, leave the aggregation group.
Examples # Create Layer 2 aggregate interface Bridge-Aggregation 1, and enter its view. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1]
interface route-aggregation Use interface route-aggregation to create a Layer 3 aggregate interface or subinterface and enter the Layer 3 aggregate interface or subinterface view. Use undo interface route-aggregation to delete a Layer 3 aggregate interface or subinterface.
Syntax interface route-aggregation { interface-number | interface-number.subnumber } undo interface route-aggregation { interface-number | interface-number.subnumber }
Default No Layer 3 aggregate interface or subinterface is created.
Views System view
Predefined user roles network-admin
Parameters interface-number: Specifies a Layer 3 aggregate interface number in the range of 1 to 1024. 106
interface-number.subnumber: Specifies a subinterface of a Layer 3 aggregate interface. The interface-number argument specifies the main interface number. The subnumber argument specifies the subinterface number and is separated from the main interface number by a dot (.). The value range for the subnumber argument is 1 to 4094.
Usage guidelines When you create a Layer 3 aggregate interface, the system automatically creates a Layer 3 aggregation group with the same number. The Layer 3 aggregation group operates in static aggregation mode by default. Deleting a Layer 3 aggregate interface also deletes the Layer 3 aggregation group and the corresponding aggregate subinterfaces. At the same time, the member ports of the aggregation group, if any, leave the aggregation group. Deleting a Layer 3 aggregate subinterface does not affect the state of the main interface and the corresponding aggregation group.
Examples # Create Layer 3 aggregate interface Route-Aggregation 1 and enter its view. system-view [Sysname] interface route-aggregation 1 [Sysname-Route-Aggregation1]
# Create Layer 3 aggregate subinterface Route-Aggregation 1.1 and enter its view. system-view [Sysname] interface route-aggregation 1.1 [Sysname-Route-Aggregation1.1]
interface schannel-bundle Use interface schannel-bundle to create an S-channel bundle interface and enter its view, or enter the view of an existing S-channel bundle interface. Use undo interface schannel-bundle to delete an S-channel bundle interface.
Syntax interface schannel-bundle interface-number undo interface schannel-bundle interface-number
Default No S-channel bundle interfaces exist.
Views System view
Predefined user roles network-admin
Parameters interface-number: Specifies an S-channel bundle interface number in the range of 1 to 1024.
107
Usage guidelines When you create an S-channel bundle interface, the system automatically creates an S-channel bundle group with the same number. The S-channel bundle group operates in static aggregation mode by default. Deleting an S-channel bundle interface also deletes the S-channel bundle group. At the same time, the member ports of the bundle group, if any, leave the bundle group.
Examples # Create S-channel bundle interface Schannel-Bundle 1 and enter its view. system-view [Sysname] interface schannel-bundle 1 [Sysname-Schannel-Bundle1]
lacp edge-port Use lacp edge-port to configure an aggregate interface as an edge aggregate interface. Use undo lacp edge-port to restore the default.
Syntax lacp edge-port undo lacp edge-port
Default An aggregate interface does not operate as an edge aggregate interface.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Usage guidelines Use this command on the aggregate interface that connects the device to a server if dynamic link aggregation is configured only on the device. This feature enables all member ports of the aggregation group to forward packets to improve link reliability. This command takes effect only on an aggregate interface corresponding to a dynamic aggregation group. Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface.
Examples # Configure Layer 2 aggregate interface Bridge-aggregation 1 as an edge aggregate interface. System-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] lacp edge-port
lacp mode Use lacp mode passive to configure LACP to operate in passive mode on a port. 108
Use undo lacp mode to restore the default.
Syntax lacp mode passive undo lacp mode
Default LACP is operating in active mode on a port.
Views Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, S-channel interface view
Predefined user roles network-admin
Usage guidelines When LACP is operating in passive mode on a local member port and its peer port, both ports cannot send LACPDUs. When LACP is operating in active mode on either end of a link, both ports can send LACPDUs. This command takes effect only on member ports of dynamic aggregation groups.
Examples # Configure LACP to operate in passive mode on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] lacp mode passive
lacp period short Use lacp period short to set the short LACP timeout interval (3 seconds) on an interface. Use undo lacp period to restore the default.
Syntax lacp period short undo lacp period
Default The LACP timeout interval is the long timeout interval (90 seconds).
Views Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, S-channel interface view
Predefined user roles network-admin
Examples # Set the short LACP timeout interval (3 seconds) on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] lacp period short
109
lacp system-priority Use lacp system-priority to set the system LACP priority. Use undo lacp system-priority to restore the default.
Syntax lacp system-priority system-priority undo lacp system-priority
Default The system LACP priority is 32768.
Views System view
Predefined user roles network-admin
Parameters system-priority: Specifies the system LACP priority in the range of 0 to 65535. The smaller the value, the higher the system LACP priority.
Examples # Set the system LACP priority to 64. system-view [Sysname] lacp system-priority 64
Related commands link-aggregation port-priority
link-aggregation bfd ipv4 Use link-aggregation bfd ipv4 to enable BFD for an aggregation group. Use undo link-aggregation bfd to restore the default.
Syntax link-aggregation bfd ipv4 source ip-address destination ip-address undo link-aggregation bfd
Default BFD is disabled for an aggregation group.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view
Predefined user roles network-admin
Parameters source ip-address: Specifies the source IP address of BFD sessions. 110
destination ip-address: Specifies the destination IP address of BFD sessions.
Usage guidelines This command might cause Selected ports in the aggregation group to change to the Unselected state. For BFD to take effect on an aggregation group, configure BFD on both ends of the aggregate link. Make sure the source and destination IP addresses are consistent at two ends of an aggregate link. For example, if you execute link-aggregation bfd ipv4 source 1.1.1.1 destination 2.2.2.2 on the local end, execute link-aggregation bfd ipv4 source 2.2.2.2 destination 1.1.1.1 on the peer end. The BFD parameters configured on an aggregate interface take effect on all BFD sessions in the aggregation group. For more information about configuring BFD parameters, see High Availability Configuration Guide. HP recommends not configuring other protocols to collaborate with BFD on a BFD-enabled aggregate interface.
Examples # Enable BFD on Layer 2 aggregate interface Bridge-aggregation 1, and specify the source and destination IP addresses as 1.1.1.1 and 2.2.2.2 for BFD sessions. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation bfd ipv4 source 1.1.1.1 destination 2.2.2.2
link-aggregation global load-sharing algorithm Use link-aggregation global load-sharing algorithm to configure the per-flow load sharing algorithm for Ethernet link aggregation. Use undo link-aggregation global load-sharing algorithm to restore the default.
Syntax link-aggregation global load-sharing algorithm algorithm-number undo link-aggregation global load-sharing algorithm
Default Algorithm 0 is used.
Views System view
Predefined user roles network-admin
Parameters algorithm algorithm-number: Specifies an algorithm by its number in the range of 1 to 8.
Usage guidelines If you execute this command multiple times, the most recent configuration takes effect. You can configure only the algorithm or the algorithm seed, or both. You can combine an algorithm with different algorithm seeds to obtain different effects.
111
If the device fails to load share traffic flows across all Selected ports, you can specify algorithm 1 to 8 in sequence until the problem is solved.
Examples # Specify algorithm 1 as the per-flow load sharing algorithm. system-view [Sysname] link-aggregation global load-sharing algorithm 1
Related commands •
display link-aggregation load-sharing mode
•
link-aggregation global load-sharing mode
•
link-aggregation global load-sharing seed
•
link-aggregation load-sharing mode
link-aggregation global load-sharing minm Use link-aggregation global load-sharing minm to set the global load sharing mode for MAC-in-MAC traffic. Use undo link-aggregation global load-sharing minm to restore the default.
Syntax link-aggregation global load-sharing minm { inner | outer } undo link-aggregation global load-sharing minm
Default MAC-in-MAC traffic is load shared based on the inner frame header, and source and destination ports.
Views System view
Predefined user roles network-admin
Parameters inner: Specifies the inner frame header, and source and destination ports. The inner frame header contains the source and destination customer MAC addresses, VLAN ID, and Ethernet type. outer: Specifies the outer frame header, and source and destination ports. The outer frame header contains the I-SID, and source and destination backbone MAC addresses.
Usage guidelines If you execute this command multiple times, the most recent configuration takes effect.
Examples # Set the global load sharing mode to load share MAC-in-MAC traffic based on the inner frame header, and source and destination ports. system-view [Sysname] link-aggregation global load-sharing minm inner
112
link-aggregation global load-sharing mode Use link-aggregation global load-sharing mode to set the global link-aggregation load sharing mode. Use undo link-aggregation global load-sharing mode to restore the default.
Syntax link-aggregation global load-sharing mode { destination-ip | destination-mac | destination-port | ingress-port | source-ip | source-mac | source-port } * undo link-aggregation global load-sharing mode
Default The system automatically chooses the global link-aggregation load sharing mode according to the packet type. The switch can perform link-aggregation load sharing for only Layer 2 or Layer 3 packets. •
•
If the incoming packets' Type field is 0x0800 or 0x86DD, the switch load shares these packets as Layer 3 packets by the combination of the following criteria: {
Source IP address.
{
Destination IP address.
{
Protocol number.
{
Port number.
If the incoming packets' Type field is not 0x0800 or 0x86DD, the switch load shares these packets as Layer 2 packets by the combination of the following criteria: {
Source MAC address.
{
Destination MAC address.
{
Ethernet frame types.
{
VLAN tag.
{
MOD ID.
{
Port ID.
Views System view
Predefined user roles network-admin
Parameters destination-ip: Load shares traffic based on destination IP addresses. destination-mac: Load shares traffic based on destination MAC addresses. destination-port: Load shares traffic based on destination ports. ingress-port: Load shares traffic based on ingress ports. source-ip: Load shares traffic based on source IP addresses. source-mac: Load shares traffic based on source MAC addresses. source-port: Load shares traffic based on source ports.
113
Usage guidelines The load sharing mode that you configure overwrites the previous mode. If unsupported load sharing mode is configured, an error prompt appears. In system view, the switch supports the following load sharing mode and combinations: •
Load sharing mode automatically determined based on the packet type.
•
Source IP address.
•
Destination IP address.
•
Source MAC address. NOTE: Packets cannot be load shared based on source MAC addresses when the destination IP addresses of the packets match multiport ARP entries. For more information about multiport ARP entries, see Layer 3—IP Services Configuration Guide.
•
Destination MAC address.
•
Source IP address and destination IP address.
•
Source IP address and source port.
•
Destination IP address and destination port.
•
Source IP address, source port, destination IP address, and destination port.
•
Any combination of ingress port, source MAC address, and destination MAC address.
Examples # Configure the global load sharing mode to load share packets based on destination MAC addresses. system-view [Sysname] link-aggregation global load-sharing mode destination-mac
Related commands •
display link-aggregation load-sharing mode
•
link-aggregation global load-sharing algorithm
•
link-aggregation global load-sharing seed
•
link-aggregation load-sharing mode
link-aggregation global load-sharing seed Use link-aggregation global load-sharing seed to configure the per-flow load sharing algorithm seed for Ethernet link aggregation. Use undo link-aggregation global load-sharing seed to restore the default.
Syntax link-aggregation global load-sharing seed seed-number undo link-aggregation global load-sharing seed
Default Algorithm seed 0 is used.
114
Views System view
Predefined user roles network-admin
Parameters seed seed-number: Specifies a seed in the range of 1 to 7FFFFFFF.
Usage guidelines If you execute this command multiple times, the most recent configuration takes effect. You can configure only the algorithm or the algorithm seed, or both. You can combine an algorithm with different algorithm seeds to obtain different effects.
Examples # Specify 1023 (3FF in hexadecimal format) as the per-flow load sharing algorithm seed. system-view [Sysname] link-aggregation global load-sharing seed 3FF
Related commands •
display link-aggregation load-sharing mode
•
link-aggregation global load-sharing algorithm
•
link-aggregation global load-sharing mode
•
link-aggregation load-sharing mode
link-aggregation ignore vlan Use link-aggregation ignore vlan to configure a Layer 2 aggregate interface to ignore the specified VLANs. Use undo link-aggregation ignore vlan to restore the default.
Syntax link-aggregation ignore vlan vlan-id-list undo link-aggregation ignore vlan vlan-id-list
Default A Layer 2 aggregate interface does not ignore any VLANs.
Views Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN ID or a range of VLAN IDs in the form of vlan-id1 to vlan-id2. The value range for VLAN IDs is 1 to 4094. The value for vlan-id2 must be equal to or greater than the value for vlan-id1.
115
Usage guidelines With this command configured, a Layer 2 aggregate interface ignores the permitted VLAN and VLAN tagging mode configuration of the specified VLANs when choosing Selected ports.
Examples # Configure Layer 2 aggregate interface bridge-aggregation 1 to ignore VLAN 50. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation ignore vlan 50
link-aggregation lacp traffic-redirect-notification enable Use link-aggregation lacp traffic-redirect-notification enable to enable link-aggregation traffic redirection. Use undo link-aggregation lacp traffic-redirect-notification enable to disable link-aggregation traffic redirection.
Syntax link-aggregation lacp traffic-redirect-notification enable undo link-aggregation lacp traffic-redirect-notification enable
Default Link-aggregation traffic redirection is disabled.
Views System view, Layer 2 aggregate interface view, Layer 3 aggregate interface view
Predefined user roles network-admin
Usage guidelines When you shut down a Selected port in an aggregation group, this feature redirects traffic of the port to other Selected ports. Zero packet loss is guaranteed for known unicast traffic, but not for unknown unicast traffic. When you restart an IRF member device that contains Selected ports, this feature redirects traffic of the IRF member device to other IRF member devices. Zero packet loss is guaranteed for known unicast traffic, but not for unknown unicast traffic. Link-aggregation traffic redirection applies only to dynamic link aggregation groups and takes effect on only known unicast packets. To prevent traffic interruption, enable link-aggregation traffic redirection on devices at both ends of the aggregate link. Do not enable both spanning tree and link-aggregation traffic redirection on a device. Otherwise, light packet loss might occur when the device reboots. Link-aggregation traffic redirection cannot operate correctly on an edge aggregate interface. Global link-aggregation traffic redirection settings take effect on all aggregation groups. A link aggregation group preferentially uses the group-specific link-aggregation traffic redirection settings. If group-specific link-aggregation traffic redirection is not configured, the group uses the global link-aggregation traffic redirection settings. 116
HP recommends that you enable link-aggregation traffic redirection on aggregate interfaces. If you enable this feature globally, communication with a third-party peer device might be affected if the peer is not compatible with this feature.
Examples # Enable link-aggregation traffic redirection. system-view [Sysname] link-aggregation lacp traffic-redirect-notification enable
link-aggregation load-sharing mode Use link-aggregation load-sharing mode to set the link-aggregation load sharing mode. Use undo link-aggregation load-sharing mode to restore the default.
Syntax link-aggregation load-sharing mode { destination-ip | destination-mac | source-ip | source-mac } * undo link-aggregation load-sharing mode
Default The load sharing mode is the same as the global load sharing mode.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view
Predefined user roles network-admin
Parameters destination-ip: Load shares traffic based on destination IP addresses. destination-mac: Load shares traffic based on destination MAC addresses. source-ip: Load shares traffic based on source IP addresses. source-mac: Load shares traffic based on source MAC addresses.
Usage guidelines The load sharing mode that you configure overwrites the previous mode. If an unsupported load sharing mode is configured, an error prompt appears. In Layer 2 aggregate interface view, the switch supports the following load sharing mode and combinations: •
Load sharing mode automatically determined based on the packet type.
•
Source IP address.
•
Destination IP address.
•
Source MAC address. NOTE: Packets cannot be load shared based on source MAC addresses when the destination IP addresses of the packets match multiport ARP entries. For more information about multiport ARP entries, see Layer 3—IP Services Configuration Guide. 117
•
Destination MAC address.
•
Destination IP address and source IP address.
•
Destination MAC address and source MAC address.
Examples # Configure Layer 2 aggregation group 1 to load share packets based on destination MAC addresses. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation load-sharing mode destination-mac
Related commands link-aggregation global load-sharing mode
link-aggregation load-sharing mode local-first Use link-aggregation load-sharing mode local-first to enable local-first load sharing for link aggregation. Use undo link-aggregation load-sharing mode local-first to disable local-first load sharing for link aggregation.
Syntax link-aggregation load-sharing mode local-first undo link-aggregation load-sharing mode local-first
Default Local-first load sharing is enabled for link aggregation.
Views System view
Predefined user roles network-admin
Usage guidelines When you disable local-first load sharing, the packets will be load shared among all Selected ports of the aggregate interface on all IRF member devices. Local-first load sharing for link aggregation takes effect on only known unicast packets.
Examples # Disable local-first load sharing for link aggregation. system-view [Sysname] undo link-aggregation load-sharing mode local-first
link-aggregation mode Use link-aggregation mode dynamic to configure an aggregation group to operate in dynamic aggregation mode and enable LACP. Use undo link-aggregation mode to restore the default.
118
Syntax link-aggregation mode dynamic undo link-aggregation mode
Default An aggregation group operates in static aggregation mode.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Examples # Configure Layer 2 aggregation group 1 to operate in dynamic aggregation mode. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation mode dynamic
link-aggregation port-priority Use link-aggregation port-priority to set the port priority of an interface. Use undo link-aggregation port-priority to restore the default.
Syntax link-aggregation port-priority port-priority undo link-aggregation port-priority
Default The port priority of an interface is 32768.
Views Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, S-channel interface view
Predefined user roles network-admin
Parameters port-priority: Specifies the port priority in the range of 0 to 65535. The smaller the value, the higher the port priority.
Examples # Set the port priority to 64 for Layer 2 Ethernet interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] link-aggregation port-priority 64
# Set the port priority to 64 for Layer 3 Ethernet interface FortyGigE 1/1/2. system-view [Sysname] interface fortygige 1/1/2 [Sysname-FortyGigE1/1/2] link-aggregation port-priority 64
119
Related commands lacp system-priority
link-aggregation selected-port maximum Use link-aggregation selected-port maximum to configure the maximum number of Selected ports allowed in an aggregation group. Use undo link-aggregation selected-port maximum to restore the default.
Syntax link-aggregation selected-port maximum number undo link-aggregation selected-port maximum
Default The maximum number of Selected ports allowed in an aggregation group is 32.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters number: Specifies the maximum number of Selected ports allowed in an aggregation group, in the range of 1 to 32.
Usage guidelines Executing this command might cause some of the Selected ports in an aggregation group to become Unselected ports. The maximum number of Selected ports allowed in the aggregation groups of the local and peer ends must be consistent. The maximum number of Selected ports allowed in an aggregation group is limited by one of the following values, whichever is smaller: •
Maximum number configured by using the link-aggregation selected-port maximum command.
•
Hardware limitation.
You can configure backup between two ports by performing the following tasks: •
Assigning two ports to an aggregation group.
•
Setting the maximum number of Selected ports to 1 for the aggregation group.
Then, only one Selected port is allowed in the aggregation group at any point in time, while the Unselected port acts as a backup port.
Examples # Set the maximum number of Selected ports to 5 for Layer 2 aggregation group 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation selected-port maximum 5
120
Related commands •
link-aggregation irf-enhanced
•
link-aggregation selected-port minimum
link-aggregation selected-port minimum Use link-aggregation selected-port minimum to configure the minimum number of Selected ports in the aggregation group. Use undo link-aggregation selected-port minimum to restore the default.
Syntax link-aggregation selected-port minimum number undo link-aggregation selected-port minimum
Default The minimum number of Selected ports in an aggregation group is not specified.
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters number: Specifies the minimum number of Selected ports in an aggregation group required to bring up the aggregate interface, in the range of 1 to 32.
Usage guidelines Executing this command might cause all member ports in the aggregation group to become Unselected ports. The minimum number of Selected ports allowed in the aggregation groups of the local and peer ends must be consistent.
Examples # Set the minimum number of Selected ports to 3 for Layer 2 aggregation group 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] link-aggregation selected-port minimum 3
Related commands link-aggregation selected-port maximum
mtu Use mtu to set the MTU for a Layer 3 aggregate interface or subinterface. Use undo mtu to restore the default.
Syntax mtu size 121
undo mtu
Default The MTU for Layer 3 aggregate interfaces and subinterfaces is 1500 bytes.
Views Layer 3 aggregate interface view, Layer 3 aggregate subinterface view
Predefined user roles network-admin
Parameters size: Specifies the MTU in bytes, in the range of 128 to 1560.
Examples # Set the MTU to 1430 bytes for Layer 3 aggregate interface Route-Aggregation 1. system-view [Sysname] interface route-aggregation 1 [Sysname-Route-Aggregation1] mtu 1430
Related commands display interface
port link-aggregation group Use port link-aggregation group to assign an interface to an aggregation group. Use undo port link-aggregation group to remove an interface from the aggregation group to which it belongs.
Syntax port link-aggregation group number undo port link-aggregation group
Default An interface does not belong to any aggregation group.
Views Layer 2 Ethernet interface view, Layer 3 Ethernet interface view, S-channel interface view
Predefined user roles network-admin
Parameters number: Specifies an aggregation group by its aggregate interface number in the range of 1 to 1024.
Usage guidelines A Layer 2 Ethernet interface can be assigned to a Layer 2 aggregation group only. A Layer 3 Ethernet interface can be assigned to a Layer 3 aggregation group only. An S-channel interface can be assigned to an S-channel bundle group only. An interface can belong to only one aggregation group.
122
Examples # Assign Layer 2 Ethernet interface FortyGigE 1/1/1 to Layer 2 aggregation group 1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] port link-aggregation group 1
# Assign Layer 3 Ethernet interface FortyGigE 1/1/2 to Layer 3 aggregation group 2. system-view [Sysname] interface fortygige 1/1/2 [Sysname-FortyGigE1/1/2] port link-aggregation group 2
reset counters interface Use reset counters interface to clear statistics for the specified aggregate interfaces.
Syntax reset counters interface [ { bridge-aggregation | route-aggregation | schannel-bundle } [ interface-number ] ]
Views User view
Predefined user roles network-admin
Parameters bridge-aggregation: Specifies Layer 2 aggregate interfaces. route-aggregation: Specifies Layer 3 aggregate interfaces. schannel-bundle: Specifies S-channel bundle interfaces. interface-number: Specifies an aggregate interface number.
Usage guidelines Use this command to clear history statistics before you collect traffic statistics for a time period. If you do not specify any options, the command clears statistics for all interfaces in the system. If you specify only the bridge-aggregation, route-aggregation, or schannel-bundle keyword, the command clears statistics for all aggregate interfaces of the specified type. If you specify the bridge-aggregation interface-number, route-aggregation interface-number, or schannel-bundle interface-number option, the command clears statistics for the specified aggregate interface. The bridge-aggregation, route-aggregation, or schannel-bundle keyword is available only when the corresponding aggregate interfaces exist on the device.
Examples # Clear statistics for Layer 2 aggregate interface Bridge-Aggregation 1. reset counters interface bridge-aggregation 1
123
reset lacp statistics Use reset lacp statistics to clear LACP statistics for the specified link aggregation member ports.
Syntax reset lacp statistics [ interface interface-list ]
Views User view
Predefined user roles network-admin
Parameters interface interface-list: Specifies a list of link aggregation member ports, in the format interface-type interface-number [ to interface-type interface-number ]. interface-type interface-number specifies an interface by its type and number. If you do not specify any member ports, the command clears LACP statistics for all member ports.
Examples # Clear LACP statistics for all link aggregation member ports. reset lacp statistics
Related commands display link-aggregation member-port
shutdown Use shutdown to shut down an aggregate interface. Use undo shutdown to bring up an aggregate interface.
Syntax shutdown undo shutdown
Views Layer 2 aggregate interface view, Layer 3 aggregate interface view, Layer 3 aggregate subinterface view, S-channel bundle interface view
Predefined user roles network-admin
Usage guidelines Shutting down or bringing up a Layer 3 aggregate interface shuts down or brings up its subinterfaces. Shutting down or bringing up a Layer 3 aggregate subinterface does not affect its main interface.
Examples # Bring up Layer 2 aggregate interface Bridge-Aggregation 1. system-view [Sysname] interface bridge-aggregation 1 [Sysname-Bridge-Aggregation1] undo shutdown
124
Port isolation commands display port-isolate group Use display port-isolate group to display port isolation group information.
Syntax display port-isolate group [ group-number ]
Views Any view
Predefined user roles network-admin network-operator
Parameters group-number: Specifies an isolation group by its number in the range of 1 to 8.
Examples # Display all isolation groups. display port-isolate group Port isolation group information: Group ID: 2 Group members: FortyGigE1/1/1 Group ID: 5 Group members: FortyGigE1/1/2 FortyGigE1/1/4
# Display information about isolation group 2. display port-isolate group 2 Port isolation group information: Group ID: 2 Group members: FortyGigE1/1/1
Table 26 Command output Field
Description
Group ID
Isolation group number.
Group members
Isolated ports in the isolation group. If the isolation group contains no isolated ports, this field displays No ports.
125
Related commands port-isolate enable
port-isolate enable Use port-isolate enable to assign a port to an isolation group. Use undo port-isolate enable to remove a port from an isolation group.
Syntax port-isolate enable group group-number undo port-isolate enable
Default The port is not assigned to any isolation group.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters group group-number: Specifies an isolation group by its number in the range of 1 to 8.
Usage guidelines The configuration in Layer 2 Ethernet interface view applies only to the interface. The configuration in Layer 2 aggregate interface view applies to the Layer 2 aggregate interface and its aggregation member ports. If the device fails to apply the configuration to the aggregate interface, it does not assign any aggregation member port to the isolation group. If the failure occurs on an aggregation member port, the device skips the port and continues to assign other aggregation member ports to the isolation group. You cannot assign the member ports of a service loopback group to an isolation group, and vice versa. To assign ports to an isolation group, make sure the isolation group already exists. One port can be assigned to only one isolation group.
Examples # Assign ports FortyGigE 1/1/1 and FortyGigE 1/1/2 to isolation group 2. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] port-isolate enable group 2 [Sysname-FortyGigE1/1/1] quit [Sysname] interface fortygige 1/1/2 [Sysname-FortyGigE1/1/2] port-isolate enable group 2
Related commands display port-isolate group
126
port-isolate group Use port-isolate group to create an isolation group. Use undo port-isolate group to delete isolation groups.
Syntax port-isolate group group-number undo port-isolate group { group-number | all }
Default No isolation group exists.
Views System view
Predefined user roles network-admin
Parameters group-number: Specifies an isolation group by its number in the range of 1 to 8. all: Deletes all isolation groups.
Usage guidelines If you execute this command multiple times, the most recent configuration takes effect.
Examples # Create isolation group 2. system-view [Sysname] port-isolate group 2
127
Spanning tree commands active region-configuration Use active region-configuration to activate your MST region configuration.
Syntax active region-configuration
Views MST region view
Predefined user roles network-admin
Usage guidelines When you configure MST region parameters, MSTP launches a new spanning tree calculation process that might cause network topology instability. This is most likely to occur when you configure the VLAN-to-instance mapping table. The launch occurs after you execute the active region-configuration command or the stp global enable command. HP recommends that you use the check region-configuration command to determine whether the MST region configurations to be activated are correct. Run this command only when they are correct.
Examples # Map VLAN 2 to MSTI 1 and manually activate the MST region configuration. system-view [Sysname] stp region-configuration [Sysname-mst-region] instance 1 vlan 2 [Sysname-mst-region] active region-configuration
Related commands •
check region-configuration
•
instance
•
region-name
•
revision-level
•
stp global enable
•
vlan-mapping modulo
bpdu-drop any Use bpdu-drop any to enable BPDU drop on a port. Use undo bpdu-drop any to disable BPDU drop on a port.
Syntax bpdu-drop any 128
undo bpdu-drop any
Default BPDU drop is disabled on a port.
Views Layer 2 Ethernet interface view
Predefined user roles network-admin
Examples # Enable BPDU drop on port FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] bpdu-drop any
check region-configuration Use check region-configuration to display MST region pre-configuration information, including the region name, revision level, and VLAN-to-instance mapping settings.
Syntax check region-configuration
Views MST region view
Predefined user roles network-admin
Usage guidelines Spanning tree devices belong to the same MST region only when they are connected through a physical link and configured with the same details as follows: •
Format selector (0 by default and not configurable).
•
MST region name.
•
MST region revision level.
•
VLAN-to-instance mapping entries in the MST region.
HP recommends that you use this command to determine whether the MST region configurations to be activated are correct. Activate them only when they are correct.
Examples # Display MST region pre-configurations. system-view [Sysname] stp region-configuration [Sysname-mst-region] check region-configuration Admin Configuration Format selector
: 0
Region name
: 001122334400
Revision level
: 0
129
Configuration digest : 0x3ab68794d602fdf43b21c0b37ac3bca8
Instance
VLANs Mapped
0
1, 3 to 4094
15
2
Table 27 Command output Field
Description
Format selector
Format selector of the MST region, which is 0 (not configurable).
Region name
MST region name.
Revision level
Revision level of the MST region.
Instance VLANs Mapped
VLAN-to-instance mappings in the MST region.
Related commands •
active region-configuration
•
instance
•
region-name
•
revision-level
•
vlan-mapping modulo
display stp Use display stp to display spanning tree status and statistics. Based on the information, you can analyze and maintain the network topology or determine whether the spanning tree is working correctly.
Syntax display stp [ instance instance-list | vlan vlan-id-list ] [ interface interface-list | slot slot-number ] [ brief ]
Views Any view
Predefined user roles network-admin network-operator
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. interface interface-list: Specifies a space-separated list of up to 10 interface items. Each item specifies an interface or a range of interfaces in the form of interface-type interface-number 1 [ to interface-type
130
interface-number 2 ]. The interface number for interface-number 2 must be equal to or greater than the interface number for interface-number 1. brief: Displays brief spanning tree status and statistics. If this keyword is not specified, the command displays the detailed spanning tree status and statistics. slot slot-number: Specifies an IRF member device by its member ID. If this option is not specified, this command applies to all member devices in the IRF fabric.
Usage guidelines In STP or RSTP mode, the command output is sorted by port name. •
If you do not specify a port, this command applies to all ports.
•
If you specify a port list, this command applies to the specified ports.
In PVST mode, the command output is sorted by VLAN ID and by port name in each VLAN. •
If you do not specify a VLAN or port, this command applies to all ports in all VLANs.
•
If you only specify a VLAN list but not a port, this command applies to all ports in the specified VLANs.
•
If you only specify a port list but not a VLAN, this command applies to the specified ports in all VLANs.
•
If you specify both a VLAN list and a port list, this command applies to the ports in the specified VLANs.
In MSTP mode, the command output is sorted by MSTI ID and by port name in each MSTI. •
If you do not specify an MSTI or port, this command applies to all MSTIs on all ports.
•
If you specify an MSTI list but not a port, this command applies to all ports in the specified MSTIs.
•
If you specify a port list but not an MSTI, this command applies to all MSTIs on the specified ports.
•
If you specify both an MSTI list and a port list, this command applies to the specified ports in the specified MSTIs.
During network convergence, the most recent spanning tree information is not displayed.
Examples # In MSTP mode, display the brief spanning tree status and statistics for MSTI 0 on ports FortyGigE 1/1/1 through FortyGigE 1/1/4. display stp instance 0 interface fortygige 1/1/1 to fortygige 1/1/4 brief MST ID
Port
Role
STP State
Protection
0
FortyGigE1/1/1
ALTE
DISCARDING
LOOP
0
FortyGigE1/1/2
DESI
FORWARDING
NONE
0
FortyGigE1/1/3
DESI
FORWARDING
NONE
0
FortyGigE1/1/4
DESI
FORWARDING
NONE
# In PVST mode, display the brief spanning tree status and statistics for VLAN 2 on ports FortyGigE 1/1/1 through FortyGigE 1/1/4. system-view [Sysname] stp mode pvst [Sysname] display stp vlan 2 interface fortygige 1/1/1 to fortygige 1/1/4 brief VLAN ID
Port
Role
STP State
Protection
2
FortyGigE1/1/1
ALTE
DISCARDING
LOOP
2
FortyGigE1/1/2
DESI
FORWARDING
NONE
2
FortyGigE1/1/3
DESI
FORWARDING
NONE
131
2
FortyGigE1/1/4
DESI
FORWARDING
NONE
Table 28 Command output Field
Description
MST ID
MSTI ID in the MST region.
Port
Port name, corresponding to each MSTI or VLAN. Port role:
Role
• • • • • •
ALTE—The port is an alternate port. BACK—The port is a backup port. ROOT—The port is a root port. DESI—The port is a designated port. MAST—The port is a master port. DISA—The port is disabled.
Spanning tree status on the port:
• FORWARDING—The port can receive and send BPDUs and also forward user traffic.
STP State
• DISCARDING—The port can receive and send BPDUs but cannot forward user traffic.
• LEARNING—The port is in a transitional state. It can receive and send BPDUs but cannot forward user traffic.
Protection type on the port: Protection
• • • •
ROOT—Root guard. LOOP—Loop guard. BPDU—BPDU guard. NONE—No protection.
# In MSTP mode, display the detailed spanning tree status and statistics for all MSTIs on all ports. display stp -------[CIST Global Info][Mode MSTP]------Bridge ID
: 32768.000f-e200-2200
Bridge times
: Hello 2s MaxAge 20s FwdDelay 15s MaxHops 20
Root ID/ERPC
: 0.00e0-fc0e-6554, 200200
RegRoot ID/IRPC
: 32768.000f-e200-2200, 0
RootPort ID
: 128.48
BPDU-Protection
: Disabled
Bridge ConfigDigest-Snooping
: Disabled
TC or TCN received
: 2
Time since last TC
: 0 days 0h:5m:42s
----[Port153(FortyGigE1/1/1)][FORWARDING]---Port protocol
: Enabled
Port role
: Designated Port (Boundary)
Port ID
: 128.153
Port cost(Legacy)
: Config=auto, Active=200
Desg.bridge/port Port edged
: 32768.000f-e200-2200, 128.2 : Config=disabled, Active=disabled
132
Point-to-Point
: Config=auto, Active=true
Transmit limit
: 10 packets/hello-time
TC-Restriction
: Disabled
Role-Restriction
: Disabled
Protection type
: NONE
MST BPDU format
: Config=auto, Active=legacy
Port ConfigDigest-Snooping
: Disabled
Rapid transition
: False
Num of VLANs mapped : 1 Port times
: Hello 2s MaxAge 20s FwdDelay 15s MsgAge 2s RemHops 20
BPDU sent
: 186
TCN: 0, Config: 0, RST: 0, MST: 186 BPDU received
: 0
TCN: 0, Config: 0, RST: 0, MST: 0
-------[MSTI 1 Global Info]------Bridge ID
: 0.000f-e23e-9ca4
RegRoot ID/IRPC
: 0.000f-e23e-9ca4, 0
RootPort ID
: 0.0
Root type
: Primary root
Master bridge
: 32768.000f-e23e-9ca4
Cost to master
: 0
TC received
: 0
# In PVST mode, display the spanning tree status and statistics for all ports in all VLANs. system-view [Sysname] stp mode pvst [Sysname] display stp -------[VLAN 1 Global Info]------Protocol status
: Enabled
Bridge ID
: 32768.000f-e200-2200
Bridge times
: Hello 2s MaxAge 20s FwdDelay 15s
VlanRoot ID/RPC
: 0.00e0-fc0e-6554, 200200
RootPort ID
: 128.48
BPDU-Protection
: Disabled
TC or TCN received
: 2
Time since last TC
: 0 days 0h:5m:42s
----[Port1(Ethernet1/1)][FORWARDING]---Port protocol
: Enabled
Port role
: Designated Port
Port ID
: 128.153
Port cost(Legacy)
: Config=auto, Active=200
Desg. bridge/port
: 32768.000f-e200-2200, 128.2
Port edged
: Config=disabled, Active=disabled
Point-to-Point
: Config=auto, Active=true
Transmit limit
: 10 packets/hello-time
Protection type
: NONE
133
Rapid transition
: False
Port times
: Hello 2s MaxAge 20s FwdDelay 15s MsgAge 2s
-------[VLAN 2 Global Info]------Protocol status
: Enabled
Bridge ID
: 32768.000f-e200-2200
Bridge times
: Hello 2s MaxAge 20s FwDly 15s
VlanRoot ID/RPC
: 0.00e0-fc0e-6554, 200200
RootPort ID
: 128.48
BPDU-Protection
: Disabled
TC or TCN received
: 2
Time since last TC
: 0 days 0h:5m:42s
# In MSTP mode, display the spanning tree status and statistics when the spanning tree feature is disabled. display stp Protocol status
: Disabled
Protocol Std.
: IEEE 802.1s
Version
: 3
Bridge-Prio.
: 32768
MAC address
: 000f-e200-8048
Max age(s)
: 20
Forward delay(s)
: 15
Hello time(s)
: 2
Max hops
: 20
TC Snooping
: Disabled
# In PVST mode, display the spanning tree status and statistics when the spanning tree feature is disabled. display stp Protocol status
: Disabled
Protocol Std.
: IEEE 802.1w (pvst)
Version
: 2
Bridge-Prio.
: 32768
MAC address
: 3822-d69f-0800
Max age(s)
: 20
Forward delay(s)
: 15
Hello time(s)
: 2
TC Snooping
: Disabled
Table 29 Command output Field
Description
Bridge ID
Bridge ID, which contains the device's priority and MAC address. For example, in output 32768.000f-e200-2200, the value preceding the dot is the device's priority. The value following the dot is the device's MAC address.
134
Field
Description Major parameters for the bridge:
Bridge times
• • • •
Hello—Hello timer. MaxAge—Maximum age timer. FwdDelay—Forward delay timer. MaxHops—Maximum hops within the MST region.
Root ID/ERPC
CIST root ID and external path cost (the path cost from the device to the CIST root).
RegRoot ID/IRPC
CIST regional root ID and internal path cost (the path cost from the device to the CIST regional root).
VlanRoot ID/RPC
VLAN root ID and root path cost (the path cost from the device to the VLAN root bridge).
RootPort ID
Root port ID. The value 0.0 indicates that the device is the root and there is no root port.
BPDU-Protection
Global status of the BPDU guard function.
Bridge ConfigDigest-Snooping
Global status of Digest Snooping.
TC or TCN received
Number of TC/TCN BPDUs received in the MSTI or VLAN.
Time since last TC
Time since the latest topology change in the MSTI or VLAN.
[FORWARDING]
The port is in forwarding state.
[DISCARDING]
The port is in discarding state.
[LEARNING]
The port is in learning state.
Port protocol
Status of the spanning tree feature on the port. Port role:
Port role
(Boundary)
Port cost(Legacy)
Desg.bridge/port
• • • • • •
Alternate. Backup. Root. Designated. Master. Disabled.
The port is a regional boundary port. Path cost of the port. The field in parentheses indicates the standard (legacy, dot1d-1998, or dot1t) used for port path cost calculation.
• Config—Configured value. • Active—Actual value. Designated bridge ID and port ID of the port. The port ID displayed is insignificant for a port which does not support port priority. The port is an edge port or non-edge port.
Port edged
• Config—Configured value. • Active—Actual value. The port is connected to a point-to-point link or not.
Point-to-Point
• Config—Configured value. • Active—Actual value. 135
Field
Description
Transmit limit
Number of BPDUs sent within each hello time. Protection type on the port:
Protection type
• • • •
ROOT—Root guard. LOOP—Loop guard. BPDU—BPDU guard. NONE—No protection.
TC-Restriction
Status of TC transmission restriction on the port.
Role-Restriction
Status of port role restriction on the port. Format of the MST BPDUs that the port can send:
MST BPDU format Port ConfigDigest-Snooping
• Config—Configured value (legacy or 802.1s). • Active—Actual value (legacy or 802.1s). Status of Digest Snooping on the port.
Rapid transition
Indicates whether the port rapidly transits to the forwarding state in the MSTI or VLAN.
Num of VLANs mapped
Number of VLANs that are mapped to the MSTI. Major parameters for the port:
Port times
• • • • •
Hello—Hello timer. MaxAge—Maximum age timer. FwdDelay—Forward delay timer. MsgAge—Message age timer. RemHops—Remaining hops.
BPDU sent
Statistics on sent BPDUs.
BPDU received
Statistics on received BPDUs.
RegRoot ID/IRPC
MSTI regional root/internal path cost. MSTI root type:
Root Type
• Primary root. • Secondary root.
Master bridge
MSTI root bridge ID.
Cost to master
Path cost from the MSTI to the master bridge.
TC received
Number of received TC BPDUs.
Protocol status
Spanning tree protocol status.
Protocol Std.
Spanning tree protocol standard.
Version
Spanning tree protocol version.
Bridge-Prio.
• In MSTP mode: Device's priority in the CIST. • In PVST mode: Device's priority in VLAN 1.
Max age(s)
Aging timer for BPDUs (in seconds, which is the same as the aging timer for VLAN 1 in PVST mode).
Forward delay(s)
Port state transition delay (in seconds, which is the same as the forward delay for VLAN 1 in PVST mode). 136
Field
Description
Hello time(s)
Interval for the root bridge to send BPDUs (in seconds, which is the same as the interval for VLAN 1 in PVST mode).
Max hops
Maximum hops in the MSTI.
TC Snooping
Status of TC Snooping, which can be Enabled or Disabled.
Related commands reset stp
display stp abnormal-port Use display stp abnormal-port to display information about ports that are blocked by spanning tree protection functions.
Syntax display stp abnormal-port
Views Any view
Predefined user roles network-admin network-operator
Examples # In MSTP mode, display information about ports that are blocked by spanning tree protection functions. display stp abnormal-port MST ID
Blocked Port
Reason
1
FortyGigE1/1/1
Root-Protected
2
FortyGigE1/1/2
Loop-Protected
12
FortyGigE1/1/3
Loopback-Protected
# In PVST mode, display information about ports that are blocked by spanning tree protection functions. system-view [Sysname] stp mode pvst [Sysname] display stp abnormal-port VLAN ID
Blocked Port
Reason
1
FortyGigE1/1/1
Root-Protected
2
FortyGigE1/1/2
Loop-Protected
2
FortyGigE1/1/3
Loopback-Protected
Table 30 Command output Field
Description
MST ID
MSTI of the blocked port.
VLAN ID
VLAN of the blocked port.
Blocked Port
Name of a blocked port.
137
Field
Description Reason that the port was blocked:
• Root-Protected—Root guard function. • Loop-Protected—Loop guard function. • Loopback-Protected—Self-loop protection. A port in the MSTI receives a BPDU that Reason
it sends.
• Disputed—Dispute protection. A port receives a low-priority BPDU from a non-blocked designated port.
• InconsistentPortType-Protected—Inconsistent port type protection. • InconsistentPvid-Protected—Inconsistent PVID protection.
display stp bpdu-statistics Use display stp bpdu-statistics to display the BPDU statistics on ports.
Syntax display stp bpdu-statistics [ interface interface-type interface-number [ instance instance-list ] ]
Views Any view
Predefined user roles network-admin network-operator
Parameters interface interface-type interface-number: Specifies an interface by its type and number. instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST.
Usage guidelines In MSTP mode, the command output is sorted by port name and by MSTI ID on each port. •
If you do not specify an MSTI or port, this command applies to all MSTIs on all ports.
•
If you specify a port but not an MSTI, this command applies to all MSTIs on the port.
•
If you specify both an MSTI ID and a port, this command applies to the specified MSTI on the port.
In STP, RSTP, or PVST mode, the command output is sorted by port name. •
If you do not specify a port, this command applies to all ports.
•
If you specify a port, this command applies to the port.
Examples # In MSTP mode, display the BPDU statistics for all MSTIs on FortyGigE 1/1/1. display stp bpdu-statistics interface fortygige 1/1/1 Port: FortyGigE1/1/1
Instance-Independent:
138
Type
Count
Last Updated
--------------------------- ---------- ----------------Invalid BPDUs
0
Looped-back BPDUs
0
Max-aged BPDUs
0
TCN sent
0
TCN received
0
TCA sent
0
TCA received
2
Config sent
0
Config received
0
RST sent
0
RST received
0
MST sent
4
10:33:11 01/13/2011
MST received
151
10:37:43 01/13/2011
Count
Last Updated
10:33:12 01/13/2011
Instance 0: Type
--------------------------- ---------- ----------------Timeout BPDUs
0
Max-hoped BPDUs
0
TC detected
1
10:32:40 01/13/2011
TC sent
3
10:33:11 01/13/2011
TC received
0
# In PVST mode, display the BPDU statistics for FortyGigE 1/1/1. system-view [Sysname] stp mode pvst [Sysname] display stp bpdu-statistics interface fortygige 1/1/1 Port: FortyGigE1/1/1 Type
Count
Last Updated
--------------------------- ---------- ----------------Invalid BPDUs
0
Looped-back BPDUs
0
Max-aged BPDUs
0
TCN sent
0
TCN received
0
TCA sent
0
TCA received
2
Config sent
0
Config received
0
RST sent
0
RST received
0
MST sent
4
10:33:11 01/13/2010
MST received
151
10:37:43 01/13/2010
Timeout BPDUs
0
Max-hoped BPDUs
0
10:33:12 01/13/2010
139
TC detected
511
10:32:40 01/13/2010
TC sent
8844
10:33:11 01/13/2010
TC received
1426
10:33:32 01/13/2010
Table 31 Command output Field
Description
Port
Port name.
Instance-Independent
Statistics not related to any particular MSTI.
Type
Statistical item.
Looped-back BPDUs
BPDUs sent and then received by the same port.
Max-aged BPDUs
BPDUs whose max age was exceeded.
TCN sent
TCN BPDUs sent.
TCN received
TCN BPDUs received.
TCA sent
TCA BPDUs sent.
TCA received
TCA BPDUs received.
Config sent
Configuration BPDUs sent.
Config received
Configuration BPDUs sent.
RST sent
Configuration BPDUs received.
RST received
RSTP BPDUs sent.
MST sent
RSTP BPDUs received.
MST received
MSTP BPDUs sent.
Instance
Statistical information for a particular MSTI.
Timeout BPDUs
Expired BPDUs.
Max-hoped BPDUs
BPDUs whose maximum hops were exceeded.
TC detected
TC BPDUs detected.
TC sent
TC BPDUs sent.
TC received
TC BPDUs received.
display stp down-port Use display stp down-port to display information about ports that were shut down by spanning tree protection functions.
Syntax display stp down-port
Views Any view
Predefined user roles network-admin network-operator 140
Examples # Display information about ports that were shut down by spanning tree protection functions. display stp down-port Down Port
Reason
FortyGigE1/1/1
BPDU-Protected
Table 32 Command output Field
Description
Down Port
Name of a port that was shut down by the spanning tree protection functions.
Reason
Reason that the port was shut down. BPDU-Protected indicates the BPDU guard function.
display stp history Use display stp history to display port role calculation history.
Syntax display stp [ instance instance-list | vlan vlan-id-list ] history [ slot slot-number ]
Views Any view
Predefined user roles network-admin network-operator
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. slot slot-number: Specifies an IRF member device by its member ID. If this option is not specified, this command applies to all member devices in the IRF fabric.
Usage guidelines In STP or RSTP mode, the output is sorted by port role calculation time. In PVST mode, the command output is sorted by VLAN ID and by port role calculation time in each VLAN. •
If you do not specify a VLAN, this command applies to all VLANs.
•
If you specify a VLAN list, this command applies to the specified VLANs.
In MSTP mode, the command output is sorted by MSTI ID and by port role calculation time in each MSTI. •
If you do not specify an MSTI, this command applies to all MSTIs.
•
If you specify an MSTI list, this command applies to the specified MSTIs. 141
Examples # In MSTP mode, display the port role calculation history for IRF member device 1 in MSTI 2. display stp instance 2 history slot 1 --------------- STP slot 1 history trace ---------------------------------
Instance 2
---------------------
Port FortyGigE1/1/1 Role change
: ROOT->DESI (Aged)
Time
: 2009/02/08 00:22:56
Port priority
: 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.1
Designated priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.1 Port FortyGigE1/1/2 Role change
: ALTER->ROOT
Time
: 2009/02/08 00:22:56
Port priority
: 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.2 128.153
Designated priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.2 128.153
# In PVST mode, display the port role calculation history for IRF member device 1 in VLAN 2. display stp vlan 2 history slot 1 --------------- STP slot 1 history trace ---------------------------------
VLAN 2
---------------------
Port FortyGigE1/1/1 Role change
: ROOT->DESI (Aged)
Time
: 2009/02/08 00:22:56
Port priority
: 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.1
Designated priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.1 Port FortyGigE1/1/2 Role change
: ALTER->ROOT
Time
: 2009/02/08 00:22:56
Port priority
: 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.2
Designated priority : 0.00e0-fc01-6510 0 0.00e0-fc01-6510 128.2
Table 33 Command output Field
Description
Port
Port name.
Role change
Role change of the port (Aged means that the change was caused by expiration of the received configuration BPDU).
Time
Time of port role calculation.
display stp region-configuration Use display stp region-configuration to display effective MST region configuration, including the following information: •
Region name.
•
Revision level. 142
User-configured VLAN-to-instance mappings.
•
Syntax display stp region-configuration
Views Any view
Predefined user roles network-admin network-operator
Examples # In MSTP mode, display effective MST region configuration. display stp region-configuration Oper Configuration Format selector
: 0
Region name
: hello
Revision level
: 0
Configuration digest : 0x5f762d9a46311effb7a488a3267fca9f Instance
VLANs Mapped
0
21 to 4094
1
1 to 10
2
11 to 20
Table 34 Command output Field
Description
Format selector
Format selector that is defined by the spanning tree protocol. The default value is 0, and the selector cannot be configured.
Region name
MST region name.
Revision level
Revision level of the MST region. The default value is 0, and the level can be configured by using the revision-level command.
VLANs Mapped
VLANs mapped to the MSTI.
Related commands •
instance
•
region-name
•
revision-level
•
vlan-mapping modulo
display stp root Use display stp root to display the root bridge information of spanning trees.
Syntax display stp root 143
Views Any view
Predefined user roles network-admin network-operator
Examples # In MSTP mode, display the root bridge information of all spanning trees. display stp root MST ID
Root Bridge ID
ExtPathCost IntPathCost Root Port
0
0.00e0-fc0e-6554
200200
0
FortyGigE1/1/1
# In PVST mode, display the root bridge information of all spanning trees. display stp root VLAN ID
Root Bridge ID
ExtPathCost IntPathCost Root Port
1
0.00e0-fc0e-6554
200200
0
FortyGigE1/1/1
Table 35 Command output Field
Description
ExtPathCost
External path cost. The device automatically calculates the default path cost of a port. Or, you can use the stp cost command to configure the path cost of a port.
IntPathCost
Internal path cost. The device automatically calculates the default path cost of a port. Or, you can use the stp cost command to configure the path cost of a port.
Root Port
Root port name (displayed only if a port of the device is the root port of MSTIs).
display stp tc Use display stp tc to display the incoming and outgoing TC/TCN BPDU statistics for ports.
Syntax display stp [ instance instance-list | vlan vlan-id-list ] tc [ slot slot-number ]
Views Any view
Predefined user roles network-admin network-operator
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. 144
slot slot-number: Specifies an IRF member device by its member ID. If this option is not specified, this command applies to all member devices in the IRF fabric.
Usage guidelines In STP or RSTP mode, the output is sorted by port name. In PVST mode, the command output is sorted by VLAN ID and by port name in each VLAN. •
If you do not specify a VLAN, this command applies to all VLANs.
•
If you specify a VLAN list, this command applies to the specified VLANs.
In MSTP mode, the command output is sorted by MSTI ID and by port name in each MSTI. •
If you do not specify an MSTI, this command applies to all MSTIs.
•
If you specify an MSTI list, this command applies to the specified MSTIs.
Examples # In MSTP mode, display the incoming and outgoing TC/TCN BPDU statistics for all ports on IRF member device 1 in MSTI 0. display stp instance 0 tc slot 1 -------------- STP slot 1 TC or TCN count ------------MST ID
Port
Receive
Send
0
FortyGigE1/1/1
6
4
0
FortyGigE1/1/2
0
2
# In PVST mode, display the incoming and outgoing TC/TCN BPDU statistics for all ports on IRF member device 1 in VLAN 2. display stp vlan 2 tc slot 1 -------------- STP slot 1 TC or TCN count ------------VLAN ID
Port
Receive
Send
2
FortyGigE1/1/1
6
4
2
FortyGigE1/1/2
0
2
Table 36 Command output Field
Description
Port
Port name.
Receive
Number of TC/TCN BPDUs received on each port.
Send
Number of TC/TCN BPDUs sent by each port.
instance Use instance to map a list of VLANs to an MSTI. Use undo instance to remap the specified VLAN or all VLANs to the CIST (MSTI 0).
Syntax instance instance-id vlan vlan-id-list undo instance instance-id [ vlan vlan-id-list ]
Default All VLANs are mapped to the CIST. 145
Views MST region view
Predefined user roles network-admin
Parameters instance-id: Specifies an MSTI ID in the range of 0 to 4094. A value of 0 represents the CIST. The value range for the instance-id argument is 1 to 4094 for the undo instance command. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094.
Usage guidelines CAUTION: Use caution with global Digest Snooping in the following situations: • When you modify the VLAN-to-instance mappings. • When you restore the default MST region configuration. If the local device has different VLAN-to-instance mappings than its neighboring devices, loops or traffic interruption will occur. If you specify no VLAN in the undo instance command, all VLANs mapped to the specified MSTI are remapped to the CIST. You cannot map the same VLAN to different MSTIs. If you map a VLAN that has been mapped to an MSTI to a new MSTI, the old mapping is automatically removed. You can configure VLAN-to-instance mapping for up to 65 MSTIs. After configuring this command, run the active region-configuration command to activate the VLAN-to-instance mapping.
Examples # Map VLAN 2 to MSTI 1. system-view [Sysname] stp region-configuration [Sysname-mst-region] instance 1 vlan 2
Related commands •
active region-configuration
•
check region-configuration
•
display stp region-configuration
region-name Use region-name to configure the MST region name. Use undo region-name to restore the default MST region name.
146
Syntax region-name name undo region-name
Default The MST region name of a device is its MAC address.
Views MST region view
Predefined user roles network-admin
Parameters name: Specifies the MST region name, a string of 1 to 32 characters.
Usage guidelines The MST region name, the VLAN-to-instance mapping table, and the MSTP revision level of a device determine the device's MST region. After configuring this command, run the active region-configuration command to activate the configured MST region name.
Examples # Set the MST region name of the device to hello. system-view [Sysname] stp region-configuration [Sysname-mst-region] region-name hello
Related commands •
active region-configuration
•
check region-configuration
•
display stp region-configuration
•
instance
•
revision-level
•
vlan-mapping modulo
reset stp Use reset stp to clear spanning tree statistics. The spanning tree statistics include the numbers of TCN BPDUs, configuration BPDUs, RST BPDUs, and MST BPDUs that are sent and received through the specified ports.
Syntax reset stp [ interface interface-list ]
Views User view
Predefined user roles network-admin 147
Parameters interface interface-list: Specifies a space-separated list of up to 10 interface items. Each item specifies an interface or a range of interfaces in the form of interface-type interface-number 1 [ to interface-type interface-number 2 ]. The interface number for interface-number 2 must be equal to or greater than the interface number for interface-number 1. If you don't specify this option, this command clears the spanning tree-related statistics information on all ports.
Examples # Clear the spanning tree statistics on ports FortyGigE 1/1/1 through FortyGigE 1/1/3. reset stp interface fortygige 1/1/1 to fortygige 1/1/3
Related commands display stp
revision-level Use revision-level to configure the MSTP revision level. Use undo revision-level to restore the default MSTP revision level.
Syntax revision-level level undo revision-level
Default The MSTP revision level is 0.
Views MST region view
Predefined user roles network-admin
Parameters level: Specifies an MSTP revision level in the range of 0 to 65535.
Usage guidelines The MSTP revision level, the MST region name, and the VLAN-to-instance mapping table of a device determine the device's MST region. After configuring this command, run the active region-configuration command to activate the configured MST region level.
Examples # Set the MSTP revision level of the MST region to 5. system-view [Sysname] stp region-configuration [Sysname-mst-region] revision-level 5
Related commands •
active region-configuration
•
check region-configuration 148
•
display stp region-configuration
•
instance
•
region-name
•
vlan-mapping modulo
stp bpdu-protection Use stp bpdu-protection to enable the BPDU guard function. Use undo stp bpdu-protection to disable the BPDU guard function.
Syntax stp bpdu-protection undo stp bpdu-protection
Default The BPDU guard function is disabled.
Views System view
Predefined user roles network-admin
Examples # Enable the BPDU guard function. system-view [Sysname] stp bpdu-protection
stp bridge-diameter Use stp bridge-diameter to specify the network diameter. Use undo stp bridge-diameter to restore the default.
Syntax stp [ vlan vlan-id-list ] bridge-diameter diameter undo stp [ vlan vlan-id-list ] bridge-diameter
Default The network diameter of the switched network is 7.
Views System view
Predefined user roles network-admin
Parameters vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater 149
than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. If you set the STP, RSTP, or MSTP switched network diameter, do not specify this option. diameter: Specifies the switched network diameter in the range of 2 to 7.
Usage guidelines The switched network diameter refers to the maximum number of devices on the path for an edge device to reach another through the root bridge. An appropriate setting of hello time, forward delay, and max age can speed up network convergence. The values of these timers are related to the network size, and you can set the timers by setting the network diameter. With the network diameter set to 7 (the default), the three timers are also set to their defaults. In STP, RSTP, or MSTP mode, each MST region is considered a device, and the configured network diameter of the switched network takes effect only on the CIST (or the common root bridge). In PVST mode, the configured network diameter takes effect only on the root bridges of the specified VLANs.
Examples # In MSTP mode, set the network diameter of the switched network to 5. system-view [Sysname] stp bridge-diameter 5
# In PVST mode, set the network diameter of VLAN 2 in the switched network to 5. system-view [Sysname] stp vlan 2 bridge-diameter 5
Related commands •
stp timer forward-delay
•
stp timer hello
•
stp timer max-age
stp compliance Use stp compliance to configure the mode that a port uses to recognize and send MSTP BPDUs. Use undo stp compliance to restore the default.
Syntax stp compliance { auto | dot1s | legacy } undo stp compliance
Default A port automatically recognizes the formats of received MSTP packets and determines the formats of MSTP packets to be sent based on the recognized formats.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
150
Parameters auto: Configures the port to recognize the MSTP BPDU format automatically and determine the format of MSTP BPDUs to send. dot1s: Configures the port to receive and send only standard-format (802.1s-compliant) MSTP BPDUs. legacy: Configures the port to receive and send only compatible-format MSTP BPDUs.
Usage guidelines When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Configure FortyGigE 1/1/1 to send only standard-format (802.1s) MSTP packets. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp compliance dot1s
stp config-digest-snooping Use stp config-digest-snooping to enable Digest Snooping. Use undo stp config-digest-snooping to disable Digest Snooping.
Syntax stp config-digest-snooping undo stp config-digest-snooping
Default The feature is disabled.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines Enable this feature both globally and on ports connected to other vendors' devices. To minimize impact, enable the feature on all associated ports before you enable it globally. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable Digest Snooping on FortyGigE 1/1/1 and then globally. 151
system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp config-digest-snooping [Sysname-FortyGigE1/1/1] quit [Sysname] stp global config-digest-snooping
Related commands •
display stp
•
stp global config-digest-snooping
stp cost Use stp cost to set the path cost of a port. Use undo stp cost to restore the default.
Syntax stp [ instance instance-list | vlan vlan-id-list ] cost cost undo stp [ instance instance-list | vlan vlan-id-list ] cost
Default The device automatically calculates the path costs of ports in each spanning tree based on the corresponding standard.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. cost: Specifies the path cost of the port, with an effective range that depends on the path cost calculation standard that is used. •
When the IEEE 802.1d-1998 standard is selected for path cost calculation, the value range for the cost argument is 1 to 65535.
•
When the IEEE 802.1t standard is selected for path cost calculation, the value range for the cost argument is 1 to 200000000.
•
When the private standard is selected for path cost calculation, the value range for the cost argument is 1 to 200000.
152
Usage guidelines Path cost is an important factor in spanning tree calculation. Setting different path costs for a port in MSTIs allows VLAN traffic flows to be forwarded along different physical links. This results in VLAN-based load balancing. The path cost setting of a port can affect the role selection of the port. When the path cost of a port is changed, the system calculates the role of the port and initiates a state transition. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, is takes effect only after the port leaves the aggregation group. If you do not specify an MSTI or VLAN, this command sets the path cost of the ports in the MSTP CIST or in the STP or RSTP spanning tree.
Examples # In MSTP mode, set the path cost of port FortyGigE 1/1/3 in MSTI 2 to 200. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] stp instance 2 cost 200
# In PVST mode, set the path cost of port FortyGigE 1/1/3 in VLAN 2 to 200. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] stp vlan 2 cost 200
Related commands •
display stp
•
stp pathcost-standard
stp edged-port Use stp edged-port to configure a port as an edge port. Use undo stp edged-port to configure a port as a non-edge port.
Syntax stp edged-port undo stp edged-port
Default All ports are non-edge ports.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
153
Usage guidelines A port directly connecting to a user terminal rather than another device or a shared LAN segment can be configured as an edge port. In case the network topology changes, an edge port does not cause a temporary loop. You can enable the port to transit to the forwarding state rapidly by configuring it as an edge port. HP recommends that you configure ports that directly connect to user terminals as edge ports. Typically, configuration BPDUs from other devices cannot reach an edge port, because the edge port does not connect to any other device. When BPDU guard is disabled, a port configured as an edge port functions as a non-edge port if it receives configuration BPDUs. On a port, the loop guard function and the edge port setting are mutually exclusive. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Configure FortyGigE 1/1/1 as an edge port. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp edged-port
Related commands •
stp bpdu-protection
•
stp loop-protection
•
stp root-protection
stp enable Use stp enable to enable the spanning tree feature. Use undo stp enable to disable the spanning tree feature.
Syntax stp enable undo stp enable
Default The spanning tree feature is enabled on all ports.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines When you enable the spanning tree feature, the device operates in STP, RSTP, PVST, or MSTP mode, depending on the spanning tree mode setting. 154
When you enable the spanning tree feature, the device dynamically maintains the spanning tree status of VLANs, based on received configuration BPDUs. When you disable the spanning tree feature, the device stops maintaining the spanning tree status. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # In MSTP mode, disable the spanning tree feature on port FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] undo stp enable
Related commands •
stp global enable
•
stp mode
•
stp vlan enable
stp global config-digest-snooping Use stp global config-digest-snooping to enable Digest Snooping globally. Use undo stp global config-digest-snooping to disable Digest Snooping globally.
Syntax stp global config-digest-snooping undo stp global config-digest-snooping
Default The feature is disabled globally.
Views System view
Predefined user roles network-admin
Usage guidelines Enable this feature both globally and on ports connected to other vendors' devices. To minimize impact, enable the feature on all associated ports before you enable it globally.
Examples # Enable Digest Snooping on FortyGigE 1/1/1 and then globally. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp config-digest-snooping [Sysname-FortyGigE1/1/1] quit
155
[Sysname] stp global config-digest-snooping
Related commands •
display stp
•
stp config-digest-snooping
stp global enable Use stp global enable to enable the spanning tree feature globally. Use undo stp global enable to disable the spanning tree feature globally.
Syntax stp global enable undo stp global enable
Default If the device starts up with the initial settings, the spanning tree feature is disabled globally. If the device starts up with the factory defaults, the spanning tree feature is enabled globally. For more information about the startup configuration, see Fundamentals Configuration Guide.
Views System view
Predefined user roles network-admin
Usage guidelines When you enable the spanning tree feature, the device operates in STP, RSTP, PVST, or MSTP mode, depending on the spanning tree mode setting. When the spanning tree feature is enabled, the device dynamically maintains the spanning tree status of VLANs based on received configuration BPDUs. When the spanning tree feature is disabled, the device stops maintaining the spanning tree status.
Examples # Enable the spanning tree feature globally. system-view [Sysname] stp global enable
Related commands •
stp enable
•
stp mode
stp global mcheck Use stp global mcheck to perform the mCheck operation globally.
Syntax stp global mcheck
156
Views System view
Predefined user roles network-admin
Usage guidelines When a port on an MSTP, RSTP, or PVST device connects to an STP device and receives STP BPDUs, the port automatically transits to the STP mode. However, the port cannot automatically transit back to the original mode when the following conditions exist: •
The peer STP device is shut down or removed.
•
The port cannot detect the change.
In this case, you can perform an mCheck operation to forcibly transit the port to operate in the original mode. The device operates in STP, RSTP, PVST, or MSTP mode, depending on the spanning tree mode setting. The stp global mcheck command takes effect only when the device operates in MSTP, RSTP, or PVST mode.
Examples # Perform mCheck globally. system-view [Sysname] stp global mcheck
Related commands •
stp mcheck
•
stp mode
stp loop-protection Use stp loop-protection to enable the loop guard function on a port. Use undo stp loop-protection to disable the loop guard function on a port.
Syntax stp loop-protection undo stp loop-protection
Default The loop guard function is disabled.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines On a port, the loop guard function is mutually exclusive with the root guard function or the edge port setting. 157
When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable the loop guard function on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp loop-protection
Related commands •
stp edged-port
•
stp root-protection
stp max-hops Use stp max-hops to set the maximum number of hops for an MST region. Use undo stp max-hops to restore the default.
Syntax stp max-hops hops undo stp max-hops
Default The maximum number of hops for an MST region is 20.
Views System view
Predefined user roles network-admin
Parameters hops: Sets the maximum hops in the range of 1 to 40.
Examples # Set the maximum hops of the MST region to 35. system-view [Sysname] stp max-hops 35
Related commands display stp
stp mcheck Use stp mcheck to perform the mCheck operation on a port.
158
Syntax stp mcheck
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines When a port on an MSTP, RSTP, or PVST device connects to an STP device and receives STP BPDUs, the port automatically transits to the STP mode. However, the port cannot automatically transit back to the original mode when the following conditions exist: •
The peer STP device is shut down or removed.
•
The port cannot detect the change.
In this case, you can perform an mCheck operation to forcibly transit the port to operation in the original mode. For example, Device A, Device B, and Device C are connected in sequence. Device A runs STP, Device B does not run any spanning tree protocol, and Device C runs RSTP, MSTP, or PVST. When Device C receives an STP BPDU transparently transmitted by Device B, the receiving port transits to the STP mode. If you configure Device B to run RSTP, MSTP, or PVST with Device C, perform mCheck operations on the ports that connect Device B and Device C. The device operates in STP, RSTP, PVST, or MSTP mode, depending on the spanning tree mode setting. The stp mcheck command takes effect only when the device operates in MSTP, RSTP, or PVST mode. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Perform mCheck on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp mcheck
Related commands •
stp global mcheck
•
stp mode
stp mode Use stp mode to configure the spanning tree operating mode. Use undo stp mode to restore the default.
Syntax stp mode { mstp | pvst | rstp | stp } 159
undo stp mode
Default A spanning tree device operates in MSTP mode.
Views System view
Predefined user roles network-admin
Parameters mstp: Configures the spanning tree device to operate in MSTP mode. pvst: Configures the spanning tree device to operate in PVST mode. rstp: Configures the spanning tree device to operate in RSTP mode. stp: Configures the spanning tree device to operate in STP mode.
Usage guidelines The MSTP mode is compatible with the RSTP mode, and the RSTP mode is compatible with the STP mode. The PVST mode's compatibility with other modes is as follows: •
Access port—The PVST mode is compatible with other modes in any VLAN.
•
Trunk or hybrid port—The PVST mode is compatible with other modes only in VLAN 1.
Examples # Configure the spanning tree device to operate in STP mode. system-view [Sysname] stp mode stp
Related commands •
stp enable
•
stp global enable
•
stp global mcheck
•
stp mcheck
•
stp vlan enable
stp no-agreement-check Use stp no-agreement-check to enable No Agreement Check on a port. Use undo stp no-agreement-check to disable No Agreement Check on a port.
Syntax stp no-agreement-check undo stp no-agreement-check
Default No Agreement Check is disabled.
160
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines This command takes effect only after you enable it on the root port. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable No Agreement Check on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp no-agreement-check
stp pathcost-standard Use stp pathcost-standard to specify a standard for the device to use when calculating the default path costs for ports. Use undo stp pathcost-standard to restore the default.
Syntax stp pathcost-standard { dot1d-1998 | dot1t | legacy } undo stp pathcost-standard
Default The devices uses the legacy standard to calculate the default path costs for ports.
Views System view
Predefined user roles network-admin
Parameters dot1d-1998: Configures the device to calculate the default path cost for ports based on IEEE 802.1d-1998. dot1t: Configures the device to calculate the default path cost for ports based on IEEE 802.1t. legacy: Configures the device to calculate the default path cost for ports based on a private standard.
Usage guidelines If you change the standard that the device uses in calculating the default path costs, you restore the path costs to the default. 161
Examples # Configure the device to calculate the default path cost for ports based on IEEE 802.1d-1998. system-view [Sysname] stp pathcost-standard dot1d-1998
Related commands •
display stp
•
stp cost
stp point-to-point Use stp point-to-point to configure the link type of a port. Use undo stp point-to-point to restore the default.
Syntax stp point-to-point { auto | force-false | force-true } undo stp point-to-point
Default The default setting is auto, and the spanning tree device automatically detects whether a port connects to a point-to-point link.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters auto: Specifies automatic detection of the link type. force-false: Specifies the non-point-to-point link type. force-true: Specifies the point-to-point link type.
Usage guidelines When connecting to a non-point-to-point link, a port is incapable of rapid state transition. You can configure the link type as point-to-point for a Layer 2 aggregate interface or a port that operates in full duplex mode. HP recommends that you use the default setting, which lets the device automatically detect the port link type. The stp point-to-point force-false or stp point-to-point force-true command configured on a port in MSTP mode takes effect on all MSTIs or VLANs. If the physical link to which the port connects is not a point-to-point link but you set it to be one, the configuration might cause a temporary loop. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group. 162
Examples # Configure the link that connects FortyGigE 1/1/3 as a point-to-point link. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] stp point-to-point force-true
Related commands display stp
stp port priority Use stp port priority to set the priority of a port. The port priority affects the role of a port in a spanning tree. Use undo stp port priority to restore the default.
Syntax stp [ instance instance-list | vlan vlan-id-list ] port priority priority undo stp [ instance instance-list | vlan vlan-id-list ] port priority
Default The port priority is 128.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. priority: Specifies the port priority in the range of 0 to 240 in increments of 16 (as in 0, 16, 32).
Usage guidelines The smaller the value, the higher the port priority. If all ports on your device use the same priority value, the port priority depends on the port index. The smaller the index, the higher the priority. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group. If you do not specify an MSTI or VLAN, this command configures the priority of the ports in the MSTP CIST or in the STP or RSTP spanning tree. 163
Examples # In MSTP mode, set the priority of port FortyGigE 1/1/3 to 16 in MSTI 2. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] stp instance 2 port priority 16
# In PVST mode, set the priority of port FortyGigE 1/1/3 to 16 in VLAN 2. system-view [Sysname] interface fortygige 1/1/3 [Sysname-FortyGigE1/1/3] stp vlan 2 port priority 16
Related commands display stp
stp port-log Use stp port-log to enable outputting port state transition information. Use undo stp port-log to disable outputting port state transition information.
Syntax stp port-log { all | instance instance-list | vlan vlan-id-list } undo stp port-log { all | instance instance-list | vlan vlan-id-list }
Default This function is disabled.
Views System view
Predefined user roles network-admin
Parameters all: Specifies all MSTIs or VLANs. instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094.
Examples # In MSTP mode, enable outputting port state transition information for MSTI 2. system-view [Sysname] stp port-log instance 2 %Aug 16 00:49:41:856 2011 Sysname STP/3/STP_DISCARDING: Instance 2's port FortyGigE1/1/1 has been set to discarding state. %Aug 16 00:49:41:856 2011 Sysname STP/3/STP_FORWARDING: Instance 2's port FortyGigE1/1/2 has been set to forwarding state.
164
The output shows that FortyGigE 1/1/1 in MSTI 2 transited to the discarding state and FortyGigE 1/1/2 in MSTI 2 transited to the forwarding state. # In PVST mode, enable outputting port state transition information for VLAN 1 through VLAN 4094. system-view [Sysname] stp port-log vlan 1 to 4094 %Aug 16 00:49:41:856 2006 Sysname STP/3/STP_DISCARDING: VLAN 2's FortyGigE1/1/1 has been set to discarding state! %Aug 16 00:49:41:856 2006 Sysname STP/3/STP_FORWARDING: VLAN 2's FortyGigE1/1/2 has been set to forwarding state.
The output shows that FortyGigE 1/1/1 in VLAN 2 transited to the discarding state and FortyGigE 1/1/2 in VLAN 2 transited to the forwarding state.
stp priority Use stp priority to set the priority of the device. Use undo stp priority to restore the default priority.
Syntax stp [ instance instance-list | vlan vlan-id-list ] priority priority undo stp [ instance instance-list | vlan vlan-id-list ] priority
Default The device priority is 32768.
Views System view
Predefined user roles network-admin
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. priority: Specifies the device priority in the range of 0 to 61440 in increments of 4096 (as in 0, 4096, 8192). You can set up to 16 priority values on the device. The smaller the value, the higher the device priority.
Usage guidelines If you do not specify an MSTI or VLAN, this command configures the priority of the device in the MSTP CIST or in the STP or RSTP spanning tree.
Examples # In MSTP mode, set the device priority to 4096 in MSTI 1. system-view
165
[Sysname] stp instance 1 priority 4096
# In PVST mode, set the device priority to 4096 in VLAN 1. system-view [Sysname] stp vlan 1 priority 4096
stp region-configuration Use stp region-configuration to enter MST region view. Use undo stp region-configuration to restore the default MST region configurations.
Syntax stp region-configuration undo stp region-configuration
Default The default settings for the MST region are as follows: •
The MST region name of the device is the MAC address of the device.
•
All VLANs are mapped to the CIST.
•
The MSTP revision level is 0.
Views System view
Predefined user roles network-admin
Usage guidelines After you enter MST region view, you can configure the MST region parameters, including the region name, VLAN-to-instance mappings, and revision level.
Examples # Enter MST region view. system-view [Sysname] stp region-configuration [Sysname-mst-region]
stp role-restriction Use stp role-restriction to enable port role restriction. Use undo stp role-restriction to disable port role restriction.
Syntax stp role-restriction undo stp role-restriction
Default Port role restriction is disabled.
166
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines When port role restriction is enabled on a port, the port cannot become a root port. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable port role restriction on interface FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp role-restriction
stp root primary Use stp root primary to configure the device as the root bridge. Use undo stp root to restore the default.
Syntax stp [ instance instance-list | vlan vlan-id-list ] root primary undo stp [ instance instance-list | vlan vlan-id-list ] root
Default A device is not a root bridge.
Views System view
Predefined user roles network-admin
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094.
Usage guidelines Once you specify the device as the root bridge, you cannot change the priority of the device. 167
If you do not specify an MSTI or VLAN, this command configures the device as the root bridge of the MSTP CIST or of the STP or RSTP spanning tree.
Examples # In MSTP mode, specify the device as the root bridge of MSTI 1. system-view [Sysname] stp instance 1 root primary
# In PVST mode, specify the device as the root bridge of VLAN 1. system-view [Sysname] stp vlan 1 root primary
Related commands •
stp priority
•
stp root secondary
stp root secondary Use stp root secondary to configure the device as a secondary root bridge. Use undo stp root to restore the default.
Syntax stp [ instance instance-list | vlan vlan-id-list ] root secondary undo stp [ instance instance-list | vlan vlan-id-list ] root
Default A device is not a secondary root bridge.
Views System view
Predefined user roles network-admin
Parameters instance instance-list: Specifies a space-separated list of up to 10 MSTI items. Each item specifies an MSTI or a range of MSTIs in the form of instance-id1 [ to instance-id2 ]. The value for instance-id2 must be equal to or greater than the value for instance-id1. The value range for the instance-id argument is 0 to 4094, and the value 0 represents the CIST. vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094.
Usage guidelines Once you specify the device as a secondary root bridge, you cannot change the priority of the device. If you do not specify an MSTI or VLAN, this command configures a secondary root bridge for the MSTP CIST or of the STP or RSTP spanning tree.
Examples # In MSTP mode, specify the device as a secondary root bridge in MSTI 1. 168
system-view [Sysname] stp instance 1 root secondary
# In PVST mode, specify the device as a secondary root bridge in VLAN 1. system-view [Sysname] stp vlan 1 root secondary
Related commands •
stp priority
•
stp root primary
stp root-protection Use stp root-protection to enable the root guard function on a port. Use undo stp root-protection to disable the root guard function on a port.
Syntax stp root-protection undo stp root-protection
Default The root guard function is disabled.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines On a port, the loop guard function and the root guard function are mutually exclusive. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable the root guard function for FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp root-protection
Related commands •
stp edged-port
•
stp loop-protection
169
stp tc-protection Use stp tc-protection to enable the TC-BPDU attack guard function for the device. Use undo stp tc-protection to disable the TC-BPDU attack guard function for the device.
Syntax stp tc-protection undo stp tc-protection
Default The TC-BPDU attack guard function is enabled.
Views System view
Predefined user roles network-admin
Usage guidelines With TC-BPDU guard, you can set the maximum number of immediate forwarding address entry flushes that the device can perform every 10 seconds. For TC-BPDUs received that exceed the limit, the device performs a forwarding address entry flush when the interval elapses. This prevents frequent flushing of forwarding address entries.
Examples # Disable the TC-BPDU attack guard function for the device. system-view [Sysname] undo stp tc-protection
Related commands stp tc-protection threshold
stp tc-protection threshold Use stp tc-protection threshold to set the maximum number of forwarding address entry flushes that the device can perform every 10 seconds. Use undo stp tc-protection threshold to restore the default.
Syntax stp tc-protection threshold number undo stp tc-protection threshold
Default By default, the device can perform a maximum of six forwarding address entry flushes every 10 seconds.
Views System view
Predefined user roles network-admin 170
Parameters number: Sets the maximum number of immediate forwarding address entry flushes that the device can perform every 10 seconds. The value is in the range of 1 to 255.
Examples # Configure the device to perform up to 10 forwarding address entry flushes every 10 seconds. system-view [Sysname] stp tc-protection threshold 10
Related commands stp tc-protection
stp tc-restriction Use stp tc-restriction to enable TC-BPDU transmission restriction. Use undo stp tc-restriction to disable TC-BPDU transmission restriction.
Syntax stp tc-restriction undo stp tc-restriction
Default TC-BPDU transmission restriction is disabled.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Usage guidelines When TC-BPDU transmission restriction is enabled on a port, the port does not send TC-BPDUs to the other ports. It also does not delete the MAC address entries. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Enable TC-BPDU transmission restriction on FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp tc-restriction
stp tc-snooping Use stp tc-snooping to enable TC Snooping. 171
Use undo stp tc-snooping to disable TC Snooping.
Syntax stp tc-snooping undo stp tc-snooping
Default TC Snooping is disabled.
Views System view
Predefined user roles network-admin
Usage guidelines TC Snooping and the spanning tree feature are mutually exclusive. You must globally disable the spanning tree feature before enabling TC Snooping.
Examples # Globally disable the spanning tree feature and enable TC Snooping. system-view [Sysname] undo stp global enable [Sysname] stp tc-snooping
Related commands stp global enable
stp timer forward-delay Use stp timer forward-delay to set the forward delay timer. Use undo stp timer forward-delay to restore the default.
Syntax stp [ vlan vlan-id-list ] timer forward-delay time undo stp [ vlan vlan-id-list ] timer forward-delay
Default The forward delay timer is 1500 centiseconds.
Views System view
Predefined user roles network-admin
Parameters vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. If you set the STP, RSTP, or MSTP forward delay, do not specify this option. 172
time: Sets the forward delay in centiseconds, in the range of 400 to 3000 in increments of 100 (as in 400, 500, 600).
Usage guidelines The forward delay timer determines the time interval of state transition. To prevent temporary loops, a spanning tree port goes through the learning (intermediate) state before it transits from the discarding state to the forwarding state. To stay synchronized with the remote device, the port has a wait period between transition states that is determined by the forward delay timer. HP recommends not setting the forward delay with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command. This command makes the spanning tree protocols automatically calculate the optimal settings for the forward delay timer. If the network diameter uses the default value, the forward delay timer also uses the default value.
Examples # In MSTP mode, set the forward delay timer to 2000 centiseconds. system-view [Sysname] stp timer forward-delay 2000
# In PVST mode, set the forward delay timer for VLAN 2 to 2000 centiseconds. system-view [Sysname] stp vlan 2 timer forward-delay 2000
Related commands •
stp bridge-diameter
•
stp timer hello
•
stp timer max-age
stp timer hello Use stp timer hello to set the hello time. Use undo stp timer hello to restore the default.
Syntax stp [ vlan vlan-id-list ] timer hello time undo stp [ vlan vlan-id-list ] timer hello
Default The hello time is 200 centiseconds.
Views System view
Predefined user roles network-admin
Parameters vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. If you set the STP, RSTP, or MSTP hello time, do not specify this option. 173
time: Sets the hello time in centiseconds, in the range of 100 to 1000 in increments of 100 (as in 100, 200, 300).
Usage guidelines Hello time is the time interval at which spanning tree devices send configuration BPDUs to maintain the spanning tree. If a device fails to receive configuration BPDUs within the set period of time, a new spanning tree calculation process is triggered. HP recommends not setting the hello time with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command. This command makes the spanning tree protocols automatically calculate the optimal settings for the hello timer. If the network diameter uses the default value, the hello timer also uses the default value.
Examples # In MSTP mode, set the hello time to 400 centiseconds. system-view [Sysname] stp timer hello 400
# In PVST mode, set the hello time for VLAN 2 to 400 centiseconds. system-view [Sysname] stp vlan 2 timer hello 400
Related commands •
stp bridge-diameter
•
stp timer forward-delay
•
stp timer max-age
stp timer max-age Use stp timer max-age to set the max age timer of the device. Use undo stp timer max-age to restore the default.
Syntax stp [ vlan vlan-id-list ] timer max-age time undo stp [ vlan vlan-id-list ] timer max-age
Default The max age is 2000 centiseconds.
Views System view
Predefined user roles network-admin
Parameters vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. If you set the STP, RSTP, or MSTP max age, do not specify this option.
174
time: Sets the max age in centiseconds in the range of 600 to 4000 in increments of 100 (as in 600, 700, 800).
Usage guidelines In the CIST of an MSTP network, the device determines whether a configuration BPDU received on a port has expired based on the max age timer. If the configuration BPDU has expired, a new spanning tree calculation process starts. The max age timer takes effect only on the CIST (or MSTI 0). HP recommends not setting the max age timer with this command. Instead, you can specify the network diameter of the switched network by using the stp bridge-diameter command. This command makes the spanning tree protocols automatically calculate the optimal settings for the max age timer. If the network diameter uses the default value, the max age timer also uses the default value.
Examples # In MSTP mode, set the max age timer to 1000 centiseconds. system-view [Sysname] stp timer max-age 1000
# In PVST mode, set the max age timer for VLAN 2 to 1000 centiseconds. system-view [Sysname] stp vlan 2 timer max-age 1000
Related commands •
stp bridge-diameter
•
stp timer forward-delay
•
stp timer hello
stp timer-factor Use stp timer-factor to set the timeout period by setting the timeout factor. Timeout period = timeout factor × 3 × hello time. Use undo stp timer-factor to restore the default.
Syntax stp timer-factor factor undo stp timer-factor
Default The timeout factor of a device is set to 3.
Views System view
Predefined user roles network-admin
Parameters factor: Sets the timeout factor in the range of 1 to 20.
175
Usage guidelines In a stable network, each non-root-bridge forwards configuration BPDUs to surrounding devices at the interval of hello time to determine whether any link fails. If a device does not receive a BPDU from the upstream device within nine times of the hello time, it assumes that the upstream device has failed. Then it will start a new spanning tree calculation process. An upstream device might be too busy to forward configuration BPDUs in time, for example, many Layer 2 interfaces are configured on the upstream device. As a result, the downstream device fails to receive a BPDU within the timeout period and then starts an undesired spanning tree calculation. The calculation might fail, and it also wastes network resources. To prevent undesired spanning tree calculation and save network resources on a stable network, you can set the timeout factor to 5, 6, or 7.
Examples # Set the timeout factor of the device to 7. system-view [Sysname] stp timer-factor 7
Related commands stp timer hello
stp transmit-limit Use stp transmit-limit to set the BPDU transmission rate of a port. Use undo stp transmit-limit to restore the default.
Syntax stp transmit-limit limit undo stp transmit-limit
Default The BPDU transmission rate of all ports is 10. Each port can send 10 BPDUs within each hello time.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view
Predefined user roles network-admin
Parameters limit: Sets the BPDU transmission rate in the range of 1 to 255.
Usage guidelines The maximum number of BPDUs a port can send within each hello time equals the BPDU transmission rate plus the hello timer value. A larger BPDU transmission rate value requires more system resources. An appropriate BPDU transmission rate setting can prevent spanning tree protocols from using excessive bandwidth resources during network topology changes. HP recommends that you use the default value. When the setting is configured in Layer 2 Ethernet interface view, it takes effect only on that interface. When the setting is configured in Layer 2 aggregate interface view, it takes effect only on the aggregate interface. 176
When the setting is configured on a member port in an aggregation group, it takes effect only after the port leaves the aggregation group.
Examples # Set the BPDU transmission rate of port FortyGigE 1/1/1 to 5. system-view [Sysname] interface fortygige 1/1/1 [Sysname-FortyGigE1/1/1] stp transmit-limit 5
stp vlan enable Use stp vlan enable to enable the spanning tree feature for VLANs. Use undo stp enable to disable the spanning tree feature for VLANs.
Syntax stp vlan vlan-id-list enable undo stp vlan vlan-id-list enable
Default The spanning tree feature is enabled for all VLANs.
Views System view
Predefined user roles network-admin
Parameters vlan vlan-id-list: Specifies a space-separated list of up to 10 VLAN items. Each item specifies a VLAN or a range of VLANs in the form of vlan-id1 [ to vlan-id2 ]. The value for vlan-id2 must be equal to or greater than the value for vlan-id1. The value range for the vlan-id argument is 1 to 4094. If you do not specify this option, the command globally enables or disables the spanning tree feature (VLANs are not included).
Usage guidelines When you enable the spanning tree feature, the device operates in STP, RSTP, PVST, or MSTP mode, depending on the spanning tree mode setting. When you enable the spanning tree feature, the device dynamically maintains the spanning tree status of VLANs, based on received configuration BPDUs. When you disable the spanning tree feature, the device stops maintaining the spanning tree status.
Examples # In PVST mode, globally enable the spanning tree feature, and enable the spanning tree feature in VLAN 2. system-view [Sysname] stp mode pvst [Sysname] stp global enable [Sysname] stp vlan 2 enable
Related commands •
stp enable 177
•
stp global enable
•
stp mode
vlan-mapping modulo Use vlan-mapping modulo to map VLANs in the MST region to MSTIs according to the specified modulo value and quickly create a VLAN-to-instance mapping table.
Syntax vlan-mapping modulo modulo
Default All VLANs are mapped to the CIST (MSTI 0).
Views MST region view
Predefined user roles network-admin
Parameters modulo: Sets the modulo value in the range of 1 to 64.
Usage guidelines You cannot map a VLAN to different MSTIs. If you map a VLAN that has been mapped to an MSTI to a new MSTI, the old mapping is automatically removed. This command maps each VLAN to the MSTI with ID (VLAN ID – 1) % modulo + 1. (VLAN ID – 1) % modulo is the modulo operation for (VLAN ID – 1). If the modulo value is 15, then VLAN 1 is mapped to MSTI 1, VLAN 2 to MSTI 2, …, VLAN 15 to MSTI 15, VLAN 16 to MSTI 16, and so on.
Examples # Map VLANs to MSTIs as per modulo 8. system-view [Sysname] stp region-configuration [Sysname-mst-region] vlan-mapping modulo 8
Related commands •
active region-configuration
•
check region-configuration
•
display stp region-configuration
•
region-name
•
revision-level
178
Loop detection commands display loopback-detection Use display loopback-detection to display the loop detection configuration and status.
Syntax display loopback-detection
Views Any view
Predefined user roles network-admin network-operator
Example # Display the loop detection configuration and status. display loopback-detection Loopback detection is enabled. Loopback detection interval is 30 second(s). Loopback is detected on following interfaces: Interface
Action mode
FortyGigE1/1/1
Block
FortyGigE1/1/2
Shutdown
FortyGigE1/1/3
None
FortyGigE1/1/4
No-learning
Table 37 Command output Field
Description Loop protection action:
• Block—When a loop is detected on a port, the device generates a log,
disables the port from learning MAC addresses, and blocks inbound traffic on the port.
• None—When a loop is detected on a port, the device generates a log but performs no action on the port.
Action mode
• No-learning—When a loop is detected on a port, the device generates a log and disables the port from learning MAC addresses.
• Shutdown—When a loop is detected on a port, the device generates a log and shuts down the port to disable it from receiving and sending any frames. The device automatically brings up the port after the detection timer expires. You can use the shutdown-interval command to set the detection timer. For more information, see Fundamentals Command Reference.
179
loopback-detection action Use loopback-detection action to configure the loop protection action on a port. Use undo loopback-detection action to restore the default.
Syntax In Layer 2 Ethernet interface view or S-channel interface view: loopback-detection action { block | no-learning | shutdown } undo loopback-detection action In Layer 2 aggregate interface view, S-channel aggregate interface view, or S-channel bundle interface view: loopback-detection action shutdown undo loopback-detection action
Default When the device detects a loop on a port, it generates a log but performs no action on the port.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view S-channel interface view, S-channel aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters block: Enables the block mode. If a loop is detected, the device disables MAC address learning and blocks inbound traffic on the port, in addition to generating a log. Layer 2 aggregate interfaces do not support this keyword. no-learning: Enables the no-learning mode. If a loop is detected, the device generates a log and disables MAC address learning on the port. Layer 2 aggregate interfaces do not support this keyword. shutdown: Enables the shutdown mode. If a loop is detected, the device generates a log and shuts down the port. The device automatically brings up the port after the detection timer expires. You can use the shutdown-interval command to set the detection timer. For more information, see Fundamentals Command Reference.
Usage guidelines To configure the loop protection action globally, use the loopback-detection global action command. The global configuration applies to all ports. The per-port configuration applies to the individual ports. The per-port configuration takes precedence over the global configuration.
Example # Set the loop protection action to shutdown on port FortyGigE 1/1/1. system-view [Sysname] interface fortygige 1/1/1 [System-FortyGigE1/1/1] loopback-detection action shutdown
180
Related commands •
display loopback-detection
•
loopback-detection global action
loopback-detection enable Use loopback-detection enable to enable loop detection on a port. Use undo loopback-detection enable to disable loop detection on a port.
Syntax loopback-detection enable vlan { vlan-list | all } undo loopback-detection enable vlan { vlan-list | all }
Default The loop detection function is disabled on ports.
Views Layer 2 Ethernet interface view, Layer 2 aggregate interface view S-channel interface view, S-channel aggregate interface view, S-channel bundle interface view
Predefined user roles network-admin
Parameters vlan-list: Specifies a VLAN list, in the format of { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id represents the VLAN ID in the range of 1 to 4094, and &<1-10> indicates that you can specify up to 10 vlan-id [ to vlan-id ] parameters. all: Specifies all existing VLANs.
Usage guidelines The port-specific loop detection configuration takes effect only after you enable loop detection globally. To enable loop detection globally, use the loopback-detection global enable command. The global configuration applies to all ports in the specified VLAN. The per-port configuration applies to the individual port only when the port belongs to the specified VLAN. The per-port configuration takes precedence over the global configuration.
Example # Enable loop detection on port FortyGigE 1/1/1 for VLAN 10 through VLAN 20. system-view [Sysname] interface fortygige 1/1/1 [System-FortyGigE1/1/1] loopback-detection enable vlan 10 to 20
Related commands •
display loopback-detection
•
loopback-detection global enable
181
loopback-detection global action Use loopback-detection global action to configure the global loop protection action. Use undo loopback-detection global action to restore the default.
Syntax loopback-detection global action shutdown undo loopback-detection global action
Default When the device detects a loop on a port, it generates a log but performs no action on the port.
Views System view
Predefined user roles network-admin
Parameters shutdown: Enables the shutdown mode. If a loop is detected, the device generates a log and shuts down the port. The device automatically brings up the port after the detection timer expires. You can use the shutdown-interval command to set the detection timer. For more information, see Fundamentals Command Reference.
Usage guidelines To configure the loop protection action on a per-port basis, use the loopback-detection action command in interface view. The global configuration applies to all ports. The per-port configuration applies to the individual ports. The per-port configuration takes precedence over the global configuration.
Example # Set the global loop protection action to shutdown. system-view [System] loopback-detection global action shutdown
Related commands •
display loopback-detection
•
loopback-detection action
loopback-detection global enable Use loopback-detection global enable to enable loop detection globally. Use undo loopback-detection global enable to disable loop detection globally.
Syntax loopback-detection global enable vlan { vlan-list | all } undo loopback-detection global enable vlan { vlan-list | all }
182
Default The loop detection function is globally disabled.
Views System view
Predefined user roles network-admin
Parameters vlan-list: Specifies a VLAN list, in the format of { vlan-id [ to vlan-id ] }&<1-10>, where vlan-id represents the VLAN ID in the range of 1 to 4094, and &<1-10> indicates that you can specify up to 10 vlan-id [ to vlan-id ] parameters. all: Specifies all existing VLANs.
Usage guidelines To enable loop detection on a per-port basis, use the loopback-detection enable command in interface view. The global configuration applies to all ports in the specified VLAN. The per-port configuration applies to the individual port only when the port belongs to the specified VLAN. The per-port configuration takes precedence over the global configuration.
Example # Globally enable loop detection for VLAN 10 through VLAN 20. system-view [System] loopback-detection global enable vlan 10 to 20
Related commands •
display loopback-detection
•
loopback-detection enable
loopback-detection interval-time Use loopback-detection interval-time to set the loop detection interval. Use undo loopback-detection interval-time to restore the default.
Syntax loopback-detection interval-time interval undo loopback-detection interval-time
Default The loop detection interval is 30 seconds.
Views System view
Predefined user roles network-admin
183
Parameters interval: Sets the loop detection interval in the range of 1 to 300 seconds.
Usage guidelines With loop detection enabled, the device sends loop detection frames at the specified interval. A shorter interval offers more sensitive detection but consumes more resources. Consider the system performance and loop detection speed when you set the loop detection interval.
Example # Set the loop detection interval to 10 seconds. system-view [Sysname] loopback-detection interval-time 10
Related commands display loopback-detection
184
VLAN commands Basic VLAN commands bandwidth Use bandwidth to configure the expected bandwidth of an interface. Use undo bandwidth to restore the default.
Syntax bandwidth bandwidth-value undo bandwidth
Default The expected bandwidth (in kbps) is the interface baud rate divided by 1000.
Views VLAN interface view
Predefined user roles network-admin
Parameters bandwidth-value: Specifies the expected bandwidth in the range of 1 to 400000000 kbps.
Usage guidelines The expected bandwidth of an interface affects the link costs in OSPF, OSPFv3, and IS-IS. For more information, see Layer 3—IP Routing Configuration Guide.
Examples # Set the expected bandwidth of VLAN-interface 1 to 10000 kbps. system-view [Sysname] interface vlan-interface 1 [Sysname-Vlan-interface1] bandwidth 10000
default Use default to restore the default settings for a VLAN interface.
Syntax default
Views VLAN interface view
185
Predefined user roles network-admin
Usage guidelines CAUTION: The default command might interrupt ongoing network services. Make sure you are fully aware of the impact of this command when you use it on a live network. This command might fail to restore the default settings for some commands for reasons such as command dependencies or system restrictions. Use the display this command in interface view to identify these commands, and then use their undo forms or follow the command reference to restore their default settings. If your restoration attempt still fails, follow the error message instructions to resolve the problem.
Examples # Restore the default settings for VLAN-interface 1. system-view [Sysname] interface vlan-interface 1 [Sysname-Vlan-interface1] default
description Use description to configure the description for a VLAN or VLAN interface. Use undo description to restore the default.
Syntax description text undo description
Default For a VLAN, the description is VLAN vlan-id. The vlan-id argument specifies the VLAN ID in a four-digit format. If the VLAN ID has fewer than four digits, leading zeros are added. For example, the default description of VLAN 100 is VLAN 0100. For a VLAN interface, the description is the name of the interface. For example, Vlan-interface1 Interface.
Views VLAN view, VLAN interface view
Predefined user roles network-admin
Parameters text: Specifies a description for a VLAN or VLAN interface, a string of 1 to 255 characters. The string can include case-sensitive letters, digits, special symbols (see Table 38), spaces, and other Unicode characters and symbols. Table 38 Special symbols Name
Symbol
Name
Symbol
Tilde
~
Left angle bracket
<
186
Name
Symbol
Name
Symbol
Exclamation point
!
Right angle bracket
>
At sign
@
Hyphen
-
Pound sign
#
Underscore
_
Dollar sign
$
Plus sign
+
Percent sign
%
Equal sign
=
Caret
^
Vertical bar
|
Ampersand sign
&
Back slash
\
Asterisk
*
Colon
:
Left brace
{
Semi-colon
;
Right brace
}
Quotation marks
"
Left parenthesis
(
Apostrophe
'
Right parenthesis
)
Comma
,
Left bracket
[
Dot
.
Right bracket
]
Slash
/
Usage guidelines You can configure a description to describe the function or connection of a VLAN or VLAN interface. The descriptions are helpful when a large number of VLANs and VLAN interfaces are created on the device.
Examples # Configure the description of VLAN 2 as sales-private. system-view [Sysname] vlan 2 [Sysname-vlan2] description sales-private
# Configure the description of VLAN-interface 2 as linktoPC56. system-view [Sysname] vlan 2 [Sysname-vlan2] quit [Sysname] interface vlan-interface 2 [Sysname-Vlan-interface2] description linktoPC56
Related commands •
display interface vlan-interface
•
display vlan
display interface vlan-interface Use display interface vlan-interface to display VLAN interface information.
Syntax display interface vlan-interface [ brief [ description | down ] ] display interface vlan-interface interface-number [ brief [ description ] ] 187
Views Any view
Predefined user roles network-admin network-operator
Parameters interface-number: Specifies a VLAN interface number. If you do not specify this argument, the command displays information about all VLAN interfaces. brief: Displays brief interface information. If you do not specify this keyword, the command displays detailed interface information. down: Displays interfaces in a down state and their down causes. If you do not specify this keyword, the command displays information about VLAN interfaces in all states. description: Displays complete interface descriptions. If you do not specify this keyword, the command displays only the first 27 characters of each interface description.
Examples # Display information for VLAN-interface 10. display interface vlan-interface 10 Vlan-interface10 Current state: UP Line protocol state: UP Description: Vlan-interface10 Interface Bandwidth: 100000kbps Maximum Transmit Unit: 1500 Internet Address is 192.168.1.54/24 Primary IP Packet Frame Type:PKTFMT_ETHNT_2,
Hardware Address: 0023-89b6-d613
IPv6 Packet Frame Type:PKTFMT_ETHNT_2,
Hardware Address: 0023-89b6-d613
Last clearing of counters: Never
# Display brief information for VLAN-interface 2. display interface vlan-interface 2 brief Brief information on interface(s) under route mode: Link: ADM - administratively down; Stby - standby Protocol: (s) - spoofing Interface
Link Protocol Main IP
Vlan2
DOWN DOWN
--
Table 39 Command output Field
Description
Vlan-interface2
VLAN interface name.
188
Description
Field
Description Physical state of a VLAN interface:
• DOWN (Administratively)—The administrative state of the
VLAN interface is down, because it has been shut down by using the shutdown command.
Current state
• DOWN—The administrative state of the VLAN interface is up,
but its physical state is down. The VLAN of this VLAN interface does not contain any physical ports in up state. The ports might not be well connected correctly or the lines might have failed.
• UP—Both the administrative state and the physical state of the VLAN interface are up.
Link layer protocol state of a VLAN interface: Line protocol state
• DOWN—The link layer protocol state of the VLAN interface is down.
• UP—The link layer protocol state of the VLAN interface is up. Partial or complete interface description configured by using the description command:
• If you do not specify the description keyword in the display Description
interface brief command, this field displays only the first 27 characters of the interface description.
• If you specify the description keyword in the display interface brief command, this field displays the complete interface description.
Bandwidth
Expected bandwidth of a VLAN interface.
Maximum Transmit Unit
MTU of a VLAN interface.
Internet protocol processing : disabled
The interface cannot process IP packets. This information is displayed when the interface is not configured with an IP address.
Internet Address is 192.168.1.54/24 Primary
The primary IP address of the interface is 192.168.1.54/24. This information is displayed only when the primary IP address is configured for the interface.
P Packet Frame Type
Framing format of sent IPv4 packets.
Hardware Address
MAC address of the VLAN interface.
IPv6 Packet Frame Type
Framing format of sent IPv6 packets.
Brief information on interface(s) under route mode
Brief information about Layer 3 interfaces. Link layer state of the interface:
Link: ADM - administratively down; Stby – standby
• ADM—The interface has been administratively shut down. To bring up the interface, use the undo shutdown command.
• Stby—The interface is operating as a backup interface.
Protocol: (s) - spoofing
Interface
The protocol attribute of an interface includes the spoofing flag (the letter s in parentheses) when the following conditions exist:
• The data link layer protocol state of an interface is shown as UP. • Its link is an on-demand link or is not present. Abbreviated interface name.
189
Field
Description Physical link state of the interface:
Link
• UP—The physical link of the interface is up. • DOWN—The physical link of the interface is down. • ADM—The interface has been administratively shut down. To bring up the interface, use the undo shutdown command.
• Stby—The interface is operating as a backup interface. Data link layer state of the interface:
Protocol
• UP—The data link layer of the interface is up. • DOWN—The data link layer of the interface is down. • UP(s)—The data link layer of the interface is spoofing up. This state is available for on-demand link setup applications. This state enables the device to initiate an on-demand link setup when a link is not present.
Main IP
Primary IP address of the interface.
display vlan Use display vlan to display VLAN information.
Syntax display vlan [ vlan-id1 [ to vlan-id2 ] | all | dynamic | reserved | static ]
Views Any view
Predefined user roles network-admin network-operator
Parameters vlan-id1: Specifies a VLAN by its ID in the range of 1 to 4094. vlan-id1 to vlan-id2: Specifies a VLAN ID range. Both the vlan-id1 and the vlan-id2 arguments are in the range of 1 to 4094. The value for the vlan-id2 argument must be equal to or greater than the value for the vlan-id1 argument. all: Specifies all VLANs except the reserved VLANs. dynamic: Specifies dynamic VLANs. If you specify this keyword, the command displays the number of dynamic VLANs and the ID for each dynamic VLAN. The dynamic VLANs are generated through MVRP. reserved: Specifies reserved VLANs. Protocol modules determine which VLANs are reserved according to function implementation. The reserved VLANs provide services for protocol modules. You cannot configure reserved VLANs. static: Specifies static VLANs. If you specify this keyword, the command displays the number of static VLANs and the ID for each static VLAN. The static VLANs are manually created.
Examples # Display VLAN 2 information. 190
display vlan 2 VLAN ID: 2 VLAN type: Static Route interface: Not configured Description: VLAN 0002 Name: VLAN 0002 Tagged ports:
None
Untagged ports: FortyGigE1/1/1
FortyGigE1/1/2
FortyGigE1/1/3
# Display VLAN 3 information. display vlan 3 VLAN ID: 3 VLAN type: static Route interface: Configured IPv4 address: 1.1.1.1 IPv4 subnet mask: 255.255.255.0 Description: VLAN 0003 Name: VLAN 0003 Tagged ports:
None
Untagged ports: None
Table 40 Command output Field
Description
VLAN type
VLAN type, static or dynamic. Whether the VLAN interface is configured for the VLAN.
Route interface
• Not configured. • Configured.
Description
Description of the VLAN.
Name
VLAN name. Primary IPv4 address of the VLAN interface. This field is displayed only when an IPv4 address is configured for the VLAN interface.
IPv4 address
When the VLAN interface is also configured with secondary IPv4 addresses, you can view them by using one of the following commands:
• display interface vlan-interface. • display this (VLAN interface view). IPv4 subnet mask
Subnet mask of the primary IP address. This field is available only when an IP address is configured for the VLAN interface.
Tagged ports
Tagged members of the VLAN.
Untagged ports
Untagged members of the VLAN.
Related commands vlan
191
display vlan brief Use display vlan brief to display brief VLAN information.
Syntax display vlan brief
Views Any view
Predefined user roles network-admin network-operator
Examples # Display brief VLAN information. display vlan brief Brief information about all VLANs: Supported Minimum VLAN ID: 1 Supported Maximum VLAN ID: 4094 Default VLAN ID: 1 VLAN ID
Name
Port
1
VLAN 0001
FGE1/1/1
FGE1/1/2
FGE1/1/4
XGE1/1/17
XGE1/1/19
2
VLAN 0002
3
VLAN 0003
XGE1/1/18
XGE1/1/20
XGE1/1/6
XGE1/1/7
XGE1/1/9
XGE1/1/10
XGE1/1/12
FGE1/1/3
XGE1/1/5
XGE1/1/8 XGE1/1/11
TGE1/0/1
TGE1/0/2
TGE1/0/3
TGE1/0/4
TGE1/0/5
TGE1/0/6
TGE1/0/7
TGE1/0/8
TGE1/0/9
TGE1/0/10
TGE1/0/12
TGE1/0/13
TGE1/0/15
TGE1/0/16
TGE1/0/11 TGE1/0/14
Table 41 Command output Field
Description
Default VLAN ID
System default VLAN ID.
Name
VLAN name.
Port
Port that allows packets from the VLAN to pass through.
interface vlan-interface Use interface vlan-interface to create a VLAN interface and enter its view or to enter the view of an existing VLAN interface. 192
Use undo interface vlan-interface to delete the specified VLAN interface.
Syntax interface vlan-interface vlan-interface-id undo interface vlan-interface vlan-interface-id
Default No VLAN interface is created.
Views System view
Predefined user roles network-admin
Parameters vlan-interface-id: Specifies a VLAN interface number in the range of 1 to 4094.
Usage guidelines Create a VLAN before you create the VLAN interface for it. You cannot create a VLAN interface for a sub-VLAN. For more information about sub-VLANs, see Layer 2—LAN Switching Configuration Guide. You cannot create VLAN interfaces for secondary VLANs that meet the following requirements: •
Associated with the same primary VLAN.
•
Enabled with Layer 3 communication in VLAN interface view of the primary VLAN interface.
For more information about secondary VLANs, Layer 2—LAN Switching Configuration Guide.
Examples # Create VLAN-interface 2, and enter its view. system-view [Sysname] vlan 2 [Sysname-vlan2] quit [Sysname] interface vlan-interface 2 [Sysname-Vlan-interface2]
Related commands display interface vlan-interface
mtu Use mtu to set the MTU for a VLAN interface. Use undo mtu to restore the default.
Syntax mtu size undo mtu
Default The MTU of a VLAN interface is 1500 bytes. 193
Views VLAN interface view
Predefined user roles network-admin
Parameters size: Sets the MTU in bytes, in the range of 128 to 1500.
Usage guidelines The ip mtu or mtu command configuration on an interface takes effect on only the packets sent to the CPU for software forwarding, including the packets destined to or sourced from the interface. Configure the MTU as appropriate to avoid fragmentation. If you configure both the mtu and ip mtu commands on a VLAN interface, the MTU set by the ip mtu command is used for fragmentation. For more information about the ip mtu command, see Layer 3—IP Services Command Reference.
Examples # Set the MTU to 1492 bytes for VLAN-interface 1. system-view [Sysname] interface vlan-interface 1 [Sysname-Vlan-interface1] mtu 1492
Related commands display interface vlan-interface
name Use name to configure a name for a VLAN. Use undo name to restore the default.
Syntax name text undo name
Default The name of a VLAN is VLAN vlan-id. The vlan-id argument specifies the VLAN ID in a four-digit format. If the VLAN ID has fewer than four digits, leading zeros are added. For example, the name of VLAN 100 is VLAN 0100.
Views VLAN view
Predefined user roles network-admin
Parameters text: Specifies a VLAN name, a string of 1 to 32 characters. The string can include case-sensitive letters, digits, special symbols (see Table 38), spaces, and other Unicode characters and symbols.
194
Usage guidelines You can configure VLAN names for VLAN identification. When 802.1X or MAC authentication is configured on a device, you can specify VLANs by name on the RADIUS server for authorization VLAN assignment.
Examples # Configure the name of VLAN 2 as test vlan. system-view [Sysname] vlan 2 [Sysname-vlan2] name test vlan
Related commands display vlan
service Use service to specify an IRF member device for forwarding the traffic on the current VLAN interface. Use undo service to restore the default.
Syntax service slot slot-number undo service slot
Default No IRF member devices are specified for forwarding the traffic on the VLAN interface.
Views VLAN interface view
Predefined user roles network-admin
Parameters slot slot-number: Specifies an IRF member device by its member ID.
Usage guidelines If no IRF member devices are specified for forwarding the traffic on the current VLAN interface, the traffic is processed on the IRF member device that receives the traffic. Some features, such as IPsec anti-replay, require that traffic for the same VLAN interface be processed on the same IRF member device. If such a feature is configured, you must use this command to specify an IRF member device for forwarding the traffic on a VLAN interface. If the specified IRF member device is removed from the IRF fabric, traffic on the VLAN interface cannot be forwarded even if the VLAN interface is up. After the specified IRF member device rejoins the IRF fabric, traffic forwarding recovers.
Examples # Specify IRF member device 2 for forwarding traffic on VLAN-interface 200.