configure elrp-client periodic

configure elrp-client periodic {vlan} vlan_name ports [ports | all | none] {remote-endpoints vxlan all} {interval interval {seconds | milliseconds}} {log | log-and-trap | trap} {disable-port {egress | ingress} {duration {seconds} | permanent}}

Description

Starts periodic ELRP packet transmission on the specified ports of the VLAN or VXLAN remote tunnel endpoints (RTEPs) using the specified interval.

Syntax Description

vlan Specifies a VLAN name.
vlan_name Specifies a VLAN name.
ports Specifies the set of VLAN ports for packet transmission.
all Specifies all ports for packet transmission.
none Specifies no ports for packet transmission. This option allows you to configure (unambiguously) ELRP on only VXLAN RTEPs.
remote-endpoints Specifies to include the remote endpoints, if any, in this VLAN. Only supported with software ELRP.
vxlan Specifies VXLAN remote endpoints.
interval Time interval between two successive ELRP PDUs.
interval Software ELRP interval range between 1–600 seconds or 1,000–600,000 ms. Hardware-assisted ELRP interval range is between 3–600,000 ms. Default is 1 second.
seconds Specifies that time interval is in the unit of seconds.
milliseconds Specifies that time interval is in the unit of milliseconds.
log Specifies that a message should be logged in the system log file when ELRP packets are received back indicating detection of network loop, or no packets are received within the specified duration.
log-and-trap (Default) Specifies that a message should be logged in the system log file and trap message should be sent to the SNMP manager when ELRP packets are received back indicating detection of network loop, or no packets are received within the specified duration.
trap Specifies that a trap message should be sent to the SNMP manager when ELRP packets are received back indicating detection of network loop, or no packets are received within the specified duration.
disable-port Specifies that the port should be disabled where the looped PDU is received.
egress Disable port where looped PDU was transmitted. Only supported with software ELRP.
duration Specifies a hold time that the port is kept disabled before re-enabling.
seconds The number of seconds the port is kept disabled.
permanent Specifies that the port is disabled permanently. User intervention is required to enable.

Default

The default interval between consecutive packet transmissions is 1 second.

If a duration in seconds is not specified, the default is permanent.

If not specified, log-and-trap action is the default.

Usage Guidelines

This command starts periodic ELRP packet transmission on the specified ports of the VLAN using the specified interval. If any of these transmitted packets is returned, indicating loopback detection, the ELRP client performs a configured action of logging a message in the system log file and/or sending a trap to the SNMP manager.

Beginning with ExtremeXOS 12.4, you have the option to automatically disable the port where the looped packet arrives and to specify the time interval for which the port remains disabled. When that specified time expires, the port is automatically enabled.

Should a loop occur on multiple ports, only the first port in the VLAN on which the PDU is received is disabled. The second port is ignored for 1 or 2 seconds and then if another PDU is received, that port is disabled until the loop is gone. This prevents shutting down all ports in the VLAN.

Use either the configure elrp-client one-shot or the run elrp command to configure non-periodic, one-time transmission of ELRP packets.

The ELRP client must be enabled globally in order for it to work on any VLANs. Use the enable elrp-client command to globally enable the ELRP client.

The ELRP client can be disabled globally so that none of the ELRP VLAN configurations take effect. Use the disable elrp-client command to globally disable the ELRP client.

Use the show elrp command to check the ELRP status and the show elrp disabled-ports command to view details of ELRP disabled ports.

For the interval option with hardware-assisted ELRP, hardware-assisted ELRP uses ACL meter to rate limit the PDU TX rate, which has a granularity of 8 Kbps, so for any interval configured for longer than 70ms in hardware-assisted ELRP mode, the actual interval is around 70ms. This is determined by hardware capabilities of the switch.

Example

The following example starts periodic ELRP packet transmission on slot 3, port 2 of VLAN marketing, sends packet transmissions every 2 seconds, sends messages to the log, and should a loop be detected, disables the port for 5 seconds:

configure elrp-client periodic marketing ports 3:2 interval 2 seconds log disable-port duration 5

History

This command was first available in ExtremeXOS 11.1.

The disable port feature was added in ExtremeXOS 12.4.

The ability to specify the time interval in milliseconds was introduced in ExtremeXOS 22.4.

The ability to specify VXLAN RTEPs was introduced in ExtremeXOS 22.4.

Platform Availability

This command is available on ExtremeSwitching 5320, 5420, 5520, and 5720 series switches.