Ethernet in the First Mile Operations and Maintenance Commands

This section describes the commands used to configure the Ethernet in the First Mile (EFM) Operations and Maintenance (OAM) protocol as per ITU-T Y.1731. Network administrators use these commands to view link operation data, such as remote fault indication and remote loopback control, which enable monitoring, testing, and troubleshooting OAM-enabled links in the network.

ethernet oam

This command is used to enable or disable the Ethernet OAM on an interface or range of interfaces.

• Default: disabled
• Format: ethernet oam {enable | disable}
• Mode: Interface Config

ethernet oam peer-timeout

This command sets the link lost timer value to 2-30 seconds on an interface or range of interfaces. If any OAM PDUs are not received from the remote DTE within this time period, then the local client executes the Fault state of the Discovery state machine.

• Default: 5 sec
• Format: ethernet oam peer-timeout <2-30>
• Mode: Interface Config

no ethernet oam peer-timeout

This command sets the link lost timer value to the default.

• Format: no ethernet oam peer-timeout
• Mode: Interface Config

ethernet oam min-pdu-rate

This command sets the minimum transmission rate (pdu_timer) in seconds for sending periodic OAM PDUs on an interface or range of interfaces. The range is from 1 to 10.

• Default: 1
• Format: ethernet oam min-pdu-rate <1-10>
• Mode: Interface Config

no ethernet oam min-pdu-rate

This command sets the minimum transmission rate (pdu_timer) in seconds for sending periodic OAM PDUs to the default.

• Format: no ethernet oam min-pdu-rate
• Mode: Interface Config

ethernet oam max-pdu-rate

This command sets the maximum transmission rate (pdu_timer) in seconds on an interface or range of interfaces when one OAM PDU is sent per second. The range is from 1 to 10.

• Default: 1
• Format: ethernet oam max-pdu-rate <1-10>
• Mode: Interface Config

no ethernet oam max-pdu-rate

This command sets the maximum transmission rate (pdu_timer) to the default.

• Format: no ethernet oam max-pdu-rate
• Mode: Interface Config

ethernet oam mode

This command set the OAM interface mode as Active or Passive on a specified interface or range of interfaces.

• Default: passive
• Format: ethernet oam mode {active | passive}
• Mode: Interface Config

ethernet oam remote-loopback

This command configures Remote Loopback timeout support on an interface or range of interfaces.

• Default: remote loopback support is enabled
• Format: ethernet oam remote-loopback [supported] [timeout <1-100>]
• Mode: Interface Config
• supported: Enables remote loopback. By default, it is enabled.
• timeout: Sets the time in seconds after which remote loopback times-out. The range is 10–100 seconds; 50 seconds is the default.

ethernet oam remote-loopback start

This command starts the remote loopback in the specified OAM interface.

NOTE: Per IEEE 802.3ah, an OAM entity should be in Active mode to start the remote loopback facility.

• Format: ethernet oam remote-loopback start <unit/slot/port>
• Mode:
  • Privileged EXEC
  • User EXEC

ethernet oam remote-loopback stop

This command stops the remote loopback in the specified OAM interface.

• Format: ethernet oam remote-loopback stop <unit/slot/port>
• Mode:
  • Privileged EXEC
  • User EXEC

ethernet oam link-monitor supported

This command enables support for link monitoring on the current interface or range of interfaces.

• Default: enabled
• Format: ethernet oam link-monitor supported
• Mode: Interface Config

no ethernet oam link-monitor supported

This command disables support for link monitoring on the current interface.

• Format: no ethernet oam link-monitor supported
• Mode: Interface Config

ethernet oam link-monitor

This command starts or stops Link Monitoring on the current OAM-enabled interface.

• Default: off
• Format: ethernet oam link-monitor {on | off}
• Mode: Interface Config

ethernet oam link-monitor frame

This command configures the Errored Frame Event properties. This command is used to configure high and low thresholds for error frames that trigger an error-frame link event. The window value provides the time in seconds during which the threshold values must be violated in order for a trap to be generated.

