OcNOS-SP : Multi-Protocol Label Switching Guide : Multi-Protocol Label Switching Command Reference : EVPN MPLS Commands
EVPN MPLS Commands
This chapter describes the EVPN MPLS commands:
l3vni
mac
access-if-evpn
Use this command to create the evpn mpls access-port.
Use the no form of this command to delete the evpn mpls access-port.
Command Syntax
access-if-evpn
no access-if-evpn
Parameters
None
Command Mode
L2 Sub-interface mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#end
 
arp-cache disable
Use this command to disable the ARP cache for MAC/IP.
When the ARP cache is disabled on a access circuit, It does not reply to any ARP arriving on this port from the cache. It withdraws all MAC/IPs configured/learned on this access circuit and removes the MAC/IP entry for this AC from the local ARP cache.
It also makes sure that on withdrawing the MAC/IP route, the MAC does not become unknown. If all routes for this MAC are being withdrawn because of this command, then It advertises a MAC-only route. This is done so that the MAC does not become unknown and only the cache functionality becomes disabled.
Use the no form of this command to enable ARP cache for MAC/IP.
Note: On enabling the cache, an IP will be in conflict, then the cache enable will fail. The conflict has to be manually removed and then the cache enabled.
Note: When encapsulation default is configured under L2 subifp , then arp-packets will not be uplifted.
Note: Not applicable for the AC port which is mapped with ELINE/Xconnect Service.
Command Syntax
arp-cache disable
no arp-cache disable
Parameters
None
Default
By default, the arp-cache option is enabled.
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#arp-cache disable
(config-access-if)#end
 
arp-nd flood-suppress
Use this command to completely restrict the flood of ARP/ND packets towards remote PEs or other Access Circuit
This command applies only when the ARP cache and ND cache are enabled. When the ARP cache is disabled, ARP flooding is not suppressed even if this command is given. When the ND cache is disabled, ND flooding is not disabled, even if this command is given.
Use the no form of this command to not restrict the flood of ARP/ND packets.
Note: Not applicable for the AC port which is mapped with ELINE/Xconnect Service.
Command Syntax
arp-nd flood-suppress
no arp-nd flood-suppress
Parameters
None
Default
By default, the arp-nd flood-suppress option is disabled.
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#arp-nd flood-suppress
(config-access-if)#end
 
arp-nd refresh timer
Use this command to configure aging out the arp-cache and nd-cache entries for given time multiplied by 3 in seconds.
Use the no form of this command to remove the configuration.
Note: Not applicable for the AC port which is mapped with ELINE/Xconnect Service.
Note: After this timer interval, it sends out ARP to revalidate and 3 times of this would lead to removal of the dynamic entry.
Command Syntax
evpn mpls arp-nd refresh-timer <3-190>
no evpn mpls arp-nd refresh-timer
Parameters
<3-190>
Refresh timer value in seconds (age-out is refresh time * 3)
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#config mode
(config)#evpn mpls arp-nd refresh-timer 100
(config)#no evpn mpls arp-nd refresh-timer
clear evpn mpls counters
Note: Use this command to clear the counters of a network port.
Command Syntax
clear evpn mpls counters ((network (ingress|(egress dst <A.B.C.D>)))| vpn-id <1-16777215> (network (ingress|(egress dst <A.B.C.D>))))
Parameters
<1-16777215>
VPN identifier
A.B.C.D
Ipv4 address
Command Mode
Exec Mode
Applicability
This command was introduced in OcNOS version 4.2.
Examples
DUT2#clear evpn mpls counters network egress dst 105.1.1.1
DUT2#
DUT2#clear evpn mpls counters vpn-id 10 network ingress
DUT2#
 
 
 
 
clear mac address-table
Use this command to clear dynamically learned MACs.
Note: To make evpn mpls disable and enable effective, system reboot is required.
Command Syntax
clear mac address-table dynamic evpn-mpls
clear mac address-table dynamic evpn-mpls evid <1-16777215>
clear mac address-table dynamic evpn-mpls evid <1-16777215> (address MACADDR|)
Parameters
address
Clear the specified MAC Address
evid
EVPN-MPLS tenant identifier
<1-16777215>
Range supported for EVID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
#clear mac address-table dynamic evpn-mpls
#clear mac address-table dynamic evpn-mpls evid 30
OcNOS#clear mac address-table dynamic evpn-mpls evid 30 address 0000.0022.2222
dynamic-learning disable
Use this command to disable dynamic learning of MACs at the Access Circuit.
This command also disables dynamic learning of MAC/IP from ARP/ND messages received on this Access Circuit.
Use the no form of this command to enable dynamic learning of MACs at the Access Circuit.
Note: Not applicable for the AC port which is mapped with ELINE/Xconnect Service.
Note: IPv4 and IPv6 addresses associated with dynamic MACs also get cleaned with this command.
Command Syntax
dynamic-learning disable
no dynamic-learning disable
Parameters
None
Default
By default, the dynamic-learning option is enabled.
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#dynamic-learning disable
(config-access-if)#end
evi-name
Use this command to name the EVPN MPLS ID.
Use the no form of this command to remove the name of the EVPN MPLS ID.
Command Syntax
evi-name <WORD>
no evi-name
Parameters
WORD
EVI name. Maximum limit 10 characters (shall not be only numeric).
Default
None
Command Mode
EVPN MPLS mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#evpn mpls id 3
(config-evpn-mpls)#evi-name vni_ELAN
(config-evpn-mpls)#exit
 
 
evpn esi hold-time
Use this command to allow some time for the evpn mpls tunnels and xconnect tunnel to come at the time of evpn mpls initialization before making the ESI up. This avoids traffic to be black-holed when a new PE is added and connected to an already running CE for multi-homing.
Use the no form of this command to make the esi up immediately when configuring the access-if cli.
Command Syntax
evpn esi hold-time <10-300>
no evpn esi hold-time
Parameters
<10-300>
Hold time in seconds
Default
Default value is 0.
Command Mode
Configuration Mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)# evpn esi hold-time 100
(config)# exit
 
