[Docs] [txt|pdf] [Tracker] [Email] [Nits]

Versions: 00

Network Working Group                                             W. Sun
Internet-Draft                                                      SJTU
Intended status: Standards Track                               T. Nadeau
Expires: January 3, 2012                                     Lucidvision
                                                               M. Morrow
                                                           Cisco Systems
                                                                G. Zhang
                                                                    CATR
                                                                   W. Hu
                                                                    SJTU
                                                            July 2, 2011


     Label Switched Path (LSP) Provisioning Performance Management
    Information Base for Generalized MPLS (GMPLS) / MPLS-TE networks
                 draft-sun-ccamp-gmpls-perf-mib-00.txt

Abstract

   This memo defines Management Information Bases (MIBs) for
   performances of provisioning Label Switched Paths (LSPs) in
   Generalized MPLS or MPLS-TE networks.

   When Generalized MPLS/MPLS-TE is used to provision LSPs, it is useful
   to record the performance of the provisioning process, such as the
   delay in creating and deleting the LSPs.  The managed information may
   be retrieved by the Management System and visualized on the GUI, so
   that the performance of dynamic provisioning may be monitored in a
   timely manner.

   This work is a continuation of the work in [RFC5814] and
   [I-D.ietf-ccamp-dpm], where the provisioning performance values are
   obtained through active measurements.

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."



Sun, et al.              Expires January 3, 2012                [Page 1]


Internet-Draft             LSP Performance MIB                 July 2011


   This Internet-Draft will expire on January 3, 2012.

Copyright Notice

   Copyright (c) 2011 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
   (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.

   This document may contain material from IETF Documents or IETF
   Contributions published or made publicly available before November
   10, 2008.  The person(s) controlling the copyright in some of this
   material may not have granted the IETF Trust the right to allow
   modifications of such material outside the IETF Standards Process.
   Without obtaining an adequate license from the person(s) controlling
   the copyright in such materials, this document may not be modified
   outside the IETF Standards Process, and derivative works of it may
   not be created outside the IETF Standards Process, except to format
   it for publication as an RFC or to translate it into languages other
   than English.























Sun, et al.              Expires January 3, 2012                [Page 2]


Internet-Draft             LSP Performance MIB                 July 2011


Table of Contents

   1.  Introduction . . . . . . . . . . . . . . . . . . . . . . . . .  4

   2.  Conventions Used in This Document  . . . . . . . . . . . . . .  5

   3.  The Internet-Standard Management Framework . . . . . . . . . .  6

   4.  Brief Description of LSP performance MIB Objects . . . . . . .  7
     4.1.  gmplsPerfMaxEntries  . . . . . . . . . . . . . . . . . . .  7
     4.2.  gmplsPerfTunnelConfigured  . . . . . . . . . . . . . . . .  7
     4.3.  gmplsPerfTable . . . . . . . . . . . . . . . . . . . . . .  7

   5.  GMPLS Performance MIB Module . . . . . . . . . . . . . . . . .  8

   6.  References . . . . . . . . . . . . . . . . . . . . . . . . . . 15
     6.1.  Normative References . . . . . . . . . . . . . . . . . . . 15
     6.2.  Informative References . . . . . . . . . . . . . . . . . . 15

   Authors' Addresses . . . . . . . . . . . . . . . . . . . . . . . . 16































Sun, et al.              Expires January 3, 2012                [Page 3]


Internet-Draft             LSP Performance MIB                 July 2011


1.  Introduction

   When Label Switched Paths (LSPs) are provisioned dynamically within
   an operational network, it is helpful to monitor and record the
   related performance information, such as the experienced provisioning
   delay and error events.  Such information may help operators to
   ensure correct operation of dynamic LSP provisioning in their
   network, or possibly identify performance degradation in the control
   plane.

   This memo defines a set of objects that can reveal the performance of
   an operational network in terms of dynamic LSP provisioning.  It is
   intended to complement the performance objects, such as the number of
   packets received and sent, per LSP tunnel, in [RFC3812] and
   [RFC4802].

   Unlike the work in [RFC5814] and [I-D.ietf-ccamp-dpm], where the
   performance values are obtained through active measurements, this
   document focuses on the performance values in operational
   environments.  The actual value of the performance in this document
   is recorded only when an LSP is provisioned, and is thus collected
   passively.  Hence such information reflects only the performance at
   specific and discrete times.  However, when properly used, they can
   be helpful in identifying performance degradation, or even
   malfunctioning, in the network control plane.


























Sun, et al.              Expires January 3, 2012                [Page 4]


Internet-Draft             LSP Performance MIB                 July 2011


2.  Conventions Used in This Document

   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].














































