request system evpn forwarding vlans
Syntax
request system evpn forwarding vlans <no-confirm> <instance instance> <vlan vlan> <detail> <module>
Description
The request system evpn forwarding vlans command validates EVPN-VXLAN
forwarding by comparing EVPN Type 2 MAC and MAC-IP reachability across the control
plane, kernel programming, and forwarding programming layers. It reports an
In-Sync or Out-of-Sync status per VLAN, and with
the detail option it highlights specific MAC and MAC-IP table
mismatches with error indicators. Inconsistencies such as entries that are missing,
stale, or resolved differently across layers, can lead to misdirected traffic,
intermittent reachability, or drops.
You can use this command for a broad health check, or narrow the scope to a routing
instance and VLAN (request system evpn forwarding vlans instance
instance_name vlan vlan_name) and
to a specific module using the module mac-table or module
mac-ip-table options. You can add the detail option for
additional information. Because this check can be resource-intensive, the CLI may prompt
for confirmation. You can limit the scope to reduce the impact. Use the
no-confirm option only when you’ve verified it’s safe. When you
run the request system evpn forwarding vlans command, the results are a
point-in-time view. Run the check only after the system reaches steady state to avoid
transient differences during convergence, MAC moves, or control-plane churn.
Options
| no-confirm |
Do not ask for confirmation |
| instance |
Routing instance |
| vlan |
VLAN name |
| detail |
Display detailed output |
| format |
Display formatted output |
| module |
Module name
|
Required Privilege Level
view
Output Fields
Table 1
describes the output fields for the request system evpn forwarding
vlans command. Output fields are listed in the approximate order in which
they appear.
| Field Name | Field Description | Level of Output |
|---|---|---|
|
Evpn host |
Device Hostname |
All levels |
|
Summary |
Overall status: Either |
All levels |
|
Vlans in sync |
Number of VLANs in sync |
All levels |
|
Vlans out of sync |
Number of VLANs out of sync |
All levels |
|
MAC TABLE |
Title for MAC table section |
detail |
|
MAC IP TABLE |
Title for MAC-IP table section |
detail |
|
Routing-Instance |
Routing instance name |
detail |
|
Vlan name |
VLAN name |
detail |
|
Mac Entry |
Reports the MAC address table entry for each MAC learned by the system. |
detail |
|
Mac-Ip Entry |
MAC-to-IP binding entry for an EVPN/static MAC-IP configuration |
detail |
|
Error |
The error code displays when the Possible error codes:
|
detail |
Sample Outputs
request system evpn forwarding vlans
The following output shows a summary output with 2 VLANs that are in
sync and 0 VLANs that are out of sync.
user@host> request system evpn forwarding vlans Do you want to proceed ? [yes,no] (no) yes EVPN-VXLAN Status : Evpn host : hostname Summary : In-Sync Vlans in sync : 2 Vlans out of sync : 0
The following output shows a summary output with 2 VLANs that are in
sync and 0 VLANs that are out of sync using the
display XML format.
user@host> request system evpn forwarding vlans | display xml
<system-evpn>
<evpn-host>hostname</evpn-host>
<vlans>
<summary>In-Sync</summary>
<vlans-in-sync>2</vlans-in-sync>
<vlans-out-of-sync>0</vlans-out-of-sync>
</vlans>
</system-evpn>
The following output shows a summary output with 1 VLAN that is in
sync and 1 VLAN that is out of sync.
user@host> request system evpn forwarding vlans Do you want to proceed ? [yes,no] (no) yes EVPN-VXLAN Status : Evpn host : hostname Summary : In-Sync Vlans in sync : 1 Vlans out of sync : 1
The following output shows a summary output with 1 VLAN that is in
sync and 1 VLAN that is out of sync using the
display XML format.
user@host> request system evpn forwarding vlans | display xml
<system-evpn>
<evpn-host>hostname</evpn-host>
<vlans>
<summary>In-Sync</summary>
<vlans-in-sync>1</vlans-in-sync>
<vlans-out-of-sync>1</vlans-out-of-sync>
</vlans>
</system-evpn>
request system evpn forwarding vlans detail
Vlans out of sync field is greater than 0.The following output shows a detail output with 2 VLANs that are
in sync and 0 VLANs that are out of sync.
user@host> request system evpn forwarding vlans detail
Do you want to proceed ? [yes,no] (no) yes
EVPN-VXLAN Status :
Evpn host : hostname
Summary : In-Sync
Vlans in sync : 2
Vlans out of sync : 0
The following output shows a detail output with 2 VLANs that are
in sync and 0 VLANs that are out of sync using
the display XML format.
user@host> request system evpn forwarding vlans detail | display xml
<system-evpn>
<evpn-host>hostname</evpn-host>
<vlans>
<summary>In-Sync</summary>
<vlans-in-sync>2</vlans-in-sync>
<vlans-out-of-sync>0</vlans-out-of-sync>
</vlans>
</system-evpn>
The following output shows a detail output with 1 VLAN that is
in sync and 1 VLAN that is out of sync.
user@host> request system evpn forwarding vlans detail
Do you want to proceed ? [yes,no] (no) yes
EVPN-VXLAN Status :
Evpn host : hostname
Summary : Out-of-Sync
Vlans in sync : 1
Vlans out of sync : 1
MAC TABLE :
Routing-Instance Vlan name Mac Entry Error
test1 v100 00:11:22:33:44:55 E_MAC_MISSING_L2_LEARNING,E_MAC_MISSING_KERNEL
test2 v200 AA:11:22:33:44:55 E_MAC_MISSING_L2_LEARNING,E_MAC_MISSING_KERNEL
MAC IP TABLE :
Routing-Instance Vlan name Mac-Ip Entry Error
test1 v100 10.1.1.25 E_MAC_MISSING_L2_LEARNING,E_MAC_MISSING_FPC0
test2 v200 10.2.2.22 E_MAC_MISSING_L2_LEARNING,E_MAC_MISSING_FPC0
The following output shows a detail output with 2 VLANs that are
in sync and 2 VLANs that are out of sync using
the display XML format.
user@host> request system evpn forwarding vlans detail | display xml
<system-evpn>
<evpn-host>hostname</evpn-host>
<vlans>
<summary>Out-of-Sync</summary>
<vlans-in-sync>2</vlans-in-sync>
<vlans-out-of-sync>2</vlans-out-of-sync>
<mac-table>
<instance>test1</instance>
<vlan>v100</vlan>
<entry>00:11:22:33:44:55</entry>
<error>E_MAC_MISSING_L2_LEARNING, E_MAC_MISSING_KERNEL</error>
</mac-table>
<mac-ip-table>
<instance>test1</instance>
<vlan>v100</vlan>
<entry>10.1.1.25</entry>
<error>E_MAC_MISSING_L2_LEARNING, E_MAC_MISSING_FPC0</error>
</mac-ip-table>
</vlans>
</system-evpn>
Release Information
Statement introduced in Junos OS Evolved Release 26.1R1