Interfaces and Hardware Component Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

PDF

Interfaces and Hardware Component Configuration Guide for Cisco 8000 Series Routers, Cisco IOS XR Releases

Ethernet OAM configuration and management examples

Updated: July 31, 2026

Want to summarize with AI?

Log in

The examples covered in this topic illustrate the configuration and management procedures for Ethernet OAM. The collection covers interface setup, global profile application, error-disable recovery, statistics management, and SNMP trap activation.

Example: Configure Ethernet OAM features on an individual interface

This example shows how to configure Ethernet OAM features on an individual interface:


configure 
 interface TenGigE 0/0/0/0
  ethernet oam
  connection timeout 30
  mib-retrieval
  link-monitor
   frame window milliseconds 60000
   frame threshold low 10000000 high 60000000
   frame-period window milliseconds 60000
   frame-period threshold ppm low 100 high 120000
   frame-seconds window milliseconds 900000
   frame-seconds threshold low 3 high 900
   symbol-period window milliseconds 60000
   symbol-period threshold ppm low 1000000 high 1000000
  exit       
  require-remote
   mode active
   mib-retrieval
  exit
  action
   critical-event error-disable-interface
   dying-gasp error-disable-interface
   capabilities-conflict error-disable-interface
   wiring-conflict error-disable-interface
   discovery-timeout error-disable-interface
   session-down error-disable-interface
   commit

Example: Configure an Ethernet OAM profile globally

This example shows how to configure an Ethernet OAM profile globally:


configure 
ethernet oam profile Profile_1
 connection timeout 30
 mib-retrieval
 link-monitor
  frame window milliseconds 60000
  frame threshold low 10000000 high 60000000
  frame-period window milliseconds 60000
  frame-period threshold ppm low 100 high 1000000
  frame-seconds window milliseconds 900000
  frame-seconds threshold low 3 high 900
  symbol-period window milliseconds 60000
  symbol-period threshold ppm low 100000 high 1000000
 exit
 require-remote
  mode active
  mib-retrieval
 exit
 action
  critical-event error-disable-interface
  dying-gasp error-disable-interface
  capabilities-conflict error-disable-interface
  wiring-conflict error-disable-interface
  discovery-timeout error-disable-interface
  session-down error-disable-interface
  commit

Example: Configure Ethernet OAM features to override the profile on an individual interface

This example shows the configuration of Ethernet OAM features in a profile followed by an override of that configuration on an interface:


configure 
 ethernet oam profile Profile_1
  mode passive
  action dying-gasp disable
  action critical-event disable
  action discovery-timeout disable
  action session-up disable
  action session-down disable
  action capabilities-conflict disable
  action wiring-conflict disable
    commit

configure 
 interface TenGigE 0/1/0/0
  ethernet oam
   profile Profile_1
    mode active
    action dying-gasp log
    action critical-event log
    action discovery-timeout log
    action session-up log
    action session-down log
    action capabilities-conflict log
    action wiring-conflict log
      commit

Example: Recover from error-disable

You can recover an error-disabled interface due to session-down using one of these methods:

  • Manually clear the error-disable using the clear command.

    Router# configure
Router(config)# ethernet oam profile Profile_1
Router(config-eoam)# action
Router(config-eoam-action)# clear session-down error-disable-interface

  • Disable and then re-enable the network link using administrative shutdown commands to reset the connection.

    Router# configure
Router(config)# interface TenGigE 0/1/0/0
Router(config-if)# shutdown
Router(config-if)# commit
Router(config-if)# no shutdown
Router(config-if)# commit

  • Configure an auto-recovery timer for this error-disable reason.

    Router# configure
Router(config)# error-disable recovery cause link-oam-session-down interval 30
Router(config)# commit

Example: Clear Ethernet OAM statistics on an interface

This example shows how to clear Ethernet OAM statistics on an interface:

Router# clear ethernet oam statistics interface gigabitethernet 0/0/0/1

Example: Enable SNMP server traps on a router

This example shows how to enable SNMP server traps on a router:


configure 
 snmp-server traps ethernet oam events