Configuring ATM PVC F5 OAM Recovery Traps

Last Updated: May 22, 2012

The ATM PVC F5 OAM Recovery Traps feature introduces Simple Network Management Protocol (SNMP) traps that notify the administrator when a permanent virtual circuit (PVC) has recovered from F5 Operation, Administration, and Maintenance (OAM) end-to-end loopback failures, and F5 OAM alarm indication signal/remote defect indication (AIS/RDI) failures.

The ATM PVC TRAP Enhancement for Segment and End AIS / RDI failures feature adds Segment and End AIS/RDI Failure notification (traps) to the existing ATM PVC trap infrastructure.

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest feature information and caveats, see the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the Feature Information Table at the end of this document.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Prerequisites for ATM PVC F5 OAM Recovery Traps

  • Extended ATM PVC up and down traps and ATM PVC traps for OAM F5 Continuity Check (CC), OAM F5 AIS/RDI, and OAM F5 loopback failures and recoveries cannot be used at the same time as legacy ATM PVC traps.
  • Legacy ATM PVC traps must be disabled by using the no snmp-server enable traps atm pvc command before before extended ATM PVC up and down traps and ATM PVC traps for OAM F5 CC, OAM F5 AIS/RDI, and OAM F5 loopback failures and recoveries can be configured. If the extended ATM PVC traps or ATM OAM F5 CC traps are enabled, you must disable them by using the no snmp-server enable traps atm pvc extension command before you can enable legacy ATM PVC traps.
  • OAM management must be enabled on the PVC before you can use any ATM PVC traps.

Restrictions for ATM PVC F5 OAM Recovery Traps

  • The F5 OAM recovery traps are supported for ATM PVCs only.
  • The CISCO-ATM-PVCTRAP-EXTN-MIB is currently supported in Cisco IOS Release 12.0(27)S, Cisco IOS Release 12.2(33)SRE, Cisco IOS Release 15.0(1)M and later releases.
  • The traps associated with CC are supported only on Cisco IOS 7500 series routers with PA-A3 and PA-A1 cards and Gigabit Switch Router (GSR).

Information About ATM PVC F5 OAM Recovery Traps

F5 OAM Recovery Traps for ATM PVCs

F5 OAM cells are used to detect connectivity failures and recoveries at the ATM layer. Before the introduction of this feature, Cisco IOS software provided support for SNMP traps (also called SNMP notifications) for F5 end-to-end loopback, and F5 AIS/RDI connectivity failures on a PVC. The ATM PVC F5 OAM Recovery Traps feature introduces SNMP traps that notify the network management system (NMS) when connectivity is restored to a PVC after the following types of failures:

  • F5 OAM end-to-end loopback failures
  • F5 OAM segment AIS/RDI failures
  • F5 OAM end-to-end AIS/RDI failures

Information in the traps includes the number of PVCs that recovered and time stamps indicating when the first and last recoveries occurred during the notification interval.

To limit the amount of traffic that can be generated by the F5 OAM failure and recovery traps, only one trap of each type can be generated in each trap interval. Each trap can report on multiple PVCs, and successive PVCs that have the same failure or recovery are reported as a range.

In addition to the traps, MIB tables are maintained to provide information about the failures and recoveries on PVCs.

For a complete description of the extended ATM PVC TRAP MIB, including the supported notifications and tables, see the MIB file called CISCO-ATM-PVCTRAP-EXTN-MIB.my, available through Cisco.com at the following URL:

http://www.cisco.com/go/mibs

Benefits of F5 OAM Recovery Traps for ATM PVCs

Before the introduction of this feature, when F5 OAM failures were detected on PVCs, failure notifications were sent to the NMS, and the operational state of the PVC was kept up. There was no mechanism for notifying the NMS when connectivity was restored to the PVCs after F5 OAM failures. The F5 OAM Recovery Traps feature introduces traps that asynchronously notify the NMS when PVCs have recovered from F5 OAM failures.