evpn irb
Use this command to map an IRB interface to an L2 VNID. This IRB interface can have multiple IP address as explained in IRB IP address CLI and can serve all subnets attached to the L2 VNID. Currently its 1:1 mapping between IRB interface & L2VNI.
This configuration enables default gateway behavior on that VTEP for that VNID and subnet and triggers default gateway MAC-IP route generation for the corresponding IRB IP with the local or global IRB MAC (router MAC) in distributed gateway in distributed gateway
This makes the default behavior as enable for gateway functionality.
No command disables default gateway behavior of the VTEP for that VNID subnet and triggers withdrawal of the default gateway MAC/IP advertisement done for that VNID subnet.
Use the no form this command to disable default gateway behavior of the VTEP for that VNID subnet and triggers withdrawal of the default gateway MAC/IP advertisement done for that VNID subnet.
Command Syntax
evpn irb [<NAME>|irb-advertise-host-route]
no evpn irb [<NAME>|irb-advertise-host-route]
Parameters
NAME
IRB interface name
irb-advertise-host-route
To advertise host IP prefixes
Command Mode
EVPN_MPLS_CONFIG Mode
Applicability
This command was introduced before OcNOS version 6.0.0.
irb-advertise-host-route introduced in OcNOS version 6.2.0.
Example
#config mode
(config)#evpn mpls id 10
(config-evpn-mpls)#evpn irb irb100
 
(config)#evpn mpls id 102
(config-evpn-mpls)#evpn irb-advertise-host-route
 
evpn irb-forwarding anycast-gateway-mac
Use this command to configure common anycast mac-address for all the IRB interfaces
Use the no form of this command to remove the global MAC address on all the IRB interfaces.
Command Syntax
evpn irb-forwarding anycast-gateway-mac MAC
no evpn irb-forwarding anycast-gateway-mac
Parameters
MAC
XX-XX-XX-XX-XX-XX Source MAC address (Option 1)
XX:XX:XX:XX:XX:XX Source MAC address (Option 2)
XXXX.XXXX.XXXX Source MAC address (Option 3)
Command Mode
Configuration Mode
Applicability
This command was introduced before OcNOS version 4.1.
Example
#configure terminal
(config)#evpn irb-forwarding anycast-gateway-mac 0000.0000.1313
Or
(config)#evpn irb-forwarding anycast-gateway-mac 00:00:00:00:13:13
Or
(config)#evpn irb-forwarding anycast-gateway-mac 00-00-00-00-13-13
 
(config)#no evpn irb-forwarding anycast-gateway-mac
 
 
evpn irb-if-forwarding anycast-gateway-mac
Use this command to enable a Layer 3 interface to use the global anycast IRB MAC address.
Use the no form of this command to unconfigure the anycast MAC at a Layer 3 interface.
Command Syntax
evpn irb-if-forwarding anycast-gateway-mac
no evpn irb-if-forwarding anycast-gateway-mac
Parameters
None
Command Mode
IRB interface mode
L3 interface mode
Applicability
This command was introduced before OcNOS version 6.0.0.
L3 interface mode support was added in OcNOS version 6.1.0.
Example
#configure teminal
(config)#interface irb 1
(config-irb-if)#ip vrf forwarding vrfip
(config-irb-if)#evpn irb-if-forwarding anycast-gateway-mac
(config-irb-if)#no evpn irb-if-forwarding anycast-gateway-mac
(config)#interface xe1
(config-irb-if)#ip vrf forwarding vrfip
(config-irb-if)#evpn irb-if-forwarding anycast-gateway-mac
(config-irb-if)#no evpn irb-if-forwarding anycast-gateway-mac
 
evpn mpls enable
Use this command to enable evpn mpls functionality.
Use the no version of this command to disable evpn mpls functionality.
Note: To make evpn mpls disable and enable effective, system reboot is required.
Command Syntax
evpn mpls enable
no evpn mpls enable
Parameters
None
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
(config)#evpn mpls enable
(config)#no evpn mpls enable
evpn mpls id
Use this command to set the VPN identifier to create a EVPN MPLS tunnel.
Use evpn mpls id for creating ELAN and use evpn mpls xconnect with source and target identifier for ELINE/XConnect.
Use the no version of this command to delete the EVPN MPLS ID for MPLS tunnel.
Command Syntax
evpn mpls id <1-16777215> (| xconnect target-mpls-id <1-16777215>) (|control-word)
no evpn mpls id <1-16777215>
Parameters
<1-16777215>
EVID
xconnect target-mpls-id
Enables E-LINE Xconnect
<1-16777215>
Target EVID
 
control-word
Enables control-word egress/ingress options for given EVPN Instance (E-LAN or E-LINE) requires hardware-profile filter evpn-mpls-cw enabled.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 3.0, X-connect parameter was introduced in OcNOS version 4.0, and control-word parameter introduced in OcNOS version 6.0.1.
Example
(config)#evpn mpls id 10
(config-evpn-mpls)#exit
 
(config)#no evpn mpls id 10
 
(config)#evpn mpls id 100 xconnect target-mpls-id 200
(config-evpn-mpls)#exit
 
(config)#no evpn mpls id 100
 
(config)#evpn mpls id 300 xconnect target-mpls-id 400 control-word
(config-evpn-mpls)#exit
 
