- Pseudowire Emulation Edge-to-Edge MIBs for Ethernet, Frame Relay, and ATM Services
- MPLS EM�MPLS LSP Multipath Tree Trace
- MPLS Enhancements to Interfaces MIB
- MPLS Label Distribution Protocol MIB
- MPLS Label Distribution Protocol MIB Version 8 Upgrade
- MPLS LSP Ping/Traceroute for LDP/TE, and LSP Ping for VCCV
- MPLS Label Switching Router MIB
- Monitoring MPLS VPNs with MIBs
- MPLS Traffic Engineering - Fast Reroute MIB
- MPLS Traffic Engineering MIB
- MPLS VPN�MIB Support
- MPLS VPN�SNMP Notifications
- Finding Feature Information
- Contents
- Prerequisites for the MPLS Traffic Engineering—Fast Reroute MIB
- Restrictions for the MPLS Traffic Engineering—Fast Reroute MIB
- Information About the MPLS Traffic Engineering—Fast Reroute MIB
MPLS Traffic Engineering—Fast Reroute MIB
The MPLS Traffic Engineering—Fast Reroute MIB provides Simple Network Management Protocol (SNMP)-based network management of the Multiprotocol Label Switching (MPLS) Fast Reroute (FRR) feature in Cisco IOS software.
The Fast Reroute MIB has the following features:
•Notifications can be created and queued.
•Command-line interface (CLI) commands enable notifications, and specify the IP address to where the notifications will be sent.
•The configuration of the notifications can be written into nonvolatile memory.
The MIB includes objects describing features within MPLS FRR, and it includes the following tables:
•cmplsFrrConstTable
•cmplsFrrLogTable
•cmplsFrrFacRouteDBTable
The MIB also includes scalar objects (that is, objects that are not in a table). For more information, see the "FRR MIB Scalar Objects" section.
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 for MPLS Traffic Engineering—Fast Reroute MIB" section.
Use Cisco Feature Navigator to find information about platform support and Cisco IOS and Catalyst OS software image support. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Contents
•Prerequisites for the MPLS Traffic Engineering—Fast Reroute MIB
•Restrictions for the MPLS Traffic Engineering—Fast Reroute MIB
•Information About the MPLS Traffic Engineering—Fast Reroute MIB
•How to Configure the MPLS Traffic Engineering—Fast Reroute MIB
•Configuration Examples for the MPLS Traffic Engineering—Fast Reroute MIB
•Feature Information for MPLS Traffic Engineering—Fast Reroute MIB
Prerequisites for the MPLS Traffic Engineering—Fast Reroute MIB
•The network must support the Intermediate System-to-Intermediate System (IS-IS) or Open Shortest Path First (OSPF) protocol.
•The SNMP is installed and enabled on the label switch routers (LSRs).
•MPLS is enabled globally on each LSR.
•Cisco Express Forwarding is enabled on the LSRs.
•Traffic engineering (TE) tunnels are enabled.
•MPLS FRR is enabled on one of the TE tunnels.
•The Resource Reservation Protocol (RSVP) is enabled.
Restrictions for the MPLS Traffic Engineering—Fast Reroute MIB
•The implementation of the FRR MIB is limited to read-only (RO) permission for MIB objects.
•Configuration of the FRR MIB using the SNMP SET command is not supported in Cisco IOS Release 12.2(33)SRA or in prior releases.
•The following tables are not implemented in the specified releases:
–mplsFrrOne2OnePlrTable—Not implemented in Cisco IOS software.
–mplsFrrDetourTable—Not implemented in Cisco IOS software.
–cmplsFrrLogTable—Implemented only in Cisco IOS 12.0S-based releases.
Information About the MPLS Traffic Engineering—Fast Reroute MIB
•Feature Design of the MPLS Traffic Engineering—Fast Reroute MIB
•Functional Structure of the MPLS Traffic Engineering—Fast Reroute MIB
•System Flow of SNMP Protocol Requests and Response Messages
•MIB Tables in the MPLS Traffic Engineering—Fast Reroute MIB
Feature Design of the MPLS Traffic Engineering—Fast Reroute MIB
The FRR MIB enables standard, SNMP-based network management of FRR in Cisco IOS software. This capability requires that SNMP agent code executes on a designated network management station (NMS) in the network. The NMS serves as the medium for user interaction with the network management objects in the MIB.
The FRR MIB is based on the Internet Engineering Task Force (IETF) draft MIB specification draft-ietf-mpls-fastreroute-mib-02.txt. The IETF draft MIB, which undergoes revisions periodically, is evolving toward becoming a standard. The Cisco implementation of the FRR MIB is expected to track the evolution of the IETF draft MIB, and may change accordingly.
Slight differences between the IETF draft MIB and the implementation of FRR within Cisco IOS software require some minor translations between the FRR MIB objects and the internal data structures of Cisco IOS software. These translations are accomplished by the SNMP agent, which runs in the background on the NMS workstation as a low priority process and provides a management interface to Cisco IOS software.
You can use an SNMP agent to access FRR MIB objects using standard SNMP GET operations. All the objects in the FRR MIB follow the conventions defined in the IETF draft MIB.
Functional Structure of the MPLS Traffic Engineering—Fast Reroute MIB
The SNMP agent code supporting the FRR MIB follows the existing model for such code in Cisco IOS software and is, in part, generated by the Cisco IOS tool set, based on the MIB source code. The basis for the generated code is the Cisco version of the FRR MIB CISCO-ietf-frr-mib.
The SNMP agent code, which has a layered structure that is common to MIB support code in Cisco IOS software, consists of the following layers:
•Platform-independent layer—This layer is generated primarily by the MIB development Cisco IOS tool set and incorporates platform- and implementation-independent functions. These functions handle SNMP standard functionality in the context of the specific MIB. This layer handles indexes and range or enumeration value checks for GET, GET-NEXT, and SET SNMP operations. A function is generated for each SNMP table or group of objects. This layer calls into the next layer.
•Application interface layer—The Cisco IOS tool set generates the function names and template code for MIB objects.
•Application-specific layer—This layer provides the mechanism for retrieving relevant data from the managed application layer. It includes an entry point function for each table. This function calls two other functions; one that searches the TE tunnel database that RSVP maintains for the relevant data according to the indexes, and another function that fills the data into the structure.
•Managed application layer—This layer includes all the structures and mechanisms, and is managed by the MIB.
System Flow of SNMP Protocol Requests and Response Messages
All SNMP protocol requests and response messages are ultimately handled by the SNMP master agent. When such a message is received on a router, the master agent parses the requests and identifies the MIB to which the request refers. The master agent then queries the subagent responsible for the MIB with a GET, GET-NEXT, or SET request. The FRR MIB subagent retrieves the appropriate data, and returns it to the master agent. The master agent is then responsible for returning an SNMP response to the NMS. All queries occur within the IP SNMP Cisco IOS process, which runs as a low priority task.
FRR MIB Scalar Objects
Scalar objects are objects that are not in tables. A scalar object has one instance (that is, one occurrence).
Table 1 describes the FRR MIB scalar objects.
FRR MIB Notifications
Notifications are issued after particular FRR events occur. This section provides the following information about FRR MIB notifications supported in Cisco IOS Release 12.0(26)S and in prior releases, Cisco IOS Release 12.2(33)SRA, Cisco IOS Release 12.2(33)SXH, and Cisco IOS Release 12.4(20)T:
•Notification Generation Events
Notification Generation Events
When you enable FRR MIB notification functionality by issuing the snmp-server enable traps mpls fast-reroute command, FRR events generate notification messages that are sent to a designated NMS in the network to signal the occurrence of specific events in Cisco IOS software.
The FRR MIB objects involved in FRR status transitions and event notifications include cmplsFrrProtected. This message is sent to an NMS if there is a major TE tunnel change (that is, fast rerouting of TE tunnels).
Notification Specification
Each FRR notification has a generic type identifier and an enterprise-specific type identifier for identifying the notification type. The generic type for all FRR notifications is "enterprise Specific" because this is not one of the generic notification types defined for SNMP. The enterprise-specific type is 1 for cmplsFrrProtected.
Each notification contains the following objects from the FRR MIB so that the FRR tunnel can be easily identified:
•cmplsFrrConstNumProtectingTunOnIf
•cmplsFrrConstNumProtectedTunOnIf
•cmplsFrrConstBandwidth
Upon being invoked, the appropriate FRR interface indexes have already been retrieved by existing FRR code. The FRR interfaces are then used to fill in data for the three objects included in the notification.
Notification Monitoring
When FRR MIB notifications are enabled (see the snmp-server enable traps command), notification messages relating to specific FRR events within Cisco IOS software are generated and sent to a specified NMS in the network. Any utility that supports SNMPv1 or SNPv2 notifications can receive notification messages.
To monitor FRR MIB notifications, log in to an NMS that supports a utility that displays SNMP notifications, and start the display utility.
MIB Tables in the MPLS Traffic Engineering—Fast Reroute MIB
The FRR MIB consists of the following tables:
The tables access various data structures to obtain information regarding detours, the FRR database, and logging.
cmplsFrrConstTable
cmplsFrrConstTable displays the configuration of an FRR-enabled tunnel and the characteristics of its accompanying backup tunnels. For each protected tunnel, there can be multiple backup tunnels.
The table is indexed by the following:
•cmplsFrrConstIfIndex
•cmplsFrrConstTunnelIndex
•cmplsFrrConstTunnelInstance
Table 2 describes the MIB objects for cmplsFrrConstTable.
cmplsFrrLogTable