ATM PVC Trap Enhancements for Segment and End AIS RDI Failures

ATM PVC trap support provides ATM PVC failure notification by sending a trap when a PVC on an ATM interface fails or leaves the UP operational state. F5 OAM cells are used to detect connectivity failures and recoveries at the ATM layer. The operator informs the NMS of these OAM failures using ATM PVC traps. The following ATM PVC Traps are supported:

  • ATM PVC DOWN TRAP
  • ATM PVC F5 Loop back failure TRAP
  • ATM PVC F5 Segment CC failure TRAP
  • ATM PVC F5 End-to-End CC failure TRAP
  • ATM PVC F5 AIS/RDI failure TRAP

When connectivity is restored, the PVC state is brought UP for allowing data transfer to take place over the PVC. This connectivity restoration uses the OAM cells. The following recovery traps are used to inform the NMS about the restoration of connectivity:

  • ATM PVC UP TRAP
  • ATM PVC F5 Loop back recovery TRAP
  • ATM PVC F5 Segment CC recovery TRAP
  • ATM PVC F5 End-to-End CC recovery TRAP
  • ATM PVC F5 AIS/RDI recovery TRAP

To limit the amount of traffic that can be generated by the F5 OAM failure and recovery traps, only one trap of each type can be generated in each trap interval. Each trap can report on multiple PVCs, and successive PVCs that have the same failure or recovery are reported as a range.

The ATM PVC Trap Enhancements for Segment and End AIS/RDI failures feature addresses the issue of generating the separate ATM F5 segment and end AIS/RDI failure and recovery traps.

Benefits of ATM PVC Trap Enhancements for Segment and End AIS RDI Failures

The ATM PVC TRAP Enhancement for Segment and End AIS/RDI Failures feature adds segment and end AIS/RDI Failure notification (traps) to the existing ATM PVC trap infrastructure. This feature adds the ifDescr object to the existing traps. The addition of this object allows the operator to get the interface name directly from the trap. The segment and end AIS/RDI failure and recovery traps are generated when AIS/RDI failure traps are enabled.

How to Configure F5 OAM Recovery Traps for ATM PVCs

Configuring ATM OAM Support

Perform this task to configure ATM OAM support on an ATM PVC.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    interface atm number

4.    ip address ip-address mask

5.    pvc [name ] vpi/vci

6.    oam-pvc manage [keep-vc-up [end aisrdi failure | seg aisrdi failure]]

7.    end


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
interface atm number


Example:

Router(config)# interface atm 0

 

Specifies an interface for configuration and enters interface configuration mode.

 
Step 4
ip address ip-address mask


Example:

Router(config-if)# ip address 10.0.0.3 255.255.255.0

 

Sets a primary or secondary IP address for an interface.

 
Step 5
pvc [name ] vpi/vci


Example:

Router(config-if)# pvc 0/40

 

Creates an ATM PVC and enters ATM virtual circuit configuration mode.

 
Step 6
oam-pvc manage [keep-vc-up [end aisrdi failure | seg aisrdi failure]]


Example:

Router(config-if-atm-vc)# oam-pvc manage

 

Configures ATM OAM management.

 
Step 7
end


Example:

Router(config-if-atm-vc)# end

 

Exits ATM virtual circuit configuration mode.

 

Enabling OAM F5 Failure and Recovery Traps

Perform this task to enable the MIB and SNMP notifications that support ATM OAM F5 CC management.

SUMMARY STEPS

1.    enable

2.    configure terminal