(config)#no evpn mpls id 300
evpn mpls irb
Use this command to enable EVPN-MPLS-IRB globally. Applicable to EVPN-MPLS
Use the no form this command to disable EVPN-MPLS.
Command Syntax
evpn mpls irb
no evpn mpls irb
Parameters
None
Command Mode
Configure Mode
Applicability
This command was introduced before OcNOS version 6.0.0.
Example
#config mode
(config)#evpn mpls irb
(config)#no evpn mpls irb
l3vni
Use this command to configure L3 Virtual Network Identifier for an ip vrf
Use the no form of this command to remove L3 Virtual Network Identifier
This identifies a tenant, with this one tenant can have L3VNI as its identifier and he can have multiple L2 networks identified with L2VNI's.
Note: L3 VNID cannot be same as L2 VNID.
Command Syntax
l3vni <L3 VNID>
no l3vni <L3 VNID>
Parameters
<1-16777215>
L3 VNID. Cannot be same as L2 VNID
Command Mode
Configure VRF mode
Applicability
This command was introduced in OcNOS version 4.1.
Example
#configure teminal
(config)#ip vrf vrfip
(config-vrf)#l3vni 10002
(config-vrf)#no l3vni 10002
 
 
mac
Use this command to configure a static MAC address with IPv4/IPv6 address or only MAC address under the Access-Circuit.
Use the no form of this command to unconfigure a static MAC address with IPv4/IPv6 address and only MAC address from the Access-Circuit.
Note: Not applicable for the AC port which is mapped with ELINE Service.
For static mac addresses,
1) the local static is given preference over remote learned static.
2) if same static mac is configured on more than one interface of same VPN then conflict state need to be resolved manually by removing that static-mac on all access-interfaces where it was configured.
Command Syntax
mac XXXX.XXXX.XXXX (| ip A.B.C.D | ipv6 X:X::X:X)
no mac XXXX.XXXX.XXXX (| ip A.B.C.D | ipv6 X:X::X:X)
Parameters
XXXX.XXXX.XXXX
Static mac address
A.B.C.D
Static IPv4 address
X:X::X:X
Static IPv6 address
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
#configure terminal
(config)# interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#mac 0000.0000.1001
(config-access-if)#mac 0000.0000.1002 ip 10.10.10.1
(config-access-if)#mac 0000.0000.1003 ipv6 1201::1
(config-access-if)#end
evpn mpls mac-ageing-time
Use this command to set the dynamically learned MAC aging time.
Use the no form of this command to set the age out the MACs in hardware to its default (300 seconds).
Note: This command affects the default bridge ageing time.
Command Syntax
evpn mpls mac-ageing-time <10-572>
no evpn mpls mac-ageing-time
Parameters
<10-572>
Ageing time in seconds.
Default
The default age out time is 300 seconds.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)#evpn mpls mac-ageing-time 10
 
 
evpn mpls multihoming enable
Use this command to enable evpn mpls multihoming
Use the no form of this command to disable evpn mpls multihoming.
Note: Node will have to be restarted for this to be applicable. If there are some nodes in topology which have multi-homed CEs, then the nodes which do not have multi-homed CEs should also enable multihoming, so that they can load share traffic to the multi-homed CEs.
Note: Before enabling multi-homing, configure the hardware-profiles with the hardware-profile filter evpn-mpls-mh commands.
Command Syntax
evpn mpls multihoming enable
no evpn mpls multihoming enable
Parameters
None
Default
By default evpn mpls multihoming is disabled.
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
#(config)# evpn mpls multihoming enable
#(config)# exit
 
 
evpn mpls vtep-ip-global
Use this command to set the source IP address is used to establish BGP peering with neighbor MPLS Nodes and to establish the EVPN MPLS tunnels.
Use the no version of this command to delete the source IP address.
Command Syntax
evpn mpls vtep-ip-global A.B.C.D
no evpn mpls vtep-ip-global A.B.C.D
Parameters
A.B.C.D
IPv4 address type.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
(config)#evpn mpls vtep-ip-global 10.10.11.1
(config)#no evpn mpls vtep-ip-global 10.10.11.1
evpn multi-homed
Use this command to configure interfaces as multi-homed and configure esi-value in case of physical and static lag and system-mac in case of Dynamic lag.
Use the no parameter of this command to unconfigure multi-homed on the interface.
Command Syntax
evpn multi-homed (esi XX:XX:XX:XX:XX:XX:XX:XX:XX | system-mac (XX-XX-XX-XX-XX-XX|XX:XX:XX:XX:XX:XX|XXXX.XXXX.XXXX)
no evpn multi-homed (esi | system-mac)
Parameters
XX:XX:XX:XX:XX:XX:XX:XX:XX
ESI value in HH:HH:HH:HH:HH:HH:HH:HH:HH - 9 octet format
XX-XX-XX-XX-XX-XX
Host MAC address (Option 1)
XX:XX:XX:XX:XX:XX
Host MAC address (Option 2)
XXXX.XXXX.XXXX
Host MAC address (Option 3)
Default
Default value is 0.
Command Mode
Interface Mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)# interface xe1
(config)# evpn multi-homed esi 00:11:22:33:44:55:66:77:88
(config)# exit
 
configure terminal
(config)# interface po1
(config)# evpn multi-homed system-mac 0000.0000.1111
(config)# exit
 
 
 