Note cmplsFrrLogTable and the show mpls traffic-eng fast-reroute log reroutes command are supported only in Cisco IOS 12.0S-based releases.
cmplsFrrLogTable is indexed by the object cmplsFrrLogIndex. The index corresponds to a log entry in the FRR feature's show mpls traffic-eng fast-reroute log reroutes command. That show command stores up to 32 entries at a time. If entries are added, the oldest entry is overwritten with new log information.
cmplsFrrLogTable can store up to 32 entries at a time, overwriting older entries as newer ones are added. The index cmplsFrrLogIndex is incremented to give each log table entry of the MIB a unique index value. Therefore, it is possible to have indexes greater than 32 even though only 32 entries are displaying.
Table 3 describes the MIB objects for cmplsFrrLogTable.
cmplsFrrFacRouteDBTable
The following indexes specify which interface and tunnel are being protected by the FRR feature:
•cmplsFrrFacRouteProtectedIfIndex
•cmplsFrrFacRouteProtectedTunIndex
The following indexes specify the backup tunnel that provides protection to the protected tunnel:
•cmplsFrrFacRouteProtectedIfIndex
•cmplsFrrFacRouteProtectingTunIndex
•cmplsFrrFacRouteProtectedTunIndex
•cmplsFrrFacRouteProtectedTunInstance
•cmplsFrrFacRouteProtectedTunIngressLSRId
•cmplsFrrFacRouteProtectedTunEgressLSRId
This version of the MIB will attempt to leverage the work already done for the MPLS TE MIB because it contains similar lookup functions for TE tunnels.
Table 4 describes the MIB objects for cmplsFrrFacRouteDBTable.
How to Configure the MPLS Traffic Engineering—Fast Reroute MIB
This section contains the following tasks:
•Enabling the SNMP Agent for FRR MIB Notifications (required)
•Enabling Cisco Express Forwarding (required)
•Enabling TE Tunnels (required)
•Enabling MPLS FRR on Each TE Tunnel (required)
•Enabling a Backup Tunnel on an Interface (required)
Enabling the SNMP Agent for FRR MIB Notifications
SUMMARY STEPS
1. enable
2. show running-config
3. configure terminal
4. snmp-server community string [view view-name] [ro] [access-list-number]
5. snmp-server enable traps mpls fast-reroute protected
6. end
7. write memory
DETAILED STEPS
Enabling Cisco Express Forwarding
SUMMARY STEPS
1. enable
2. configure terminal
3. ip cef distributed
4. end
DETAILED STEPS
Enabling TE Tunnels
SUMMARY STEPS
1. enable
2. configure terminal
3. ip cef
4. mpls traffic-eng tunnels
5. interface typeslot/port
6. mpls traffic-eng tunnels
7. end
DETAILED STEPS
Enabling MPLS FRR on Each TE Tunnel
SUMMARY STEPS
1. enable
2. configure terminal
3. interface typeslot/port
4. tunnel mode mpls traffic-eng
5. tunnel mpls traffic-eng fast-reroute
6. end
DETAILED STEPS
Enabling a Backup Tunnel on an Interface
SUMMARY STEPS
1. enable
2. configure terminal
3. interface typeslot/port
4. mpls traffic-eng backup-path tunnel interface
5. end
DETAILED STEPS
Configuration Examples for the MPLS Traffic Engineering—Fast Reroute MIB
•Enabling an SNMP Agent on a Host NMS: Example
•Enabling Cisco Express Forwarding: Example
•Enabling MPLS FRR on Each TE Tunnel: Example
•Enabling a Backup Tunnel on an Interface: Example
Enabling an SNMP Agent on a Host NMS: Example
The following example shows how to enable an SNMP agent on the host NMS:
enable
show running-config
configure terminal
snmp-server community public ro
snmp-server enable traps mpls fast-reroute protected
end
write memory
Enabling Cisco Express Forwarding: Example
The following example shows how to enable Cisco Express Forwarding:
enable
configure terminal
ip cef distributed
end
Enabling TE Tunnels: Example
The following example shows how to enable traffic engineering tunnels:
enable
configure terminal
ip cef
mpls traffic-eng tunnels interface Ethernet1/0 mpls traffic-eng tunnels
end
Enabling MPLS FRR on Each TE Tunnel: Example
The following example shows how to enable MPLS Fast Reroute on each TE tunnel:
enable
configure terminal interface POS1/0 tunnel mode mpls traffic-eng
tunnel mpls traffic-eng fast-reroute
end
Enabling a Backup Tunnel on an Interface: Example
The following example shows how to enable a backup tunnel on an interface:
enable
configure terminal interface POS1/0
mpls traffic-eng backup-path tunnel1
end
Additional References
Related Documents
|
|
---|---|
SNMP agent support for the MPLS Traffic Engineering MIB |
|
Fast Reroute |
MPLS Traffic Engineering (TE): Fast Reroute (FRR) Link and Node Protection |
Standards
|
|
---|---|
MPLS-FRR-MIB |
draft-ietf-mpls-fastreroute-mib-02.txt |
MIBs
|
|
---|---|
MPLS Traffic Engineering (TE) MIB |
To locate and download MIBs for selected platforms, Cisco IOS releases, and feature sets, use Cisco MIB Locator found at the following URL: |
RFCs
|
|
---|---|
No new or modified RFCs are supported by this MIB, and support for existing RFCs has not been modified by this MIB. |
— |
Technical Assistance
Feature Information for MPLS Traffic Engineering—Fast Reroute MIB
Table 5 lists the features in this module and provides links to specific configuration information. Only features that were introduced or modified in Cisco IOS Release 12.0(10)ST or Cisco IOS Release 12.0(16)ST or 12.4(20)T or a later release appear in the table.
Not all commands may be available in your Cisco IOS software release. For release information about a specific command, see the command reference documentation.
Use Cisco Feature Navigator to find information about platform support and software image support. Cisco Feature Navigator enables you to determine which Cisco IOS and Catalyst OS software images support a specific software release, feature set, or platform. To access Cisco Feature Navigator, go to http://www.cisco.com/go/cfn. An account on Cisco.com is not required.
Glossary
Cisco Express Forwarding—An advanced Layer 3 IP switching technology. Cisco Express Forwarding optimizes network performance and scalability for networks with large and dynamic traffic patterns.
index—A method of uniquely identifying a tunnel.
instance—An occurrence. An object can have one or more instances.
IS-IS—Intermediate System-to-Intermediate System. IS-IS is an OSI link-state hierarchical routing protocol based on DECnet Phase V routing where intermediate system (IS) routers exchange routing information based on a single metric to determine network topology.
label—A short, fixed-length data construct that tells switching nodes how to forward data (packets or cells).
LFIB—Label Forwarding Information Base. The data structure for storing information about incoming and outgoing tags (labels) and associated equivalent packets suitable for labeling.
LSR—label switching router. A device that forwards MPLS packets based on the value of a fixed-length label encapsulated in each packet.
MIB—Management Information Base. A database of network management information that is used and maintained by a network management protocol such as Simple Network Management Protocol (SNMP). The value of a MIB object can be changed or retrieved by using SNMP commands, usually through a network management system. MIB objects are organized in a tree structure that includes public (standard) and private (proprietary) branches.
NMS—network management station. A powerful, well-equipped computer (typically an engineering workstation) that is used by a network administrator to communicate with other devices in the network. An NMS is typically used to manage network resources, gather statistics, and perform a variety of network administration and configuration tasks.
notification—A message sent by a Simple Network Management Protocol (SNMP) agent to a network management station, console, or terminal to indicate that a significant event within Cisco IOS software has occurred.
object—A variable that has a specific instance associated with it.
OSPF—Open Shortest Path First. Link-state, hierarchical Interior Gateway Protocol (IGP) routing algorithm proposed as a successor to Routing Information Protocol (RIP) in the Internet community. OSPF features include least-cost routing, multipath routing, and load balancing.
RSVP—Resource Reservation Protocol. Protocol for reserving network resources to provide quality of service (QoS) guarantees to application flows.
scalar object—Objects that are not instances. A scalar object has one instance.
SNMP—Simple Network Management Protocol. A network management protocol used almost exclusively in TCP/IP networks. SNMP provides a means to monitor and control network devices, manage configurations, collect statistics, monitor performance, and ensure network security.
SNMP agent—A managed node or device. The router that has the MIB implementation on it.