Sun, et al.              Expires January 3, 2012                [Page 5]


Internet-Draft             LSP Performance MIB                 July 2011


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], STD 58, RFC 2579[RFC2579] and STD 58, RFC
   2580[RFC2580].





































Sun, et al.              Expires January 3, 2012                [Page 6]


Internet-Draft             LSP Performance MIB                 July 2011


4.  Brief Description of LSP performance MIB Objects

4.1.  gmplsPerfMaxEntries

   Defines the maximum number of rows stored in the gmplsPerfTable.  An
   implementation MUST start assigning gmplsPerfEntryIndex values at 1
   and wrap after exceeding the maximum possible value, as defined by
   the limit of this object.

4.2.  gmplsPerfTunnelConfigured

   Defines the The total number of tunnels configured.

4.3.  gmplsPerfTable

   The performance of past LSP provisioning process is stored in this
   table.  To handle possible provisioning failures, start and complete
   timestamp of a provisioning operation is recorded.  For example, for
   LSP creation process, the timestamps of creation initiation and
   completion are recorded seperatly.  It is up to the users to
   determine the actual performance value, or identify a possible
   creation/deletion failure.  The maximum number of entries stored in
   this table is determined by the value of gmplsPerfMaxEntries.




























Sun, et al.              Expires January 3, 2012                [Page 7]


Internet-Draft             LSP Performance MIB                 July 2011


5.  GMPLS Performance MIB Module

    GMPLS-PROV-PERF-STD-MIB DEFINITIONS ::= BEGIN

    IMPORTS
        gmplsTeStdMIB
            FROM GMPLS-TE-STD-MIB
        mplsStdMIB,
        MplsTunnelIndex,
        MplsExtendedTunnelId
            FROM MPLS-TC-STD-MIB            -- RFC 3811
        TimeStamp
            FROM SNMPv2-TC
        MODULE-IDENTITY, OBJECT-TYPE,
        Gauge32, Unsigned32
            FROM SNMPv2-SMI
        OBJECT-GROUP
            FROM SNMPv2-CONF;

    gmplsPerfMIB MODULE-IDENTITY
        LAST-UPDATED "201104180654Z"    -- Apr 18, 2011 6:54:00 AM
        ORGANIZATION "IETF Common Control and Measurement Plane Working
    Group"
        CONTACT-INFO
            "Weiqiang Sun
            Shanghai Jiao Tong University (SJTU)
            Email: sunwq@mit.edu

            Thomas D. Nadeau
            Email: thomas.nadeau@huawei.com"
        DESCRIPTION
            "Copyright (C) The Internet Society (2011).  This version of
            this MIB module is part of RFC XXX; see the RFC itself for
            full legal notices.

            This MIB module defines managed object definitions
            for dynamic LSP provisioning."
        REVISION "201104180654Z"        -- Apr 18, 2011 6:54:00 AM
        DESCRIPTION
            "Initial version."
        -- 1.3.6.1.2.1.10.166.13.1
        ::= { gmplsTeStdMIB 1 }


    gmplsPerfTunnelConfigured OBJECT-TYPE
        SYNTAX  Unsigned32
        MAX-ACCESS read-only
        STATUS  current



Sun, et al.              Expires January 3, 2012                [Page 8]