hardware-profile filter evpn-mpls-cw
This hardware filter needs to be enabled, to allow configuring EVPN-MPLS with control-word functionality per EVI. Filter cannot be disabled if "EVPN-MPLS" is globally enabled.
Before enabling EVPN MPLS per-evi control-word (evpn mpls id command), give this command.
Before disabling the hardware-profile, disable EVPN MPLS globally (no evpn mpls enable).
Note: You need to save the configuration and do a reboot after giving this command.
Use the disable form of this command to disable the configured hardware-profile.
Command Syntax
hardware-profile filter evpn-mpls-cw enable
hardware-profile filter evpn-mpls-cw disable
Parameters
None
Default
By default, EVPN MPLS control-word hardware-profile is disabled.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 6.1.0.
Example
#configure terminal
(config)# hardware-profile filter evpn-mpls-cw enable
(config)# hardware-profile filter evpn-mpls-cw disable
hardware-profile filter evpn-mpls-mh
Use this command to enable the hardware-profile for EVPN MPLS multihoming to successfully activate multi-homing in the hardware.
Before enabling EVPN MPLS multihoming (evpn mpls multihoming enable command), give this command.
Before disabling the hardware-profile, disable EVPN MPLS multihoming.
Note: You need to save the configuration and do a reboot after giving this command.
Use the disable form of this command to disable the configured hardware-profile.
Command Syntax
hardware-profile filter evpn-mpls-mh enable
hardware-profile filter evpn-mpls-mh disable
Parameters
None
Default
By default, EVPN MPLS multihoming hardware-profile is disabled.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
#configure terminal
(config)# hardware-profile filter evpn-mpls-mh enable
(config)# hardware-profile filter evpn-mpls-mh disable
hardware-profile statistics evpn-mpls
Use this command to enable or disable filter statistics in hardware for evpn mpls network counters.
Note: You need to save the configuration and do a reboot after giving this command.
Command Syntax
hardware-profile statistics evpn-mpls enable
hardware-profile statistics evpn-mpls disable
Parameters
None
Default
By default, evpn mpls statistics profile is disabled.
Command Mode
Config mode
Applicability
This command was introduced in OcNOS version 4.2.
Example
#configure terminal
(config)# hardware-profile statistics evpn-mpls enable
(config)# hardware-profile statistics evpn-mpls disable
 
 
 
 
 
 
host-reachability-protocol
Use this command to set the host reachable protocol to Ethernet-VPN over BGP. This defines BGP as the mechanism for host reachability advertisement to discover EVPN peers and to learn remote host details.
Use no form of this command to remove Ethernet-VPN as the host reachable protocol.
Command Syntax
host-reachability-protocol evpn-bgp WORD
no host-reachability-protocol evpn-bgp
Parameters
WORD
MAC Routing/Forwarding instance name. Maximum limit 32 characters
Default
None
Command Mode
EVPN MPLS Config mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
(config)#evpn mpls id 1
(config-evpn-mpls)#host-reachability-protocol evpn-bgp vrf1
ip address
Use this command to set anycast flag for primary and secondary subnets under IRB interface.
With this anycast gateway can be supported for multiple subnets.
Command Syntax
ip address [ <A.B.C.D/M> | anycast]
ip address [ <A.B.C.D> | <A.B.C.D> | anycast]
ip address [ <A.B.C.D/M> | secondary | anycast]
ip address [ <A.B.C.D> | <A.B.C.D> | secondary | anycast]
Default
The default value is router mac
Parameters
anycast
Anycast flag
secondary
Used for secondary address option
Command Mode
IRB_IF Mode
Applicability
The anycast flag was introduced in OcNOS version 6.3.0.
Example
(config)#interface irb2
(config-irb-if)#ip address 40.1.1.1/24 anycast
(config-irb-if)#ip address 41.1.1.1/24 secondary anycast
(config-irb-if)#
(config)#interface irb1
(config-irb-if)#ip address 42.1.1.1 255.255.255.0 anycast
(config-irb-if)#ip address 43.1.1.1 255.255.255.0 secondary anycast
(config-irb-if)#
 
ipv6 address
Use this command to set anycast flag for any configured subnets under IRB interface.
With this anycast gateway can be supported for multiple subnets.
Command Syntax
ipv6 address [ < X:X::X:X/M > | anycast]
Default
The default value is router mac
Parameters
anycast
Anycast flag
Command Mode
IRB_IF Mode
Applicability
The anycast flag was introduced in OcNOS version 6.3.0.
Example
(config)#interface irb1
(config-irb-if)# ipv6 address 1100::1/64 anycast
 
mac-holdtime
Use this command to set the MAC hold time for a MAC/IP or MAC.
The feature holds the MAC in hardware until BGP has withdrawn from the neighbors. This helps to reduce the flooding to other access ports.
This setting applies when the L2 Subifp is shut down, the physical port on which the access port is down, or the access port is removed from the VNID using the no form of the map vnid command.
When the MAC hold time is configured as -1, then the MAC is not removed from the hardware and is also not withdrawn from EVPN BGP.
Use the no form of this command to remove the MAC hold time for the MAC/IP or MAC.
Note: When a MAC is moved to discard state, traffic to and from this MAC is discarded. This is applicable only on statically configured MAC/MAC-IPs.
Command Syntax
mac-holdtime <-1-300>
no mac-holdtime
Parameters
<-1-300>
MAC hold time in seconds. Specify -1 to "never expire".
Default
The default holdtime for mac is 3 seconds.
Command Mode
EVPN MPLS mode and ACC_IF mode
Note: When configured in both modes, then the ACC_IF mode value takes preference for that access port.
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#configure terminal
(config)#evpn mpls id 3
(config-evpn-mpls)#mac-holdtime -1
(config-evpn-mpls)#exit
 
