Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

l2-learning

Syntax

Hierarchy Level

Description

Configure Layer 2 (L2) address learning and forwarding properties globally.

The remaining statements are explained separately. See CLI Explorer.

Options

arp-nd-probe-disable

Disable probing for ip address.

arp-nd-probe-failed-log

Enable syslog when probing for ip address fails.

crb-proxy-mac Configure proxy MAC address to be used in MAC-IP refresh.

In the case of central routing and bridging deployments, you need to configure the crb-proxy-mac statement on all the leaf nodes. Use the following configuration to configure crb-proxy-mac CLI statement:

On IPv4:

user@host# set protocols l2-learning crb-proxy-mac family inet mac-address

On IPv6:

user@host#set protocols l2-learning crb-proxy-mac family inet6 mac-address

When IRB is not configured on the leaf devices, to do ARP/ND refresh upon ARP/ND timer (Mac-IP timer) expiration, the configured MAC address is used as the source MAC address.

ctxt-history Configure the number and size of files to collect for troubleshooting Layer 2 address learning issues in Ethernet VPN (VPN) networks.
decapsulate-accept-inner-vlan

Accept VXLAN packets with inner VLAN disabled by default.

destination-udp-port

VXLAN destination UDP port

  • Default: 4789

  • Range: 4789 through 65535

disable-vxlan-multicast-transit

Reduces the processing load on the VXLAN Tunnel Endpoint (VTEP) loopback interface by preventing the re-encapsulation and forwarding of specified multicast group traffic (or all multicast traffic) to other VTEPs in the VXLAN.

garp-na-enable

When a new static entry is provisioned (local provider edge (PE)) or EVPN-learned (remote PE), the PE can send an unsolicited gratuitous ARP (GARP) or NA message to all the connected access customer edge (CE) routers so that they can update their ARP/ND caches. If this feature is required, a global knob garp-na-enable must be configured.

global-ctx-limit

Set the debug context history limit to define how many events the system logs in process memory for debugging. You can specify a value from 0 to 5000000, representing the number of captured events. Each even consumes up to 200 bytes of memory. By default, the system stores 256000 entries to log Layer 2 process events. To disable this feature, set the global-ctx-limit to 0. The system then frees the memory used for context logging and stop logging further events.

  • Range: 0 to 5000000 event entries

  • Default: 256000 event entries

global-ctx-mem-limit

Context history memory limit (in bytes).

global-mac-ip-limit

Limits the total number of MAC-IP binding entries that can be added system-wide to the MAC-IP bindings database.

global-mac-ip-snooping

Enable global mac-ip snooping feature

global-mac-ip-table-aging-time

System level MAC+IP table aging time (seconds)

  • Range: 60 through 1000000

global-mac-limit

Limits the total number of MAC addresses that can be learned system-wide from logical interfaces on the router or switch.

global-mac-move

Sets parameters for detecting and responding to MAC address moves when a MAC address frequently appears on a different interface to generate reports and prevent loops in the network.

global-mac-pinning-discard-notification-interval

Set interval for MAC Pinning discard notification (seconds)

  • Range: 2 through 86400

global-mac-statistics

Enable MAC address statistics at system level

global-mac-table-aging-time

System level MAC table aging time (seconds)

  • Range: 10 through 1000000

global-mode

Global L2 Mode

  • switching—Switching mode

  • transparent-bridge—Transparent bridge mode

global-no-control-mac-aging

Disable control MAC-address aging from software.

global-no-hw-mac-learning

Disable hardware MAC-address learning at system level.

global-no-mac-learning

Disable dynamic MAC address learning at system level.

global-static-mac-move-drop-log

Set global static mac move drop and log notification.

global-le-bridge-domain-aging-time

Specify the aging timer for the Logical Ethernet (LE) bridge-domain. The system learns the MAC address using the next hop (NH) and the bridge-domain (BD), which together form the NHBD. The aging timer, specified in seconds global-le-bridge-domain-aging-time <seconds>, determines how long the system retains the MAC entry in the forwarding table before removing it. Setting a shorter timer removes NHBD entries more quickly.

  • Range: 120 to 1000000 seconds

mac-learning-log system-timezone

By default, the mac-learning-logs are stored in UTC timestamps. The logs are displayed in the output of the show ethernet-switching mac-learning-log command.

You can configure to display the logs in the system timezone by default by using the mac-learning-log system-timezone option.

mclag-arp-nd-sync

It is a configuration statement that enables synchronization of Address Resolution Protocol (ARP) and Neighbor Discovery (ND) entries between MC-LAG peers during power-up, reboot, or IRB interface state changes. The statement is only supported on platforms running Junos OS.

mclag-arpreq-sync

In an active-active MC-LAG configuration, to synchronize configure Address Resolution Protocol (ARP) requests between the MC-LAG peers, configure the mclag-arpreq-sync statement at the edit protocols l2-learning hierarchy level. The statement is only supported on platforms running Junos OS.

niso-maintenance

The niso-maintenance statement enables you to shut down all L2 interfaces, or only those associated with a specific network isolation group, to facilitate controlled and efficient maintenance operations.

no-mclag-ifa-sync

The no-mclag-ifa-sync statement disables the automatic creation of static Address Resolution Protocol (ARP) and Neighbor Discovery (ND) entries in MC-LAG configurations. The statement is only supported on platforms running Junos OS.

Note:

The statement is not supported on QFX series.

platform-parameters

Sets platform-specific options for Layer 2 address learning features.

source-udp-port

VXLAN source UDP port

  • Range: 49152 through 65535

telemetry

Enables streaming of real-time operational data (such as traffic patterns, device status, and error rates) from Juniper devices to external collectors over gRPC connections for network monitoring, troubleshooting, and performance analysis.

traceoptions

Defines tracing operations that log protocol events, state changes, errors, and packet flows to a file in /var/log for debugging and troubleshooting purposes across various Junos OS protocols and services.

Required Privilege Level

routing—To view this statement in the configuration.

routing-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 8.4.

Statement modified in Junos OS Release 9.5. Support for global mode added in Junos OS Release 15.1X49-D40.

global-le-bridge-domain-aging-time option introduced in Junos OS Release 14.2R5 for the MX Series.

global-mac-ip-limit and global-mac-ip-table-aging-time options introduced in Junos OS Release 17.4R1 for MX Series routers and EX9200 switches.

global-ctx-limit option introduced in Junos OS Release 20.2R3.

mac-learning-log system-timezone option introduced in Junos OS Release 25.4R1 for EX Series and QFX Series switches.