3.    snmp-server enable traps atm pvc extension {up | down | oam failure [aisrdi | loopback }

4.    end


DETAILED STEPS
  Command or Action Purpose
Step 1
enable


Example:

Router> enable

 

Enables privileged EXEC mode.

  • Enter your password if prompted.
 
Step 2
configure terminal


Example:

Router# configure terminal

 

Enters global configuration mode.

 
Step 3
snmp-server enable traps atm pvc extension {up | down | oam failure [aisrdi | loopback }


Example:

Router(config)# snmp-server enable traps atm pvc extension oam failure aisrdi

 

Enables ATM OAM F5 AIS/RDI failure and recovery traps and ATM OAM F5 end-to-end loopback failure and recovery traps.

 
Step 4
end


Example:

Router(config)# end

 

Exits global configuration mode.

 

Troubleshooting Tips

  • Use the show running-config command to verify the configuration of ATM OAM management.
  • Use the show atm pvccommand to verify that ATM OAM management is enabled and to display the state of the PVC.
  • Use the debug snmp packet command to display which SNMP traps are being generated.

Configuration Examples for ATM PVC F5 OAM Recovery Traps

Enabling OAM PVC Managment Example

The following example shows how to enable ATM PVC OAM management:

Router(config)# interface ATM 2/0.1 point-to-point
 
Router(config-subif)# pvc pvc 45/54
	
Router(config-if-atm-vc)# oam-pvc manage
Router(config-if-atm-vc)# end

Note
Enhanced Interior Gateway Routing Protocol (EIGRP) must be configured on the router if you want the notification packets to be sent to the NMS.

ATM PVC Extended Up and Down Notifications Examples

Enabling ATM PVC Extended Up and Down Notifications

The following example shows how to enable ATM PVC extended up and down notifications:

Router(config)# snmp-server community public RW 
Router(config)# snmp-server host 172.16.61.90 public
Router(config)# snmp-server enable traps atm pvc extension up
Router(config)# snmp-server enable traps atm pvc extension down
Router(config)# snmp-server host 10.0.0.115 vrf Mgmt-intf version 2c public udp-port 2030

ATM PVC Down Notification

The following sample output shows an ATM PVC in the DOWN state:

Router# show atm vc
Codes: DN - DOWN, IN - INACTIVE 
           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
0/3/0.100  pvc100         0   100 PVC     SNAP       UBR  149760              DN
Received SNMPv2c Trap:
Community: public
From: 10.0.0.54
sysUpTimeInstance = 1918435
snmpTrapOID.0 = catmIntfPvcDownTrap
ifIndex.52 = 52
atmIntfPvcFailures.15 = 4
atmIntfCurrentlyFailingPVcls.15 = 1
ifDescr.52 = ATM0/3/0.100
catmPVclCurFailTime.52.0.100 = 1915435
catmPVclPrevRecoverTime.52.0.100 = 259552
catmPVclFailureReason.52.0.100 = catmLoopbackOAMFailure(1)

ATM PVC Up Notification

The following sample output shows an ATM PVC in the UP state:

Router# show atm vc
Codes: DN - DOWN, IN - INACTIVE 
           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
0/3/0.100  pvc100         0   100 PVC     SNAP       UBR  149760              UP
Received SNMPv2c Trap:
Community: public
From: 9.0.0.54
sysUpTimeInstance = 1933376
snmpTrapOID.0 = catmIntfPvcUp2Trap
ifIndex.52 = 52
catmIntfCurrentlyDownToUpPVcls.15 = 1
ifDescr.52 = ATM0/3/0.100
catmPVclCurRecoverTime.52.0.100 = 1930676
catmPVclPrevFailTime.52.0.100 = 1915435
catmPVclRecoveryReason.52.0.100 = catmLoopbackOAMRecover(1)

ATM OAM Failure Looback Notification Examples

Enabling ATM OAM Failure Loopback Notification

The following example shows how to enable ATM PVC OAM failure loopback notifications and extended up and down notifications:
Router(config)# snmp-server community public RW
Router(config)# snmp-server enable traps atm pvc extension up
Router(config)# snmp-server enable traps atm pvc extension down
Router(config)# snmp-server enable traps atm pvc extension oam failure loopback
Router(config)# snmp-server host 10.0.0.115 vrf Mgmt-intf version 2c public udp-port 2030

Note
If you configure the snmp-server enable traps atm pvc extension oam failure command, you may not see up or down traps when an OAM failure trap is generated. Additionally, the PVC will stay in the UP state.

OAM Loopback Failure Notification

The following sample output shows an ATM PVC that has failed. Note that the output indicates the PVC is still in the UP state.

Router# show atm vc
Codes: DN - DOWN, IN - INACTIVE 
           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
0/3/0.100  pvc100         0   100 PVC     SNAP       UBR  149760              UP 
Received SNMPv2c Trap:
Community: public
From: 9.0.0.54
sysUpTimeInstance = 1964155
snmpTrapOID.0 = catmIntfPvcOAMFailureTrap
ifIndex.52 = 52
catmIntfOAMFailedPVcls.15 = 65
catmIntfCurrentOAMFailingPVcls.15 = 1
ifDescr.52 = ATM0/3/0.100
catmPVclStatusTransition.52.0.100 = 1
catmPVclStatusChangeStart.52.0.100 = 1961155
catmPVclStatusChangeEnd.52.0.100 = 1961155

OAM Loopback Recovery Notification

The following sample output shows an ATM PVC in the UP state:

Router# show atm vc
Codes: DN - DOWN, IN - INACTIVE 
           VCD /                                            Peak Av/Min Burst
Interface  Name         VPI   VCI Type    Encaps     SC     Kbps   Kbps Cells St
0/3/0.100  pvc100         0   100 PVC     SNAP       UBR  149760              UP

Received SNMPv2c Trap:
Community: public
From: 9.0.0.54
sysUpTimeInstance = 1986456
snmpTrapOID.0 = catmIntfPvcOAMRecoverTrap
ifIndex.52 = 52
catmIntfOAMRcovedPVcls.15 = 10
catmIntfCurrentOAMRcovingPVcls.15 = 1
ifDescr.52 = ATM0/3/0.100
catmPVclStatusUpTransition.52.0.100 = 1
catmPVclStatusUpStart.52.0.100 = 1983456
catmPVclStatusUpEnd.52.0.100 = 1983456

Additional References

Related Documents

Related Topic

Document Title

ATM commands: complete command syntax, defaults, command mode, command history, usage guidelines, and examples.

Cisco IOS Asynchronous Transfer Mode Command Reference

Cisco IOS commands

Cisco IOS Master Commands List, All Releases

Standards

Standards

Title

No new or modified standards are supported by this feature.

--

MIBs

MIBs

MIBs Link

  • ATM PVC MIB
  • CISCO-ATM-PVCTRAP-EXTN-MIB.my
  • CISCO-IETF-ATM2-PVCTRAP-MIB

To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL:

http://www.cisco.com/go/mibs

RFCs

RFCs

Title

No new or modified RFCs are supported by this features.

--

Technical Assistance

Description

Link

The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

http://www.cisco.com/cisco/web/support/index.html

Feature Information for ATM PVC F5 OAM Recovery Traps

The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/go/cfn. An account on Cisco.com is not required.

Table 1 Feature Information for Configuring ATM PVC F5 OAM Recovery Traps

Feature Name

Releases

Feature Information

ATM PVC F5 OAM Recovery Traps

12.0(26)S 15.0(1)M

The ATM PVC F5 OAM Recovery Traps feature introduces SNMP traps that notify the administrator when a PVC has recovered from F5 OAM end-to-end loopback failures and F5 OAM AIS/RDI failures.

The following sections provide information about this feature:

The following command was introduced: snmp-server enable traps atm pvc extension.

ATM PVC Trap Enhancements for Segment and End AIS/RDI Failures

12.0(27)S 15.0(1)M

The ATM PVC TRAP Enhancement for Segment and End AIS/RDI failures feature adds segment and end AIS/RDI failure notification (traps) to the existing ATM PVC trap infrastructure.

The following sections provide information about this feature:

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: www.cisco.com/go/trademarks. Third-party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2012 Cisco Systems, Inc. All rights reserved.