mac-vrf
Use this command to create a MAC VRF to use in EVPN routes.
Use the no form of this command to delete the MAC VRF.
Command Syntax
mac vrf WORD
no mac vrf WORD
Parameters
WORD MAC
Routing/Forwarding instance name. Maximum limit 32 characters
Command Mode
Configure mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#configure terminal
(config)#mac vrf vrf1
(config)#no mac vrf vrf1
 
 
 
 
map vpn-id
Use this command to map a sub-interface to a tenant.
Use the no form of this command to remove the tenant.
Command Syntax
map vpn-id <1-16777215>
no map vpn-id <1-16777215>
Parameters
<1-16777215>
VNID
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#map vpn-id 1
(config-access-if)#end
nd-cache disable
Use this command to disable ND cache for MAC/IPv6.
When the ND cache is disabled on an Access Circuits, It does not reply to any ND arriving on this port from the cache. It withdraws all MAC/IPs configured/learned on this Access Circuit and removes the MAC/IP entry for this AC from the local ND cache.
It also makes sure that on withdrawing the MAC/IP route, the MAC does not become unknown. If all routes for this MAC are being withdrawn because of this command, then it advertises a MAC-only route. This is done so that the MAC does not become unknown and only the cache functionality becomes disabled.
Use the no form of this command to enable ND cache for MAC/IPv6.
Note: On enabling the cache, an IP will be in conflict, then the cache enable will fail. The conflict has to be manually removed and then the cache enabled.
Note: Not applicable for the AC port which is mapped with ELINE/Xconnect Service.
Command Syntax
nd-cache disable
no nd-cache disable
Parameters
None
Default
By default, the nd-cache option is enabled.
Command Mode
Access if evpn mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
#configure terminal
(config)#interface xe1.1 switchport
(config-if)#access-if-evpn
(config-access-if)#nd-cache disable
(config-access-if)#end
 
show bgp l2vpn evpn
Use this command to display details about Layer 2 Virtual Private Network (L2VPN) Ethernet Virtual Private Network (EVPN) routes.
Note: A BGP EVPN route update received for an unreachable IP address is also listed by this command and as a best route. This is because the next hop tracking feature is not supported for the EVPN address family. However, the tunnel to this IP address is shown in unresolved state by the show nvo vxlan tunnel output.
Note: An E-tag (Ethernet tag) can have the value of zero/VID/VNID based on the use case. An E-tag can go up to 32 bits and no restrictions are noted in the RFC. Since an E-tag can have different values, it should not be compared with the label/VNID.
Command Syntax
show bgp l2vpn evpn ((vrf WORD)|(rd WORD)| time|)
show bgp l2vpn evpn mac-ip ((vrf WORD)|(rd WORD)|)
show bgp l2vpn evpn mcast
show bgp l2vpn evpn multihoming es-route <(rd WORD)|(vrf WORD)>
show bgp l2vpn evpn multihoming ethernet-ad-per-evi <(rd WORD)|(vrf WORD)>
show bgp l2vpn evpn multihoming ethernet-ad-per-es <(rd WORD)|(vrf WORD)>
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
MH-PE2#sh bgp l2vpn evpn
BGP table version is 22, local router ID is 102.1.1.1
Status codes: s suppressed, d damped, h history, * valid, > best, i - internal,
l - labeled, S Stale
Origin codes: i - IGP, e - EGP, ? - incomplete
 
[EVPN route type]:[ESI]:[VNID]:[relevent route informantion]
1 - Ethernet Auto-discovery Route
2 - MAC/IP Route
3 - Inclusive Multicast Route
4 - Ethernet Segment Route
5 - Prefix Route
 
Network Next Hop Metric LocPrf Weight Path Peer Encap
 
RD[101.1.1.1:1]
*>i [1]:[00:00:00:00:00:15:15:00:00:00]:[6001]:[18]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
*>i [3]:[6001]:[32,101.1.1.1]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
 
RD[101.1.1.1:2]
*>i [1]:[00:00:00:00:00:15:15:00:00:00]:[10]:[19]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
 
RD[101.1.1.1:22]
*>i [1]:[00:00:00:00:00:15:15:00:00:00]:[4294967295]:[0]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
*>i [4]:[00:00:00:00:00:15:15:00:00:00]:[32,101.1.1.1]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
 
RD[102.1.1.1:1] VRF[l2vrf1]:
*> [1]:[00:00:00:00:00:15:15:00:00:00]:[6001]:[19]
102.1.1.1 0 100 32768 i ---------- MPLS
* i 101.1.1.1 0 100 0 i 101.1.1.1 MPLS
* i [1]:[00:00:00:00:00:15:15:00:00:00]:[4294967295]:[0]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
*> [2]:[00:00:00:00:00:15:15:00:00:00]:[6001]:[48,0000:0000:aa11]:[0]:[19]
102.1.1.1 0 100 32768 i ---------- MPLS
*> [2]:[00:00:00:00:00:15:15:00:00:00]:[6001]:[48,0000:0000:aa12]:[32,12.12.12.10]:[19]
102.1.1.1 0 100 32768 i ---------- MPLS
*> [2]:[00:00:00:00:00:15:15:00:00:00]:[6001]:[48,0000:0000:aa13]:[128,1201::10]:[19]
102.1.1.1 0 100 32768 i ---------- MPLS
* i [3]:[6001]:[32,101.1.1.1]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
*> [3]:[6001]:[32,102.1.1.1]
102.1.1.1 0 100 32768 i ---------- MPLS
* i [3]:[6001]:[32,105.1.1.1]
105.1.1.1 0 100 0 i 105.1.1.1 MPLS
 
RD[102.1.1.1:2] VRF[l2vrf2]:
* i [1]:[0]:[11]:[641]
105.1.1.1 0 100 0 i 105.1.1.1 MPLS
*> [1]:[00:00:00:00:00:15:15:00:00:00]:[10]:[18]
102.1.1.1 0 100 32768 i ---------- MPLS
* i 101.1.1.1 0 100 0 i 101.1.1.1 MPLS
* i [1]:[00:00:00:00:00:15:15:00:00:00]:[4294967295]:[0]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
 
