configure eaps port

configure eaps name [primary | secondary] port ports


Configures a node port as the primary or secondary port for the specified EAPS (Extreme Automatic Protection Switching) domain.

Syntax Description

name Specifies the name of an EAPS domain.
primary Specifies that the port is to be configured as the primary port.
secondary Specifies that the port is to be configured as the secondary port.
ports Specifies one port or slot and port.



Usage Guidelines

Each node on the ring connects through two ring ports. One port must be configured as the primary port; the other must be configured as the secondary port.

The primary and secondary ports have significance only on a master node. The health-check messages are sent out the primary port of the master node, and the master node blocks the protected VLAN (Virtual LAN)s on the secondary port.

The master node‘s secondary EAPS port cannot be configured on ports that are already configured as follows:

There is no distinction between the primary and secondary ports on a transit node.

Beginning with ExtremeXOS 11.1, if you have a primary or secondary port that is a member of a load-shared group, you do not need to disable your EAPS domain and remove that ring port when modifying the load-shared group. For more information about configuring load sharing on your switch, see “Configuring Slots and Ports on a Switch” in the ExtremeXOS 22.2 User Guide.

For complete information about software licensing, including how to obtain and upgrade your license and what licenses are appropriate for this feature, see the ExtremeXOS 22.2 Feature License Requirements document.

Messages Displayed when Adding EAPS Ring Ports to a VLAN

If you attempt to add EAPS ring ports to a VLAN that is not protected by EAPS, the switch prompts you by default to confirm this action. For example, if you use the configure vlan vlan_name add ports port_list command, and the ports that you are attempting to add to the VLAN are currently used by EAPS as either primary or secondary ring ports, the switch displays the following message:

 Make sure <vlan_name> is protected by EAPS. Adding EAPS ring ports to a VLAN could cause a loop in the network. Do you really want to add these ports (y/n) 

Enter y to add the ports to the VLAN. Enter n or press [Return] to cancel this action.

If you see this message, either configure the VLAN as an EAPS protected VLAN by using the configure eaps add protected vlan command or add ports that the EAPS domain does not use as primary or secondary ring ports.

If you have considerable knowledge and experience with EAPS, you might find the EAPS loop protection warning messages unnecessary. For more information, see the configure eaps config-warnings off.


The following example adds port 1 to the EAPS domain eaps_1 as the primary port:

configure eapseaps_1primary port 1 


This command was first available in ExtremeXOS 11.0.

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches.