Internet DRAFT - draft-dhody-pce-pcep-pathkey-mib
draft-dhody-pce-pcep-pathkey-mib
PCE Working Group D. Dhody
Internet-Draft U. Palle
Intended status: Standards Track Q. Zhao
Expires: February 5, 2015 Huawei Technology
D. King
Old Dog Consulting
August 4, 2014
Management Information Base (MIB) for the PCE Communications Protocol
(PCEP) for Path-Key based Confidentiality in Inter-Domain Path
Computation.
draft-dhody-pce-pcep-pathkey-mib-08
Abstract
This memo defines a portion of the Management Information Base (MIB)
for use with network management protocols in the Internet community.
In particular, it describes managed objects for modeling of the Path
Computation Element communication Protocol (PCEP) for communications
between a Path Computation Client (PCC) and a Path Computation
Element (PCE), or between two PCEs when path-key-based
confidentiality in inter-domain path computation is requested.
Status of This Memo
This Internet-Draft is submitted in full conformance with the
provisions of BCP 78 and BCP 79.
Internet-Drafts are working documents of the Internet Engineering
Task Force (IETF). Note that other groups may also distribute
working documents as Internet-Drafts. The list of current Internet-
Drafts is at http://datatracker.ietf.org/drafts/current/.
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."
This Internet-Draft will expire on February 5, 2015.
Copyright Notice
Copyright (c) 2014 IETF Trust and the persons identified as the
document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents
Dhody, et al. Expires February 5, 2015 [Page 1]
Internet-Draft PCEP PATHKEY MIB August 2014
(http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents
carefully, as they describe your rights and restrictions with respect
to this document. Code Components extracted from this document must
include Simplified BSD License text as described in Section 4.e of
the Trust Legal Provisions and are provided without warranty as
described in the Simplified BSD License.
Table of Contents
1. Introduction . . . . . . . . . . . . . . . . . . . . . . . . 2
1.1. Requirements Language . . . . . . . . . . . . . . . . . . 3
2. Terminology . . . . . . . . . . . . . . . . . . . . . . . . . 3
3. The Internet-Standard Management Framework . . . . . . . . . 3
4. PCEP Pathkey MIB Module Architecture . . . . . . . . . . . . 3
4.1. Relations to other MIB modules . . . . . . . . . . . . . 4
5. Example of the PCEP PathKey MIB module usage . . . . . . . . 4
6. Object definitions . . . . . . . . . . . . . . . . . . . . . 5
6.1. PCEP-PATHKEY-MIB . . . . . . . . . . . . . . . . . . . . 5
7. IANA Considerations . . . . . . . . . . . . . . . . . . . . . 21
8. Security Considerations . . . . . . . . . . . . . . . . . . . 21
9. References . . . . . . . . . . . . . . . . . . . . . . . . . 21
9.1. Normative References . . . . . . . . . . . . . . . . . . 21
9.2. Informative References . . . . . . . . . . . . . . . . . 22
1. Introduction
The Path Computation Element (PCE) defined in [RFC4655] is an entity
that is capable of computing a network path or route based on a
network graph, and applying computational constraints. A Path
Computation Client (PCC) may make requests to a PCE for paths to be
computed.
The PCE communication protocol (PCEP) is designed as a communication
protocol between PCCs and PCEs for path computations and is defined
in [RFC5440].
If confidentiality is required between domains, Path-Key based
mechanism is described in [RFC5520]. For preserving the
confidentiality of the "Confidential Path Segment (CPS)"; the PCE
returns a path containing a loose hop in place of the segment that
must be kept confidential.
[PCEP-MIB] defines a portion of the MIB for use with network
management protocols in the Internet community that can be used to
manage PCEP communications between a PCC and a PCE, or between two
PCEs. This memo describes MIB for path-key-based confidentiality in
inter-domain path computations.
Dhody, et al. Expires February 5, 2015 [Page 2]
Internet-Draft PCEP PATHKEY MIB August 2014
1.1. Requirements Language
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 [RFC2119].
2. Terminology
This document uses the terminology defined in [RFC4655], [RFC5440]
and [RFC5520]. The following terminology is used in this document.
Domain: Any collection of network elements within a common sphere of
address management or path computational responsibility. Examples
of domains include Interior Gateway Protocol (IGP) areas and
Autonomous Systems (ASs).
IGP: Interior Gateway Protocol. Either of the two routing
protocols, Open Shortest Path First (OSPF) or Intermediate System
to Intermediate System (IS-IS).
3. The Internet-Standard Management Framework
For a detailed overview of the documents that describe the current
Internet-Standard Management Framework, please refer to section 7 of
[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] and STD 58, RFC 2580 [RFC2580].
4. PCEP Pathkey MIB Module Architecture
The PCEP Pathkey MIB will contain the following information:
o PCEP Pathkey counters, timers and configurations
o PCEP Pathkey table of Confidential Path Segment (CPS) related
information.
The PCEP Pathkey MIB has no role when PCEP peer is PCC.
Dhody, et al. Expires February 5, 2015 [Page 3]
Internet-Draft PCEP PATHKEY MIB August 2014
4.1. Relations to other MIB modules
The PCEP Pathkey MIB imports the following textual conventions from
the MPLS-TC-STD-MIB defined in [RFC3811]:
o MplsPathIndex
o TeHopAddressType
o TeHopAddress
o TeHopAddressUnnum
The PCEP Pathkey MIB imports the following textual conventions from
the INET-ADDRESS-MIB defined in [RFC4001]:
o InetAddressType
o InetAddress
5. Example of the PCEP PathKey MIB module usage
In this section we provide an example to showcase the relationship
between pcePcepPathKeyTable and pcePcepPathKeyHopTable described in
Section 6. While this example is not meant to illustrate every
permutation of the MIB, nor in its entirety, it is intended as an aid
to understand some of the key concepts. It is meant to be read after
going through the MIB itself.
Dhody, et al. Expires February 5, 2015 [Page 4]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyTable of the PCEP-PATHKEY-MIB module:
{
pcePcepPathKey (4512),
pcePcepPathKeyCPSIndex (1),
pcePcepPathKeyReqSrcAddrType ipv4 (1),
pcePcepPathKeyReqSrcAddr (1.1.1.1),
pcePcepPathKeyRequestId (10),
pcePcepPathKeyRetrieved (1),
pcePcepPathKeyRtrAddrType ipv4 (1),
pcePcepPathKeyRtrAddr (2.2.2.2),
pcePcepPathKeyDiscardTime (10),
pcePcepPathKeyReuseTime (30)
}
Entries of pcePcepPathKeyHopTable of the PCEP-PATHKEY-MIB module:
{
pcePcepPathKeyHopListIndex 1,
pcePcepPathKeyHopIndex 1,
pcePcepPathKeyHopAddrType ipv4 (1),
pcePcepPathKeyHopIpAddr "192.168.100.1",
pcePcepPathKeyHopIpPrefixLen 32,
pcePcepPathKeyHopAddrUnnum 0,
}
{
pcePcepPathKeyHopListIndex 1,
pcePcepPathKeyHopIndex 2,
pcePcepPathKeyHopAddrType ipv4 (1),
pcePcepPathKeyHopIpAddr "192.168.100.2",
pcePcepPathKeyHopIpPrefixLen 32,
pcePcepPathKeyHopAddrUnnum 0
}
The pcePcepPathKeyTable is the table for all the Path-Keys generated
by PCE. To access the CPS hidden by path-key pcePcepPathKey (4512),
index pcePcepPathKeyCPSIndex (1) is used in pcePcepPathKeyHopTable to
find the hop list (pcePcepPathKeyHopListIndex). To access each hop
of the path another index pcePcepPathKeyHopIndex is used along with
pcePcepPathKeyHopListIndex.
6. Object definitions
6.1. PCEP-PATHKEY-MIB
Dhody, et al. Expires February 5, 2015 [Page 5]
Internet-Draft PCEP PATHKEY MIB August 2014
PCEP-PATHKEY-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY,
OBJECT-TYPE,
mib-2,
NOTIFICATION-TYPE,
Unsigned32,
Counter32
FROM SNMPv2-SMI -- RFC 2578
TruthValue,
TimeStamp
FROM SNMPv2-TC -- RFC 2579
MODULE-COMPLIANCE,
OBJECT-GROUP,
NOTIFICATION-GROUP
FROM SNMPv2-CONF -- RFC 2580
MplsPathIndex,
TeHopAddressType,
TeHopAddress,
TeHopAddressUnnum
FROM MPLS-TC-STD-MIB -- RFC 3811
InetAddressType,
InetAddress
FROM INET-ADDRESS-MIB -- RFC 4001
pcePcepPathkeyMIB MODULE-IDENTITY
LAST-UPDATED
"201408051200Z" -- August 05, 2014
ORGANIZATION
"IETF Path Computation Element (PCE) Working Group"
CONTACT-INFO
"Email: pce@ietf.org
WG charter
http://www.ietf.org/html.charters/pce-charter.html"
DESCRIPTION
"This MIB module defines a collection of objects for managing PCE
communication protocol(PCEP) for Path-Key-Based Inter-Domain Path
Computation"
Copyright (C) The IETF Trust (2014). This version of this MIB module
is part of RFC YYYY; see the RFC itself for full legal notices.
-- RFC Ed,: replace YYYY with actual RFC number & remove
this note
-- Revision history
Dhody, et al. Expires February 5, 2015 [Page 6]
Internet-Draft PCEP PATHKEY MIB August 2014
REVISION
"201408051200Z" -- 05 August 2014 12:00:00 EST
DESCRIPTION
"
Main Changes from -07 draft :
1. Editorial Changes."
REVISION
"201402061200Z" -- 06 February 2014 12:00:00 EST
DESCRIPTION
"
Main Changes from -06 draft :
1. Align to changes in base PCEP MIB."
REVISION
"201401031200Z" -- 03 January 2014 12:00:00 EST
DESCRIPTION
"
Main Changes from -05 draft :
1. Editorial Changes."
REVISION
"201307031200Z" -- 03 July 2013 12:00:00 EST
DESCRIPTION
"
Main Changes from -04 draft :
1. Aligment with the updates in PCEP-MIB draft
2. Editorial Changes."
REVISION
"201208171200Z" -- 17 Aug 2012 12:00:00 EST
DESCRIPTION
"
Main Changes from -03 draft :
1. Adding of DEFVAL for some objects.
2. Editorial Changes."
REVISION
"201202221200Z" -- 22 Feb 2012 12:00:00 EST
DESCRIPTION
"
Main Changes from -02 draft :
1. Editorial Changes.
2. Updated Contact Information."
REVISION
"201109051200Z" -- 05 Sept 2011 12:00:00 EST
DESCRIPTION
"
Main Changes from -01 draft :
1. Added pcePcepPathKeyCPSIndex.
2. Added pcePcepPathKeyHopListIndex.
3. Removed pcePcepPathKeyHopNum.
4. Updated Contact Information."
Dhody, et al. Expires February 5, 2015 [Page 7]
Internet-Draft PCEP PATHKEY MIB August 2014
REVISION
"201103081200Z" -- 08 Mar 2011 12:00:00 EST
DESCRIPTION
"
Main Changes from -00 draft :
1. Added HopTable to store the CPS hops.
2. Added Path Key Creation Time."
REVISION
"201009171200Z" -- 17 Sep 2010 12:00:00 EST
DESCRIPTION
"Initial version, published as RFC YYYY."
-- RFC Ed.: replace YYYY with actual RFC number & remove
this note
::= { mib-2 XXX }
-- RFC Ed.: replace XXX with IANA-assigned number & remove
this note
pcePcepPathKeyNotifications OBJECT IDENTIFIER ::=
{ pcePcepPathkeyMIB 0 }
pcePcepPathKeysObjects OBJECT IDENTIFIER ::=
{ pcePcepPathkeyMIB 1 }
pcePcepPathKeyConformance OBJECT IDENTIFIER ::=
{ pcePcepPathkeyMIB 2 }
pcePcepPathKeyObjects OBJECT IDENTIFIER ::=
{ pcePcepPathKeysObjects 1 }
--
-- PCE Pathkey Objects
--
pcePcepPathKeyDiscardTimer OBJECT-TYPE
SYNTAX Unsigned32
UNITS "minutes"
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The value which indicates a period of time after the
expiration of which a PCE can discard unwanted
path-keys and CPS."
DEFVAL {10}
::= { pcePcepPathKeyObjects 1 }
Dhody, et al. Expires February 5, 2015 [Page 8]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyReUseTimer OBJECT-TYPE
SYNTAX Unsigned32
UNITS "minutes"
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The value which indicates a period of time which
should expire before an old path-key could be
reused for a new CPS."
DEFVAL {30}
::= { pcePcepPathKeyObjects 2 }
pcePcepPathKeyRetainStatus OBJECT-TYPE
SYNTAX INTEGER {
enabled(1),
disabled(2)
}
MAX-ACCESS read-only
STATUS optional
DESCRIPTION
"The path-key retain status of this PCE to retain the
path-key and CPS after retrieval."
DEFVAL {disabled(2)}
::= { pcePcepPathKeyObjects 3 }
pcePcepPathKeysGenerated OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The number of path-keys generated by this PCE."
::= { pcePcepPathKeyObjects 4 }
pcePcepPathKeyExpandUn OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The number of attempts to expand an unknown
path-key."
::= { pcePcepPathKeyObjects 5 }
Dhody, et al. Expires February 5, 2015 [Page 9]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyExpandExp OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The number of attempts to expand an expired
path-key."
::= { pcePcepPathKeyObjects 6 }
pcePcepPathKeyExpandSame OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS optional
DESCRIPTION
"The number of attempts to expand the same
path-key."
::= { pcePcepPathKeyObjects 7 }
pcePcepPathKeyExpNoExpansion OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS optional
DESCRIPTION
"The number of path-keys expired without any attempt
to expand it."
::= { pcePcepPathKeyObjects 8 }
pcePcepPathKeyExpansionSuccess OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS optional
DESCRIPTION
"The number of path-key expansion requests (PCReq)
which had successful retrieval."
::= { pcePcepPathKeyObjects 9 }
pcePcepPathKeyExpansionFailures OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS optional
DESCRIPTION
"The number of path-key expansion requests (PCReq)
which had failed retrieval."
::= { pcePcepPathKeyObjects 10 }
Dhody, et al. Expires February 5, 2015 [Page 10]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyConfig OBJECT-TYPE
SYNTAX INTEGER {
enabled(1),
disabled(2)
}
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"Path-key based confidentiality is enabled."
DEFVAL {disabled(2)}
::= { pcePcepPathKeyObjects 11 }
pcePcepPathKeyTable OBJECT-TYPE
SYNTAX SEQUENCE OF pcePcepPathKeyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains information about the
Pathkey CPS of PCE. Applicable only when
pcePcepPathKeyConfig is enabled(1)."
::= { pcePcepPathKeyObjects 12 }
pcePcepPathKeyEntry OBJECT-TYPE
SYNTAX pcePcepPathKeyEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"Represents a path-key and CPS entry. An entry is
only created when a path-key is
generated by PCE during inter-domain path
computation."
INDEX { pcePcepPathKey }
::= { pcePcepPathKeyTable 1 }
Dhody, et al. Expires February 5, 2015 [Page 11]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyEntry ::= SEQUENCE {
pcePcepPathKey Unsigned32,
pcePcepPathKeyCPSIndex MplsPathIndex,
pcePcepPathKeyReqSrcAddrType InetAddressType,
pcePcepPathKeyReqSrcAddr InetAddress,
pcePcepPathKeyRequestId Unsigned32,
pcePcepPathKeyRetrieved INTEGER,
pcePcepPathKeyRtrAddrType InetAddressType,
pcePcepPathKeyRtrAddr InetAddress,
pcePcepPathKeyCreationTime TimeStamp,
pcePcepPathKeyDiscardTime Unsigned32,
pcePcepPathKeyReuseTime Unsigned32,
}
pcePcepPathKey OBJECT-TYPE
SYNTAX Unsigned32 (1..65535)
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The path-key value to identify a CPS."
::= { pcePcepPathKeyEntry 1 }
pcePcepPathKeyCPSIndex OBJECT-TYPE
SYNTAX MplsPathIndex
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The HopList index of the CPS. This index
is used to expand Hops in
pcePcepPathKeyHopTable."
::= { pcePcepPathKeyEntry 2 }
pcePcepPathKeyReqSrcAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The type of the PCEP peer Internet address.
This object specifies how the value of the
pcePcepPathKeyReqSrcAddr object should be
interpreted."
::= { pcePcepPathKeyEntry 3 }
Dhody, et al. Expires February 5, 2015 [Page 12]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyReqSrcAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The Internet address of the PCEP peer that
issued the original request that led to the
creation of the path-key.
The type is given by
pcePcepPathKeyReqSrcAddrType "
::= { pcePcepPathKeyEntry 4 }
pcePcepPathKeyRequestId OBJECT-TYPE
SYNTAX Unsigned32
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The request ID of the original PCReq that led
to the creation of the path-key."
::= { pcePcepPathKeyEntry 5 }
pcePcepPathKeyRetrieved OBJECT-TYPE
SYNTAX INTEGER {
TRUE(1),
FALSE(2)
}
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"It specifies whether the path-key is retrieved
or not."
::= { pcePcepPathKeyEntry 6 }
pcePcepPathKeyRtrAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The type of the PCEP peer Internet address.
This object specifies how the value of the
pcePcepPathKeyRtrAddr object should be
interpreted. Applicable only when
pcePcepPathKeyRetrieved is TRUE(1)."
::= { pcePcepPathKeyEntry 7 }
Dhody, et al. Expires February 5, 2015 [Page 13]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyRtrAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The Internet address of the PCEP peer that
issued the path-key expansion or retrieval.
Applicable only when pcePcepPathKeyRetrieved
is TRUE(1). The type is given by
pcePcepPathKeyRtrAddrType."
::= { pcePcepPathKeyEntry 8 }
pcePcepPathKeyCreationTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The value of sysUpTime at which Path Key
was generated by PCE."
::= { pcePcepPathKeyEntry 9 }
pcePcepPathKeyDiscardTime OBJECT-TYPE
SYNTAX Unsigned32
UNIT "seconds"
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The time after which the path segment associated
with the path-key will be discarded."
::= { pcePcepPathKeyEntry 10 }
pcePcepPathKeyReuseTime OBJECT-TYPE
SYNTAX Unsigned32
UNIT "seconds"
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The time after which the path-key will be available
for re-use."
::= { pcePcepPathKeyEntry 11 }
Dhody, et al. Expires February 5, 2015 [Page 14]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyHopTable OBJECT-TYPE
SYNTAX SEQUENCE OF pcePcepPathKeyHopEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains information about the
Pathkey Hop in the CPS of PCE."
::= { pcePcepPathKeyObjects 12 }
pcePcepPathKeyHopEntry OBJECT-TYPE
SYNTAX pcePcepPathKeyHopEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"An entry in this table represents a Hop in the CPS.
An entry is only created when a path-key generated
by PCE during inter-domain computation."
INDEX { pcePcepPathKeyHopListIndex,
pcePcepPathKeyHopIndex }
::= { pcePcepPathKeyHopTable 1 }
pcePcepPathKeyHopEntry ::= SEQUENCE {
pcePcepPathKeyHopListIndex MplsPathIndex,
pcePcepPathKeyHopIndex MplsPathIndex,
pcePcepPathKeyHopAddrType TeHopAddressType,
pcePcepPathKeyHopIpAddr TeHopAddress,
pcePcepPathKeyHopIpPrefixLen InetAddressPrefixLength,
pcePcepPathKeyHopAddrUnnum TeHopAddressUnnum,
}
pcePcepPathKeyHopListIndex OBJECT-TYPE
SYNTAX MplsPathIndex
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The primary index into pcePcepPathKeyHopEntry table
identifying a particular CPS. All hops in the CPS
will have the same ListIndex. This corresponds to
pcePcepPathKeyCPSIndex in pcePcepPathKeyEntry."
::= { pcePcepPathKeyHopEntry 1 }
Dhody, et al. Expires February 5, 2015 [Page 15]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyHopIndex OBJECT-TYPE
SYNTAX MplsPathIndex
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The secondry index into pcePcepPathKeyHopEntry
table identifying a particular Hop in the CPS."
::= { pcePcepPathKeyHopEntry 2 }
pcePcepPathKeyHopAddrType OBJECT-TYPE
SYNTAX TeHopAddressType
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The Hop Address Type of this CPS hop. Only
ipv4(1), ipv6(2) and unnum(4) are allowed."
DEFVAL { ipv4 }
::= { pcePcepPathKeyHopEntry 3 }
pcePcepPathKeyHopIpAddr OBJECT-TYPE
SYNTAX TeHopAddress
MAX-ACCESS read-only
STATUS mandatory
DESCRIPTION
"The Hop Address for this CPS hop.
The type of this address is determined by the
value of the corresponding
pcePcepPathKeyHopAddrType."
DEFVAL { '00000000'h } -- IPv4 address 0.0.0.0
::= { pcePcepPathKeyHopEntry 4 }
pcePcepPathKeyHopIpPrefixLen OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"pcePcepPathKeyHopAddrType if set to ipv4(1) or
ipv6(2), then this value will contain an
appropriate prefix length for the IP address in
object pcePcepPathKeyHopIpAddr. Otherwise this
value is irrelevant and should be ignored."
DEFVAL { 32 }
::= { pcePcepPathKeyHopEntry 5 }
Dhody, et al. Expires February 5, 2015 [Page 16]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyHopAddrUnnum OBJECT-TYPE
SYNTAX TeHopAddressUnnum
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"If pcePcepPathKeyHopAddrType is set to unnum(4),
then this value will contain the interface
identifier of the unnumbered interface for this
hop. This object should be used in conjunction
with pcePcepPathKeyHopIpAddr which would contain
the LSR Router ID in this case."
::= { pcePcepPathKeyHopEntry 6 }
---
--- Notifications
---
pcePcepPathKeyExpandUnNtf NOTIFICATION-TYPE
OBJECTS {
pcePcepPathKeyExpandUn
}
STATUS mandatory
DESCRIPTION
"This notification is sent when an attempt to expand
an unknown path-key is made. The value of the
counter pcePcepPathKeyExpandUn is also increased at
this time."
::= { pcePcepPathKeyNotifications 1 }
pcePcepPathKeyExpandExpNtf NOTIFICATION-TYPE
OBJECTS {
pcePcepPathKeyExpandExp
}
STATUS mandatory
DESCRIPTION
"This notification is sent when an attempt to expand
an expired path-key is made. The value of the
counter pcePcepPathKeyExpandExp is also increased
at this time."
::= { pcePcepPathKeyNotifications 2 }
Dhody, et al. Expires February 5, 2015 [Page 17]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyExpandSameNtf NOTIFICATION-TYPE
OBJECTS {
pcePcepPathKeyExpandSame
}
STATUS optional
DESCRIPTION
"This notification is sent when a duplicate attempt
to expand the same path-key is made. The value of
the counter pcePcepPathKeyExpandSame is also
increased at this time."
::= { pcePcepPathKeyNotifications 3 }
pcePcepPathKeyExpNoExpansionNtf NOTIFICATION-TYPE
OBJECTS {
pcePcepPathKeyExpNoExpansion
}
STATUS optional
DESCRIPTION
"This notification is sent when path-key expires
without any attempt to expand it. The value of
the counter pcePcepPathKeyExpNoExpansion is also
increased at this time."
::= { pcePcepPathKeyNotifications 4 }
--****************************************************************
-- Module Conformance Statement
--****************************************************************
pcePcepPathKeyGroups
OBJECT IDENTIFIER ::= { pcePcepPathKeyConformance 1 }
pcePcepPathKeyCompliances
OBJECT IDENTIFIER ::= { pcePcepPathKeyConformance 2 }
--
-- Read-Only Compliance
--
Dhody, et al. Expires February 5, 2015 [Page 18]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyModuleReadOnlyCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The Module is implemented with support
for read-only. In other words, only monitoring
is available by implementing this
MODULE-COMPLIANCE."
MODULE -- this module
MANDATORY-GROUPS
{ pcePcepPathKeyGeneralGroup,
pcePcepPathKeyNotificationsGroup
}
::= { pcePcepPathKeyCompliances 1 }
-- units of conformance
Dhody, et al. Expires February 5, 2015 [Page 19]
Internet-Draft PCEP PATHKEY MIB August 2014
pcePcepPathKeyGeneralGroup OBJECT-GROUP
OBJECTS {
pcePcepPathKeyDiscardTimer,
pcePcepPathKeyReUseTimer,
pcePcepPathKeysGenerated,
pcePcepPathKeyExpandUn,
pcePcepPathKeyExpandExp,
pcePcepPathKeyConfig,
pcePcepPathKey,
pcePcepPathKeyCPSIndex,
pcePcepPathKeyReqSrcAddrType,
pcePcepPathKeyReqSrcAddr,
pcePcepPathKeyRequestId,
pcePcepPathKeyRetrieved,
pcePcepPathKeyRtrAddrType,
pcePcepPathKeyRtrAddr,
pcePcepPathKeyCreationTime,
pcePcepPathKeyDiscardTime,
pcePcepPathKeyReuseTime,
pcePcepPathKeyHopListIndex,
pcePcepPathKeyHopIndex,
pcePcepPathKeyHopAddrType,
pcePcepPathKeyHopIpAddr,
pcePcepPathKeyHopIpPrefixLen,
pcePcepPathKeyHopAddrUnnum,
}
STATUS current
DESCRIPTION
"Objects that apply to all PCEP Pathkey MIB
implementations."
::= { pcePcepPathKeyGroups 1 }
pcePcepPathKeyNotificationsGroup NOTIFICATION-GROUP
NOTIFICATIONS { pcePcepPathKeyExpandUnNtf,
pcePcepPathKeyExpandExpNtf
}
STATUS current
DESCRIPTION
"The notifications for a PCEP Pathkey MIB
implementation."
::= { pcePcepPathKeyGroups 2 }
END
Dhody, et al. Expires February 5, 2015 [Page 20]
Internet-Draft PCEP PATHKEY MIB August 2014
7. IANA Considerations
The MIB module in this document uses the following IANA-assigned
OBJECT IDENTIFIER values recorded in the SMI Numbers registry:
Descriptor OBJECT IDENTIFIER value
---------- -----------------------
pcePcepPathkeyMIB { mib-2 XXX }
Editor's Note (to be removed prior to publication): the IANA is
requested to assign a value for "XXX" under the 'mib-2' subtree and
to record the assignment in the SMI Numbers registry. When the
assignment has been made, the RFC Editor is asked to replace "XXX"
(here and in the MIB module) with the assigned value and to remove
this note.
8. Security Considerations
[PCEP-MIB] describes the security consideration related to the PCE
MIB module, which are applicable to PCE Path-Key MIB defined in this
document. Further [RFC5520] describes various security consideration
when dealing with Path-Key. Since this MIB contains confidential path
segment, care should be taken to maintain the confidentiality during
SNMP MIB operations.
Security features described by the SNMPv3 framework [RFC3410] like
User-based Security Model (USM) [RFC3414] with the AES cipher
algorithm [RFC3826] and Transport Security Model (TSM) [RFC5591] in
combination with a secure transport such as SSH [RFC5592] or TLS/DTLS
[RFC6353]. should be supported.
9. References
9.1. Normative References
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate
Requirement Levels", BCP 14, RFC 2119, March 1997.
[RFC2578] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Structure of Management Information
Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.
[RFC2579] McCloghrie, K., Ed., Perkins, D., Ed., and J.
Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD
58, RFC 2579, April 1999.
Dhody, et al. Expires February 5, 2015 [Page 21]
Internet-Draft PCEP PATHKEY MIB August 2014
[RFC2580] McCloghrie, K., Perkins, D., and J. Schoenwaelder,
"Conformance Statements for SMIv2", STD 58, RFC 2580,
April 1999.
[RFC2863] McCloghrie, K. and F. Kastenholz, "The Interfaces Group
MIB", RFC 2863, June 2000.
[RFC3411] Harrington, D., Presuhn, R., and B. Wijnen, "An
Architecture for Describing Simple Network Management
Protocol (SNMP) Management Frameworks", STD 62, RFC 3411,
December 2002.
[RFC3811] Nadeau, T. and J. Cucchiara, "Definitions of Textual
Conventions (TCs) for Multiprotocol Label Switching (MPLS)
Management", RFC 3811, June 2004.
[RFC3813] Srinivasan, C., Viswanathan, A., and T. Nadeau,
"Multiprotocol Label Switching (MPLS) Label Switching
Router (LSR) Management Information Base (MIB)", RFC 3813,
June 2004.
[RFC4001] Daniele, M., Haberman, B., Routhier, S., and J.
Schoenwaelder, "Textual Conventions for Internet Network
Addresses", RFC 4001, February 2005.
[RFC5440] Vasseur, JP. and JL. Le Roux, "Path Computation Element
(PCE) Communication Protocol (PCEP)", RFC 5440, March
2009.
[PCEP-MIB]
Koushik, K., Emile, S., Zhao, Q., King, D., and J.
Hardwick, "Path Computation Element Protocol (PCEP)
Management Information Base", draft-ietf-pce-pcep-mib-09
(work in progress), July 2014.
9.2. Informative References
[RFC3410] Case, J., Mundy, R., Partain, D., and B. Stewart,
"Introduction and Applicability Statements for Internet-
Standard Management Framework", RFC 3410, December 2002.
[RFC3414] Blumenthal, U. and B. Wijnen, "User-based Security Model
(USM) for version 3 of the Simple Network Management
Protocol (SNMPv3)", STD 62, RFC 3414, December 2002.
[RFC3826] Blumenthal, U., Maino, F., and K. McCloghrie, "The
Advanced Encryption Standard (AES) Cipher Algorithm in the
SNMP User-based Security Model", RFC 3826, June 2004.
Dhody, et al. Expires February 5, 2015 [Page 22]
Internet-Draft PCEP PATHKEY MIB August 2014
[RFC4655] Farrel, A., Vasseur, J., and J. Ash, "A Path Computation
Element (PCE)-Based Architecture", RFC 4655, August 2006.
[RFC5520] Bradford, R., Vasseur, JP., and A. Farrel, "Preserving
Topology Confidentiality in Inter-Domain Path Computation
Using a Path-Key-Based Mechanism", RFC 5520, April 2009.
[RFC5591] Harrington, D. and W. Hardaker, "Transport Security Model
for the Simple Network Management Protocol (SNMP)", STD
78, RFC 5591, June 2009.
[RFC5592] Harrington, D., Salowey, J., and W. Hardaker, "Secure
Shell Transport Model for the Simple Network Management
Protocol (SNMP)", RFC 5592, June 2009.
[RFC6353] Hardaker, W., "Transport Layer Security (TLS) Transport
Model for the Simple Network Management Protocol (SNMP)",
STD 78, RFC 6353, July 2011.
Authors' Addresses
Dhruv Dhody
Huawei Technology
Leela Palace
Bangalore, Karnataka 560008
INDIA
EMail: dhruv.ietf@gmail.com
Udayasree Palle
Huawei Technology
Leela Palace
Bangalore, Karnataka 560008
INDIA
EMail: udayasree.palle@huawei.com
Quintin Zhao
Huawei Technology
125 Nagog Technology Park
Acton, MA 01719
US
EMail: quintin.zhao@huawei.com
Dhody, et al. Expires February 5, 2015 [Page 23]
Internet-Draft PCEP PATHKEY MIB August 2014
Daniel King
Old Dog Consulting
UK
EMail: daniel@olddog.co.uk
Dhody, et al. Expires February 5, 2015 [Page 24]