RD[102.1.1.1:22] VRF[evpn-gvrf-1]:
*> [1]:[00:00:00:00:00:15:15:00:00:00]:[4294967295]:[0]
102.1.1.1 0 100 32768 i ---------- MPLS
* i [4]:[00:00:00:00:00:15:15:00:00:00]:[32,101.1.1.1]
101.1.1.1 0 100 0 i 101.1.1.1 MPLS
*> [4]:[00:00:00:00:00:15:15:00:00:00]:[32,102.1.1.1]
102.1.1.1 0 100 32768 i ---------- MPLS
 
RD[105.1.1.1:1]
*>i [3]:[6001]:[32,105.1.1.1]
105.1.1.1 0 100 0 i 105.1.1.1 MPLS
 
RD[105.1.1.1:2]
*>i [1]:[0]:[11]:[641]
105.1.1.1 0 100 0 i 105.1.1.1 MPLS
 
Total number of prefixes 21
MH-PE2#
MH-PE2#
 
show evpn mpls
Use this command to display the EVPN Information.
Command Syntax
show evpn mpls (|id <1-16777215>)
Parameters
<1-16777215>
EVID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
MH-PE2#sh evpn mpls
EVPN-MPLS Information
=================
Codes: NW - Network Port
AC - Access Port
(u) - Untagged
 
VPN-ID EVI-Name EVI-Type Type Interface ESI VLAN DF-Status Src-Addr Dst-Addr
_______________________________________________________________________________________________________________________________
6001 ---- L2 NW ---- ---- ---- ---- 102.1.1.1 101.1.1.1
6001 ---- L2 NW ---- ---- ---- ---- 102.1.1.1 105.1.1.1
6001 ---- -- AC xe1.301 --- Single Homed Port --- ---- ---- ---- ----
6001 ---- -- AC po10.301 00:00:00:00:00:15:15:00:00:00 ---- DF ---- ----
6002 ---- L2 NW ---- ---- ---- ---- 102.1.1.1 101.1.1.1
6002 ---- L2 NW ---- ---- ---- ---- 102.1.1.1 105.1.1.1
6002 ---- -- AC po10.302 00:00:00:00:00:15:15:00:00:00 ---- NON-DF ---- ----
 
Total number of entries are 7
MH-PE2#
 
show evpn mpls arp-cache
Use this command to display the ARP cache information.
Command syntax
show evpn mpls arp-cache (|evid <1-16777215>) summary
Parameters
evid
EVID
<1-16777215>
Range supported for EVID
summary
Ethernet Virtual Private Network ID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
PE1#show evpn mpls arp-cache
MPLS-EVPN ARP-CACHE Information
===============================
EVPN-ID Ip-Addr Mac-Addr Type Age-Out Retries-Left
_____________________________________________________________________________
2001 122.122.122.1 0000.0000.1111 Dynamic Local ----
2001 122.122.122.2 0000.0000.2222 Dynamic Remote ----
Total number of entries are 2
PE1#
show evpn mpls counters
This command to display the ingress/egress evpn-mpls network port statistic counters for both BUM and known unicast data traffic.
Note: To see the statistics, you must enable the command hardware-profile statistics evpn-mpls enable and reboot the board for the command to take effect.
Command syntax
show evpn mpls counters ((network (ingress|(egress dst <A.B.C.D>)))| vpn-id <1-16777215> (network (ingress|(egress dst <A.B.C.D>))))
Parameters
<1-16777215>
VPN identifier
A.B.C.D
Ipv4 address
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.2.
Examples
DUT2#show evpn mpls counters network egress
+----------+---------------+-----------+-----------+
| VPN-ID | DESTINATION | BUM | Unicast |
| | PEER | TX (pkts) | TX (pkts) |
+----------+---------------+-----------+-----------+
2000 2.2.2.2 140136 68900
1999 2.2.2.2 140138 68899
1998 2.2.2.2 140136 68899
1997 2.2.2.2 140137 68897
DUT2#
DUT2#show evpn mpls counters network ingress
+----------+-----------+-----------+
| VPN-ID | BUM | Unicast |
| | RX (pkts) | RX (pkts) |
+----------+-----------+-----------+
30 0 800122
10 0 727383
4001 5 727362
3003 0 0
3002 727368 0
3001 3 727364
DUT2#
 
 
 
show evpn mpls label alias
Use this command to display the alias label details of the MH Nodes.
Command syntax
show evpn mpls label alias
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
Remote-PE3#sh evpn mpls label alias
S - Self
R - Remote
ESI PE-IP-ADDRESS TENANT ALIAS-LABEL
=================================================================================
00:00:00:00:00:15:15:00:00:00 101.1.1.1(R) 6001 18
00:00:00:00:00:15:15:00:00:00 101.1.1.1(R) 6002 20
00:00:00:00:00:15:15:00:00:00 101.1.1.1(R) 11 19
00:00:00:00:00:15:15:00:00:00 102.1.1.1(R) 6001 19
00:00:00:00:00:15:15:00:00:00 102.1.1.1(R) 6002 20
00:00:00:00:00:15:15:00:00:00 102.1.1.1(R) 11 18
Remote-PE3#
Remote-PE3#
 
