The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
The ATM SNMP Trap and OAM Enhancements feature provides the ability to send Simple Network Management Protocol (SNMP) notifications for ATM permanent virtual circuits (PVCs) when the PVC state changes and when Operation, Administration and Maintenance (OAM) loopback fails for a PVC. This feature also provides information about the virtual path identifier/virtual channel identifier (VPI/VCI) in the ATM PVC traps.
The ATM OAM AIS-RDI Monitoring feature extends the existing ATM virtual circuit OAM functionality to include monitoring of the Alarm Indication Signal-Remote Defect Indication (AIS-RDI).
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.
Before you enable ATM PVC trap support, you must configure Simple Network Management Protocol (SNMP) support and an IP routing protocol on your router. For more information about configuring SNMP support, refer to the chapter "Configuring SNMP Support" in the Cisco IOS XE Network Management Configuration Guide.
To receive PVC failure notification and to allow access to PVC status tables on your router, you must have the Cisco extended ATM PVC trap MIB called CISCO-IETF-ATM2-PVCTRAP-MIB-EXTN.my compiled in your Network Management System (NMS) application. You can find this MIB at Cisco's MIB website: http://www.cisco.com/go/mibs.
The legacy ATM PVC trap must be disabled by using the no snmp-server enable traps atm pvc command before extended ATM PVC traps are configured.
The ATM SNMP Trap and OAM Enhancements feature introduces the following enhancements to the SNMP notifications for ATM permanent virtual circuits (PVCs) and to OAM functionality:
Before the introduction of the ATM SNMP trap and OAM enhancements, the only SNMP notifications for ATM PVCs were the ATM PVC failure traps that were generated when a PVC failed or left the UP operational state. The ATM SNMP trap and OAM enhancements introduce ATM PVC up traps, which are generated when a PVC changes from the DOWN state to the UP state.
The ATM SNMP trap and OAM enhancements introduce the ATM PVC OAM failure trap. OAM loopback is a mechanism that detects whether a connection is up or down by sending OAM end-to-end loopback command/response cells. An OAM loopback failure indicates that the PVC has lost connectivity. The ATM PVC OAM failure trap is generated when OAM loopback for a PVC fails and is sent at the end of the notification interval.
When OAM loopback for a PVC fails, the PVC is included in the atmStatusChangePVclRangeTable or atmCurrentStatusChangePVclTable and in the ATM PVC OAM failure trap.
Before this feature was introduced, if OAM loopback failed, the PVC was placed in the DOWN state. When the ATM PVC OAM failure trap is enabled, the PVC remains up even if OAM loopback fails, and thus it ensures continuous flow of data.
Note |
ATM PVC traps are generated at the end of the notification interval. It is possible to generate three types of ATM PVC traps (the ATM PVC failure trap, ATM PVC up trap, and ATM PVC OAM failure trap) at the end of the same notification interval. However, only one type of trap is generated for each PVC. |
The ATM SNMP Trap and OAM Enhancements feature introduces extended ATM PVC traps. The extended traps include VPI/VCI information for affected PVCs, the number of up-to-down and down-to-up state transitions that a PVC goes through in an interval, and the time stamp of the first and the last PVC state transition.
Note |
Extended ATM PVC traps cannot be used at the same time as the legacy ATM PVC trap. The legacy ATM PVC trap must be disabled by using the no snmp-server enable traps atm pvc command before extended ATM PVC traps are configured. |
The ATM SNMP Trap and OAM Enhancements feature introduces a high watermark trap. A trap is generated when the number of configured PVCs in an interface and related subinterfaces exceeds a preconfigured high watermark threshold. When the number of configured PVCs in an interface and related subinterfaces falls below the high watermark threshold, another trap is generated to indicate that the fault is cleared. A minimum duration between the occurrence of two consecutive high watermark thresholds can also be set.
The ATM PVC trap is defined in the ATM PVC trap MIB. The ATM SNMP trap and OAM enhancements introduce the following tables and MIB objects:
The ATM OAM Alarm Indication Signal--Reverse Defect Indication (AIS-RDI) Monitoring feature extends the existing ATM VC OAM functionality to include monitoring of the AIS-RDI. Once the feature is enabled, OAM AIS-RDI is monitored on the VCs. If the number of consecutive OAM AIS-RDI cells received is greater than a configurable number, the VC is brought down. The VC is brought up when there are no OAM AIS-RDI cells received within a configurable interval.
The ATM SNMP Trap and OAM Enhancements and the ATM OAM AIS-RDI Monitoring features have the following benefits:
Perform this task to configure extended ATM PVC trap support.
Perform this task to configure ATM PVC high watermark trap support using Remote Monitoring (RMON).
When you configure PVC trap support, you must also enable OAM management on the PVC. Perform this task to enable OAM management.
Perform this task to enable OAM AIS-RDI monitoring on VCs.
To verify the configuration of ATM PVC traps, use the show running-config command.
The following is sample output from the show atm vc command: Example:
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/2/0 oam 0 5 PVC SNAP UBR 0 IN
0/2/0 7 0 10 PVC SNAP UBR 0 IN
0/2/0 2 0 40 PVC SNAP UBR 0 IN
0/2/0 1 0 100 PVC SNAP UBR 0 IN
0/2/0 name 1 1 PVC SNAP UBR 0 IN
0/2/0 4 2 200 PVC SNAP UBR 0 IN
0/2/0 vpi/vci 3 100 PVC SNAP UBR 0 IN
0/2/0 8 4 100 PVC SNAP UBR 0 IN
|
The following example shows the three extended ATM PVC traps enabled on a router. If PVC 0/1 either leaves the up state or down state or encounters an OAM loopback failure, then the host 172.16.61.90 receives SNMP notifications:
! Configure SNMP support and an IP routing protocol on your router: Router(config)# snmp-server community public ro Router(config)# snmp-server host 172.16.61.90 public Router(config)# ip routing Router(config)# router igrp 109 Router(config-router)# network 172.16.0.0 ! ! Enable extended ATM PVC trap support and OAM management: Router(config)# snmp-server enable traps atm pvc extension down Router(config)# snmp-server enable traps atm pvc extension up Router(config)# snmp-server enable traps atm pvc extension oam failure loopback Router(config)# interface atm 0/1/0.1 Router(config-if)# pvc 0/1 Router(config-if-atm-vc)# oam-pvc manage
This section contains examples of output for the extended ATM PVC traps.
The following example shows the output for the extended ATM PVC failure trap for PVCs 1/100, 1/102, and 1/103. Note that only one trap is generated for all the PVCs associated with the same interface or subinterface (in contrast to the legacy ATM PVC failure trap that generates a separate trap for each PVC). The VPI/VCI information and timing are located in the objects that are associated with the trap.
00:23:56:SNMP:Queuing packet to 1.1.1.1 00:23:56:SNMP:V2 Trap, reqid 2, errstat 0, erridx 0 sysUpTime.0 = 143636 snmpTrapOID.0 = atmIntfPvcFailuresTrap ifEntry.1.19 = 19 atmIntfPvcFailures.2 = 7 atmIntfCurrentlyFailingPVcls.2 = 3 atmPVclLowerRangeValue.19.1.2 = 102 atmPVclHigherRangeValue.19.1.2 = 103 atmPVclRangeStatusChangeStart.19.1.2 = 140643 atmPVclRangeStatusChangeEnd.19.1.2 = 140698 atmPVclStatusTransition.19.1.100 = 1 atmPVclStatusChangeStart.19.1.100 = 140636 atmPVclStatusChangeEnd.19.1.100 = 140636 00:23:56:SNMP:Packet sent via UDP to 1.1.1.1
The following example shows the output for the extended ATM PVC up trap for PVCs 1/100, 1/102, and 1/103:
00:31:29:SNMP:Queuing packet to 1.1.1.1 00:31:29:SNMP:V2 Trap, reqid 2, errstat 0, erridx 0 sysUpTime.0 = 188990 snmpTrapOID.0 = atmIntfPvcUpTrap ifEntry.1.19 = 19 atmIntfCurrentlyDownToUpPVcls.2 = 3 atmPVclLowerRangeValue.19.1.2 = 102 atmPVclHigherRangeValue.19.1.2 = 103 atmPVclRangeStatusChangeStart.19.1.2 = 186005 atmPVclRangeStatusChangeEnd.19.1.2 = 186053 atmPVclStatusTransition.19.1.100 = 1 atmPVclStatusChangeStart.19.1.100 = 185990 atmPVclStatusChangeEnd.19.1.100 = 185990 00:31:30:SNMP:Packet sent via UDP to 1.1.1.1
The following example shows how to enable OAM ASI-RDI monitoring in ATM VC configuration mode:
Router> enable Router# configure terminal Router(config)# interface atm 2/0/0 Router(config-if)# pvc 0/400 Router(config-if-atm-vc)# oam ais-rdi 25 5 Router(config-if-atm-vc)# end
The following example shows how to enable OAM ASI-RDI monitoring in ATM VC class configuration mode:
Router> enable Router# configure terminal Router(config)# vc-class atm vctest Router(config-vc-class)# oam ais-rdi 14 5 Router(config-vc-class)# end
Related Topic |
Document Title |
---|---|
Cisco IOS commands |
|
ATM commands: complete command syntax, defaults, command mode, command history, usage guidelines, and examples |
Cisco IOS Asynchronous Transfer Mode Command Reference |
SNMP commands: complete command syntax, defaults, command mode, command history, usage guidelines, and examples |
Cisco IOS Network Management Command Reference |
Overview of ATM SPAs |
"Configuring ATM" |
Standard |
Title |
---|---|
None |
-- |
MIB |
MIBs Link |
---|---|
To locate and download MIBs for selected platforms, Cisco software releases, and feature sets, use Cisco MIB Locator found at the following URL: |
Description |
Link |
---|---|
The Cisco Support and Documentation website provides online resources to download documentation, software, and tools. Use these resources to install and configure the software and to troubleshoot and resolve technical issues with Cisco products and technologies. Access to most tools on the Cisco Support and Documentation website requires a Cisco.com user ID and password. |
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 SNMP Trap and OAM Enhancements |
Feature Name |
Releases |
Feature Information |
---|---|---|
ATM SNMP Trap and OAM Enhancements |
Cisco IOS XE Release 2.3 Cisco IOS XE Release 3.2S |
The feature provides enhancements to the Simple Network Management Protocol (SNMP) notifications for ATM permanent virtual circuits (PVCs) and to Operation, Administration, and Maintenance (OAM) functionality. The ATM SNMP Trap and OAM Enhancements feature introduces a high watermark trap. A trap is generated when the number of configured PVCs in an interface and related subinterfaces exceeds a preconfigured high watermark threshold. The following commands were introduced or modified: oam-pvc manage, rmon alarm, snmp-server enable traps atm pvc extension. |
ATM OAM AIS-RDI Monitoring |
Cisco IOS XE Release 2.3 |
The ATM OAM AIS-RDI Monitoring feature extends the existing ATM virtual circuit OAM functionality to include monitoring of the AIS-RDI. The following commands were introduced or modified: oam ais-rdi. |
inform --SNMP trap message that includes a delivery confirmation request.
MIB --Management Information Base. Database of network management information that is used and maintained by a network management protocol such as SNMP. The value of a MIB object can be changed or retrieved using SNMP commands, usually through a network management system (NMS). MIB objects are organized in a tree structure that includes public (standard) and private (proprietary) branches.
NMS --Network Management System. An application or suite of applications that are designed to monitor networks using SNMP. CiscoView is one example of an NMS.
OAM --Operation, Administration, and Maintenance. The ATM Forum specifies OAM cells that are used to monitor virtual circuits. OAM cells provide a virtual circuit-level loopback in which a router responds to the cells, demonstrating that the circuit is up and the router is operational.
PVC --Permanent Virtual Circuit. Virtual circuit that is permanently established. PVCs save bandwidth that is associated with circuit establishment and teardown in situations where certain virtual circuits must exist all the time. In ATM terminology, PVC also stands for permanent virtual connection.
SNMP --Simple Network Management Protocol. An application-layer protocol that provides a message format for communication between SNMP managers and agents and is exclusively used in TCP/IP networks. SNMP provides a means to monitor and control network devices and to manage configurations, statistics collection, performance, and security.
trap --A message from an SNMP agent alerting the SNMP manager to a condition on the network.
VCI --Virtual Channel Identifier. A 16-bit field in the header of an ATM cell. The VCI, together with the VPI, is used to identify the next destination of a cell as it passes through a series of ATM switches on its way to its destination. ATM switches use the VPI/VCI fields to identify the next network VCL that a cell needs to transit on its way to its final destination.
VCL --Virtual Channel Link. A connection between two ATM devices.
VPI --Virtual Path Identifier. An 8-bit field in the header of an ATM cell. The VPI, together with the VCI, is used to identify the next destination of a cell as it passes through a series of ATM switches on its way to its destination. ATM switches use the VPI/VCI fields to identify the next VCL that a cell needs to transit on its way to its final destination. The function of the VPI is similar to that of the DLCI in Frame Relay.
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.