Internet-Draft             LSP Performance MIB                 July 2011


        DESCRIPTION
            "The total number of tunnels configured."
        -- 1.3.6.1.2.1.10.166.13.1.3
        ::= { gmplsPerfMIB 3 }


    gmplsPerfMaxEntries OBJECT-TYPE
        SYNTAX  Gauge32
        MAX-ACCESS read-only
        STATUS  current
        DESCRIPTION
            "An implementation MUST start assigning gmplsPerfEntryIndex
            values at 1 and wrap after exceeding the maximum possible
            value, as defined by the limit of this object.

            A value of 0 for this object disables creation of
            gmplsPerfEntry."
        -- 1.3.6.1.2.1.10.166.13.1.2
        ::= { gmplsPerfMIB 2 }


    --Performance Table

    gmplsPerfTable OBJECT-TYPE
        SYNTAX  SEQUENCE OF GmplsPerfEntry
        MAX-ACCESS not-accessible
        STATUS  current
        DESCRIPTION
            "Defines a table for storing the results of LSP
            provisioning operations. It allows the provisioning
            performance be retrieved later for monitoring or
            diagnostic purposes. The recorded performance information
            is intended to complement the existing performance
            statistics in the MPLS-TE-STD-MIB and GMPLS-TE-STD-MIB.

            Note that the creation and tear-down operation performances
            are stored in one table, ie., gmplsPerfTable. When an LSP
            tunnel creation operation is  initiated, an entry MUST be
            added in this table and Tunnel ID as well as the time of
            initiation MUST be recorded. Upon completion of the creation
            process, ie., a positive signaling feedback is received by
            the ingress LSR,  this complete time object in this entry
            MUST be updated.

            When an LSP tunnel deletion process is initiated, the
            corresponding entry with the same tunnel ID MUST be located
            and updated with time of the deletion initiation time. When
            the deletion operation is complete, the entry MUST again



Sun, et al.              Expires January 3, 2012                [Page 9]


Internet-Draft             LSP Performance MIB                 July 2011


            be updated with the completion time.

            Under circumstances that the creation or deletion operation
            may fail, an entry may be partially updated. Eg., when a
            creation operation timeouts without a positive signaling
            feedback, the creation completion time may never be updated.
            When a tear-down operation is caused by nodes other than the
            Ingress LSR, the tear-down start time may not be known to
            the ingress LSR. In such cases, the user of the MIB MUST be
            aware of such events and treat the performance information
            accordingly.

            The number of entries in this table is limited by the value
            of the corresponding gmplsPerfMaxEntries object. An
            implementation MUST start assigning gmplsPerfEntryIndex at
            1 and wrap after exceeding the maximum possible value, as
            defined by the limit of gmplsPerfMaxEntries. An
            implementation of this MIB will remove the oldest entry
            in the gmplsPerfTable to allow the addition of a new entry
            once the number of rows in the gmplsPerfTable reaches the
            value specified by gmplsPerfMaxEntries."
        -- 1.3.6.1.2.1.10.166.13.1.1
        ::= { gmplsPerfMIB 1 }


    gmplsPerfEntry OBJECT-TYPE
        SYNTAX  GmplsPerfEntry
        MAX-ACCESS not-accessible
        STATUS  current
        DESCRIPTION
            "Defines an entry in the gmplsPerfTable. An entry can be
            created when an LSP tunnel is signaled. An implementation
            of this MIB MAY choose to disable the creation of
            performance entry, when an LSP is provisioned through
            SNMP."
        INDEX {
            gmplsPerfEntryIndex,
            gmplsPerfTunnelID }
        -- 1.3.6.1.2.1.10.166.13.1.1.1
        ::= { gmplsPerfTable 1 }


    GmplsPerfEntry ::= SEQUENCE {

        gmplsPerfEntryIndex         Gauge32,
        gmplsPerfTunnelID           MplsTunnelIndex,
        gmplsPerfCurrentStatus      INTEGER,
        gmplsPerfSrcID              MplsExtendedTunnelId,



Sun, et al.              Expires January 3, 2012               [Page 10]


Internet-Draft             LSP Performance MIB                 July 2011


        gmplsPerfDstID              MplsExtendedTunnelId,
        gmplsPerfCreateStartTime    TimeStamp,
        gmplsPerfCreateCompleteTime TimeStamp,
        gmplsPerfDeleteStartTime    TimeStamp,
        gmplsPerfDeleteCompleteTime TimeStamp }


    gmplsPerfEntryIndex OBJECT-TYPE
        SYNTAX  Gauge32
        MAX-ACCESS not-accessible
        STATUS  current
        DESCRIPTION
            "The index of the performance entry. The number of entries
            in this table is limited by the value of the corresponding
            gmplsPerfMaxEntries object. An implementation MUST start
            assigning gmplsPerfEntryIndex at 1 and wrap after exceeding
            the maximum possible value, as defined by the limit of
            gmplsPerfMaxEntries. An implementation of this MIB will
            remove the oldest entry in the gmplsPerfTable to allow the
            addition of an new entry once the number of rows in the
            gmplsPerfTable reaches the value specified by
            gmplsPerfMaxEntries."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.1
        ::= { gmplsPerfEntry 1 }


    gmplsPerfTunnelID OBJECT-TYPE
        SYNTAX  MplsTunnelIndex
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The ID of the tunnel being provisioned."
        REFERENCE
            "RFC 3812"
        -- 1.3.6.1.2.1.10.166.13.1.1.1.2
        ::= { gmplsPerfEntry 2 }


    gmplsPerfCurrentStatus OBJECT-TYPE
        SYNTAX  INTEGER {
            CreationInProgress(0),
            Up(1),
            DeletionInProgress(2),
            Deleted(3) }
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "This object defines the current status of the LSP tunnel.