show evpn mpls label esi
Use this command to display the esi label details of MH Nodes.
Command syntax
show evpn mpls label esi
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Examples
MH-PE1#sh evpn mpls label esi
S - Self
R - Remote
ESI PE-IP-ADDRESS ESI-LABEL
================================================================
00:00:00:00:00:13:13:00:00:00 101.1.1.1(S) 38
00:00:00:00:00:13:13:00:00:00 102.1.1.1(R) 43
00:00:00:00:00:15:15:00:00:00 101.1.1.1(S) 37
00:00:00:00:00:15:15:00:00:00 102.1.1.1(R) 42
 
 
 
show evpn mpls mac-table
Use this command to display the host MAC address table.
Command Syntax
show evpn mpls mac-table (|evid <1-16777215>|) (summary | hardware |)
Parameters
<1-16777215>
EVID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
PE1#sh evpn mpls mac-table
=====================================================================================================================================================
EVPN MPLS MAC Entries
=====================================================================================================================================================
VNID Interface VlanId Inner-VlanId Mac-Addr VTEP-Ip/ESI Type Status Time-out AccessPortDesc
_____________________________________________________________________________________________________________________________________________________
 
2001 ---- ---- ---- 0000.0000.aa21 101.1.1.1 Dynamic Remote ------- -------
2001 xe1.14 ---- ---- 0000.0000.bb21 105.1.1.1 Dynamic Local ------- -------
1001 ---- ---- ---- 0000.0000.aa11 101.1.1.1 Dynamic Remote ------- -------
1001 xe1.2 ---- ---- 0000.0000.bb11 105.1.1.1 Static Local ------- -------
 
Total number of entries are : 4
 
PE1#
show evpn mpls nd-cache
Use this command to display the ND cache information.
Command Syntax
show evpn mpls nd-cache (|evid <1-16777215>) summary
Parameters
evid
EVID
<1-16777215>
Range supported for EVID
summary
Ethernet Virtual Private Network ID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
PE1#
PE1#show evpn mpls nd-cache
MPLS-EVPN ND-CACHE Information
==============================
EVPN-ID Ip-Addr Mac-Addr Type Age-Out Retries-Left
_____________________________________________________________________________________________
1001 1201::1 0000.0000.cc10 Dynamic Local ----
1001 1201::2 0000.0000.dd10 Dynamic Remote ----
Total number of entries are 2
PE1#
PE1#
 
show evpn mpls route-count
Use this command to display the evpn active route (MAC-IP.MAC-IPv6 and MAC-only) count information.
Command Syntax
show evpn mpls route-count (|evid <1-16777215>)
Parameters
evid
EVID
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 5.0.
Examples
PE1#show evpn mpls route-count
EVPN-MPLS Active route count information
====================================
Max route count : 32768
Active route count: 6
 
---------------------------------------------
VNID Total MACONLY MACIPv4 MACIPv6
---------------------------------------------
6001 3 1 1 1
7001 3 1 1 1
 
Total number of entries are 2
PE1#
 
Table 4-32 explains the output fields.
 
Table 4-32: show evpn mpls route-count fields
Field
Description
Max route count
Maximum number of route count in evpn mpls.
Active route count
Number of active route count in the interface.
VNID
VNID is used to identify Layer 2 segments and to maintain Layer 2 isolation between the segments.
Total
Total number of entries for the interface.
MACONLY
The MAC-only route for both the local and the remote entries in the EVPN MPLS instance route table.
MACIPv4
IPv4 media access control (MAC) address for a default virtual gateway.
MACIPv6
IPv6 media access control (MAC) address for a default virtual gateway.
show evpn mpls static host state
Use this command to display the state of the host which is configured statically.
Command Syntax
show evpn mpls static host state
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
MH-PE2#sh evpn mpls static host status
MPLS Static Host Information
=============================
Codes: NW - Network Port
AC - Access Port
(u) - Untagged
 
VNID Ifname Outer-Vlan Inner-vlan Ip-Addr Mac-Addr Status
___________________________________________________________________________________________________________
6001 po10.301 --- --- 0.0.0.0 0000.0000.aa11 Active
6001 po10.301 --- --- 12.12.12.10 0000.0000.aa12 Active
6001 po10.301 --- --- 1201::10 0000.0000.aa13 Active
 
Total number of entries are 3
MH-PE2#
 
 
 
 
 
 
 
 
 
show evpn mpls status
Use this command to display EVPN MPLS status in hardware.
Command Syntax
show evpn mpls status
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
PE-1#show evpn mpls status
EVPN-MPLS is ACTIVE in Hardware
show evpn mpls tunnel
Use this command to view the active EVPN MPLS tunnels for ELAN.
Command Syntax
show evpn mpls tunnel (| summary)
Parameters
summary
Summary information
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Example
PE1#sh evpn mpls tunnel
EVPN-MPLS Network tunnel Entries
Source Destination Status Up/Down Update evpn-id
===================================================================================
101.1.1.1 105.1.1.1 Installed 00:43:09 00:43:09 2001
101.1.1.1 105.1.1.1 Installed 00:43:09 00:43:09 1001
 
Total number of entries are 2
PE1#
 
show evpn mpls tunnel label
Use this command to display the label details of the EVPN tunnels.
Command Syntax
show evpn mpls tunnel label
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0 and RSVP multipath was introduced in OcNOS version 5.0.
Example
PE1#show evpn mpls tunnel label
EVPN-MPLS Network tunnel labels
(*) in Policy - tunnel-policy inherited from mac-vrf
================+===========+=========+===============+=========+=========+=========+=========+============+=========+============+========
Local Remote RSVP-Multipath Underlay
Destination Status VPN-ID Policy MC-Label UC-Label MC-Label UC-Label Grp-Name NHLFE-ix NW-Intf NW-Label
================+===========+=========+===============+=========+=========+=========+=========+============+=========+============+========
3.3.3.3 Installed 601 -- 640 17 640 17 -- -- xe10 24320
3.3.3.3 Installed 801 -- 641 18 641 18 -- -- xe10 24320
4.4.4.4 Installed 1601 -- 642 20 640 17 MP1 12 NA NA
4.4.4.4 Installed 1801 -- 643 21 641 18 MP1 12 NA NA
Total number of entries are 4
PE1#
 
 
 