• Format: ethernet oam link-monitor frame {threshold {high (<1-65535> | none) | low <1-65535>}|window <10-60>}
• Mode: Interface Config
• threshold: Error threshold high value and low value in number of Errored-Frames. Default is 0 for high and 1 for low.
• window: Event window size in number of seconds from 10-60. Default is 1.

no ethernet oam link-monitor frame

This command resets the errored frame event properties to their default values.

• Default: By default, errored frame event properties are disabled.
• Format: no ethernet oam link-monitor frame {threshold {high | low} |window}
• Mode: Interface Config

ethernet oam link-monitor frame-period

This command configures the Errored Frame Period Event Properties. This command is used to configure high and low thresholds for the error-frame period that triggers an error-frame-period link event. The window value provides the time is seconds during which the threshold values must be violated in order for a trap to be generated.

• Format: ethernet oam link-monitor frame-period {threshold {high (<1-65535>| none) | low <1-65535>}|window <1-65535>}
• Mode: Interface Config
• threshold: Errored frame threshold high and low values in number of frames. Default is 0 for high and 1 for low.
• window: Polling event window size in number of frames from 1-65535. Default is 1000.

no ethernet oam link-monitor frame-period

This command resets the errored frame period event properties to their default values.

• Format: no ethernet oam link-monitor frame-period {threshold {high | low} |window}
• Mode: Interface Config

ethernet oam link-monitor frame-seconds

This command configures the Errored Frame Seconds Event Properties. This command is used to configure high and low thresholds for the error-frame seconds that triggers an error-frame-seconds link event. The window value provides the time is seconds during which the threshold values must be violated in order for a trap to be generated.

• Format: ethernet oam link-monitor frame-seconds {threshold {high (<1-65535> | none) | low <1-65535>} |window <10-900>}
• Mode: Interface Config
• threshold: Errored frame threshold high and low values in number of seconds. Default is 0 for high and 1 for low.
• window: Polling Event window size in number of seconds from 10-900. Default is 10 seconds.

no ethernet oam link-monitor frame-seconds

This command resets the errored frame seconds event properties.

• Format: no ethernet oam link-monitor frame-seconds{threshold {high | low} |window}
• Mode: Interface Config

show ethernet oam statistics interface

This command shows the OAM statistics for the specified OAM interface.

• Format: show ethernet oam statistics [interface <unit/slot/port> | all]
• Mode:
  • Privileged EXEC
  • User EXEC

show ethernet oam discovery interface

This command shows the OAM entity discovery information on the specified OAM interface.

• Format: show ethernet oam discovery [interface <unit/slot/port> | all]
• Mode: Privileged EXEC

show ethernet oam status interface

This command displays OAM status information for the specified interface.

• Format: show ethernet oam status [interface <unit/slot/port> | all]
• Mode:
  • Privileged EXEC
  • User EXEC

show ethernet oam interface

This command displays the interface information for a specified OAM interface.

• Format: show ethernet oam interface <unit/slot/port>
• Mode:
  • Privileged EXEC
  • User EXEC

show ethernet oam link-monitor

This command displays the Ethernet OAM (Dot3ah) Link-Monitoring information for an OAM-enabled interface.

• Format: show ethernet oam link-monitor <unit/slot/port>
• Mode:
  • Privileged EXEC
  • User EXEC

show ethernet oam summary

This command displays the Ethernet OAM (Dot3ah) summary of the protocol information.

• Format: show ethernet oam summary [<unit/slot/port> | all]
• Mode:
  • Privileged EXEC
  • User EXEC

debug dot3ah packet

Use this command to turn on dot3ah packet debug trace on the console. This will allow you to see whether the OAM packet is transmitted or received on an EFM-OAM/Dot3ah-enabled interface.

• Format: debug dot3ah packet
• Mode:
  • Privileged EXEC
  • User EXEC

clear ethernet oam statistics

This command clears the Ethernet OAM (Dot3ah) protocol statistics information on the interface(s).

• Format: show ethernet oam statistics [<unit/slot/port> | all]
• Mode:
  • Privileged EXEC
  • User EXEC