Sun, et al.              Expires January 3, 2012               [Page 11]


Internet-Draft             LSP Performance MIB                 July 2011


            CreationInProgress
              The corresponding LSP tunnel is being created, but
              the creation operation has not finished yet.

            Up
              The corresponding LSP tunnel has been created
              successfully.

            DeletionInProgress
              The corresponding LSP tunnel is being deleted, but
              the deletion process has not finished yet.

            Deleted
              The corresponding LSP tunnel has been deleted."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.3
        ::= { gmplsPerfEntry 3 }


    gmplsPerfSrcID OBJECT-TYPE
        SYNTAX  MplsExtendedTunnelId
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The address of the ingress LSR ID."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.5
        ::= { gmplsPerfEntry 5 }


    gmplsPerfDstID OBJECT-TYPE
        SYNTAX  MplsExtendedTunnelId
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The address of the egress LSR ID."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.6
        ::= { gmplsPerfEntry 6 }


    gmplsPerfCreateStartTime OBJECT-TYPE
        SYNTAX  TimeStamp
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The time when the tunnel setup operation is
            initiated."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.7
        ::= { gmplsPerfEntry 7 }




Sun, et al.              Expires January 3, 2012               [Page 12]


Internet-Draft             LSP Performance MIB                 July 2011


    gmplsPerfCreateCompleteTime OBJECT-TYPE
        SYNTAX  TimeStamp
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The time when the LSP tunnel create operation
            is complete."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.8
        ::= { gmplsPerfEntry 8 }


    gmplsPerfDeleteStartTime OBJECT-TYPE
        SYNTAX  TimeStamp
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The time when the LSP Tunnel tear-down operation
            is initiated."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.9
        ::= { gmplsPerfEntry 9 }


    gmplsPerfDeleteCompleteTime OBJECT-TYPE
        SYNTAX  TimeStamp
        MAX-ACCESS read-create
        STATUS  current
        DESCRIPTION
            "The time when an LSP tear-down operation
            is complete."
        -- 1.3.6.1.2.1.10.166.13.1.1.1.10
        ::= { gmplsPerfEntry 10 }


    gmplsPerfGroups OBJECT IDENTIFIER
        -- 1.3.6.1.2.1.10.166.13.1.4
        ::= { gmplsPerfMIB 4 }

    gmplsDeletionGroup OBJECT-GROUP
        OBJECTS {
            gmplsPerfTunnelID,
            gmplsPerfCurrentStatus,
            gmplsPerfSrcID,
            gmplsPerfDstID,
            gmplsPerfDeleteStartTime,
            gmplsPerfDeleteCompleteTime }
        STATUS  current
        DESCRIPTION
            "The group of object that constitute the LSP tunnel



Sun, et al.              Expires January 3, 2012               [Page 13]


