- Table of Contents
- Related Documents
-
Title | Size | Download |
---|---|---|
01-EVPN commands | 167.17 KB |
Contents
display evpn drni synchronized-mac
display l2vpn forwarding evpn split-horizon
evpn multihoming advertise disable
evpn multihoming timer df-delay
mac-address forwarding-conversational-learning
EVPN commands
address-family l2vpn evpn
Use address-family l2vpn evpn to create the BGP EVPN address family and enter its view, or enter the view of the existing BGP EVPN address family.
Use undo address-family l2vpn evpn to delete the BGP EVPN address family and all settings in BGP EVPN address family view.
Syntax
address-family l2vpn evpn
undo address-family l2vpn evpn
Default
The BGP EVPN address family does not exist.
Views
BGP instance view
Predefined user roles
network-admin
Usage guidelines
Configuration made in BGP EVPN address family view takes effect only on routes and peers of the BGP EVPN address family that are on the public network.
Examples
# Create the BGP EVPN address family and enter its view.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn evpn
[Sysname-bgp-default-evpn]
arp mac-learning disable
Use arp mac-learning disable to disable an EVPN instance from learning MAC addresses from ARP information.
Use undo arp mac-learning disable to restore the default.
Syntax
arp mac-learning disable
undo arp mac-learning disable
Default
An EVPN instance learns MAC addresses from ARP information.
Views
EVPN instance view
Predefined user roles
network-admin
Usage guidelines
The MAC information and ARP information advertised by a remote VTEP overlap. To avoid duplication, use this command to disable the learning of MAC addresses from ARP information. EVPN will learn remote MAC addresses only from the MAC information advertised from remote sites.
Examples
# Disable an EVPN instance from learning MAC addresses from ARP information.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan] arp mac-learning disable
display bgp l2vpn evpn
Use display bgp l2vpn evpn to display BGP EVPN routes.
Syntax
display bgp [ instance instance-name ] l2vpn evpn [ peer ipv4-address { advertised-routes | received-routes } [ statistics ] | [ route-distinguisher route-distinguisher | route-type { auto-discovery | es | imet | mac-ip } ] * [ { evpn-route route-length | evpn-prefix } [ advertise-info ] | ipv4-address | ipv6-address | mac-address ] | statistics ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
instance instance-name: Specifies a BGP instance by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays BGP EVPN routes for the default BGP instance.
peer ipv4-address: Specifies a peer by its IPv4 address.
advertised-routes: Specifies the routes advertised to the specified peer.
received-routes: Specifies the routes received from the specified peer.
statistics: Displays BGP EVPN route statistics.
route-distinguisher route-distinguisher: Specifies a route distinguisher (RD), a string of 3 to 21 characters. The RD can use one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number. For example, 65536:1. The AS number must be equal to or greater than 65536.
route-type: Specifies a route type.
auto-discovery: Specifies Ethernet auto-discovery routes.
es: Specifies Ethernet segment (ES) routes.
imet: Specifies inclusive multicast Ethernet tag (IMET) routes.
mac-ip: Specifies MAC/IP advertisement routes.
evpn-route: Specifies a BGP EVPN route, a case-insensitive string of 1 to 512 characters.
route-length: Specifies the route length in bits, in the range of 0 to 65535.
evpn-prefix: Specifies a BGP EVPN route in the format of evpn-route/route-length, a case-insensitive string of 1 to 512 characters.
advertise-info: Displays advertisement information for BGP EVPN routes.
ipv4-address: Specifies an IPv4 address.
ipv6-address: Specifies an IPv6 address.
mac-address: Specifies a MAC address in MAC/IP advertisement routes. If you specify the route-type keyword, to use this argument, you must also specify the mac-ip keyword.
Usage guidelines
If you do not specify any parameter, this command displays brief information about all BGP EVPN routes.
Examples
# Display brief information about all BGP EVPN routes.
<Sysname> display bgp l2vpn evpn
BGP local router ID is 8.8.8.8
Status codes: * - valid, > - best, d - dampened, h - history,
s - suppressed, S - stale, i - internal, e - external
a - additional-path
Origin: i - IGP, e - EGP, ? - incomplete
Total number of routes from all PEs: 3
Route distinguisher: 1:1
Total number of routes: 2
* >e Network : [2][0][48][0011-0022-0033][32][11.22.33.55]/136
NextHop : 1.1.1.2 LocPrf : 100
PrefVal : 0 OutLabel : NULL
MED : 0
Path/Ogn: 20i
Route distinguisher of public instance: 1:15
Total number of routes: 1
* >i Network : [2][0][48][7010-0000-0001][0][0.0.0.0]/104
NextHop : 1.1.1.4 LocPrf : 100
PrefVal : 0 OutLabel : NULL
MED : 0
Path/Ogn: 20i
Table 1 Command output
Field |
Description |
Status codes |
Route status codes: · * - valid—Valid route. · > - best—Optimal route. · d - dampened—Dampened route. · h - history—History route. · i - internal—Internal route. · e - external—External route. · s - suppressed—Suppressed route. · S - Stale—Stale route. · a - additional-path—Add-Path optimal route. |
Origin |
Origin of the route: · i – IGP—Originated in the AS. The origin of routes advertised by using the network command is IGP. · e – EGP—Learned through EGP. · ? – incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is incomplete. |
Network |
BGP EVPN route/route length. BGP EVPN routes are as follows: · [1][ESI][EthernetTagID] ¡ 1—Ethernet auto-discovery route. ¡ ESI—Ethernet segment identifier (ESI). ¡ EthernetTagID—Ethernet tag ID. · [2][EthernetTagID][MACLength][MAC][IPAddressLength][IPAddress] ¡ 2—MAC/IP advertisement route. ¡ EthernetTagID—Ethernet tag ID. ¡ MACLength—MAC address length. ¡ MAC—MAC address. ¡ IPAddressLength—IP address length. ¡ IPAddress—IP address. · [3][EthernetTagID][IPAddressLength][IPAddress] ¡ 3—IMET route. ¡ IPAddressLength—IP address length. ¡ IPAddress—IP address of the originating router. · [4][ESI][IPAddressLength][IPAddress] ¡ 4—ES route. ¡ ESI—ESI. ¡ IPAddressLength—IP address length. ¡ IPAddress—IP address of the originating router. |
NextHop |
Next hop IP address. |
MED |
Multi-Exit Discriminator (MED) attribute. |
LocPrf |
Local precedence. |
OutLabel |
Outgoing label. |
PrefVal |
Preferred value. |
Path/Ogn |
AS_PATH and ORIGIN attributes of the route. |
# Display detailed information about BGP EVPN route [1][0001.0203.0405.0607.0809][5]/120 with RD 1.1.1.1:100.
<Sysname> display bgp l2vpn evpn route-distinguisher 1.1.1.1:100 [1][0001.0203.0405.0607.0809][5] 120
BGP local router ID: 172.16.250.133
Local AS number: 100
Route distinguisher: 1.1.1.1:100
Total number of routes: 1
Paths: 1 available, 1 best
BGP routing table information of [1][0001.0203.0405.0607.0809][5]/120:
From : 10.1.1.2 (192.168.56.17)
Rely nexthop : 10.1.1.2
Original nexthop: 10.1.1.2
OutLabel : NULL
Ext-Community : <RT: 1:2>, <Encapsulation Type: VXLAN >, <ESI Label: Flag 0,
Label 1>
RxPathID : 0x0
TxPathID : 0x0
AS-path : 200
Origin : igp
Attribute value : MED 0, pref-val 0
State : valid, external, best
IP precedence : N/A
QoS local ID : N/A
Traffic index : N/A
EVPN route type : Ethernet auto-discovery route
ESI : 0001.0203.0405.0607.0809
Ethernet tag ID : 5
MPLS label : 10
Table 2 Command output
Field |
Description |
Paths |
Number of routes: · available—Number of valid routes. · best—Number of optimal routes. |
From |
IP address of the BGP peer that advertised the route. |
Rely Nexthop |
Next hop after route recursion. If no next hop is found, this field displays not resolved. |
Original nexthop |
Original next hop of the route. If the route was obtained from a BGP update message, the original next hop is the next hop IP address in the message. |
OutLabel |
Outgoing label of the route. |
Ext-Community |
Extended community attributes: · RT. · Encapsulation Type. · ESI Label. |
RxPathID |
Add-Path ID value of the received route. This field is not supported by the BGP EVPN address family. |
TxPathID |
Add-Path ID value of the sent route. This field is not supported by the BGP EVPN address family. |
AS-path |
AS_PATH attribute of the route. This attribute records the ASs the route has passed and avoids routing loops. |
Origin |
Origin of the route: · igp—Originated in the AS. The origin of routes advertised by using the network command is IGP. · egp—Learned through EGP. · incomplete—Unknown origin. The origin of routes redistributed from IGP protocols is incomplete. |
Attribute value |
Attributes of the route: · MED—MED value for the destination network. · localpref—Local preference value. · pref-val—Preferred value. · pre—Route preference value. |
State |
Current state of the route: · valid. · internal. · external. · local. · synchronize. · best. |
IP precedence |
IP precedence in the range of 0 to 7. N/A indicates that the IP precedence is invalid. |
QoS local ID |
QoS local ID in the range of 1 to 4095. N/A indicates that the QoS local ID is invalid. |
Traffic index |
Traffic index in the range of 1 to 64. N/A indicates that the traffic index is invalid. |
MPLS label |
MPLS label. The current software version does not support this field. |
# Display detailed information about BGP EVPN route [2][5][48][0001-0203-0405][32][4.5.5.5]/136 with RD 1.1.1.1:100.
<Sysname> display bgp l2vpn evpn route-distinguisher 1.1.1.1:100 [2][5][48][0001-0203-0405][32][5.5.5.5] 136
BGP local router ID: 172.16.250.133
Local AS number: 100
Route distinguisher: 1.1.1.1:100
Total number of routes: 1
Paths: 1 available, 1 best
BGP routing table information of [2][5][48][0001-0203-0405][32][5.5.5.5]/136:
From : 10.1.1.2 (192.168.56.17)
Rely nexthop : 10.1.1.2
Original nexthop: 10.1.1.2
OutLabel : NULL
Ext-Community : <RT: 1:2>, <RT: 1:3>, <RT: 1:4>, <RT: 1:5>, <RT: 1:6>, <RT: 1:7
>, <Encapsulation Type: VXLAN>, <Router's Mac: 0006-0708-0910
>, <MAC Mobility: Flag 0, SeqNum 2>, <Default GateWay>
RxPathID : 0x0
TxPathID : 0x0
AS-path : 200
Origin : igp
Attribute value : MED 0, pref-val 0
State : valid, external, best
IP precedence : N/A
QoS local ID : N/A
Traffic index : N/A
EVPN route type : MAC/IP advertisement route
ESI : 0001.0203.0405.0607.0809
Ethernet tag ID : 5
MAC address : 0001-0203-0405
IP address : 5.5.5.5/32
MPLS label1 : 10
MPLS label2 : 0
Table 3 Command output
Field |
Description |
Ext-Community |
Extended community attributes: · RT. · Encapsulation Type. · Router's Mac. · MAC Mobility—MAC mobility. ¡ Flag—Indicates whether the MAC address can move. A value of 1 indicates that the MAC address cannot move, and a value of 0 indicates that the MAC address can move. ¡ SeqNum—Identifies the most recent move of the MAC address. |
MPLS label1 |
VXLAN ID used for Layer 2 forwarding. |
MPLS label2 |
This field is not supported in the current software version. L3 VXLAN ID used for Layer 3 forwarding. |
# Display detailed information about BGP EVPN route [3][0][32][5.5.5.5]/80 with RD 1.1.1.1:100.
<Sysname> display bgp l2vpn evpn route-distinguisher 1.1.1.1:100 [3][0][32][4.5.5.5] 80
BGP local router ID: 172.16.250.133
Local AS number: 100
Route distinguisher: 1.1.1.1:100
Total number of routes: 1
Paths: 1 available, 1 best
BGP routing table information of [3][0][32][4.5.5.5]/80:
From : 10.1.1.2 (192.168.56.17)
Rely nexthop : 10.1.1.2
Original nexthop: 10.1.1.2
OutLabel : NULL
Ext-Community : <RT: 1:2>, <Encapsulation Type: VXLAN>
RxPathID : 0x0
TxPathID : 0x0
PMSI tunnel : Flag 0, TunnelType 6, Label 10, EndPointAddress 10.1.1.2
AS-path : 200
Origin : igp
Attribute value : MED 0,pref-val 0
State : valid, external, best
IP precedence : N/A
QoS local ID : N/A
Traffic index : N/A
EVPN route type : Inclusive multicast Ethernet tag route
Ethernet tag ID : 0
Origin address : 5.5.5.5/32
Table 4 Command output
Field |
Description |
Ext-Community |
Extended community attributes: · RT. · Encapsulation Type. |
PMSI tunnel |
P-Multicast Service Interface (PMSI) tunnel information: · Flag—This field is fixed at 0 in the current software version. · TunnelType—This field is fixed at 6 in the current software version, which represents a head-end replication tunnel. · Label—VXLAN ID. · EndPointAddress—Tunnel destination address. |
Origin address |
IP address of the originating router. |
# Display detailed information about BGP EVPN route [4][0000.0000.0000.0000.000a][32][4.5.5.5]/128 with RD 1.1.1.1:100.
<Sysname> display bgp l2vpn evpn route-distinguisher 1.1.1.1:100 [4][0000.0000.0000.0000.000a][32][4.5.5.5] 128
BGP local router ID: 172.16.250.133
Local AS number: 100
Route distinguisher: 1.1.1.1:100
Total number of routes: 1
Paths: 1 available, 1 best
BGP routing table information of [4][0000.0000.0000.0000.000a][32][4.5.5.5]/128:
From : 10.1.1.2 (192.168.56.17)
Rely nexthop : 10.1.1.2
Original nexthop: 10.1.1.2
OutLabel : NULL
Ext-Community : <RT: 1:2>, <Encapsulation Type: VXLAN>, <ES-Import RT: 1:1>
RxPathID : 0x0
TxPathID : 0x0
AS-path : 200
Origin : igp
Attribute value : MED 0,pref-val 0
State : valid, external, best
IP precedence : N/A
QoS local ID : N/A
Traffic index : N/A
EVPN route type : Ethernet segment route
ESI : 0000.0000.0000.0000.000a
Origin address : 4.5.5.5/32
Table 5 Command output
Field |
Description |
Ext-Community |
Extended community attributes: · RT. · Encapsulation Type. · ES-Import RT. |
Origin address |
IP address of the originating router. |
display evpn auto-discovery
Use display evpn auto-discovery to display information about IPv4 peers that are automatically discovered through BGP.
Syntax
display evpn auto-discovery { imet [ peer ip-address] [ vsi vsi-name ] | mac-ip ] [ count ] }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
imet: Specifies IPv4 peers discovered through IMET routes.
peer ip-address: Specifies a peer by its IPv4 address. If you do not specify this option, the command displays information about all automatically discovered IPv4 peers.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays IPv4 peer information for all VSIs.
mac-ip: Specifies IPv4 peers discovered through MAC/IP advertisement routes that do not carry L3 VXLAN IDs.
count: Displays the number of IPv4 peers. If you do not specify this keyword, the command displays detailed IPv4 peer information.
Examples
# Display information about IPv4 peers discovered through IMET routes.
<Sysname> display evpn auto-discovery imet
Total number of automatically discovered peers: 2
VSI name: vpna
RD PE_address Tunnel_address Tunnel mode VXLAN ID
1:10 2.2.2.2 2.2.2.2 VXLAN 10
2:100 3.3.3.3 3.3.3.3 VXLAN 10
Table 6 Command output
Field |
Description |
PE_address |
Identifier of the remote VTEP on the VSI. |
Tunnel_address |
Tunnel destination IP address. |
Tunnel mode |
Tunnel mode VXLAN represents a VXLAN tunnel. |
# Display information about IPv4 peers discovered through MAC/IP advertisement routes that do not carry L3 VXLAN IDs.
<Sysname> display evpn auto-discovery mac-ip
Total number of automatically discovered peers: 1
VSI name: vpna
Destination IP Source IP VXLAN ID Tunnel mode Tunnel name
6.6.6.6 1.1.1.9 100 VXLAN Tunnel1
Table 7 Command output
Field |
Description |
Destination IP |
Tunnel destination IP address. |
Source IP |
Tunnel source IP address. |
Tunnel mode |
Tunnel mode. VXLAN represents a VXLAN tunnel. |
display evpn drni synchronized-mac
Use display evpn drni synchronized-mac to display DR-synchronized MAC address entries.
Syntax
display evpn drni synchronized-mac [ vsi vsi-name ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
vsi vsi-name: Specifies a VSI name, a case-sensitive string of 1 to 31 characters. If you do not specify a VSI, this command displays MAC address entries for all VSIs.
count: Displays the number of MAC address entries that match the command. If you do not specify this keyword, the command displays detailed information about MAC address entries.
Usage guidelines
To ensure VM reachability information consistency in a DR system, DR member devices synchronize MAC address entries and ARP packets with each other through an IPL. This command displays the synchronized MAC address entries from a DR peer.
Examples
# Display all DR-synchronized MAC address entries.
<Sysname> display evpn drni synchronized-mac
VSI name: bbb
MAC address Link ID Interface
0000-0000-000a 1 BAGG10
0000-0000-0009 0 Tunnel1
# Display the total number of DR-synchronized MAC address entries.
<Sysname> display evpn drni synchronized-mac count
Total number of entries: 2
Table 8 Command output
Field |
Description |
Link ID |
AC's or VXLAN tunnel's link ID on a VSI. |
Interface |
Outgoing interface name. |
display evpn es
Use display evpn es to display EVPN ES information.
Syntax
display evpn es { local [ vsi vsi-name ] [ esi esi-id ] [ verbose ] | remote [ vsi vsi-name ] [ esi esi-id ] [ nexthop next-hop ] }
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
local: Specifies local ES information.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays ES information about all VSIs.
esi esi-id: Specifies an ES by its ESI in XXXX.XXXX.XXXX.XXXX.XXXX format. Each X represents a hexadecimal digit. The ESI must begin with 00 and cannot be all zeros. If you do not specify this option, the command displays information about all ESs.
verbose: Displays detailed ES information. If you do not specify this keyword, the command displays brief ES information.
remote: Specifies remote ES information.
nexthop next-hop: Specifies a next hop. If you do not specify this option, the command displays ES information received from all next hops.
Examples
# Display brief information about local ESs of VSI vpna.
<Sysname> display evpn es local vsi vpna
Redundancy mode: A – All-active S – Single-active
VSI name : vpna
ESI Tag ID DF address Mode State
0001.0002.0002.0002.0002 - 1.1.1.1 A Up
0001.0002.0003.0004.0005 - 1.1.1.1 A Up
0003.0003.0003.0003.0003 2 2.2.2.2 A Up
# Display brief information about local ESs of all VSIs.
<Sysname> display evpn es local
Redundancy mode: A – All-active S – Single-active
VSI name : v1
ESI Tag ID DF address Mode State
0003.0003.0003.0003.0003 1 1.1.1.1 A Up
0003.0003.0003.0003.0003 3 3.3.3.3 A Up
0003.0003.0003.0003.0003 10 2.2.2.2 A Up
VSI name : vpna
ESI Tag ID DF address Mode State
0001.0002.0002.0002.0002 - 1.1.1.1 A Up
0001.0002.0003.0004.0005 - 1.1.1.1 A Up
0003.0003.0003.0003.0003 2 2.2.2.2 A Up
Table 9 Command output
Field |
Description |
Tag ID |
Ethernet tag ID. |
DF address |
Router ID of the VTEP elected as the DF. |
Mode |
Redundancy mode of the ES: · A—All-active mode. · S—Single-active mode. |
State |
State of the ES: · Up. · Down. |
# Display detailed information about local ESs of all VSIs.
<Sysname> display evpn es local verbose
VSI name : v1
ESI : 0003.0003.0003.0003.0003
Interface : HundredGigE1/0/1
Redundancy mode : All-active
State : Up
ACs :
Link ID Service instance ID Tag ID DF address
0 1 1 1.1.1.1
1 3 3 3.3.3.3
2 10 10 2.2.2.2
VSI name : vpna
ESI : 0001.0002.0002.0002.0002
Interface : HundredGigE1/0/2
Redundancy mode : All-active
State : Up
ACs :
Link ID Service instance ID Tag ID DF address
1 - - 1.1.1.1
ESI : 0001.0002.0003.0004.0005
Interface : HundredGigE1/0/3
Redundancy mode : All-active
State : Up
ACs :
Link ID Service instance ID Tag ID DF address
0 - - 1.1.1.1
ESI : 0003.0003.0003.0003.0003
Interface : HundredGigE1/0/4
Redundancy mode : All-active
State : Up
ACs :
Link ID Service instance ID Tag ID DF address
2 2 2 2.2.2.2
Table 10 Command output
Field |
Description |
Redundancy mode |
Redundancy mode of the ES: · All-active. · Single-active. |
State |
State of the ES: · Up. · Down. If the ES is not manually assigned an ESI, a hyphen (-) is displayed. |
ACs |
The VSI's ACs on the ES. |
Link ID |
The AC's link ID on the VSI. |
Service instance ID |
Ethernet service instance ID. |
Tag ID |
Ethernet tag ID. |
DF address |
Router ID of the VTEP elected as the DF. |
# Display information about remote ESs of all VSIs.
<Sysname> display evpn es remote
VSI name : v1
ESI : 0003.0003.0003.0003.0003
Redundancy mode : All-active
A-D per ES routes :
1.1.1.1
A-D per EVI routes :
Tag ID Peer IP
1 1.1.1.1
3 1.1.1.1
10 1.1.1.1
VSI name : vpna
ESI : 0001.0000.0000.0000.0001
Redundancy mode : All-active
Ethernet segment routes :
1.1.1.1
3.3.3.3
A-D per ES routes :
1.1.1.1
3.3.3.3
A-D per EVI routes :
Tag ID Peer IP
- 1.1.1.1
- 3.3.3.3
ESI : 0001.0002.0003.0004.0005
Redundancy mode : All-active
Ethernet segment routes :
1.1.1.1
A-D per ES routes :
1.1.1.1
A-D per EVI routes :
Tag ID Peer IP
- 1.1.1.1
# Display remote ES information received from next hop 3.3.3.3 for VSI vpna.
<Sysname> display evpn es remote vsi vpna nexthop 3.3.3.3
VSI name : vpna
ESI : 0001.0000.0000.0000.0001
Redundancy mode : All-active
Ethernet segment routes :
3.3.3.3
A-D per ES routes :
3.3.3.3
A-D per EVI routes :
Tag ID Peer IP
- 3.3.3.3
Table 11 Command output
Field |
Description |
Redundancy mode |
Redundancy mode of the ES: · All-active. · Single-active. |
Ethernet segment routes |
Ethernet segment routes for the ES. |
A-D per ES routes |
A-D per Ethernet segment routes for the ES. |
A-D per EVI routes |
A-D per EVI routes for the ES. |
Tag ID |
Ethernet tag ID. |
Peer IP |
IP address of the remote peer. |
display evpn route mac
Use display evpn route mac to display IPv4 EVPN MAC address entries.
Syntax
display evpn route mac [ local | remote ] [ vsi vsi-name ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
local: Specifies local MAC address entries.
remote: Specifies remote MAC address entries.
vsi vsi-name: Specifies a VSI by its name, a case-sensitive string of 1 to 31 characters. If you do not specify this option, the command displays MAC address entries for all VSIs.
count: Displays the number of MAC address entries. If you do not specify this keyword, the command displays detailed information about MAC address entries.
Usage guidelines
If you do not specify the local or remote keyword, this command displays both local and remote IPv4 EVPN MAC address entries.
Examples
# Display all IPv4 EVPN MAC address entries.
<Sysname> display evpn route mac
Flags: D - Dynamic B - BGP L - Local active
G - Gateway S - Static M - Mapping I - Invalid
VSI name: bbb
MAC address Link ID/Name Flags Next hop
0000-0000-000a 1 DL -
0000-0000-0009 Tunnel1 B 2.2.2.2
0001-2000-4000 - BI 3.3.3.3
# Display the total number of IPv4 EVPN MAC address entries.
<Sysname> display evpn route mac count
Total number of entries: 3
Table 12 Command output
Field |
Description |
Link ID/Name |
For a local MAC address, this field displays the AC's link ID on the VSI. For a remote MAC address, this field displays the tunnel interface name. |
Flags |
MAC address entry type: · D—The entry is dynamically learned. · B—The entry is learned from BGP EVPN routes. · L—The local entry is active. If this flag is not set and the B flag is set, the entry learned from BGP EVPN routes is active. · S—The static entry is active. · M—The entry from a remote VXLAN mapped to a local VXLAN is active. · I—The entry is invalid. Possible reasons: ¡ The VSI has been administratively shut down by using the shutdown command. ¡ The outgoing tunnel interface does not exist. |
Next hop |
IP address of the remote VTEP. If the MAC address entry is a local entry, a hyphen (-) is displayed. |
display evpn routing-table
Use display evpn routing-table to display the EVPN routing table for a VPN instance.
Syntax
display evpn routing-table [ ipv6 ] [ count ]
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
ipv6: Specifies IPv6 information. If you do not specify this keyword, the command displays IPv4 information.
count: Displays the number of entries in the routing table. If you do not specify this keyword, the command displays detailed information about the routing table.
Examples
# Display the EVPN IPv4 routing table for VPN instance vpn1.
<Sysname> display evpn routing-table vpn-instance vpn1
Flags: E - with valid ESI A – A-D ready L - Local ES exists
VPN instance name: vpn1 Local L3VNI: 7
IP address Nexthop Outgoing interface NibID Flags
10.1.1.11 1.1.1.1 Vsi-interface3 0x18000000 EAL
10.1.1.12 2.2.2.2 Vsi-interface3 0x18000001 EA
# Display the EVPN IPv4 routing table for the public instance.
<Sysname> display evpn routing-table public-instance
Flags: E - with valid ESI A – A-D ready L - Local ES exists
Public instance Local L3VNI: 3900
IP address Nexthop Outgoing interface NibID Flags
10.1.1.11 1.1.1.1 Vsi-interface3 0x18000000 EAL
10.1.1.12 2.2.2.2 Vsi-interface3 0x18000001 EA
# Display the number of EVPN route entries in the IPv4 routing table for VPN instance vpn1.
<Sysname> display evpn routing-table vpn-instance vpn1 count
Total number of entries: 2
# Display the EVPN IPv6 routing table for VPN instance vpna.
<Sysname> display evpn routing-table ipv6 vpn-instance vpna
VPN instance: vpna Local L3VNI: 7
IPv6 address : BC10:0300:1000:0020:0200:0300:0100:0034
Next hop : 1.1.1.1
Outgoing interface : Vsi-interface3
NibID : 0x18000000
IPv6 address : BC10:0300:1000:0020:0200:0300:0100:0035
Next hop : 2.2.2.2
Outgoing interface : Vsi-interface3
NibID : 0x18000001
Table 13 Command output
Field |
Description |
NibID |
Next hop ID. |
Flags |
Flags of the route: · E—The route carries a valid ESI. · A—All Ethernet auto-discovery routes are received. The ECMP routes for the next hop can be issued. · L—An active local ESI exists. Remote routes are not issued. · -—The MAC/IP advertisement route does not have a valid ESI. ECMP routes are not supported. |
display l2vpn forwarding evpn split-horizon
Use display l2vpn forwarding evpn split-horizon to display site-facing interfaces excluded from traffic forwarding by split horizon.
Syntax
display l2vpn forwarding evpn split-horizon [ tunnel tunnel-number ] slot slot-number
Views
Any view
Predefined user roles
network-admin
network-operator
Parameters
tunnel tunnel-number: Specifies a VXLAN tunnel interface number. The value range for the tunnel-number argument is 0 to 15359. If you do not specify this option, the command displays all site-facing interfaces excluded from traffic forwarding by split horizon.
slot slot-number: Specifies an IRF member device by its member ID.
Examples
# Display site-facing interfaces excluded from traffic forwarding for Tunnel 0.
<Sysname> display l2vpn forwarding evpn split-horizon tunnel 0 slot 0
Tunnel name: 0
Total number of filtered interfaces: 2
Filtered interfaces:
HGE1/0/1
HGE1/0/2
Table 14 Command output
Field |
Description |
Tunnel name |
VXLAN tunnel interface name. |
Filtered interfaces |
Site-facing interfaces that do not forward the flood traffic received from the VXLAN tunnel. |
esi
Use esi to assign an ESI to an interface.
Use undo esi to restore the default.
Syntax
esi esi-id
undo esi
Default
No ESI is assigned to an interface.
Views
Interface view
Predefined user roles
network-admin
Parameters
esi-id: Specifies an ES by its ESI in XXXX.XXXX.XXXX.XXXX.XXXX format. Each X represents a hexadecimal digit. The ESI must begin with 00 and cannot be all zeros.
Usage guidelines
An ESI uniquely identifies an ES. The links on interfaces with the same ESI belong to the same ES. Traffic of the ES can be distributed among the links for load sharing.
To modify the ESI of an interface, first use the undo esi command to delete the original ESI.
Examples
# Assign ESI 0000.0001.0002.0003.0004 to HundredGigE 1/0/1.
<Sysname> system-view
[Sysname] interface hundredgige 1/0/1
[Sysname-HundredGigE1/0/1] esi 0000.0001.0002.0003.0004
evpn drni group
Use evpn drni group to enable EVPN distributed relay and specify the virtual VTEP address.
Use undo evpn drni group to restore the default.
Syntax
evpn drni group virtual-vtep-ip
undo evpn drni group
Default
EVPN distributed relay is disabled.
Views
System view
Predefined user roles
network-admin
Parameters
virtual-vtep-ip: Specifies the virtual VTEP address.
Usage guidelines
EVPN distributed relay virtualizes two VTEPs or EVPN gateways into one DR system to avoid single points of failure. The VTEPs or EVPN gateways use a virtual VTEP address to establish VXLAN tunnels to remote devices.
For the device to re-establish VXLAN tunnels, you must execute the address-family l2vpn evpn command in BGP instance view after you enable or disable EVPN distributed relay.
To modify the virtual VTEP address, you must first delete the original virtual VTEP address.
Examples
# Enable EVPN distributed relay and specify the virtual VTEP address as 1.1.1.1.
<Sysname> system-view
[Sysname] evpn drni group 1.1.1.1
Related commands
evpn edge group
evpn drni local
Use evpn drni local to specify the IP addresses of the VTEPs in a DR system.
Use undo evpn drni local to restore the default.
Syntax
evpn drni local local-ip remote remote-ip
undo evpn drni local
Default
The IP addresses of the VTEPs in a DR system are not specified.
Views
System view
Predefined user roles
network-admin
Parameters
local local-ip: Specifies the IP address of the local VTEP.
remote remote-ip: Specifies the IP address of the peer VTEP.
Usage guidelines
An AC that is attached to only one of the VTEPs in a DR system is called a single-armed AC. After you configure this command, each VTEP in a DR system changes the next hop of the routes for single-armed ACs to its local VTEP IP address when advertising the routes. This ensures that the traffic of a single-armed AC is forwarded to its attached VTEP. When a VTEP receives BGP EVPN routes from the peer VTEP IP address specified by using this command, it does not set up a VXLAN tunnel to the peer VTEP.
You must execute this command if single-armed ACs are attached to a DR system that uses an Ethernet aggregate link as the IPL. You do not need to execute this command on a DR system that uses a VXLAN tunnel as the IPL. In such a DR system, a VTEP uses the source IP address of the IPL as the next hop of routes for single-armed ACs to ensure correct traffic forwarding.
When you execute this command, make sure the IP address of the local VTEP belongs to a local interface. Make sure the local VTEP IP address and peer VTEP IP address are reversed on the VTEPs in a DR system.
Examples
# Specify the IP addresses of the local and peer VTEPs in the DR system as 2.2.2.2 and 3.3.3.3, respectively.
<Sysname> system-view
[Sysname] evpn drni local 2.2.2.2 remote 3.3.3.3
evpn encapsulation
Use evpn encapsulation to create an EVPN instance and enter its view, or enter the view of an existing EVPN instance.
Use undo evpn encapsulation to restore the default.
Syntax
evpn encapsulation vxlan
undo evpn encapsulation
Default
No EVPN instance exists.
Views
VSI view
Predefined user roles
network-admin
Parameters
vxlan: Specifies VXLAN encapsulation.
Usage guidelines
Before you can configure EVPN settings, you must create an EVPN instance.
Examples
# Create an EVPN instance and enter its view.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan]
evpn multihoming advertise disable
Use evpn multihoming advertise disable to disable advertisement of EVPN multihoming routes and withdraw the EVPN multihoming routes that have been advertised to remote sites.
Use undo evpn multihoming advertise disable to restore the default.
Syntax
evpn multihoming advertise disable
undo evpn multihoming advertise disable
Default
The device advertises EVPN multihoming routes.
Views
System view
Predefined user roles
network-admin
Usage guidelines
EVPN multihoming routes include Ethernet auto-discovery routes and Ethernet segment routes.
In a multihomed EVPN network, execute this command on a redundant VTEP before you reboot it. This operation allows other VTEPs to refresh their EVPN routing table to prevent traffic interruption caused by the reboot.
Examples
# Disable advertisement of EVPN multihoming routes and withdraw the EVPN multihoming routes that have been advertised to remote sites.
<Sysname> system-view
[Sysname] evpn multihoming advertise disable
evpn multihoming timer df-delay
Use evpn multihoming timer df-delay to set the DF election delay.
Use undo evpn multihoming timer df-delay to restore the default.
Syntax
evpn multihoming timer df-delay delay-value
undo evpn multihoming timer df-delay
Default
The DF election delay is 3 seconds.
Views
System view
Predefined user roles
network-admin
Parameters
delay-value: Specifies the DF election delay, in the range of 1 to 1200 seconds.
Usage guidelines
DF election delay defines the minimum interval allowed between two DF elections.
The DF election can be triggered by site-facing interface status changes, redundant VTEP membership changes, and interface ESI changes. To prevent frequent DF elections from degrading network performance, set the DF election delay.
Examples
# Set the DF election delay to 5 seconds.
<Sysname> system-view
[Sysname] evpn multihoming timer df-delay 5
import evpn mac-ip
Use import evpn mac-ip to enable the device to redistribute received MAC/IP advertisement routes that contain ARP or ND information into a BGP unicast routing table.
Use undo import evpn mac-ip to disable the device from redistributing received MAC/IP advertisement routes that contain ARP or ND information into a BGP unicast routing table.
Syntax
import evpn mac-ip
undo import evpn mac-ip
Default
MAC/IP advertisement routes that contain ARP or ND information are not redistributed into any BGP unicast routing table.
Views
BGP IPv4 unicast address family view
BGP IPv6 unicast address family view
BGP-VPN IPv4 unicast address family view
BGP-VPN IPv6 unicast address family view
Predefined user roles
network-admin
Usage guidelines
This command enables the device to redistribute received MAC/IP advertisement routes that contain ARP or ND information into a BGP unicast routing table.
· If you use this command in BGP IPv4 or IPv6 unicast address family view, the device will redistribute the routes into the BGP IPv4 or IPv6 unicast routing table. In addition, the device will advertise the routes to the local site.
· If you use this command in BGP-VPN IPv4 or IPv6 unicast address family view, the device will redistribute the routes into the BGP-VPN IPv4 or IPv6 unicast routing table of the corresponding VPN instance. To advertise the routes to the local site, you must configure the advertise l2vpn evpn command.
Examples
# Redistribute received MAC/IP advertisement routes into the BGP-VPN IPv4 unicast routing table of VPN instance vpna.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] ip vpn-instance vpna
[Sysname-bgp-default-vpna] address-family ipv4
[Sysname-bgp-default-ipv4-vpna] import evpn mac-ip
Related commands
advertise l2vpn evpn
mac-address forwarding-conversational-learning
Use mac-address forwarding-conversational-learning to enable conversational learning for remote MAC address entries.
Use undo mac-address forwarding-conversational-learning to disable conversational learning for remote MAC address entries.
Syntax
mac-address forwarding-conversational-learning
undo mac-address forwarding-conversational-learning
Default
Conversational learning is disabled for remote MAC address entries.
Views
System view
Predefined user roles
network-admin
Usage guidelines
Use this command only on an EVPN network.
By default, the device issues a remote MAC address entry to the hardware after the remote MAC address is advertised to the local site by BGP EVPN routes. This feature enables the device to issue a remote MAC address entry to the hardware only when the entry is required for packet forwarding. This feature saves hardware resources on the device.
With this feature enabled, the device generates a blackhole MAC address entry for an unknown MAC address if receiving 50 frames destined for that MAC address within the MAC aging time. For more information about the MAC aging time and blackhole MAC address entries, see MAC address table configuration in Layer 2—LAN Switching Configuration Guide.
Examples
# Enable conversational learning for remote MAC address entries.
<Sysname> system-view
[Sysname] mac-address forwarding-conversational-learning
mac-advertising disable
Use mac-advertising disable to disable MAC address advertisement and withdraw advertised MAC addresses.
Use undo mac-advertising disable to restore the default.
Syntax
mac-advertising disable
undo mac-advertising disable
Default
MAC address advertisement is enabled.
Views
EVPN instance view
Predefined user roles
network-admin
Usage guidelines
The MAC information and ARP information advertised by the VTEP overlap. To avoid duplication, use this command to disable MAC address advertisement and withdraw the MAC addresses advertised to remote VTEPs.
Examples
# Disable MAC address advertisement and withdraw advertised MAC addresses for an EVPN instance.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan] mac-advertising disable
nd mac-learning disable
Use nd mac-learning disable to disable an EVPN instance from learning MAC addresses from ND information.
Use undo nd mac-learning disable to restore the default.
Syntax
nd mac-learning disable
undo nd mac-learning disable
Default
An EVPN instance learns MAC addresses from ND information.
Views
EVPN instance view
Predefined user roles
network-admin
Usage guidelines
The MAC information and ND information advertised by a remote VTEP overlap. To avoid duplication, use this command to disable the learning of MAC addresses from ND information. EVPN will learn remote MAC addresses only from the MAC information advertised from remote sites.
Examples
# Disable an EVPN instance from learning MAC addresses from ND information.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan] nd mac-learning disable
policy vpn-target
Use policy vpn-target to enable route target filtering for BGP EVPN routes.
Use undo policy vpn-target to disable route target filtering for BGP EVPN routes.
Syntax
policy vpn-target
undo policy vpn-target
Default
Route target filtering is enabled for BGP EVPN routes.
Views
BGP EVPN address family view
Predefined user roles
network-admin
Usage guidelines
When route target filtering is enabled for BGP EVPN routes, the EVPN routing table accepts only BGP EVPN routes of which the export route targets match the local import route targets. If the device must save all BGP EVPN routes, use the undo policy vpn-target command to disable route target filtering for BGP EVPN routes.
Examples
# Disable route target filtering for BGP EVPN routes.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn evpn
[Sysname-bgp-default-evpn] undo policy vpn-target
route-distinguisher
Use route-distinguisher to configure an RD for an EVPN instance.
Use undo route-distinguisher to restore the default.
Syntax
route-distinguisher { route-distinguisher | auto [ router-id ] }
undo route-distinguisher
Default
No RD is configured for an EVPN instance.
Views
EVPN instance view
Predefined user roles
network-admin
Parameters
route-distinguisher: Specifies an RD, a string of 3 to 21 characters. The RD cannot be all zeros and can use one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number. For example, 65536:1. The AS number must be equal to or greater than 65536.
auto: Automatically generates an RD in the N:VXLAN ID format. The initial value of N is 1. If N:VXLAN ID is already in use, the system increases the value of N by 1 until the RD is available.
router-id: Automatically generates an RD based on the router ID in the Router ID:N format. The initial value of N is 1. If Router ID:N is already in use, the system increases the value of N by 1 until the RD is available. If you do not specify this keyword with the auto keyword, the system automatically generates an RD based on the VXLAN ID in the N:VXLAN ID format.
Usage guidelines
EVPN uses MP-BGP to advertise BGP EVPN routes for automatic VTEP discovery, MAC reachability information advertisement, and host route advertisement. MP-BGP uses the RD to differentiate BGP EVPN routes of different EVPN instances.
Examples
# Configure 22:1 as the RD of an EVPN instance.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan] route-distinguisher 22:1
rr-filter
Use rr-filter to create a route reflector (RR) reflection policy.
Use undo rr-filter to restore the default.
Syntax
rr-filter ext-comm-list-number
undo rr-filter
Default
An RR does not filter reflected BGP EVPN routes.
Views
BGP EVPN address family view
Predefined user roles
network-admin
Parameters
ext-comm-list-number: Specifies an extended community attribute list by its number in the range of 1 to 199.
Usage guidelines
This command enables an RR to reflect only received BGP EVPN routes that match the attributes in the specified extended community attribute list.
If a cluster contains multiple RRs, you can configure different reflection policies on the RRs for load sharing among the RRs.
For more information about the extended community attribute list, see Layer 3—IP Routing Configuration Guide.
Examples
# Configure a reflection policy for the device to reflect BGP EVPN routes that match extended community attribute list 10.
<Sysname> system-view
[Sysname] bgp 100
[Sysname-bgp-default] address-family l2vpn evpn
[Sysname-bgp-default-evpn] rr-filter 10
Related commands
ip extcommunity-list (Layer 3—IP Routing Command Reference)
vpn-target
Use vpn-target to configure route targets for EVPN.
Use undo vpn-target to delete route targets for EVPN.
Syntax
vpn-target { vpn-target&<1-8> | auto } [ both | export-extcommunity | import-extcommunity ]
undo vpn-target { vpn-target&<1-8> | auto | all } [ both | export-extcommunity | import-extcommunity ]
Default
EVPN does not have route targets.
Views
EVPN instance view
Predefined user roles
network-admin
Parameters
vpn-target&<1-8>: Specifies a space-separated list of up to eight route targets. Each route target is a string of 3 to 21 characters in one of the following formats:
· 16-bit AS number:32-bit user-defined number. For example, 101:3.
· 32-bit IP address:16-bit user-defined number. For example, 192.168.122.15:1.
· 32-bit AS number:16-bit user-defined number. For example, 65536:1. The AS number must be equal to or greater than 65536.
auto: Automatically generates a route target in the format of BGP AS number:VXLAN ID.
both: Uses the specified route targets as both import and export targets. If you do not specify the both, export-extcommunity, or import-extcommunity keyword, the both keyword applies.
export-extcommunity: Uses the specified route targets as export targets.
import-extcommunity: Uses the specified route targets as import targets.
all: Specifies all route targets.
Usage guidelines
EVPN uses MP-BGP to advertise BGP EVPN routes for automatic VTEP discovery, MAC reachability information advertisement, and host route advertisement. MP-BGP uses route targets to control the advertisement and acceptance of BGP EVPN routes.
A VTEP sets the export targets for BGP EVPN routes before advertising the routes to remote VTEPs. The VTEP checks the export targets of BGP EVPN routes from remote VTEPs and imports only BGP EVPN routes of which the export targets match the local import targets.
If you execute this command multiple times, all configured route targets take effect.
Examples
# Configure import route targets 10:1, 100:1, and 1000:1 for an EVPN instance.
<Sysname> system-view
[Sysname] vsi aaa
[Sysname-vsi-aaa] evpn encapsulation vxlan
[Sysname-vsi-aaa-evpn-vxlan] vpn-target 10:1 100:1 1000:1 import-extcommunity