One document matched: draft-ietf-l3vpn-mpls-vpn-mib-02.txt
Differences from draft-ietf-l3vpn-mpls-vpn-mib-01.txt
IETF Internet Draft Thomas D. Nadeau
Expires: August 2004 Cisco Systems, Inc.
Document: draft-ietf-l3vpn-mpls-vpn-mib-02.txt Editor
Harmen Van Der Linde
AT&T
Editor
February 2004
MPLS/BGP Layer 3 Virtual Private Network Management
Information Base Using
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
IETF L3 Working Group Expires August 2004 [Page 1]
Internet Draft MPLS L3 VPN MIB February 03, 2004
5.0 Assumptions and Prerequisites.....................................3
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)
IETF L3 Working Group Expires August 2004 [Page 2]
Internet Draft MPLS L3 VPN MIB February 03, 2004
and Customer Edge (CE) or PE/CE" will be replaced by PE in all cases
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.
IETF L3 Working Group Expires August 2004 [Page 3]
Internet Draft MPLS L3 VPN MIB February 03, 2004
6.2 mplsL3VpnIfConfTable
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 August 2004 [Page 4]
Internet Draft MPLS L3 VPN MIB February 03, 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-MIB-DRAFT-02 DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Integer32, Counter32, Unsigned32,
mib-2, 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-MIB-DRAFT-01
SnmpAdminString
FROM SNMP-FRAMEWORK-MIB
IANAipRouteProtocol
FROM IANA-RTPROTO-MIB
InetAddress, InetAddressType,
InetAddressPrefixLength,
InetAutonomousSystemNumber
FROM INET-ADDRESS-MIB
MplsIndexType
FROM MPLS-LSR-STD-MIB
;
mplsL3VpnMIB MODULE-IDENTITY
LAST-UPDATED "200210311200Z" -- 31 October 2002 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 August 2004 [Page 5]
Internet Draft MPLS L3 VPN MIB February 03, 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
"200210311200Z" -- 31 October 2002 12:00:00 GMT
DESCRIPTION
"Initial version. Published as RFC xxxx." -- RFC-editor pls fill in xxxx
::= { mib-2 xxx } -- assigned by IANA
-- 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
Networks Identifier', September 1999."
IETF L3 Working Group Expires August 2004 [Page 6]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
MAX-ACCESS read-write
STATUS current
IETF L3 Working Group Expires August 2004 [Page 7]
Internet Draft MPLS L3 VPN MIB February 03, 2004
DESCRIPTION
"If this object is true, then it enables the
generation of all notifications defined in
this MIB."
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
mplsL3VpnIfConfTable OBJECT-TYPE
SYNTAX SEQUENCE OF MplsL3VpnIfConfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table specifies per-interface MPLS capability
IETF L3 Working Group Expires August 2004 [Page 8]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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),
interProvider (3)
}
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Denotes whether this link participates in a
IETF L3 Working Group Expires August 2004 [Page 9]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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."
::= { 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
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
."
IETF L3 Working Group Expires August 2004 [Page 10]
Internet Draft MPLS L3 VPN MIB February 03, 2004
::= { 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,
mplsL3VpnVrfConfStorageType StorageType
}
mplsL3VpnVrfName OBJECT-TYPE
SYNTAX MplsL3VpnName
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
IETF L3 Working Group Expires August 2004 [Page 11]
Internet Draft MPLS L3 VPN MIB February 03, 2004
"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
STATUS current
DESCRIPTION
"The time at which this VRF entry was created."
::= { mplsL3VpnVrfEntry 5 }
mplsL3VpnVrfOperStatus OBJECT-TYPE
SYNTAX INTEGER { up (1),
down (2)
IETF L3 Working Group Expires August 2004 [Page 12]
Internet Draft MPLS L3 VPN MIB February 03, 2004
}
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
SYNTAX Unsigned32
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"Denotes mid-level water marker for the number
of routes which this VRF may hold."
::= { mplsL3VpnVrfEntry 9 }
IETF L3 Working Group Expires August 2004 [Page 13]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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."
::= { 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 mplsVrfMaxPossibleRoutes unless it is set
to 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 }
mplsL3VpnVrfConfStorageType OBJECT-TYPE
SYNTAX StorageType
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"The storage type for this entry."
::= { mplsL3VpnVrfEntry 14 }
-- MplsL3VpnVrfRTTable
IETF L3 Working Group Expires August 2004 [Page 14]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
"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
IETF L3 Working Group Expires August 2004 [Page 15]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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."
::= { 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 }
IETF L3 Working Group Expires August 2004 [Page 16]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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
IETF L3 Working Group Expires August 2004 [Page 17]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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
IETF L3 Working Group Expires August 2004 [Page 18]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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,
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
IETF L3 Working Group Expires August 2004 [Page 19]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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.
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
IETF L3 Working Group Expires August 2004 [Page 20]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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 }
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
IETF L3 Working Group Expires August 2004 [Page 21]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
"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 }
IETF L3 Working Group Expires August 2004 [Page 22]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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-
IETF L3 Working Group Expires August 2004 [Page 23]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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 }
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
IETF L3 Working Group Expires August 2004 [Page 24]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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 }
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
IETF L3 Working Group Expires August 2004 [Page 25]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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
IETF L3 Working Group Expires August 2004 [Page 26]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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
IETF L3 Working Group Expires August 2004 [Page 27]
Internet Draft MPLS L3 VPN MIB February 03, 2004
"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
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
IETF L3 Working Group Expires August 2004 [Page 28]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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."
::= { mplsL3VpnGroups 6 }
mplsL3VpnVrfRteGroup OBJECT-GROUP
OBJECTS {
mplsL3VpnVrfRteInetCidrIfIndex,
mplsL3VpnVrfRteInetCidrType,
mplsL3VpnVrfRteInetCidrProto,
mplsL3VpnVrfRteInetCidrAge,
mplsL3VpnVrfRteInetCidrNextHopAS,
mplsL3VpnVrfRteInetCidrMetric1,
mplsL3VpnVrfRteInetCidrMetric2,
mplsL3VpnVrfRteInetCidrMetric3,
mplsL3VpnVrfRteInetCidrMetric4,
mplsL3VpnVrfRteInetCidrMetric5,
mplsL3VpnVrfRteXCPointer,
mplsL3VpnVrfRteInetCidrStatus
}
STATUS current
DESCRIPTION
IETF L3 Working Group Expires August 2004 [Page 29]
Internet Draft MPLS L3 VPN MIB February 03, 2004
"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
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
IETF L3 Working Group Expires August 2004 [Page 30]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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., Bogovic, T., Brannon, S.,
Carugi, M., Chase, C., Chung, T., De Clercq, J.,
Dean, E., Hitchin, P., Leelanivas, M., Marshall, D.,
Martini, L., Srinivasan, V., Vedrenne, A., "BGP/MPLS
VPNs", Internet Draft <draft-rosen-rfc2547bis-
03.txt>, February 2001.
[MPLSArch] Rosen, E., Viswanathan, A., and R. Callon,
"Multiprotocol Label Switching Architecture",
RFC3031, January 2001.
[VPN-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 <draft-
ietf-mpls-lsr-mib-14.txt>, November 2003.
[TEMIB] Srinivasan, C., Viswanathan, A. and Nadeau, T., "MPLS
Traffic Engineering Management Information Base ",
Internet Draft <draft-ietf-mpls-te-mib-14.txt>,
November 2003.
[RFC2096] Baker, F., "IP Forwarding Table MIB", RFC2096,
January 1997.
[IANAFamily] Internet Assigned Numbers Authority (IANA), ADDRESS
FAMILY NUMBERS, (http://www.isi.edu/in-
notes/iana/assignements/address-family-numbers),
for MIB see:
ftp://ftp.isi.edu/mib/iana.mib/ianaaddressfamilynum
bers.mib
[VPNTCMIB] Schliesser, B., and Nadeau, T., "Definition of
Textual Conventions for Provider Provisioned
Virtual Private Network (PPVPN) Management.",
Internet Draft <draft-ietf-l3vpn-tc-mib-00.txt>,
November 2002.
IETF L3 Working Group Expires August 2004 [Page 31]
Internet Draft MPLS L3 VPN MIB February 03, 2004
[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.
14.2 Informative References
[RFC2026] S. Bradner, "The Internet Standards Process --
Revision 3", RFC 2026, October 1996.
[RFC3413] Levi, D., Meyer, P., Stewart, B.,
"SNMP Applications", RFC 3413, December 2002.
[RFC3410] Case, J., Mundy, R., Partain, D. and B. Stewart,
"Introduction and Applicability Statements for
Internet-Standard Management Framework", RFC 3410,
December 2002.
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
IETF L3 Working Group Expires August 2004 [Page 32]
Internet Draft MPLS L3 VPN MIB February 03, 2004
13.0 Contributors' Addresses
Luyuan Fang
AT&T
200 Laurel Ave
Middletown, NJ 07748
Phone: +1-732-420-1921
Email: luyuanfang@att.com
Fabio M. Chiussi
Bell Laboratories, Lucent Technologies
101 Crawfords Corner Road, Room 4D-521
Holmdel, NJ 07733
Phone: +1-732-949-2407
Email: fabio@bell-labs.com
Joseph Dube
Avici Systems, Inc.
101 Billerica Avenue
North Billerica, MA 01862
Phone: +1-978-964-2258
Email: jdube@avici.com
Martin Tatham
British Telecom
BT Adastal Park,
Martlesham Heath,
Ipswich, IP5 3RE
UK
Tel: +44 1473 606349
Fax: +44 1473 606727
Email: martin.tatham@bt.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
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
IETF L3 Working Group Expires August 2004 [Page 33]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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,
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
IETF L3 Working Group Expires August 2004 [Page 34]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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
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.
IETF L3 Working Group Expires August 2004 [Page 35]
Internet Draft MPLS L3 VPN MIB February 03, 2004
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 8 } to the
MPLS-L3VPN-MIB module specified in this document.
IETF L3 Working Group Expires August 2004 [Page 36]
| PAFTECH AB 2003-2026 | 2026-04-21 13:19:59 |