IETF Internet Draft Thomas D. Nadeau Expires: November 2004 Cisco Systems, Inc. Document: draft-ietf-l3vpn-mpls-vpn-mib-03.txt Harmen Van Der Linde AT&T Editors May 2004 MPLS/BGP Layer 3 Virtual Private Network Management Information Base Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC 2026. Internet-Drafts are working documents of the In ternet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet- Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet- Drafts as reference material or to cite them other than as "work in progress." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Abstract This memo defines an portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects to configure and/or monitor Multi-protocol Label Switching Layer-3 Virtual Private Networks on a Multi-Protocol Label Switching (MPLS) Label Switching Router (LSR) supporting this feature. Contents 1.0 Abstract..........................................................2 2.0 Introduction......................................................2 3.0 Terminology.......................................................3 4.0 The SNMP Management Framework.....................................3 5.0 Assumptions and Prerequisites.....................................3 IETF L3 Working Group Expires November 2004 [Page 1] Internet Draft MPLS L3 VPN MIB May 14, 2004 6.0 Brief Description of MIB Objects..................................4 6.1 mplsL3VpnVrfTable................................................4 6.2 mplsL3VpnIfConfTable.............................................4 6.3 mplsL3VpnVrfPerfTable............................................5 6.4 mplsL3VpnVrfRouteTable...........................................5 6.5 MplsVpnVrfRTTable................................................5 7.0 Example of MPLS L3VPN Setup.......................................5 8.0 MPLS-L3VPN-MIB Module Definition..................................6 9.0 Acknowledgements.................................................37 10.0 Intellectual Property Notice....................................37 11.0 References......................................................37 11.1 Normative References............................................37 11.2 Informative References..........................................37 12.0 Editors' Addresses..............................................40 13.0 Contributors' Addresses.........................................40 14.0 Dedication......................................................41 15.0 Full Copyright Statement........................................41 16.0 Security Considerations.........................................41 17. Intellectual Property Notice....................................41 18.0 IANA Considerations.............................................41 18.1 IANA Considerations for MPLS-L3VPN-MIB..........................41 2.0 Introduction This memo defines an portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes managed objects to configure and/or monitor Multi-protocol Label Switching Layer-3 Virtual Private Networks on a Multi-Protocol Label Switching (MPLS) Label Switching Router (LSR) supporting this feature. Comments should be made directly to the MPLS mailing list at mpls@uu.net and the Layer-3 VPN (L3VPN) WG at l3vpn@ietf.org. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in RFC 2119, reference [RFC2119]. 3.0 Terminology This document uses terminology from the document describing the MPLS architecture [MPLSArch] and from the document describing MPLS Layer-3 VPNs (L3VPN) [MPLSBGPVPN], as well as the MPLS architecture [RFC3031]. Throughout this document, the use of the terms "Provider Edge (PE) and Customer Edge (CE) or PE/CE" will be replaced by PE in all cases IETF L3 Working Group Expires November 2004 [Page 2] Internet Draft MPLS L3 VPN MIB May 14, 2004 except when a network device is a CE when used in the carrier of carriers model. 4.0 The SNMP Management Framework For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to section 7 of RFC 3410 [RFC3410]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. MIB objects are generally accessed through the Simple Network Management Protocol (SNMP). Objects in the MIB are defined using the mechanisms defined in the Structure of Management Information (SMI). This memo specifies a MIB module that is compliant to the SMIv2, which is described in STD 58, RFC 2578 [RFC2578], STD 58, RFC 2579 [RFC2579] and STD 58, RFC 2580 [RFC2580]. 5.0 Assumptions and Prerequisites It is assumed that certain things are configured and operational in order for the tables and objects described in this MIB to function correctly. These things are outlined below: - MPLS in general, must be configured and operational. - LDP paths or traffic engineered tunnels should be configured between PEs and CEs. 6.0 Brief Description of MIB Objects The following subsections describe the purpose of each of the objects contained in the MPLS-VPN-MIB. 6.1 mplsL3VpnVrfTable This table represents the MPLS L3VPNs that are configured. A Network Management System (NMS) or SNMP agent creates an entry in this table for every MPLS L3VPN configured on the LSR being examined. The VPR that is configured at a particular device represents an instance of some VPN, but not the entire VPN (unless it is the only VRF, of course). The collective set of VRF instances comprises the actual VPN. This information is typically only known in its entirety at the NMS. That is, specific devices generally only know of their local VRF information, but not that of other LSRs' VRFs. 6.2 mplsL3VpnIfConfTable IETF L3 Working Group Expires November 2004 [Page 3] Internet Draft MPLS L3 VPN MIB May 14, 2004 This table represents the MPLS L3VPN-enabled interfaces that are associated with a specific VRF as represented in the aforementioned mplsL3VpnVrfTable. Each entry in this table corresponds to an entry in the Interfaces MIB. In addition, each entry extends its corresponding entry in the Interface MIB to contain specific MPLS L3VPN information. Due to this correspondence, certain objects such as traffic counters are not found in this MIB to avoid overlap, but instead are found in the Interfaces MIB [RFC2863]. 6.3 mplsL3VpnVrfPerfTable This table contains objects to measure the performance of MPLS L3VPNs and augments the mplsL3VpnVrfConfTable. High capacity counters are provided for objects that are likely to wrap around quickly on objects such as high-speed interface counters. 6.4 mplsL3VpnVrfRouteTable The table contains the objects necessary to configure and monitor routes used by a particular VRF. This includes a cross-connect pointer into the MPLS-LSR-STD-MIB's mplsXCTable, which may be used to refer that entry to its label stack used to label switch that entry. 6.5 MplsVpnVrfRTTable The table contains the objects necessary to configure and monitor route targets for a particular VRF. 7.0 Example of MPLS L3VPN Setup In this section, we provide a brief example of using the MIB objects described in the following section. While this example is not meant to illustrate every nuance of the MIB, it is intended as an aid to understanding some of the key concepts. It is our intent that it is read only after the reader has gone through the MIB itself. This configuration is under the assumption that 1) MPLS has been pre- configured in the network, through enabling LDP or RSVP-TE. 2) OSPF or ISIS has been pre-configured. 3) BGP sessions have been established between PEs. Defining the VRF, the route target and route distinguisher: In mplsL3VpnVrfTable: { IETF L3 Working Group Expires November 2004 [Page 4] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfName = "RED", mplsL3VpnVrfDescription = "Intranet of Company ABC", mplsL3VpnVrfRD = "100:1", -- octet string mplsL3VpnVrfRowStatus = createAndGo(4) } In mplsL3VpnVrfRouteTTable: { mplsL3VpnVrfRTRowStatus."Red"."100:1".import = createAndGo, mplsL3VpnVrfRTRowStatus."Red"."100:1".export = createAndGo } 8.0 MPLS-L3VPN-MIB Module Definition MPLS-L3VPN-DRAFT-03-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE, Integer32, Counter32, Unsigned32, Gauge32 FROM SNMPv2-SMI MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF TEXTUAL-CONVENTION, TruthValue, RowStatus, StorageType, TimeStamp FROM SNMPv2-TC InterfaceIndex FROM IF-MIB VPNId FROM L3VPN-TC-DRAFT-02-MIB SnmpAdminString FROM SNMP-FRAMEWORK-MIB IANAipRouteProtocol FROM IANA-RTPROTO-MIB InetAddress, InetAddressType, InetAddressPrefixLength, InetAutonomousSystemNumber FROM INET-ADDRESS-MIB mplsStdMIB FROM MPLS-TC-STD-MIB MplsIndexType FROM MPLS-LSR-STD-MIB ; mplsL3VpnMIB MODULE-IDENTITY LAST-UPDATED "200405011200Z" -- 01 May 2004 12:00:00 GMT ORGANIZATION "IETF Layer-3 Virtual Private Networks Working Group." CONTACT-INFO " Thomas D. Nadeau tnadeau@cisco.com IETF L3 Working Group Expires November 2004 [Page 5] Internet Draft MPLS L3 VPN MIB May 14, 2004 Harmen van der Linde hvdl@att.com Luyuan Fang luyuanfang@att.com Stephen Brannon Fabio M. Chiussi fabio@bell-labs.com Joseph Dube Martin Tatham martin.tatham@bt.com Comments and discussion to l3vpn@ietf.org" DESCRIPTION "This MIB contains managed object definitions for the Layer-3 Multiprotocol Label Switching Virtual Private Networks. Copyright (C) The Internet Society (2004). This version of this MIB module is part of RFCXXX; see the RFC itself for full legal notices." -- Revision history. REVISION "200405011200Z" -- 01 May 2004 12:00:00 GMT DESCRIPTION "Initial version. Published as RFC xxxx." -- RFC-editor pls fill in xxx ::= { mplsStdMIB xxx } -- assigned by IANA, see section 18.1 for details -- Textual Conventions. MplsL3VpnName ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An identifier that is assigned to each MPLS/BGP VPN and is used to uniquely identify it. This is assigned by the system operator or NMS and SHOULD be unique throughout the MPLS domain. If this is the case, then this identifier can then be used at any LSR within a specific MPLS domain to identify this MPLS/BGP VPN. It may also be possible to preserve the uniqueness of this identifier across MPLS domain boundaries, in which case this identifier can then be used to uniquely identify MPLS/BGP VPNs on a more global basis. This object MAY be set to the VPN ID as defined in RFC 2685." REFERENCE "RFC 2685 Fox B., et al, 'Virtual Private IETF L3 Working Group Expires November 2004 [Page 6] Internet Draft MPLS L3 VPN MIB May 14, 2004 Networks Identifier', September 1999." SYNTAX OCTET STRING(SIZE (0..31)) MplsL3VpnRouteDistinguisher ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "Syntax for a route distinguisher and route target." SYNTAX OCTET STRING(SIZE (0..256)) -- Top level components of this MIB. mplsL3VpnNotifications OBJECT IDENTIFIER ::= { mplsL3VpnMIB 0 } mplsL3VpnObjects OBJECT IDENTIFIER ::= { mplsL3VpnMIB 1 } mplsL3VpnScalars OBJECT IDENTIFIER ::= { mplsL3VpnObjects 1 } mplsL3VpnConf OBJECT IDENTIFIER ::= { mplsL3VpnObjects 2 } mplsL3VpnPerf OBJECT IDENTIFIER ::= { mplsL3VpnObjects 3 } mplsL3VpnRoute OBJECT IDENTIFIER ::= { mplsL3VpnObjects 4 } mplsL3VpnConformance OBJECT IDENTIFIER ::= { mplsL3VpnMIB 3 } -- -- Scalar Objects -- mplsL3VpnConfiguredVrfs OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of VRFs which are configured on this node." ::= { mplsL3VpnScalars 1 } mplsL3VpnActiveVrfs OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of VRFs which are active on this node. That is, those VRFs whose corresponding mplsL3VpnVrfOperStatus object value is equal to operational (1)." ::= { mplsL3VpnScalars 2 } mplsL3VpnConnectedInterfaces OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Total number of interfaces connected to a VRF." ::= { mplsL3VpnScalars 3 } mplsL3VpnNotificationEnable OBJECT-TYPE SYNTAX TruthValue IETF L3 Working Group Expires November 2004 [Page 7] Internet Draft MPLS L3 VPN MIB May 14, 2004 MAX-ACCESS read-write STATUS current DESCRIPTION "If this object is true, then it enables the generation of all notifications defined in this MIB." REFERENCE "See also RFC3413 for explanation that notifications are under the ultimate control of the MIB modules in this document." DEFVAL { false } ::= { mplsL3VpnScalars 4 } mplsL3VpnVrfConfMaxPossRts OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Denotes maximum number of routes which the device will allow all VRFs jointly to hold. If this value is set to 0, this indicates that the device is unable to determine the absolute maximum. In this case, the configured maximum MAY not actually be allowed by the device." ::= { mplsL3VpnScalars 5 } mplsL3VpnVrfConfRteMxThrshTime OBJECT-TYPE SYNTAX Unsigned32 UNITS "seconds" MAX-ACCESS read-only STATUS current DESCRIPTION "Denotes the interval in seconds, at which the route max threshold notification may be re-issued after the maximum value has been exceeded (or has been reached if mplsL3VpnVrfConfMaxRoutes and mplsL3VpnVrfConfHighRteThresh are equal) and the initial notification has been issued. This value is intended to prevent continuous generation of notifications by an agent in the event that routes are continually added to a VRF after it has reached its maximum value. If this value is set to 0, the agent should only issue a single notification at the time that the maxium threshold has been reached, and should not issue any more notifications until the value of routes has fallen below the configured threshold value. This is the recommended default behavior." DEFVAL { 0 } ::= { mplsL3VpnScalars 6 } -- VPN Interface Configuration Table IETF L3 Working Group Expires November 2004 [Page 8] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnIfConfTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnIfConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per-interface MPLS capability and associated information." ::= { mplsL3VpnConf 1 } mplsL3VpnIfConfEntry OBJECT-TYPE SYNTAX MplsL3VpnIfConfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by an LSR for every interface capable of supporting MPLS L3VPN. Each entry in this table is meant to correspond to an entry in the Interfaces Table." INDEX { mplsL3VpnVrfName, mplsL3VpnIfConfIndex } ::= { mplsL3VpnIfConfTable 1 } MplsL3VpnIfConfEntry ::= SEQUENCE { mplsL3VpnIfConfIndex InterfaceIndex, mplsL3VpnIfVpnClassification INTEGER, mplsL3VpnIfVpnRouteDistProtocol BITS, mplsL3VpnIfConfStorageType StorageType, mplsL3VpnIfConfRowStatus RowStatus } mplsL3VpnIfConfIndex OBJECT-TYPE SYNTAX InterfaceIndex MAX-ACCESS not-accessible STATUS current DESCRIPTION "This is a unique index for an entry in the mplsL3VpnIfConfTable. A non-zero index for an entry indicates the ifIndex for the corresponding interface entry in the MPLS-VPN-layer in the ifTable. Note that this table does not necessarily correspond one-to-one with all entries in the Interface MIB having an ifType of MPLS-layer; rather, only those which are enabled for MPLS L3VPN functionality." REFERENCE "RFC 2233 - The Interfaces Group MIB using SMIv2, McCloghrie, K., and F. Kastenholtz, Nov. 1997" ::= { mplsL3VpnIfConfEntry 1 } mplsL3VpnIfVpnClassification OBJECT-TYPE SYNTAX INTEGER { carrierOfCarrier (1), enterprise (2), IETF L3 Working Group Expires November 2004 [Page 9] Internet Draft MPLS L3 VPN MIB May 14, 2004 interProvider (3) } MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes whether this link participates in a carrier-of-carrier's, enterprise, or inter-provider scenario." ::= { mplsL3VpnIfConfEntry 2 } mplsL3VpnIfVpnRouteDistProtocol OBJECT-TYPE SYNTAX BITS { none (0), bgp (1), ospf (2), rip(3), isis(4), static(5), other (6) } MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes the route distribution protocol across the PE-CE link. Note that more than one routing protocol may be enabled at the same time, thus this object is specified as a bitmask. For example, static(5) and ospf(2) are a typical configuration." ::= { mplsL3VpnIfConfEntry 3 } mplsL3VpnIfConfStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this entry." REFERENCE "See RFC2579." DEFVAL { volatile } ::= { mplsL3VpnIfConfEntry 4 } mplsL3VpnIfConfRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This variable is used to create, modify, and/or delete a row in this table. Rows in this table signify that the specified interface is associated with this VRF. If the row creation operation succeeds, the interface will have been IETF L3 Working Group Expires November 2004 [Page 10] Internet Draft MPLS L3 VPN MIB May 14, 2004 associated with the specified VRF, otherwise the agent MUST not allow the association. If the agent only allows read-only operations on this table, it MUST create entries in this table as they are created on the device. When a row in this table is in active(1) state, no objects in that row can be modified by the agent except mplsL3VpnIfConfStorageType and mplsL3VpnIfConfRowStatus." ::= { mplsL3VpnIfConfEntry 5 } -- VRF Configuration Table mplsL3VpnVrfTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnVrfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per-interface MPLS L3VPN VRF Table capability and associated information. Entries in this table define VRF routing instances associated with MPLS/VPN interfaces. Note that multiple interfaces can belong to the same VRF instance. The collection of all VRF instances comprises an actual VPN." ::= { mplsL3VpnConf 2 } mplsL3VpnVrfEntry OBJECT-TYPE SYNTAX MplsL3VpnVrfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by an LSR for every VRF capable of supporting MPLS L3VPN. The indexing provides an ordering of VRFs per-VPN interface." INDEX { mplsL3VpnVrfName } ::= { mplsL3VpnVrfTable 1 } MplsL3VpnVrfEntry ::= SEQUENCE { mplsL3VpnVrfName MplsL3VpnName, mplsL3VpnVrfVpnId VPNId, mplsL3VpnVrfDescription SnmpAdminString, mplsL3VpnVrfRD MplsL3VpnRouteDistinguisher, mplsL3VpnVrfCreationTime TimeStamp, mplsL3VpnVrfOperStatus INTEGER, mplsL3VpnVrfActiveInterfaces Unsigned32, mplsL3VpnVrfAssociatedInterfaces Unsigned32, mplsL3VpnVrfConfMidRteThres Unsigned32, mplsL3VpnVrfConfHighRteThresh Unsigned32, mplsL3VpnVrfConfMaxRoutes Unsigned32, mplsL3VpnVrfConfLastChanged TimeStamp, mplsL3VpnVrfConfRowStatus RowStatus, IETF L3 Working Group Expires November 2004 [Page 11] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfConfStorageType StorageType } mplsL3VpnVrfName OBJECT-TYPE SYNTAX MplsL3VpnName MAX-ACCESS not-accessible STATUS current DESCRIPTION "The human-readable name of this VPN. This MAY be equivalent to the RFC2685 VPN-ID, but may also vary. If it is set to the VPN ID, it MUST be equivalent to the value of mplsL3VpnVrfVpnId. It is strongly recommended that all sites supporting VRFs that are part of the same VPN use the same naming convention for VRFs as well as the same VPN ID." REFERENCE "RFC 2685 Fox B., et al, `Virtual Private Networks Identifier`, September 1999." ::= { mplsL3VpnVrfEntry 1 } mplsL3VpnVrfVpnId OBJECT-TYPE SYNTAX VPNId MAX-ACCESS read-create STATUS current DESCRIPTION "The VPN ID as specified in RFC 2685. If a VPN ID has not been specified for this VRF, then this variable SHOULD be set to an empty string." ::= { mplsL3VpnVrfEntry 2 } mplsL3VpnVrfDescription OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The human-readable description of this VRF." ::= { mplsL3VpnVrfEntry 3 } mplsL3VpnVrfRD OBJECT-TYPE SYNTAX MplsL3VpnRouteDistinguisher MAX-ACCESS read-create STATUS current DESCRIPTION "The route distinguisher for this VRF." ::= { mplsL3VpnVrfEntry 4 } mplsL3VpnVrfCreationTime OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only IETF L3 Working Group Expires November 2004 [Page 12] Internet Draft MPLS L3 VPN MIB May 14, 2004 STATUS current DESCRIPTION "The time at which this VRF entry was created." ::= { mplsL3VpnVrfEntry 5 } mplsL3VpnVrfOperStatus OBJECT-TYPE SYNTAX INTEGER { up (1), down (2) } MAX-ACCESS read-only STATUS current DESCRIPTION "Denotes whether a VRF is operational or not. A VRF is up(1) when at least one interface associated with the VRF, which ifOperStatus is up(1). A VRF is down(2) when: a. There does not exist at least one interface whose ifOperStatus is up(1). b. There are no interfaces associated with the VRF." ::= { mplsL3VpnVrfEntry 6 } mplsL3VpnVrfActiveInterfaces OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Total number of interfaces connected to this VRF with ifOperStatus = up(1). This counter should be incremented when: a. When the ifOperStatus of one of the connected interfaces changes from down(2) to up(1). b. When an interface with ifOperStatus = up(1) is connected to this VRF. This counter should be decremented when: a. When the ifOperStatus of one of the connected interfaces changes from up(1) to down(2). b. When one of the connected interfaces with ifOperStatus = up(1) gets disconnected from this VRF." ::= { mplsL3VpnVrfEntry 7 } mplsL3VpnVrfAssociatedInterfaces OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Total number of interfaces connected to this VRF (independent of ifOperStatus type)." ::= { mplsL3VpnVrfEntry 8 } mplsL3VpnVrfConfMidRteThres OBJECT-TYPE IETF L3 Working Group Expires November 2004 [Page 13] Internet Draft MPLS L3 VPN MIB May 14, 2004 SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes mid-level water marker for the number of routes which this VRF may hold." DEFVAL { 0 } ::= { mplsL3VpnVrfEntry 9 } mplsL3VpnVrfConfHighRteThresh OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes high-level water marker for the number of routes which this VRF may hold." DEFVAL { 0 } ::= { mplsL3VpnVrfEntry 10 } mplsL3VpnVrfConfMaxRoutes OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Denotes maximum number of routes which this VRF is configured to hold. This value MUST be less than or equal to mplsL3VpnVrfConfMaxPossRts unless it is set to 0." DEFVAL { 0 } ::= { mplsL3VpnVrfEntry 11 } mplsL3VpnVrfConfLastChanged OBJECT-TYPE SYNTAX TimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The value of sysUpTime at the time of the last change of this table entry, which includes changes of VRF parameters defined in this table or addition or deletion of interfaces associated with this VRF." ::= { mplsL3VpnVrfEntry 12 } mplsL3VpnVrfConfRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This variable is used to create, modify, and/or delete a row in this table." ::= { mplsL3VpnVrfEntry 13 } IETF L3 Working Group Expires November 2004 [Page 14] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfConfStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "The storage type for this entry." REFERENCE "See RFC2579." DEFVAL { volatile } ::= { mplsL3VpnVrfEntry 14 } -- MplsL3VpnVrfRTTable mplsL3VpnVrfRTTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnVrfRTEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per-VRF route target association. Each entry identifies a connectivity policy supported as part of a VPN." ::= { mplsL3VpnConf 3 } mplsL3VpnVrfRTEntry OBJECT-TYPE SYNTAX MplsL3VpnVrfRTEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " An entry in this table is created by an LSR for each route target configured for a VRF supporting a MPLS L3VPN instance. The indexing provides an ordering per-VRF instance." INDEX { mplsL3VpnVrfName, mplsL3VpnVrfRTIndex, mplsL3VpnVrfRTType } ::= { mplsL3VpnVrfRTTable 1 } MplsL3VpnVrfRTEntry ::= SEQUENCE { mplsL3VpnVrfRTIndex Unsigned32, mplsL3VpnVrfRTType INTEGER, mplsL3VpnVrfRT MplsL3VpnRouteDistinguisher, mplsL3VpnVrfRTDescr SnmpAdminString, mplsL3VpnVrfRTRowStatus RowStatus } mplsL3VpnVrfRTIndex OBJECT-TYPE SYNTAX Unsigned32 (1..4294967295) MAX-ACCESS not-accessible STATUS current DESCRIPTION IETF L3 Working Group Expires November 2004 [Page 15] Internet Draft MPLS L3 VPN MIB May 14, 2004 "Auxiliary index for route-targets configured for a particular VRF." ::= { mplsL3VpnVrfRTEntry 2 } mplsL3VpnVrfRTType OBJECT-TYPE SYNTAX INTEGER { import(1), export(2), both(3) } MAX-ACCESS not-accessible STATUS current DESCRIPTION "The route target export distribution type." ::= { mplsL3VpnVrfRTEntry 3 } mplsL3VpnVrfRT OBJECT-TYPE SYNTAX MplsL3VpnRouteDistinguisher MAX-ACCESS read-create STATUS current DESCRIPTION "The route target distribution policy." ::= { mplsL3VpnVrfRTEntry 4 } mplsL3VpnVrfRTDescr OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "Description of the route target." ::= { mplsL3VpnVrfRTEntry 5 } mplsL3VpnVrfRTRowStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "This variable is used to create, modify, and/or delete a row in this table. When a row in this table is in active(1) state, no objects in that row can be modified by the agent except mplsL3VpnVrfRTRowStatus." ::= { mplsL3VpnVrfRTEntry 6 } -- VRF Security Table mplsL3VpnVrfSecTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnVrfSecEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per MPLS L3VPN VRF Table security features." IETF L3 Working Group Expires November 2004 [Page 16] Internet Draft MPLS L3 VPN MIB May 14, 2004 ::= { mplsL3VpnConf 6 } mplsL3VpnVrfSecEntry OBJECT-TYPE SYNTAX MplsL3VpnVrfSecEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by an LSR for every VRF capable of supporting MPLS L3VPN. Each entry in this table is used to indicate security-related information for each VRF entry." AUGMENTS { mplsL3VpnVrfEntry } ::= { mplsL3VpnVrfSecTable 1 } MplsL3VpnVrfSecEntry ::= SEQUENCE { mplsL3VpnVrfSecIllegalLblVltns Counter32, mplsL3VpnVrfSecIllLblRcvThrsh Unsigned32 } mplsL3VpnVrfSecIllegalLblVltns OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the number of illegally received labels on this VPN/VRF." ::= { mplsL3VpnVrfSecEntry 1 } mplsL3VpnVrfSecIllLblRcvThrsh OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "The number of illegally received labels above which this notification is issued." ::= { mplsL3VpnVrfSecEntry 2 } -- VRF Performance Table mplsL3VpnVrfPerfTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnVrfPerfEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per MPLS L3VPN VRF Table performance information." ::= { mplsL3VpnPerf 1 } mplsL3VpnVrfPerfEntry OBJECT-TYPE SYNTAX MplsL3VpnVrfPerfEntry MAX-ACCESS not-accessible IETF L3 Working Group Expires November 2004 [Page 17] Internet Draft MPLS L3 VPN MIB May 14, 2004 STATUS current DESCRIPTION "An entry in this table is created by an LSR for every VRF capable of supporting MPLS L3VPN." AUGMENTS { mplsL3VpnVrfEntry } ::= { mplsL3VpnVrfPerfTable 1 } MplsL3VpnVrfPerfEntry ::= SEQUENCE { mplsL3VpnVrfPerfRoutesAdded Counter32, mplsL3VpnVrfPerfRoutesDeleted Counter32, mplsL3VpnVrfPerfCurrNumRoutes Unsigned32 } mplsL3VpnVrfPerfRoutesAdded OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the number of routes added to this VPN/VRF since this device has last been reset or the VRF was created, whichever came last." ::= { mplsL3VpnVrfPerfEntry 1 } mplsL3VpnVrfPerfRoutesDeleted OBJECT-TYPE SYNTAX Counter32 MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the number of routes removed from this VPN/VRF." ::= { mplsL3VpnVrfPerfEntry 2 } mplsL3VpnVrfPerfCurrNumRoutes OBJECT-TYPE SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the number of routes currently used by this VRF." ::= { mplsL3VpnVrfPerfEntry 3 } -- VRF Routing Table mplsL3VpnVrfRteTable OBJECT-TYPE SYNTAX SEQUENCE OF MplsL3VpnVrfRteEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table specifies per-interface MPLS L3VPN VRF Table routing information. Entries in this table define VRF routing entries associated with the specified MPLS/VPN interfaces. Note IETF L3 Working Group Expires November 2004 [Page 18] Internet Draft MPLS L3 VPN MIB May 14, 2004 that this table contains both BGP and IGP routes, as both may appear in the same VRF." REFERENCE "1. RFC 1213 Section 6.6, The IP Group. 2. RFC 2096 " ::= { mplsL3VpnRoute 1 } mplsL3VpnVrfRteEntry OBJECT-TYPE SYNTAX MplsL3VpnVrfRteEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry in this table is created by an LSR for every route present configured (either dynamically or statically) within the context of a specific VRF capable of supporting MPLS/BGP VPN. The indexing provides an ordering of VRFs per-VPN interface. Implementors need to be aware that if the value of the mplsL3VpnVrfName (an OID) has more that 111 sub-identifiers, then OIDs of column instances in this table will have more than 128 sub-identifiers and cannot be accessed using SNMPv1, SNMPv2c, or SNMPv3." INDEX { mplsL3VpnVrfName, mplsL3VpnVrfRteInetCidrDestType, mplsL3VpnVrfRteInetCidrDest, mplsL3VpnVrfRteInetCidrPfxLen, mplsL3VpnVrfRteInetCidrPolicy, mplsL3VpnVrfRteInetCidrNHopType, mplsL3VpnVrfRteInetCidrNextHop } ::= { mplsL3VpnVrfRteTable 1 } MplsL3VpnVrfRteEntry ::= SEQUENCE { mplsL3VpnVrfRteInetCidrDestType InetAddressType, mplsL3VpnVrfRteInetCidrDest InetAddress, mplsL3VpnVrfRteInetCidrPfxLen InetAddressPrefixLength, mplsL3VpnVrfRteInetCidrPolicy OBJECT IDENTIFIER, mplsL3VpnVrfRteInetCidrNHopType InetAddressType, mplsL3VpnVrfRteInetCidrNextHop InetAddress, mplsL3VpnVrfRteInetCidrIfIndex InterfaceIndex, mplsL3VpnVrfRteInetCidrType INTEGER, mplsL3VpnVrfRteInetCidrProto IANAipRouteProtocol, mplsL3VpnVrfRteInetCidrAge Gauge32, mplsL3VpnVrfRteInetCidrNextHopAS InetAutonomousSystemNumber, mplsL3VpnVrfRteInetCidrMetric1 Integer32, mplsL3VpnVrfRteInetCidrMetric2 Integer32, mplsL3VpnVrfRteInetCidrMetric3 Integer32, mplsL3VpnVrfRteInetCidrMetric4 Integer32, IETF L3 Working Group Expires November 2004 [Page 19] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfRteInetCidrMetric5 Integer32, mplsL3VpnVrfRteXCPointer MplsIndexType, mplsL3VpnVrfRteInetCidrStatus RowStatus } mplsL3VpnVrfRteInetCidrDestType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of the mplsL3VpnVrfRteInetCidrDest address, as defined in the InetAddress MIB. Only those address types that may appear in an actual routing table are allowed as values of this object." REFERENCE "RFC 3291" ::= { mplsL3VpnVrfRteEntry 1 } mplsL3VpnVrfRteInetCidrDest OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "The destination IP address of this route. The type of this address is determined by the value of the mplsL3VpnVrfRteInetCidrDestType object. The values for the index objects mplsL3VpnVrfRteInetCidrDest and mplsL3VpnVrfRteInetCidrPfxLen must be consistent. When the value of mplsL3VpnVrfRteInetCidrDest is x, then the bitwise logical-AND of x with the value of the mask formed from the corresponding index object mplsL3VpnVrfRteInetCidrPfxLen MUST be equal to x. If not, then the index pair is not consistent and an inconsistentName error must be returned on SET or CREATE requests." ::= { mplsL3VpnVrfRteEntry 2 } mplsL3VpnVrfRteInetCidrPfxLen OBJECT-TYPE SYNTAX InetAddressPrefixLength (0..128) MAX-ACCESS not-accessible STATUS current DESCRIPTION "Indicates the number of leading one bits which form the mask to be logical-ANDed with the destination address before being compared to the value in the mplsL3VpnVrfRteInetCidrDest field. IETF L3 Working Group Expires November 2004 [Page 20] Internet Draft MPLS L3 VPN MIB May 14, 2004 The values for the index objects mplsL3VpnVrfRteInetCidrDest and mplsL3VpnVrfRteInetCidrPfxLen must be consistent. When the value of mplsL3VpnVrfRteInetCidrDest is x, then the bitwise logical-AND of x with the value of the mask formed from the corresponding index object mplsL3VpnVrfRteInetCidrPfxLen MUST be equal to x. If not, then the index pair is not consistent and an inconsistentName error must be returned on SET or CREATE requests." ::= { mplsL3VpnVrfRteEntry 3 } mplsL3VpnVrfRteInetCidrPolicy OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS not-accessible STATUS current DESCRIPTION "This object is an opaque object without any defined semantics. Its purpose is to serve as an additional index which may delineate between multiple entries to the same destination. The value { 0 0 } shall be used as the default value for this object." ::= { mplsL3VpnVrfRteEntry 4 } mplsL3VpnVrfRteInetCidrNHopType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS not-accessible STATUS current DESCRIPTION "The type of the mplsL3VpnVrfRteInetCidrNextHop address, as defined in the InetAddress MIB. Value should be set to unknown(0) for non-remote routes. Only those address types that may appear in an actual routing table are allowed as values of this object." REFERENCE "RFC 3291" ::= { mplsL3VpnVrfRteEntry 5 } mplsL3VpnVrfRteInetCidrNextHop OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS not-accessible STATUS current DESCRIPTION "On remote routes, the address of the next system en route. For non-remote routes, a zero length string. The type of this address is determined by the value of the mplsL3VpnVrfRteInetCidrNHopType object." ::= { mplsL3VpnVrfRteEntry 6 } IETF L3 Working Group Expires November 2004 [Page 21] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfRteInetCidrIfIndex OBJECT-TYPE SYNTAX InterfaceIndex MAX-ACCESS read-create STATUS current DESCRIPTION "The ifIndex value which identifies the local interface through which the next hop of this route should be reached. A value of 0 is valid and represents the scenario where no interface is specified." ::= { mplsL3VpnVrfRteEntry 7 } mplsL3VpnVrfRteInetCidrType OBJECT-TYPE SYNTAX INTEGER { other (1), -- not specified by this MIB reject (2), -- route which discards traffic and -- returns ICMP notification local (3), -- local interface remote (4), -- remote destination blackhole(5) -- route which discards traffic -- silently } MAX-ACCESS read-create STATUS current DESCRIPTION "The type of route. Note that local(3) refers to a route for which the next hop is the final destination; remote(4)refers to a route for which the next hop is not the final destination. Routes which do not result in traffic forwarding or rejection should not be displayed even if the implementation keeps them stored internally. reject(2) refers to a route which, if matched, discards the message as unreachable and returns a notification (e.g. ICMP error) to the message sender. This is used in some protocols as a means of correctly aggregating routes. blackhole(5) refers to a route which, if matched, discards the message silently." ::= { mplsL3VpnVrfRteEntry 8 } mplsL3VpnVrfRteInetCidrProto OBJECT-TYPE SYNTAX IANAipRouteProtocol MAX-ACCESS read-only STATUS current DESCRIPTION IETF L3 Working Group Expires November 2004 [Page 22] Internet Draft MPLS L3 VPN MIB May 14, 2004 "The routing mechanism via which this route was learned. Inclusion of values for gateway routing protocols is not intended to imply that hosts should support those protocols." ::= { mplsL3VpnVrfRteEntry 9 } mplsL3VpnVrfRteInetCidrAge OBJECT-TYPE SYNTAX Gauge32 MAX-ACCESS read-only STATUS current DESCRIPTION "The number of seconds since this route was last updated or otherwise determined to be correct. Note that no semantics of 'too old' can be implied except through knowledge of the routing protocol by which the route was learned." ::= { mplsL3VpnVrfRteEntry 10 } mplsL3VpnVrfRteInetCidrNextHopAS OBJECT-TYPE SYNTAX InetAutonomousSystemNumber MAX-ACCESS read-create STATUS current DESCRIPTION "The Autonomous System Number of the Next Hop. The semantics of this object are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. When this object is unknown or not relevant its value should be set to zero." DEFVAL { 0 } ::= { mplsL3VpnVrfRteEntry 11 } mplsL3VpnVrfRteInetCidrMetric1 OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "The primary routing metric for this route. The semantics of this metric are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. If this metric is not used, its value should be set to -1." DEFVAL { -1 } ::= { mplsL3VpnVrfRteEntry 12 } mplsL3VpnVrfRteInetCidrMetric2 OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current IETF L3 Working Group Expires November 2004 [Page 23] Internet Draft MPLS L3 VPN MIB May 14, 2004 DESCRIPTION "An alternate routing metric for this route. The semantics of this metric are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. If this metric is not used, its value should be set to -1." DEFVAL { -1 } ::= { mplsL3VpnVrfRteEntry 13 } mplsL3VpnVrfRteInetCidrMetric3 OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "An alternate routing metric for this route. The semantics of this metric are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. If this metric is not used, its value should be set to -1." DEFVAL { -1 } ::= { mplsL3VpnVrfRteEntry 14 } mplsL3VpnVrfRteInetCidrMetric4 OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "An alternate routing metric for this route. The semantics of this metric are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. If this metric is not used, its value should be set to -1." DEFVAL { -1 } ::= { mplsL3VpnVrfRteEntry 15 } mplsL3VpnVrfRteInetCidrMetric5 OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "An alternate routing metric for this route. The semantics of this metric are determined by the routing- protocol specified in the route's mplsL3VpnVrfRteInetCidrProto value. If this metric is not used, its value should be set to -1." DEFVAL { -1 } ::= { mplsL3VpnVrfRteEntry 16 } IETF L3 Working Group Expires November 2004 [Page 24] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsL3VpnVrfRteXCPointer OBJECT-TYPE SYNTAX MplsIndexType MAX-ACCESS read-create STATUS current DESCRIPTION "Index into mplsXCTable which identifies which cross- connect entry is associated with this VRF route entry by containing the mplsXCIndex of that cross-connect entry. The string containing the single octet 0x00 indicates that a label stack is not associated with this route entry. This can be the case because the label bindings have not yet been established, or because some change in the agent has removed them. When the label stack associated with this VRF route is created by the agent, it MUST establish the associated cross-connect entry in the mplsXCTable and then set that index to the value of this object. Changes to the cross-connect object in the mplsXCTable MUST automatically be be reflected the value of this object. If this object represents a static routing entry, then the manager must ensure that this entry is also maintained consistently in the corresponding mplsXCTable as well." ::= { mplsL3VpnVrfRteEntry 17 } mplsL3VpnVrfRteInetCidrStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The row status variable, used according to row installation and removal conventions. A row entry cannot be modified when the status is marked as active(1)." ::= { mplsL3VpnVrfRteEntry 18 } -- MPLS L3VPN Notifications mplsVrfIfUp NOTIFICATION-TYPE OBJECTS { mplsL3VpnIfConfRowStatus, mplsL3VpnVrfOperStatus } STATUS current DESCRIPTION "This notification is generated when: a. The ifOperStatus of an interface associated with a VRF changes to the up(1) state. b. When an interface with ifOperStatus = up(1) is associated with a VRF." ::= { mplsL3VpnNotifications 1 } IETF L3 Working Group Expires November 2004 [Page 25] Internet Draft MPLS L3 VPN MIB May 14, 2004 mplsVrfIfDown NOTIFICATION-TYPE OBJECTS { mplsL3VpnIfConfRowStatus, mplsL3VpnVrfOperStatus } STATUS current DESCRIPTION "This notification is generated when: a. The ifOperStatus of an interface associated with a VRF changes to the down(1) state. b. When an interface with ifOperStatus = up(1) state is disassociated with a VRF." ::= { mplsL3VpnNotifications 2 } mplsNumVrfRouteMidThreshExceeded NOTIFICATION-TYPE OBJECTS { mplsL3VpnVrfPerfCurrNumRoutes, mplsL3VpnVrfConfMidRteThres } STATUS current DESCRIPTION "This notification is generated when the number of routes contained by the specified VRF exceeds the value indicated by mplsL3VpnVrfMidRouteThreshold. A single notification MUST be generated when this threshold is exceeded, and no other notifications of this type should be issued until the value of mplsL3VpnVrfPerfCurrNumRoutes has fallen below that of mplsL3VpnVrfConfMidRteThres." ::= { mplsL3VpnNotifications 3 } mplsNumVrfRouteMaxThreshExceeded NOTIFICATION-TYPE OBJECTS { mplsL3VpnVrfPerfCurrNumRoutes, mplsL3VpnVrfConfHighRteThresh } STATUS current DESCRIPTION "This notification is generated when the number of routes contained by the specified VRF exceeds or attempts to exceed the maximum allowed value as indicated by mplsL3VpnVrfMaxRouteThreshold. In cases where mplsL3VpnVrfConfHighRteThresh is set to the same value as mplsL3VpnVrfConfMaxRoutes, mplsL3VpnVrfConfHighRteThresh need not be exceeded; rather, just reached for this notification to be issued. Note that mplsL3VpnVrfConfRteMxThrshTime denotes the interval at which the this notification will be re-issued after the maximum value has been exceeded (or reached if mplsL3VpnVrfConfMaxRoutes and mplsL3VpnVrfConfHighRteThresh are equal) and the initial notification has been issued. This value is intended to prevent continuous generation of notifications by an agent in the event that routes are continually added to a VRF IETF L3 Working Group Expires November 2004 [Page 26] Internet Draft MPLS L3 VPN MIB May 14, 2004 after it has reached its maximum value. The default value is 0 minutes. If this value is set to 0, the agent should only issue a single notification at the time that the maximum threshold has been reached, and should not issue any more notifications until the value of routes has fallen below the configured threshold value." ::= { mplsL3VpnNotifications 4 } mplsNumVrfSecIllglLblThrshExcd NOTIFICATION-TYPE OBJECTS { mplsL3VpnVrfSecIllegalLblVltns } STATUS current DESCRIPTION "This notification is generated when the number of illegal label violations on a VRF as indicated by mplsL3VpnVrfSecIllegalLblVltns has exceeded mplsL3VpnVrfSecIllLblRcvThrsh. The threshold is not included in the varbind here because the value of mplsL3VpnVrfSecIllegalLblVltns should be one greater than the threshold at the time this notification is issued." ::= { mplsL3VpnNotifications 5 } mplsNumVrfRouteMaxThreshCleared NOTIFICATION-TYPE OBJECTS { mplsL3VpnVrfPerfCurrNumRoutes, mplsL3VpnVrfConfHighRteThresh } STATUS current DESCRIPTION "This notification is generated only after the number of routes contained by the specified VRF exceeds or attempts to exceed the maximum allowed value as indicated by mplsVrfMaxRouteThreshold, and then falls below this value. The emission of this notification informs the operator that the error condition has been cleared without the operator having to query the device. Note that mplsL3VpnVrfConfRteMxThrshTime denotes the interval at which the the mplsNumVrfRouteMaxThreshExceeded notification will be re-issued after the maximum value has been exceeded (or reached if mplsL3VpnVrfConfMaxRoutes and mplsL3VpnVrfConfHighRteThresh are equal) and the initial notification has been issued. Therefore, the generation of this notification should also be emitted with this same frequency (assuming that the error condition is cleared). Specifically, if the error condition is reached and cleared several times during the period of time specified in mplsL3VpnVrfConfRteMxThrshTime, only a single notification will be issued to indicate the first instance of the error condition as well as the first time the error condition is cleared. This behavior is intended to prevent continuous generation of notifications by an agent in the event that routes are continually added and removed to/from a VRF after it has reached its maximum IETF L3 Working Group Expires November 2004 [Page 27] Internet Draft MPLS L3 VPN MIB May 14, 2004 value. The default value is 0. If this value is set to 0, the agent should issue a notification whenever the maximum threshold has been cleared." ::= { mplsL3VpnNotifications 6 } -- Conformance Statement mplsL3VpnGroups OBJECT IDENTIFIER ::= { mplsL3VpnConformance 1 } mplsL3VpnCompliances OBJECT IDENTIFIER ::= { mplsL3VpnConformance 2 } -- Module Compliance mplsL3VpnModuleCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "Compliance statement for agents that support the MPLS VPN MIB." MODULE -- this module -- The mandatory groups have to be implemented -- by all LSRs supporting MPLS L3VPNs. However, -- they may all be supported -- as read-only objects in the case where manual -- configuration is unsupported. MANDATORY-GROUPS { mplsL3VpnScalarGroup, mplsL3VpnVrfGroup, mplsL3VpnIfGroup, mplsL3VpnPerfGroup, mplsL3VpnVrfRteGroup, mplsL3VpnVrfRTGroup, mplsL3VpnSecGroup, mplsL3VpnNotificationGroup } ::= { mplsL3VpnCompliances 1 } -- Units of conformance. mplsL3VpnScalarGroup OBJECT-GROUP OBJECTS { mplsL3VpnConfiguredVrfs, mplsL3VpnActiveVrfs, mplsL3VpnConnectedInterfaces, mplsL3VpnNotificationEnable, mplsL3VpnVrfConfMaxPossRts, mplsL3VpnVrfConfRteMxThrshTime } STATUS current DESCRIPTION "Collection of scalar objects required for MPLS VPN management." ::= { mplsL3VpnGroups 1 } mplsL3VpnVrfGroup OBJECT-GROUP IETF L3 Working Group Expires November 2004 [Page 28] Internet Draft MPLS L3 VPN MIB May 14, 2004 OBJECTS { mplsL3VpnVrfVpnId, mplsL3VpnVrfDescription, mplsL3VpnVrfRD, mplsL3VpnVrfCreationTime, mplsL3VpnVrfOperStatus, mplsL3VpnVrfActiveInterfaces, mplsL3VpnVrfAssociatedInterfaces, mplsL3VpnVrfConfMidRteThres, mplsL3VpnVrfConfHighRteThresh, mplsL3VpnVrfConfMaxRoutes, mplsL3VpnVrfConfLastChanged, mplsL3VpnVrfConfRowStatus, mplsL3VpnVrfConfStorageType } STATUS current DESCRIPTION "Collection of objects needed for MPLS VPN VRF management." ::= { mplsL3VpnGroups 2 } mplsL3VpnIfGroup OBJECT-GROUP OBJECTS { mplsL3VpnIfVpnClassification, mplsL3VpnIfVpnRouteDistProtocol, mplsL3VpnIfConfStorageType, mplsL3VpnIfConfRowStatus } STATUS current DESCRIPTION "Collection of objects needed for MPLS VPN interface management." ::= { mplsL3VpnGroups 3 } mplsL3VpnPerfGroup OBJECT-GROUP OBJECTS { mplsL3VpnVrfPerfRoutesAdded, mplsL3VpnVrfPerfRoutesDeleted, mplsL3VpnVrfPerfCurrNumRoutes } STATUS current DESCRIPTION "Collection of objects needed for MPLS VPN performance information." ::= { mplsL3VpnGroups 4 } mplsL3VpnSecGroup OBJECT-GROUP OBJECTS { mplsL3VpnVrfSecIllegalLblVltns, mplsL3VpnVrfSecIllLblRcvThrsh } STATUS current DESCRIPTION "Collection of objects needed for MPLS VPN security-related information." IETF L3 Working Group Expires November 2004 [Page 29] Internet Draft MPLS L3 VPN MIB May 14, 2004 ::= { mplsL3VpnGroups 6 } mplsL3VpnVrfRteGroup OBJECT-GROUP OBJECTS { mplsL3VpnVrfRteInetCidrIfIndex, mplsL3VpnVrfRteInetCidrType, mplsL3VpnVrfRteInetCidrProto, mplsL3VpnVrfRteInetCidrAge, mplsL3VpnVrfRteInetCidrNextHopAS, mplsL3VpnVrfRteInetCidrMetric1, mplsL3VpnVrfRteInetCidrMetric2, mplsL3VpnVrfRteInetCidrMetric3, mplsL3VpnVrfRteInetCidrMetric4, mplsL3VpnVrfRteInetCidrMetric5, mplsL3VpnVrfRteXCPointer, mplsL3VpnVrfRteInetCidrStatus } STATUS current DESCRIPTION "Objects required for VRF route table management." ::= { mplsL3VpnGroups 7 } mplsL3VpnVrfRTGroup OBJECT-GROUP OBJECTS { mplsL3VpnVrfRTDescr, mplsL3VpnVrfRT, mplsL3VpnVrfRTRowStatus } STATUS current DESCRIPTION "Objects required for VRF route target management." ::= { mplsL3VpnGroups 8 } mplsL3VpnNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS { mplsVrfIfUp, mplsVrfIfDown, mplsNumVrfRouteMidThreshExceeded, mplsNumVrfRouteMaxThreshExceeded, mplsNumVrfSecIllglLblThrshExcd, mplsNumVrfRouteMaxThreshCleared } STATUS current DESCRIPTION "Objects required for MPLS VPN notifications." ::= { mplsL3VpnGroups 9 } -- End of MPLS-VPN-MIB END 9.0 Acknowledgments IETF L3 Working Group Expires November 2004 [Page 30] Internet Draft MPLS L3 VPN MIB May 14, 2004 This document has benefited from discussions and input from Bill Fenner, Gerald Ash, Sumit Mukhopadhyay, Mike Piecuch, and Joan Weiss. 10.0 Intellectual Property Considerations The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to per- tain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards- related documentation can be found in BCP-11. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights which may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. 14.0 References 14.1 Normative References [RFC2547bis] Rosen, E., Rekhter, Y., et al., "BGP/MPLS VPNs", Internet Draft , September 2003. [MPLSArch] Rosen, E., Viswanathan, A., and R. Callon, "Multiprotocol Label Switching Architecture", RFC3031, January 2001. [RFC2685] Fox B., et al, "Virtual Private Networks Identifier", RFC 2685, September 1999. [LSRMIB] Srinivasan, C., Viswanathan, A. and T. Nadeau, "MPLS Multiprotocol Label Switching (MPLS) Label Switch Router Management Information Base ", Internet Draft , November 2003. [TEMIB] Srinivasan, C., Viswanathan, A. and Nadeau, T., "MPLS Traffic Engineering Management Information Base ", Internet Draft , IETF L3 Working Group Expires November 2004 [Page 31] Internet Draft MPLS L3 VPN MIB May 14, 2004 November 2003. [RFC2096] Baker, F., "IP Forwarding Table MIB", RFC2096, January 1997. [VPNTCMIB] Schliesser, B., and Nadeau, T., "Definition of Textual Conventions for Provider Provisioned Virtual Private Network (PPVPN) Management.", Internet Draft , November 2002. [RFC3291] Daniele, M., Haberman, B., Routhier, S., Schoenwaelder, J., "Textual Conventions for Internet Network Addresses", RFC 3291, May 2002. -- RFC Ed : An update to RFC 3291 is in the works, in the case that -- draft-ietf-ops-rfc3291bis is published before or at the same -- time as this document, please update this reference and the two -- citations in the document. Afterwards, please remove this note. [RFC2863] McCloghrie, K., and Kastenholz, F., "The Interfaces Group MIB", RFC 2863, June 2000. [2011upd] Routhier, S., "Management Information Base for the Internet Protocol (IP), draft-ietf-ipv6-rfc2011-update-02.txt, February 2003. [RTPROTO] IANA, "IP Route Protocol MIB", http://www.iana.org/assignments/ianaiprouteprotocol-mib, September 2000. [RFC2578] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [RFC2579] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, 14.2 Informative References [RFC2026] S. Bradner, "The Internet Standards Process -- Revision 3", RFC 2026, October 1996. [RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart, "Introduction and Applicability Statements for Internet-Standard Management Framework", RFC 3410, December 2002. [RFC3413] Levi, D., Meyer, P., Stewart, B., "SNMP Applications", RFC 3413, December 2002. IETF L3 Working Group Expires November 2004 [Page 32] Internet Draft MPLS L3 VPN MIB May 14, 2004 12.0 Editors' Addresses Thomas D. Nadeau Cisco Systems, Inc. 300 Beaverbrook Drive Boxborough, MA Phone: +1-978-936-1470 Email: tnadeau@cisco.com Harmen van der Linde AT&T - Layer-2/Layer-3 NM Architecture and Operations Planning Room C2-3C34 200 Laurel Ave Middletown, NJ 07748 Tel: +1-732-420-1916 Email: hvdl@att.com 13.0 Contributors' Addresses Luyuan Fang Martin Tatham AT&T British Telecom 200 Laurel Ave BT Adastal Park, Middletown, NJ 07748 Martlesham Heath, Phone: +1-732-420-1921 Ipswich, IP5 3RE Email: luyuanfang@att.com UK Tel: +44 1473 606349 Fax: +44 1473 606727 Email: martin.tatham@bt.com Fabio M. Chiussi Joseph Dube Bell Laboratories, Avici Systems, Inc. Lucent Technologies 101 Billerica Avenue 101 Crawfords Corner Road North Billerica, MA 01862 Room 4D-521 Holmdel, NJ 07733 Phone: +1-732-949-2407 Email: fabio@bell-labs.com 14.0 Dedication Steve Brannon passed away suddenly on January 30, 2001. We would like to dedicate our efforts in this area and this document to his memory. 15.0 Full Copyright Statement Copyright (C) The Internet Society (2004). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise IETF L3 Working Group Expires November 2004 [Page 33] Internet Draft MPLS L3 VPN MIB May 14, 2004 explain it or assist in its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. 16.0 Security Considerations It is clear that these MIB modules are potentially useful for monitoring of MPLS LSRs supporting L3 MPLS VPN. This MIB module can also be used for configuration of certain objects, and anything that can be configured can be incorrectly configured, with potentially disastrous results. There are a number of management objects defined in this MIB module with a MAX-ACCESS clause of read-write and/or read-create. Such objects may be considered sensitive or vulnerable in some network environments. The support for SET operations in a non-secure environment without proper protection can have a negative effect on network operations. These are the tables and objects and their sensitivity/vulnerability: o the mplsL3VpnVrfRouteTable, mplsL3VpnIfConfTable and mplsL3VpnVrfTable tables collectively contain objects which may be used to provision MPLS VRF interfaces and configuration. Unauthorized access to objects in these tables, could result in disruption of traffic on the network. This is especially true if these VRFs have been previously provisioned and are in use. The use of stronger mechanisms such as SNMPv3 security should be considered where possible. Specifically, SNMPv3 VACM and USM MUST be used with any v3 agent which implements this MIB module. Administrators should consider whether read access to these objects should be allowed, IETF L3 Working Group Expires November 2004 [Page 34] Internet Draft MPLS L3 VPN MIB May 14, 2004 since read access may be undesirable under certain circumstances. Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability: o the mplsL3VpnVrfTable, mplsL3VpnIfConfTable tables collectively show the VRF interfaces and associated VRF configurations as well as their linkages to other MPLS-related configuration and/or performanc statistics. Administrators not wishing to reveal this information should consider these objects sensitive/vulnerable and take precautions so they are not revealed. SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), even then, there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module. It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410], section 8), including full support for the SNMPv3 cryptographic mechanisms (for authentication and privacy). Further, deployment of SNMP versions prior to SNMPv3 is NOT RECOMMENDED. Instead, it is RECOMMENDED to deploy SNMPv3 and to enable cryptographic security. It is then a customer/operator responsibility to ensure that the SNMP entity giving access to an instance of this MIB module, is properly configured to give access to the objects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 17. Intellectual Property Notice The IETF takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on the IETF's procedures with respect to rights in standards-track and standards-related documentation can be found in BCP-11 [RFC2028]. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an IETF L3 Working Group Expires November 2004 [Page 35] Internet Draft MPLS L3 VPN MIB May 14, 2004 attempt made to obtain a general license or permission for the use of such proprietary rights by implementors or users of this specification can be obtained from the IETF Secretariat. The IETF invites any interested party to bring to its attention any copyrights, patents or patent applications, or other proprietary rights that may cover technology that may be required to practice this standard. Please address the information to the IETF Executive Director. 18. IANA Considerations As described in [MPLSMGMT] and as requested in the MPLS-TC-STD-MIB [MPLSTCMIB], MPLS related standards track MIB modules should be rooted under the mplsStdMIB subtree. There is one MPLS-related MIB module contained in this document. Each of the following "IANA Considerations" subsections requests IANA for a new assignment under the mplsStdMIB subtree. New assignments can only be made via a Standards Action as specified in [RFC2434]. 18.1. IANA Considerations for MPLS-L3VPN-MIB The IANA is requested to assign { mplsStdMIB 11 } to the MPLS-L3VPN-MIB module specified in this document. IETF L3 Working Group Expires November 2004 [Page 36]