show eaps shared-port

show eaps shared-port {port} {detail}

Description

Displays shared-port information for one or more EAPS (Extreme Automatic Protection Switching) domains.

Syntax Description

port Specifies a shared-port.
detail Specifies to display the status of all segments and VLANs.

Default

N/A.

Usage Guidelines

If you enter the show eaps shared-port command without the detail keyword, the command displays a summary of status information for all configured EAPS shared ports.

If you specify an EAPS shared-port, the command displays information about that specific port and the related segment ports. The segment ports are sorted in ascending order based on their port number. You can use this order and your knowledge of the EAPS topology to determine which segment port becomes the active-open port if the common link fails. For more information, see “Common Link Fault Detection and Response” in the ExtremeXOS 22.2 User Guide.

You can use the detail keyword to display more detailed status information about the segments and VLANs associated with each shared port.

The following table describes the significant fields and values in the display output of the show eaps shared-port {port {detail} commands:

Field Description
Shared Port Displays the port number of the shared port.
Mode Indicates whether the switch on either end of the common link is a controller or partner. The mode is configured by the user.
Link ID The link ID is the unique common link identifier configured by the user.
Up

Displays one of the following:

Yes—Indicates that the link ID and the mode are configured.

No—Indicates that the link ID or the mode is not configured.

State

Displays one of the following states:

Idle—Shared-port instance is not running.

Ready—The EAPS shared-port instance is running, the neighbor can be reached, and the common link is up.

Blocking—The EAPS shared-port instance is running, the neighbor cannot be reached, or the common link is down.

Preforwarding—The EAPS shared-port instance is in a blocking state, and the common link came up. To prevent a superloop, a temporary blocking state is created before going into Ready state.

Domain Count Indicates the number of EAPS domains sharing the common link.
VLAN (Virtual LAN) Count Indicates the total number of VLANs that are protected under the EAPS domains sharing this common link.
Nbr

Yes—Indicates that the EAPS instance on the other end of the common link is configured with matching link ID and opposite modes. For example, if one end of the common link is configured as a controller, the other end must be configured as a partner.

Err—Indicates that the EAPS instance on the other end of the common link is configured with a matching link ID, but the modes are configured the same. For example, both modes are configured as controller, or both modes are configured as partner.

No—The neighbor on the other end of the common link cannot be reached. Indicates one or more of the following:
  • The switch on the other end of the common link is not running.
  • The shared port has not been created.
  • The link IDs on each side of the common link do not match.
  • The common link, and any other segment, between the controller and partner are not fully connected.
RB ID The ID of the root blocker. If the value is none, there are not two or more common-link failures.
RB State None—This EAPS shared-port is not the root blocker.Active—This EAPS shared-port is the root blocker and is currently active.Inactive—This EAPS shared-port is the root blocker but is currently inactive.
Active Open (available with the detail keyword) None—Indicates that there is no Active-Open port on the VLAN.Port #—Indicates the port that is Active-Open and is in a forwarding state.
Segment Timer expiry action

Segment down—Specifies that if the controller or partner switch detects a down segment, that segment stays down and a query is not sent through the ring. The switch marks the segment status as Down.

Send alert—Specifies that if the controller or partner switch detects a down segment, that switch keeps the segment up and sends a warning message to the log (default). The switch sends a trap alert and sets the failed flag [F].

Segment Port (available with the detail keyword or by specifying a shared port) Identifies the segment port of an EAPS ring that shares the common link.
Status (available with the detail keyword or by specifying a shared port)

Up—Connectivity is established between the segment and the EAPS shared-port on the common link neighbor.

Down—There is a break in the path between the segment and the EAPS shared-port on the common link neighbor.

Blocking-Up—The path is Up, but due to the root blocker being in the Active state, this port is blocked to prevent a loop.

Blocking-Down—The root blocker is in the Active state; however, the path is Down. Because the path is Down, there is no need to block the root blocker port to prevent a loop.

[F]—The segment timer has expired but has not received an explicit link-down notification. The segment port remains in the Up state, with the timer expired flag set to True.

EAPS Domain (available with the detail keyword or by specifying a shared port) The EAPS domain assigned to the segment port.
Vlan-port count (available with the detail keyword or by specifying a shared port) The total number of VLANs being protected on this segment port.
Adjacent Blocking Id (available with the detail keyword or by specifying a shared port)

None—The neighbor on this port is not reporting a Controller in the Blocking state.

Link-Id—The neighbor on this port is a controller in the Blocking state with a link ID of Link-Id.

Segment RB Id (available with the detail keyword or by specifying a shared port)

None—The neighbor on this port is not aware of a root blocker in the network.

RB-Id—The neighbor on this port has determined that there is a root blocker in the network with a link ID of RB-Id

.
Vlan (available with the detail keyword or by specifying a shared port) Displays a list of VLANs protected by the segment port.
Virtual-port Status (available with the detail keyword or by specifying a shared port)

This information appears for the Controller, when it is in either the Blocking or Preforwarding state.

Active-Open—This VLAN or port is in the Forwarding state and has connectivity to the neighboring EAPS shared port via this port.

Open—This VLAN or port is in the Forwarding state but does not have connectivity to the neighboring EAPS shared port via this port.

Blocked—This VLAN or port is in the Blocking state to prevent a loop in the network.

Down—This port‘s link is down.

Active—At this moment, this VLAN or port is not being handled by EAPS shared port. Rather, this VLAN or port is being handled by the regular EAPS protocol.

Bvlan

When a common link connects an access VLAN (CVLAN or SVLAN) to a core VLAN (BVLAN), this field displays the BVLAN name. For more information, see Common Link Fault Detection and Response in the ExtremeXOS 22.2 User Guide.

Example

The following command displays shared-port information for all EAPS shared ports on a switch:

#show eaps shared-port
EAPS shared-port count: 1
--------------------------------------------------------------------------------
Link               Domain Vlan      RB       RB
Shared-port  Mode        Id   Up State      count  count Nbr State    Id
--------------------------------------------------------------------------------
10:1         Controller  1    Y  Ready      2      1     Yes None     None
Segment Timer expiry action: Send alert
--------------------------------------------------------------------------------

The following command displays detailed information for all EAPS shared ports:

#show eaps shared-port detail
EAPS shared-port count: 1
--------------------------------------------------------------------------------
Link               Domain Vlan      RB       RB
Shared-port  Mode        Id   Up State      count  count Nbr State    Id
--------------------------------------------------------------------------------
4:1          Controller  10   Y  Blocking   2      1     Yes Active   10
Segment Timer expiry action: Send alert
Segment Port: 5:7,  Status: Blocking-Up
EAPS Domain:             d1
Vlan-port count:         1
Adjacent Blocking Id:    None
Segment RB Id:           None
Vlan                     Virtual-port Status
p_1                  Blocked
Segment Port: 2:11,         Status: Down
EAPS Domain:             d2
Vlan-port count:         1
Adjacent Blocking Id:    20
Segment RB Id:           None
Vlan                     Virtual-port Status
p_1                  Open
Vlan: p_1,   Vlan-port count: 2,    Active Open: None
Segment Port             Virtual-port Status
5:7                  Blocked
2:11                 Open

The following command displays detailed information for an EAPS shared port that is in the Blocking state:

#  show eaps shared-port 1:24
--------------------------------------------------------------------------------
Link                   Domain Vlan      RB       RB
Shared-port  Mode        Id   Up State          count  count Nbr State    Id
--------------------------------------------------------------------------------
1:24         Controller  10   Y  Blocking       3      5     Yes None     None
Segment Health Check interval:        1 sec
Segment Timeout:                      3 sec
Segment Fail Timer expiry action:     Send alert
Common Path Health Check interval:    1 sec
Common Path Timeout:                  3 sec
Segment Port: 3:35  Status: Up
EAPS Domain:             d3
Vlan-port count:         3
Adjacent Blocking Id:    None
Segment RB Id:           None
Segment Port: 3:36  Status: Up
EAPS Domain:             d2
Vlan-port count:         3
Adjacent Blocking Id:    None
Segment RB Id:           None
Segment Port: 3:38  Status: Up
EAPS Domain:             d1
Vlan-port count:         5
Adjacent Blocking Id:    None
Segment RB Id:           None
Vlan: data1,         Vlan-port count: 3,    Active Open: 3:38 Bvlan: metro1
Vlan: data2,         Vlan-port count: 3,    Active Open: 3:38 Bvlan: metro1
Vlan: data3,         Vlan-port count: 3,    Active Open: 3:38 Bvlan: metro2
Vlan: metro1,        Vlan-port count: 1,    Active Open: 3:38
Vlan: metro2,        Vlan-port count: 1,    Active Open: 3:38
--------------------------------------------------------------------------------
 
Note

Note

The BVLAN information in the previous example appears only when a BVLAN configuration is present.

History

This command was first available in ExtremeXOS 11.1.

Platform Availability

This command is available on all platforms with the appropriate license. 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.