show elsm

show elsm

Description

Displays summary information for all of the ELSM-enabled ports on the switch.

Syntax Description

This command has no arguments or variables.

Default

N/A.

Usage Guidelines

Use this command to display the operational state of ELSM on the configured ports.

If no ports are configured for ELSM, the switch does not display any information.

For ELSM-enabled ports, this command displays the following information in a tabular format:
  • Port—The port number of the ELSM-enabled port.

  • ELSM State—The current state of ELSM on the port. The ELSM state can be one of the following:
    • Up—Indicates a healthy remote system and this port is receiving Hello+ messages from its peer.

      If an ELSM-enabled port enters the Up state, the up timer begins. Each time the port receives a Hello+ message from its peer, the up timer restarts and the port remains in the Up state.

    • Down—Indicates that the port is down, blocked, or has not received Hello+ messages from its peer.

      If an ELSM-enabled port does not receive a hello message from its peer before the up timer expires, the port transitions to the Down state. When ELSM is down, data packets are neither forwarded nor transmitted out of that port.

    • Down-Wait—Indicates a transitional state.

      If the port enters the Down state and later receives a Hello+ message from its peer, the port enters the Down-Wait state. If the number of Hello+ messages received is greater than or equal to the hello threshold (by default 2 messages), the port transitions to the Up state. If the number of Hello+ messages received is less than the hold threshold, the port enters the Down state.

    • Down-Stuck—Indicates that the port is down and requires user intervention.

      If the port repeatedly flaps between the Up and Down states, the port enters the Down-Stuck state. Depending on your configuration, there are two ways for a port to transition out of this state:

      By default, automatic restart is enabled, and the port automatically transitions out of this state. See the command enable elsm ports auto-restart for more information.

      If you disabled automatic restart, and the port enters the Down-Stuck state, you can clear the stuck state and enter the Down state by using one of the following commands:

      clear elsm ports port_list auto-restart

      enable elsm ports port_list auto-restart

  • Hello time —The current value of the hello timer, which by default is 1 second. The hello timer indicates the number of seconds between consecutive hello messages.

Additional show Command

You can also use the show ports {port_list} information {detail} command to display ELSM information.

If you do not specify the detail parameter, the following columns display the current state of ELSM on the switch:
  • Flags:
    • L—Indicates that ELSM is enabled on the switch.

    • - —Indicates that ELSM is disabled on the switch.

  • ELSM:
    • up—Indicates that ELSM is enabled and the ELSM peer ports are up and communicating; the ELSM link state is up. In the up state, the ELSM-enabled port sends and receives hello messages from its peer.

    • dn—Indicates that ELSM is enabled, but the ELSM peers are not communicating; the ELSM link state is down. In the down state, ELSM transitions the peer port on this device to the down state. ELSM blocks all incoming and outgoing switching traffic and all control traffic except ELSM PDUs.

    • - —Indicates that ELSM is disabled on the switch.

If you specify the optional detail parameter, the following ELSM output is called out in written explanations versus displayed in a tabular format:

Example

The following command displays summary configuration information for all of the ELSM-enabled ports on the switch:

show elsm

The following is sample output from this command:

Port   ELSM State   Hello Time
====   ==========   ==========
5:14   Up 1 (second)
5:18   Down         1 (second)

History

This command was first available in ExtremeXOS 11.4.

Platform Availability

This command is available on ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, X870, 5320, 5420, and 5520 series switches.