show evpn mpls xconnect
Use this command to display the VPWS xconnect details of the MTU, AC-NW connections, and network status.
Command Syntax
show evpn mpls xconnect
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
Remote-PE3#sh evpn mpls xconnect
EVPN-MPLS Xconnect Info
========================
AC-AC: Local-Cross-connect
AC-NW: Cross-connect to Network
AC-UP: Access-port is up
AC-DN: Access-port is down
NW-UP: Network is up
NW-DN: Network is down
NW-SET: Network and AC both are up
 
Local Remote Connection-Details
================================ ============ ===================================================================================
VPN-ID EVI-Name MTU VPN-ID Source Destination PE-IP MTU Type NW-Status
================================ ============ ===================================================================================
11 ---- 1500 10 xe1.10 00:00:00:00:00:15:15:00:00:00 102.1.1.1 1500 AC-NW NW-SET
101.1.1.1 1500 ---- ----
40 ---- 1500 30 xe2.2 --- Single Homed Port --- 102.1.1.1 1500 AC-NW NW-SET
 
Total number of entries are 2
Remote-PE3#
 
show evpn mpls xconnect tunnel
Use this command to view the active EVPN MPLS Tunnels for ELINE.
Command Syntax
show evpn mpls xconnect tunnel (| summary)
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0.
Example
PE1#
PE1#show evpn mpls xconnect tunnel
EVPN-MPLS Network tunnel Entries
Source Destination Status Up/Down Update local-evpn-id remote-evpn-id
========================================================================================================
101.1.1.1 105.1.1.1 Installed 01:25:48 01:25:48 50 60
101.1.1.1 105.1.1.1 Installed 00:07:53 00:07:53 30 40
101.1.1.1 105.1.1.1 Installed 00:07:55 00:07:55 10 20
 
Total number of entries are 3
PE1#
show evpn mpls xconnect tunnel label
Use this command to display the label details of EVPN tunnels for ELINE.
Command Syntax
show evpn mpls xconnect tunnel label
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 4.0 and RSVP-Multipath is introduced in OcNOS version 5.0.
Example
PE1#
PE1#show evpn mpls xco tunnel label
EVPN-MPLS Network tunnel labels
(*) in Policy - tunnel-policy inherited from mac-vrf
================+===========+=========+=========+===============+=========+=========+============+=========+============+=========
Local Remote Local Remote RSVP-Multipath Underlay
Destination Status VPWS-ID VPWS-ID Policy UC-Label UC-Label Grp-Name NHLFE-ix NW-Intf NW-Label
================+===========+=========+=========+===============+=========+=========+============+=========+============+=========
3.3.3.3 Installed 501 1 -- 16 16 MP2 10 NA NA
4.4.4.4 Installed 1501 1001 -- 19 16 -- -- xe10 24320
Total number of entries are 2
PE1#
 
 
 
 
show running-config evpn mpls
Use this command to display the current running configuration of EVPN MPLS.
Command Syntax
show running-config evpn mpls
Parameters
None
Command Mode
Exec mode
Applicability
This command was introduced in OcNOS version 3.0.
Examples
#show running-config evpn mpls
!
evpn mpls enable
!
evpn mpls vtep-ip-global 101.1.1.1
!
evpn mpls multihoming enable
!
evpn esi hold-time 30
!
evpn mpls mac-ageing-time 180
!
evpn mpls arp-nd refresh-timer 60
!
evpn mpls id 10 xconnect target-mpls-id 20
host-reachability-protocol evpn-bgp l2vrf5
!
vpn-id 1001
host-reachability-protocol evpn-bgp l2vrf1
mac-holdtime 300
evi-name ELANE
!
interface xe1.2 switchport
access-if-evpn
map vpn-id 1001
dynamic-learning disable
arp-nd flood-suppress
mac-holdtime 200
arp-cache disable
nd-cache disable
mac 0000.0000.aa31
mac 0000.0000.aa32 ip 12.12.12.10
mac 0000.0000.aa33 ipv6 1201::1
!
interface xe1.10 switchport
encapsulation dot1q 10
access-if-evpn
map vpn-id 10
!
 
tunnel-select-policy
Use this command to associate tunnel-policy to an EVPN instance and to a mac-vrf. This will be used while selecting transport for EVPN service. In particular, an EVPN instance could be either an ELINE or ELAN type and may also multi-homing also enabled.
Use the no parameter with this command to un-configure tunnel-policy from the EVPN instance.
Please refer MPLS Service Mapping Configuration for Tunnel-policy Name configuration.
Command Syntax
tunnel-select-policy NAME
no tunnel-select-policy
Parameters
NAME
Name of tunnel-policy
Command Mode
EVPN MPLS Config mode and MAC_VRF MODE
Note:
Applicability
This command was introduced in OcNOS version 4.1 but the support for this CLI under mac-vrf mode is introduced in OcNOS-SP version 4.2.
Examples
#configure terminal
(config)#mac vrf vrf1
(config-vrf)# tunnel-select-policy policy1
(config-vrf)#end
(config)# evpn mpls id 1001
(config-evpn-mpls)# tunnel-select-policy policy2
(config-evpn-mpls)# end
(config)# evpn mpls id 10 xconnect target-mpls-id 20
(config-evpn-mpls)# tunnel-select-policy policy3
(config-evpn-mpls)# end