Internet-Draft             LSP Performance MIB                 July 2011


            deletion performance."
        -- 1.3.6.1.2.1.10.166.13.1.4.1
        ::= { gmplsPerfGroups 1 }

    gmplsCreationGroup OBJECT-GROUP
        OBJECTS {
            gmplsPerfTunnelID,
            gmplsPerfCurrentStatus,
            gmplsPerfSrcID,
            gmplsPerfDstID,
            gmplsPerfCreateStartTime,
            gmplsPerfCreateCompleteTime }
        STATUS  current
        DESCRIPTION
            "The group of object that constitute the LSP tunnel
            creation performance."
        -- 1.3.6.1.2.1.10.166.13.1.4.2
        ::= { gmplsPerfGroups 2 }

    gmplsPerfBasicGroup OBJECT-GROUP
        OBJECTS {
            gmplsPerfEntryIndex,
            gmplsPerfTunnelID,
            gmplsPerfMaxEntries,
            gmplsPerfCurrentStatus,
            gmplsPerfCreateStartTime,
            gmplsPerfCreateCompleteTime,
            gmplsPerfDeleteStartTime,
            gmplsPerfDeleteCompleteTime,
            gmplsPerfDstID,
            gmplsPerfSrcID,
            gmplsPerfTunnelConfigured,
            gmplsPerfErrThreshold }
        STATUS  current
        DESCRIPTION
            "Basic objects."
        -- 1.3.6.1.2.1.10.166.13.1.4.3
        ::= { gmplsPerfGroups 3 }

    END











Sun, et al.              Expires January 3, 2012               [Page 14]


Internet-Draft             LSP Performance MIB                 July 2011


6.  References

6.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.

   [RFC2580]  McCloghrie, K., Perkins, D., and J. Schoenwaelder,
              "Conformance Statements for SMIv2", STD 58, RFC 2580,
              April 1999.

   [RFC3410]  Case, J., Mundy, R., Partain, D., and B. Stewart,
              "Introduction and Applicability Statements for Internet-
              Standard Management Framework", RFC 3410, December 2002.

   [RFC3812]  Srinivasan, C., Viswanathan, A., and T. Nadeau,
              "Multiprotocol Label Switching (MPLS) Traffic Engineering
              (TE) Management Information Base (MIB)", RFC 3812,
              June 2004.

   [RFC4802]  Nadeau, T. and A. Farrel, "Generalized Multiprotocol Label
              Switching (GMPLS) Traffic Engineering Management
              Information Base", RFC 4802, February 2007.

6.2.  Informative References

   [I-D.ietf-ccamp-dpm]
              Sun, W. and G. Zhang, "Label Switched Path (LSP) Data Path
              Delay Metrics in Generalized MPLS/ MPLS-TE Networks",
              draft-ietf-ccamp-dpm-03 (work in progress), May 2011.

   [RFC5814]  Sun, W. and G. Zhang, "Label Switched Path (LSP) Dynamic
              Provisioning Performance Metrics in Generalized MPLS
              Networks", RFC 5814, March 2010.









Sun, et al.              Expires January 3, 2012               [Page 15]


Internet-Draft             LSP Performance MIB                 July 2011


Authors' Addresses

   Weiqiang Sun
   Shanghai Jiao Tong University
   800 Dongchuan Road
   Shanghai  200240
   China

   Phone: +86 21 3420 5359
   Email: sunwq@mit.edu


   Thomas D. Nadeau
   Lucidvision

   Email: tnadeau@lucidvision.com


   Monique Morrow
   Cisco Systems
   Richistrasse 7
   CH-8304 Zurich-Wallisellen
   Switzerland

   Phone: +41 44 878 9412
   Email: mmorrow@cisco.com


   Guoying Zhang
   China Academy of Telecommunication Research,MII.
   No.52 Hua Yuan Bei Lu,Haidian District
   Beijing  100083
   China

   Phone: +86-1062300106
   Email: zhangguoying@mail.ritt.com.cn


   Weisheng Hu
   Shanghai Jiao Tong University
   800 Dongchuan Road
   Shanghai  200240
   China

   Phone: +86 21 3420 5419
   Email: wshu@sjtu.edu.cn





Sun, et al.              Expires January 3, 2012               [Page 16]


Html markup produced by rfcmarkup 1.129d, available from https://tools.ietf.org/tools/rfcmarkup/