L2RIB

L2RIB (Layer 2 Routing Information Base) configuration manages the EVPN MAC mobility settings on NX-OS devices, including duplicate MAC address detection and recovery. A MAC address is marked as duplicate when it moves the configured number of times within the detection duration; L2RIB then periodically retries learning the duplicate MAC after the recovery timeout, up to the configured retry count. These settings are typically aligned across all VTEP leaf switches in a VXLAN EVPN fabric.

Diagram

Classes

nxos

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No
templates	List	templates	No

devices (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

templates (nxos)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (nxos.devices)

Name	Type	Constraint	Mandatory	Default Value
system	Class	system	No

system (nxos.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
l2rib	Class	l2rib	No

l2rib (nxos.devices.configuration.system)

Name	Type	Constraint	Mandatory	Default Value
dup_host_mac_detection_moves	Integer	min: 1, max: 1000	No
dup_host_mac_detection_duration	Integer	min: 2, max: 36000	No
dup_host_mac_recovery_timeout	Integer	min: 0, max: 1800	No
dup_host_mac_recovery_retry_count	Integer	min: 0, max: 3000	No

Examples

Example 1: VXLAN leaf with tuned duplicate MAC detection

nxos:
  devices:
    - name: LEAF1
      configuration:
        system:
          l2rib:
            dup_host_mac_detection_moves: 10
            dup_host_mac_detection_duration: 300

Example 2: VXLAN leaf with duplicate MAC detection and recovery

nxos:
  devices:
    - name: LEAF2
      configuration:
        system:
          l2rib:
            dup_host_mac_detection_moves: 10
            dup_host_mac_detection_duration: 300
            dup_host_mac_recovery_timeout: 60
            dup_host_mac_recovery_retry_count: 5