Skip to main content

MPLS/BGP Layer 3 VPN Multicast Management Information Base
draft-ietf-bess-mvpn-mib-03

The information below is for an old version of the document.
Document Type
This is an older version of an Internet-Draft that was ultimately published as RFC 8503.
Authors Zhaohui (Jeffrey) Zhang , Saud Asif , Andy Green , Sameer Gulrajani , Pradeep Jain , Hiroshi Tsunoda
Last updated 2017-03-01
Replaces draft-ietf-l3vpn-mvpn-mib
RFC stream Internet Engineering Task Force (IETF)
Formats
Reviews
Additional resources Mailing list discussion
Stream WG state WG Consensus: Waiting for Write-Up
Document shepherd Mach Chen
IESG IESG state Became RFC 8503 (Proposed Standard)
Consensus boilerplate Unknown
Telechat date (None)
Responsible AD (None)
Send notices to "Mach Chen" <mach.chen@huawei.com>
draft-ietf-bess-mvpn-mib-03
Network Working Group                                      Z. Zhang, Ed.
Internet-Draft                                                   Juniper
Intended status: Standards Track                                 S. Asif
Expires: September 1, 2017                                          AT&T
                                                                A. Green
                                                                      BT
                                                           S. Gulranjani
                                                                   Cisco
                                                                 P. Jain
                                                          Alcatel-Lucent
                                                         H. Tsunoda, Ed.
                                          Tohoku Institute of Technology
                                                       February 28, 2017

       MPLS/BGP Layer 3 VPN Multicast Management Information Base
                      draft-ietf-bess-mvpn-mib-03

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 to configure and/or
   monitor MVPN, Multicast in MultiProtocol Label Switching/Border
   Gateway Protocol (MPLS/BGP) IP Virtual Private Networks (VPNs) on a
   router.

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 September 1, 2017.

Zhang, et al.           Expires September 1, 2017               [Page 1]
Internet-Draft             L3VPN Multicast MIB             February 2017

Copyright Notice

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

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
     1.1.  Terminology . . . . . . . . . . . . . . . . . . . . . . .   3
   2.  The Internet-Standard Management Framework  . . . . . . . . .   3
   3.  MVPN MIB  . . . . . . . . . . . . . . . . . . . . . . . . . .   4
     3.1.  Summary of MIB Module . . . . . . . . . . . . . . . . . .   4
     3.2.  MIB Module Definitions  . . . . . . . . . . . . . . . . .   6
   4.  Security Considerations . . . . . . . . . . . . . . . . . . .  31
   5.  IANA Considerations . . . . . . . . . . . . . . . . . . . . .  32
   6.  Acknowledgement . . . . . . . . . . . . . . . . . . . . . . .  33
   7.  References  . . . . . . . . . . . . . . . . . . . . . . . . .  33
     7.1.  Normative References  . . . . . . . . . . . . . . . . . .  33
     7.2.  Informative References  . . . . . . . . . . . . . . . . .  34
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  35

1.  Introduction

   Multicast in MultiProtocol Label Switching/Border Gateway Protocol
   (MPLS/BGP) IP Virtual Private Networks (VPNs) is specified in
   [RFC6513], [RFC6514], and [RFC6625].  The term "Multicast VPN (MVPN)"
   [RFC6513] refers to a BGP/MPLS Layer 3 (IP) VPN service that supports
   multicast.

   These specifications support either Protocol Independent Multicast
   (PIM) or BGP as the protocol for exchanging VPN multicast state
   (referred to as C-multicast states, where 'C-' stands for 'VPN
   Customer-') among Provider Edge routers (PEs).  In the rest of this
   document we will use the term "PIM-MVPN" to refer to PIM being used
   for exchanging C-multicast states, and "BGP-MVPN" to refer to BGP
   being used for exchanging C-multicast states.

Zhang, et al.           Expires September 1, 2017               [Page 2]
Internet-Draft             L3VPN Multicast MIB             February 2017

   This document defines a Management Information Base (MIB) for MVPN-
   specific objects that are generic to both PIM-MVPN and BGP-MVPN.

   This document borrowed some text from Cisco PIM-MVPN MIB
   [I-D.svaidya-mcast-vpn-mib].  For PIM-MVPN this document attempts to
   provide coverage comparable to [I-D.svaidya-mcast-vpn-mib], but in a
   generic way that applies to both PIM-MVPN and BGP-MVPN.

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

   Comments should be made directly to the BESS WG at bess@ietf.org.

1.1.  Terminology

   This document adopts the definitions, acronyms and mechanisms
   described in [RFC6513] and other documents that [RFC6513] refers to.
   Familiarity with Multicast, MPLS, L3VPN, MVPN concepts and/or
   mechanisms is assumed.  Some terms specifically related to this
   document are explained below.

   The term "Multicast VPN (MVPN)" [RFC6513] refers to a BGP/MPLS L3
   (IP) VPN service that supports multicast.

   Interchangeably, the term Multicast Virtual Routing and Forwarding
   table (MVRF) and MVPN are used to refer to a particular Multicast VPN
   instantiation on a particular PE device.

   "Provider Multicast Service Interface (PMSI)" [RFC6513] is a
   conceptual interface instantiated by a Provider tunnel (P-tunnel), a
   transport mechanism used to deliver multicast traffic.  A PE uses to
   send customer multicast traffic to all or some PEs in the same VPN.

   There are two kinds of PMSI: "Inclusive PMSI (I-PMSI)" and "Selective
   PMSI (S-PMSI)" [RFC6513].  An I-PMSI is a PMSI that enables a PE
   attached to a particular MVPN to transmit a message to all PEs in the
   same VPN.  An S-PMSI is a PMSI that enables a PE attached to a
   particular MVPN to transmit a message to some of the PEs in the same
   VPN.

2.  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
   RFC 3410 [RFC3410].

Zhang, et al.           Expires September 1, 2017               [Page 3]
Internet-Draft             L3VPN Multicast MIB             February 2017

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

3.  MVPN MIB

   This section gives the overview of the MVPN MIB.  The MIB module aims
   to provide configuring and/or monitoring of MVPNs on PE devices: the
   whole multicast VPN machinery and the per-MVRFs information,
   including the configuration, status and operational details, such as
   different P-Multicast Service Interfaces (PMSIs) and the provider
   tunnels implementing them.

3.1.  Summary of MIB Module

   The configuration and states specific to an MVPN include the
   following:

   o  C-multicast routing exchange protocol (PIM or BGP)

   o  I-PMSI, S-PMSI and corresponding provider tunnels

   o  Mapping of C-multicast states to PMSI/tunnels

   To represent them, the following tables are defined.  The following
   figure depicts relationships among tables defined in this document.
   Each box in the figure represents a table defined in this document.
   The label in each box corresponds to a table name.

Zhang, et al.           Expires September 1, 2017               [Page 4]
Internet-Draft             L3VPN Multicast MIB             February 2017

        +--------------+
        | MvpnBgp      |
        | GeneralTable |
        +--------------+    +-------------------+    +-----------------+
        | MvpnGeneral       | MvpnPmsiConfig    |    | MvpnSpmsiConfig |
        | Table        | -> | Table             | <- | Table           |
        +--------------+    +-------------------+    +-----------------+

        +--------------+    +-------------------+    +-----------------+
        |  MvpnIpmsi   | -> | L2L3VpnMcastPmsi  | <- |    MvpnSpmsi    |
        |  Table       |    | TunnelAttribute   |    |    Table        |
        +--------------+    | Table             |    +-----------------+
                         -> +-------------------+
                        /            ^
                       /             |
        +--------------+    +-------------------+
        | MvpnInterAs  |    |  MvpnMrouteTable  |
        | IpmsiTable   |    +-------------------+
        +--------------+

   o  mvpnGeneralTable

      An entry in this table is created for each MVRF in the device, for
      general configuration/states of the MVRF, including Inclusive PMSI
      (I-PMSI) configuration.

      Existence of the corresponding VRF in [RFC4382] is necessary for a
      row to exist in this table.

   o  mvpnBgpGeneralTable

      This table augments mvpnGeneralTable and is for BGP-MVPN specific
      information.

   o  mvpnSpmsiConfigTable

      This table contains objects for Selective PMSI (S-PMSI)
      configurations in an MVRF.

   o  mvpnPmsiConfigTable

      Both I-PMSI configuration (in mvpnGeneralEntry) and S-PMSI
      configuration (in mvpnSpmsiConfigEntry) refer to entries in this
      table.

   o  mvpnIpmsiTable

Zhang, et al.           Expires September 1, 2017               [Page 5]
Internet-Draft             L3VPN Multicast MIB             February 2017

      This table contains all advertised and received intra-as I-PMSIs.
      With PIM-MVPN, it is applicable only when BGP-Based Autodiscovery
      of MVPN Membership is used.

   o  mvpnInterAsIpmsiTable

      This table contains all advertised and received inter-as I-PMSIs.
      With PIM-MVPN, it is applicable only when BGP-Based Autodiscovery
      of MVPN Membership is used.

   o  mvpnSpmsiTable

      This table contains all advertised or received S-PMSIs.

   o  l2l3VpnMcastPmsiTunnelAttributeTable

      This table is defined separately in l2L3VpnMcastMIB
      [I-D.ietf-bess-l2l3-vpn-mcast-mib], which is common for both VPLS
      Multicast and MVPN.  It contains sent/received PMSI attribute
      entries referred to by mvpnIpmsiEntry, mvpnSpmsiEntry,
      mvpnInterAsIpmsiEntry, and other MIB objects (e.g., VPLS Multicast
      ones).

   o  mvpnMrouteTable

      This table augments
      ipMcastMIB.ipMcast.ipMcastRouteTable [RFC5132], for some MVPN
      specific information.

3.2.  MIB Module Definitions

  MCAST-VPN-MIB DEFINITIONS ::= BEGIN

  IMPORTS
     MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
     Gauge32, Unsigned32, mib-2                 -- [RFC2578]
        FROM SNMPv2-SMI

     MODULE-COMPLIANCE, OBJECT-GROUP
        FROM SNMPv2-CONF                        -- [RFC2580]

     TruthValue, RowPointer, RowStatus, TimeStamp, TimeInterval
        FROM SNMPv2-TC                          -- [RFC2579]

     SnmpAdminString
        FROM SNMP-FRAMEWORK-MIB                 -- [RFC2571]

     InetAddress, InetAddressType

Zhang, et al.           Expires September 1, 2017               [Page 6]
Internet-Draft             L3VPN Multicast MIB             February 2017

        FROM INET-ADDRESS-MIB                   -- [RFC2851]

     mplsL3VpnVrfName, MplsL3VpnRouteDistinguisher
        FROM MPLS-L3VPN-STD-MIB                 -- [RFC4382]

     ipMcastRouteEntry
        FROM IPMCAST-MIB                        -- [RFC5132]

     L2L3VpnMcastProviderTunnelType
        FROM L2L3-VPN-MCAST-MIB;

  mvpnMIB MODULE-IDENTITY
     LAST-UPDATED "201702281200Z"  -- 28th February 2017 12:00:00 GMT
     ORGANIZATION "IETF BESS Working Group."
     CONTACT-INFO
           "       Zhaohui Zhang
                   Juniper Networks, Inc.
                   10 Technology Park Drive
                   Westford, MA 01886
                   USA
                   Email: zzhang@juniper.net

                   Saud Asif
                   AT&T
                   C5-3D30 200 South Laurel Avenue
                   Middletown, NJ 07748
                   USA
                   Email: sasif@att.com

                   Andy Green
                   BT Design 21CN Converged Core IP & Data
                   01473 629360 Adastral Park, Martlesham Heath,
                   Ipswich IP5 3RE
                   UK
                   Email: andy.da.green@bt.com

                   Sameer Gulrajani
                   Cisco Systems
                   Tasman Drive San Jose, CA  95134
                   USA
                   Email: sameerg@cisco.com

                   Pradeep G. Jain
                   Alcatel-Lucent Inc
                   701 E Middlefield road Mountain view, CA 94043
                   USA
                   Email: pradeep.jain@alcatel-lucent.com

Zhang, et al.           Expires September 1, 2017               [Page 7]
Internet-Draft             L3VPN Multicast MIB             February 2017

                   Hiroshi Tsunoda
                   Tohoku Institute of Technology
                   35-1, Yagiyama Kasumi-cho
                   Taihaku-ku, Sendai, 982-8577
                   Japan
                   Email: tsuno@m.ieice.org

                   Comments and discussion to bess@ietf.org"

     DESCRIPTION
          "This MIB contains managed object definitions for
           multicast in BGP/MPLS IP VPNs defined by [RFC6513].
           Copyright (C) The Internet Society (2016)."

    -- Revision history.

    REVISION "201702281200Z"  -- 28th February, 2017
    DESCRIPTION
        "Initial version, published as RFC XXXX."

    -- RFC Ed. replace XXXX with actual RFC number and remove this note

    ::= { mib-2 YYYY }

    -- IANA Reg.: Please assign a value for "YYYY" under the
    -- 'mib-2' subtree and record the assignment in the SMI
    -- Numbers registry.

    -- RFC Ed.: When the above assignment has been made, please
    -- remove the above note
    -- replace "YYYY" here with the assigned value and
    -- remove this note.

  -- Top level components of this MIB.
  mvpnNotifications OBJECT IDENTIFIER ::= { mvpnMIB 0 }

  -- tables, scalars
  mvpnObjects       OBJECT IDENTIFIER ::= { mvpnMIB 1 }

  -- conformance information
  mvpnConformance   OBJECT IDENTIFIER ::= { mvpnMIB 2 }

  -- mvpn Objects
  mvpnScalars       OBJECT IDENTIFIER ::= { mvpnObjects 1 }
  mvpnGeneral       OBJECT IDENTIFIER ::= { mvpnObjects 2 }
  mvpnConfig        OBJECT IDENTIFIER ::= { mvpnObjects 3 }
  mvpnStates        OBJECT IDENTIFIER ::= { mvpnObjects 4 }

Zhang, et al.           Expires September 1, 2017               [Page 8]
Internet-Draft             L3VPN Multicast MIB             February 2017

  -- Scalar Objects

  mvpnMvrfs OBJECT-TYPE
     SYNTAX        Gauge32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The total number of MVRFs that are present on this device,
          whether for IPv4, IPv6, or mLDP C-Multicast."
     ::= { mvpnScalars 1 }

  mvpnV4Mvrfs OBJECT-TYPE
     SYNTAX        Gauge32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The number of MVRFs for IPv4 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 2 }

  mvpnV6Mvrfs OBJECT-TYPE
     SYNTAX        Gauge32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The number of MVRFs for IPv6 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 3 }

  mvpnPimV4Mvrfs OBJECT-TYPE
     SYNTAX         Gauge32
     MAX-ACCESS     read-only
     STATUS         current
     DESCRIPTION
         "The number of PIM-MVPN MVRFs for IPv4 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 4 }

  mvpnPimV6Mvrfs OBJECT-TYPE
     SYNTAX         Gauge32
     MAX-ACCESS     read-only
     STATUS         current
     DESCRIPTION
         "The number of PIM-MVPN MVRFs for IPv6 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 5 }

  mvpnBgpV4Mvrfs OBJECT-TYPE

Zhang, et al.           Expires September 1, 2017               [Page 9]
Internet-Draft             L3VPN Multicast MIB             February 2017

     SYNTAX         Gauge32
     MAX-ACCESS     read-only
     STATUS         current
     DESCRIPTION
         "The number of BGP-MVPN MVRFs for IPv4 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 6 }

  mvpnBgpV6Mvrfs OBJECT-TYPE
     SYNTAX         Gauge32
     MAX-ACCESS     read-only
     STATUS         current
     DESCRIPTION
         "The number of BGP-MVPN MVRFs for IPv6 C-Multicast that are
          present in this device."
     ::= { mvpnScalars 7 }

  mvpnMldpMvrfs OBJECT-TYPE
     SYNTAX         Gauge32
     MAX-ACCESS     read-only
     STATUS         current
     DESCRIPTION
         "The number of BGP-MVPN MVRFs for mLDP C-Multicast that are
          present in this device."
     ::= { mvpnScalars 8 }

  mvpnNotificationEnable OBJECT-TYPE
     SYNTAX        TruthValue
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
          "If this object is TRUE, then the generation of all
           notifications defined in this MIB is enabled."
     DEFVAL { false }
     ::= { mvpnScalars 9 }

  -- General MVRF Information Table

  mvpnGeneralTable  OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnGeneralEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table specifies the general information about the MVRFs
          present in this device."
     ::= { mvpnGeneral 1 }

  mvpnGeneralEntry OBJECT-TYPE

Zhang, et al.           Expires September 1, 2017              [Page 10]
Internet-Draft             L3VPN Multicast MIB             February 2017

     SYNTAX        MvpnGeneralEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry in this table is created for each MVRF in the
          device."
     INDEX       { mplsL3VpnVrfName,
                   mvpnGenAddressFamily }
     ::= { mvpnGeneralTable 1 }

  MvpnGeneralEntry ::= SEQUENCE {
     mvpnGenAddressFamily       INTEGER,
     mvpnGenOperStatusChange    INTEGER,
     mvpnGenOperChangeTime      TimeStamp,
     mvpnGenCmcastRouteProtocol INTEGER,
     mvpnGenIpmsiConfig         RowPointer,
     mvpnGenInterAsPmsiConfig   RowPointer,
     mvpnGenUmhSelection        INTEGER,
     mvpnGenSiteType            INTEGER,
     mvpnGenSptnlLimit          Unsigned32,
     mvpnGenRowStatus           RowStatus
  }

  mvpnGenAddressFamily OBJECT-TYPE
     SYNTAX      INTEGER { ipv4(1),
                           ipv6(2)
                          }
     MAX-ACCESS  not-accessible
     STATUS      current
     DESCRIPTION
         "The Address Family that this entry is for"
     ::= { mvpnGeneralEntry 1 }

  mvpnGenOperStatusChange OBJECT-TYPE
     SYNTAX      INTEGER { createdMvrf(1),
                           deletedMvrf(2),
                           modifiedMvrfIpmsiConfig(3),
                           modifiedMvrfSpmsiConfig(4)
                          }
     MAX-ACCESS  read-only
     STATUS      current
     DESCRIPTION
         "This object describes the last operational change that
          happened for the given MVRF.

          createdMvrf - indicates that the MVRF was created in the
          device.

Zhang, et al.           Expires September 1, 2017              [Page 11]
Internet-Draft             L3VPN Multicast MIB             February 2017

          deletedMvrf - indicates that the MVRF was deleted from the
          device. A row in this table will never have
          mvpnGenOperStatusChange equal to deletedMvrf(2),
          because in that case the row itself will be deleted from the
          table. This value for mvpnGenOperStatusChange is defined
          mainly for use in mvpnMvrfChange notification.

          modifiedMvrfIpmsiConfig - indicates that the I-PMSI
          for the MVRF was configured, deleted or changed.

          modifiedMvrfSpmsiConfig - indicates that the S-PMSI
          for the MVRF was configured, deleted or changed."
     DEFVAL { createdMvrf }
     ::= { mvpnGeneralEntry 2 }

  mvpnGenOperChangeTime OBJECT-TYPE
     SYNTAX        TimeStamp
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The time at which the last operational change for the MVRF in
          question took place. The last operational change is specified
          by mvpnGenOperStatusChange."
     ::= { mvpnGeneralEntry 3 }

  mvpnGenCmcastRouteProtocol OBJECT-TYPE
     SYNTAX        INTEGER { pim (1),
                             bgp (2)
                           }
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "The protocol used to signal C-multicast states across the
          provider core.
          pim(1): PIM (PIM-MVPN).
          bgp(2): BGP (BGP-MVPN)."
     ::= { mvpnGeneralEntry 4 }

  mvpnGenIpmsiConfig OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "This points to a row in mvpnPmsiConfigTable,
          for I-PMSI configuration."
     ::= { mvpnGeneralEntry 5 }

  mvpnGenInterAsPmsiConfig OBJECT-TYPE

Zhang, et al.           Expires September 1, 2017              [Page 12]
Internet-Draft             L3VPN Multicast MIB             February 2017

     SYNTAX        RowPointer
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "This points to a row in mvpnPmsiConfigTable,
          for inter-as I-PMSI configuration, in case of segmented
          inter-as provider tunnels."
     ::= { mvpnGeneralEntry 6 }

  mvpnGenUmhSelection OBJECT-TYPE
     SYNTAX            INTEGER {
                             highestPeAddress  (1),
                             cRootGroupHashing (2),
                             ucastUmhRoute     (3)
                       }
     MAX-ACCESS        read-write
     STATUS            current
     DESCRIPTION
         "The UMH selection method for this mvpn, as specified in
          section 5.1.3 of [RFC6513]:
            highestPeAddress   (1): PE with the highest address
            cRootGroupHashing (2): hashing based on (c-root, c-group)
            uncastUmhRoute     (3): per ucast route towards c-root"

     ::= { mvpnGeneralEntry 7}

  mvpnGenSiteType   OBJECT-TYPE
     SYNTAX            INTEGER {
                             senderReceiver (1),
                             receiverOnly   (2),
                             senderOnly     (3)
                       }
     MAX-ACCESS        read-write
     STATUS            current
     DESCRIPTION
         "Whether this site is a receiver-only site or not.
          senderReceiver (1):   both sender and receiver site.
          receiverOnly   (2):   receiver-only site.
          senderOnly     (3):   sender-only site."
     ::= { mvpnGeneralEntry 8}

  mvpnGenSptnlLimit OBJECT-TYPE
     SYNTAX            Unsigned32
     MAX-ACCESS        read-write
     STATUS            current
     DESCRIPTION
         "The max number of selective provider tunnels this device
          allows for this mvpn."

Zhang, et al.           Expires September 1, 2017              [Page 13]
Internet-Draft             L3VPN Multicast MIB             February 2017

     ::= { mvpnGeneralEntry 9}

  mvpnGenRowStatus OBJECT-TYPE
     SYNTAX        RowStatus
     MAX-ACCESS    read-create
     STATUS        current
     DESCRIPTION
         "This is used to create or delete a row in this table."
     ::= { mvpnGeneralEntry 10 }

  -- General BGP-MVPN table

  mvpnBgpGeneralTable OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnBgpGeneralEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table augments the mvpnGeneralTable and is for BGP-MVPN
          specific information."
     ::= { mvpnGeneral 2 }

  mvpnBgpGeneralEntry OBJECT-TYPE
     SYNTAX           MvpnBgpGeneralEntry
     MAX-ACCESS       not-accessible
     STATUS           current
     DESCRIPTION
         "The mvpnBgpGeneralEntry matches and augments an
          mvpnGeneralEntry for a BGP-MVPN instance, with BGP-MVPN
          specific informatoin."
     AUGMENTS      { mvpnGeneralEntry }
  ::= { mvpnBgpGeneralTable 1 }

  MvpnBgpGeneralEntry ::= SEQUENCE {
     mvpnBgpGenMode           INTEGER,
     mvpnBgpGenVrfRtImport    MplsL3VpnRouteDistinguisher,
     mvpnBgpGenSrcAs          Unsigned32
  }

  mvpnBgpGenMode       OBJECT-TYPE
     SYNTAX            INTEGER {
                             rptSpt  (1),
                             sptOnly (2)
                       }
     MAX-ACCESS        read-write
     STATUS            current
     DESCRIPTION
         "For two different BGP-MVPN modes:
          rptSpt(1):  inter-site shared tree mode

Zhang, et al.           Expires September 1, 2017              [Page 14]
Internet-Draft             L3VPN Multicast MIB             February 2017

          sptOnly(2): inter-site source-only tree mode."
     ::= { mvpnBgpGeneralEntry 1}

  mvpnBgpGenVrfRtImport OBJECT-TYPE
     SYNTAX             MplsL3VpnRouteDistinguisher
     MAX-ACCESS         read-write
     STATUS             current
     DESCRIPTION
         "The VRF Route Import Extended Community that this device
          adds to unicast vpn routes that it advertises for this mvpn."
     ::= { mvpnBgpGeneralEntry 2}

  mvpnBgpGenSrcAs      OBJECT-TYPE
     SYNTAX            Unsigned32
     MAX-ACCESS        read-only
     STATUS            current
     DESCRIPTION
         "The Source AS number in Source AS Extended Community that this
          device adds to the unicast vpn routes that it advertises for
          this mvpn."
     ::= { mvpnBgpGeneralEntry 3}

  -- PMSI Configuration Table

  mvpnPmsiConfigTable  OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnPmsiConfigEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table specifies the configured PMSIs."
     ::= { mvpnConfig 1 }

  mvpnPmsiConfigEntry OBJECT-TYPE
     SYNTAX        MvpnPmsiConfigEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry in this table is created for each PMSI configured
          on this router. It can be referred to by either I-PMSI
          configuration (in mvpnGeneralEntry) or S-PMSI configuration
          (in mvpnSpmsiConfigEntry)"
     INDEX       { mvpnPmsiConfigTunnelType,
                   mvpnPmsiConfigTunnelAuxInfo,
                   mvpnPmsiConfigTunnelPimGroupAddressType,
                   mvpnPmsiConfigTunnelPimGroupAddress,
                   mvpnPmsiConfigTunnelOrTemplateName }
     ::= { mvpnPmsiConfigTable 1 }

Zhang, et al.           Expires September 1, 2017              [Page 15]
Internet-Draft             L3VPN Multicast MIB             February 2017

  MvpnPmsiConfigEntry ::= SEQUENCE {
    mvpnPmsiConfigTunnelType                 L2L3VpnMcastProviderTunnelType,
    mvpnPmsiConfigTunnelAuxInfo              Unsigned32,
    mvpnPmsiConfigTunnelPimGroupAddressType  InetAddressType,
    mvpnPmsiConfigTunnelPimGroupAddress      InetAddress,
    mvpnPmsiConfigTunnelOrTemplateName       SnmpAdminString,
    mvpnPmsiConfigEncapsType                 INTEGER,
    mvpnPmsiConfigRowStatus                  RowStatus
  }

  mvpnPmsiConfigTunnelType OBJECT-TYPE
     SYNTAX        L2L3VpnMcastProviderTunnelType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "Type of tunnel used to instantiate the PMSI."
     ::= { mvpnPmsiConfigEntry 1 }

  mvpnPmsiConfigTunnelAuxInfo OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "Additional tunnel information depending on the type.
          pim:         In case of S-PMSI, number of groups starting at
                       mvpnPmsiConfigTunnelPimGroupAddress.
                       This allows a range of PIM provider tunnel
                       group addresses to be specified in S-PMSI case.
                       In I-PMSI case, it must be 1.
          rsvp-p2mp:   1 for statically specified rsvp-p2mp tunnel
                       2 for dynamically created rsvp-p2mp tunnel
          ingress-replication:
                       1 for using any existing p2p/mp2p lsp
                       2 for dynamically creating new p2p lsp"
     ::= { mvpnPmsiConfigEntry 2 }

  mvpnPmsiConfigTunnelPimGroupAddressType OBJECT-TYPE
     SYNTAX        InetAddressType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "In case of PIM provider tunnel, the type of tunnel address."
     ::= { mvpnPmsiConfigEntry 3 }

  mvpnPmsiConfigTunnelPimGroupAddress OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current

Zhang, et al.           Expires September 1, 2017              [Page 16]
Internet-Draft             L3VPN Multicast MIB             February 2017

     DESCRIPTION
         "In case of PIM provider tunnel, the provider tunnel address."
     ::= { mvpnPmsiConfigEntry 4 }

  mvpnPmsiConfigTunnelOrTemplateName OBJECT-TYPE
     SYNTAX        SnmpAdminString
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The tunnel name or template name used to create tunnels.
          Depending on mvpnPmsiConfigTunnelType and
          mvpnPmsiConfigTunnelAuxInfo:

          dynamically created rsvp-p2mp tunnel:       template name
          statically specified rsvp-p2mp tunnel:      tunnel name
          ingress-replication using
            dynamically created lsps:                 template name
          other:                                      null"
     ::= { mvpnPmsiConfigEntry 5 }

  mvpnPmsiConfigEncapsType OBJECT-TYPE
     SYNTAX        INTEGER { greIp (1),
                             ipIp  (2),
                             mpls  (3)
                           }
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "The encapsulation type to be used, in case of PIM tunnel or
          ingress-replication."
     ::= { mvpnPmsiConfigEntry 6 }

  mvpnPmsiConfigRowStatus OBJECT-TYPE
     SYNTAX        RowStatus
     MAX-ACCESS    read-create
     STATUS        current
     DESCRIPTION
         "Used to create/modify/delete a row in this table."
    ::= { mvpnPmsiConfigEntry 7 }

  -- S-PMSI configuration table

  mvpnSpmsiConfigTable  OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnSpmsiConfigEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table specifies S-PMSI configuration."

Zhang, et al.           Expires September 1, 2017              [Page 17]
Internet-Draft             L3VPN Multicast MIB             February 2017

     ::= { mvpnConfig 2 }

  mvpnSpmsiConfigEntry OBJECT-TYPE
     SYNTAX        MvpnSpmsiConfigEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry is created for each S-PMSI configuration."
     INDEX       {  mplsL3VpnVrfName,
                    mvpnSpmsiConfigCmcastAddressType,
                    mvpnSpmsiConfigCmcastGroupAddress,
                    mvpnSpmsiConfigCmcastGroupPrefixLen,
                    mvpnSpmsiConfigCmcastSourceAddress,
                    mvpnSpmsiConfigCmcastSourcePrefixLen }
     ::= { mvpnSpmsiConfigTable 1 }

  MvpnSpmsiConfigEntry ::= SEQUENCE {
     mvpnSpmsiConfigCmcastAddressType     InetAddressType,
     mvpnSpmsiConfigCmcastGroupAddress    InetAddress,
     mvpnSpmsiConfigCmcastGroupPrefixLen  Unsigned32,
     mvpnSpmsiConfigCmcastSourceAddress   InetAddress,
     mvpnSpmsiConfigCmcastSourcePrefixLen Unsigned32,
     mvpnSpmsiConfigThreshold             Unsigned32,
     mvpnSpmsiConfigPmsiPointer           RowPointer,
     mvpnSpmsiConfigRowStatus             RowStatus
  }

  mvpnSpmsiConfigCmcastAddressType OBJECT-TYPE
     SYNTAX        InetAddressType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "Type of C-multicast address"
     ::= { mvpnSpmsiConfigEntry 1 }

  mvpnSpmsiConfigCmcastGroupAddress OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "C-multicast group address"
     ::= { mvpnSpmsiConfigEntry 2 }

  mvpnSpmsiConfigCmcastGroupPrefixLen OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION

Zhang, et al.           Expires September 1, 2017              [Page 18]
Internet-Draft             L3VPN Multicast MIB             February 2017

         "C-multicast group address prefix length.
          A group 0 (or ::0) with prefix length 32 (or 128)
          indicates wildcard group, while a group 0 (or ::0)
          with prefix length 0 indicates any group."
     ::= { mvpnSpmsiConfigEntry 3 }

  mvpnSpmsiConfigCmcastSourceAddress OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "C-multicast source address"
     ::= { mvpnSpmsiConfigEntry 4 }

  mvpnSpmsiConfigCmcastSourcePrefixLen OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "C-multicast source address prefix length.
          A source 0 (or ::0) with prefix length 32 (or 128)
          indicates a wildcard source, while a source 0 (or ::0)
          with prefix length 0 indicates any source."
     ::= { mvpnSpmsiConfigEntry 5 }

  mvpnSpmsiConfigThreshold OBJECT-TYPE
     SYNTAX        Unsigned32  (0..4294967295)
     UNITS         "kilobits per second"
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "The bandwidth threshold value which when exceeded for a
          multicast routing entry in the given MVRF, triggers usage
          of S-PMSI."
     ::= { mvpnSpmsiConfigEntry 6 }

  mvpnSpmsiConfigPmsiPointer OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-write
     STATUS        current
     DESCRIPTION
         "This points to a row in mvpnPmsiConfigTable,
          to specify tunnel attributes."
     ::= { mvpnSpmsiConfigEntry 7 }

  mvpnSpmsiConfigRowStatus OBJECT-TYPE
     SYNTAX        RowStatus
     MAX-ACCESS    read-create

Zhang, et al.           Expires September 1, 2017              [Page 19]
Internet-Draft             L3VPN Multicast MIB             February 2017

     STATUS        current
     DESCRIPTION
         "Used to create/modify/delete a row in this table."
    ::= { mvpnSpmsiConfigEntry 8 }

  -- Table of intra-as I-PMSIs advertised/received

  mvpnIpmsiTable OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnIpmsiEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table is for all advertised/received I-PMSI
          advertisements."
     ::= { mvpnStates 1 }

  mvpnIpmsiEntry OBJECT-TYPE
     SYNTAX        MvpnIpmsiEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry in this table corresponds to an I-PMSI
          advertisement that is advertised/received on this router.
          This represents all the sender PEs in the MVPN,
          with the provider tunnel they use to send traffic."
     INDEX  { mplsL3VpnVrfName,
              mvpnIpmsiAfi,
              mvpnIpmsiRD,
              mvpnIpmsiOrigAddrType,
              mvpnIpmsiOrigAddress }
     ::= { mvpnIpmsiTable 1 }

  MvpnIpmsiEntry ::= SEQUENCE {
     mvpnIpmsiAfi          Unsigned32,
     mvpnIpmsiRD           MplsL3VpnRouteDistinguisher,
     mvpnIpmsiOrigAddrType InetAddressType,
     mvpnIpmsiOrigAddress  InetAddress,
     mvpnIpmsiUpTime       TimeInterval,
     mvpnIpmsiAttribute    RowPointer
     }

  mvpnIpmsiAfi OBJECT-TYPE
     SYNTAX        Unsigned32 (1|2)
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The address family this I-PMSI is for.
          1 - IPv4

Zhang, et al.           Expires September 1, 2017              [Page 20]
Internet-Draft             L3VPN Multicast MIB             February 2017

          2 - IPv6"
     ::= { mvpnIpmsiEntry 1 }

  mvpnIpmsiRD OBJECT-TYPE
     SYNTAX        MplsL3VpnRouteDistinguisher
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The Route Distinguisher in this I-PMSI."
     ::= { mvpnIpmsiEntry 2 }

  mvpnIpmsiOrigAddrType OBJECT-TYPE
     SYNTAX        InetAddressType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The Internet address type of mvpnIpmsiOrigAddress."
     ::= { mvpnIpmsiEntry 3 }

  mvpnIpmsiOrigAddress OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The BGP address of the device that originated the I-PMSI."
     ::= { mvpnIpmsiEntry 4 }

  mvpnIpmsiUpTime OBJECT-TYPE
     SYNTAX        TimeInterval
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The time since this I-PMSI
          was first advertised/received by the device."
     ::= { mvpnIpmsiEntry 5 }

  mvpnIpmsiAttribute OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "Points to a row in the l2L3VpnMcastPmsiTunnelAttributeTable."
     ::= { mvpnIpmsiEntry 6 }

  -- Table of inter-as I-PMSIs advertised/received

  mvpnInterAsIpmsiTable OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnInterAsIpmsiEntry

Zhang, et al.           Expires September 1, 2017              [Page 21]
Internet-Draft             L3VPN Multicast MIB             February 2017

     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "This table is for all advertised/received inter-as I-PMSI
          advertisements."
     ::= { mvpnStates 2 }

  mvpnInterAsIpmsiEntry OBJECT-TYPE
     SYNTAX        MvpnInterAsIpmsiEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry in this table corresponds to an inter-as I-PMSI
          advertisement that is advertised/received on this router.
          This represents all the ASes in the MVPN,
          with the provider tunnel used to send traffic to."
     INDEX  { mplsL3VpnVrfName,
              mvpnInterAsIpmsiAfi,
              mvpnInterAsIpmsiRD,
              mvpnInterAsIpmsiSrcAs }
     ::= { mvpnInterAsIpmsiTable 1 }

  MvpnInterAsIpmsiEntry ::= SEQUENCE {
     mvpnInterAsIpmsiAfi          Unsigned32,
     mvpnInterAsIpmsiRD           MplsL3VpnRouteDistinguisher,
     mvpnInterAsIpmsiSrcAs        Unsigned32,
     mvpnInterAsIpmsiAttribute    RowPointer
     }

  mvpnInterAsIpmsiAfi OBJECT-TYPE
     SYNTAX        Unsigned32 (1|2)
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The address family this I-PMSI is for.
          1 - IPv4
          2 - IPv6"
     ::= { mvpnInterAsIpmsiEntry 1 }

  mvpnInterAsIpmsiRD OBJECT-TYPE
     SYNTAX        MplsL3VpnRouteDistinguisher
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The Route Distinguisher in this inter-as I-PMSI."
     ::= { mvpnInterAsIpmsiEntry 2 }

  mvpnInterAsIpmsiSrcAs OBJECT-TYPE

Zhang, et al.           Expires September 1, 2017              [Page 22]
Internet-Draft             L3VPN Multicast MIB             February 2017

     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The source-as in this inter-as I-PMSI."
     ::= { mvpnInterAsIpmsiEntry 3 }

  mvpnInterAsIpmsiAttribute OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "Points to a row in the l2L3VpnMcastPmsiTunnelAttributeTable."
     ::= { mvpnInterAsIpmsiEntry 4 }

  -- Table of S-PMSIs advertised/received

  mvpnSpmsiTable OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnSpmsiEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
            "This table has information about the S-PMSIs sent/received
             by a device."
     ::= { mvpnStates 3 }

  mvpnSpmsiEntry OBJECT-TYPE
     SYNTAX        MvpnSpmsiEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "An entry in this table is created or updated for each S-PMSI
          advertised/received in a particular MVRF."
     INDEX  { mplsL3VpnVrfName,
              mvpnSpmsiCmcastAddrType,
              mvpnSpmsiCmcastGroup,
              mvpnSpmsiCmcastGroupPrefixLen,
              mvpnSpmsiCmcastSource,
              mvpnSpmsiCmcastSourcePrefixLen,
              mvpnSpmsiOrigAddrType,
              mvpnSpmsiOrigAddress}
     ::= { mvpnSpmsiTable 1 }

  MvpnSpmsiEntry ::= SEQUENCE {
     mvpnSpmsiCmcastAddrType        InetAddressType,
     mvpnSpmsiCmcastGroup           InetAddress,
     mvpnSpmsiCmcastGroupPrefixLen  Unsigned32,
     mvpnSpmsiCmcastSource          InetAddress,

Zhang, et al.           Expires September 1, 2017              [Page 23]
Internet-Draft             L3VPN Multicast MIB             February 2017

     mvpnSpmsiCmcastSourcePrefixLen Unsigned32,
     mvpnSpmsiOrigAddrType          InetAddressType,
     mvpnSpmsiOrigAddress           InetAddress,
     mvpnSpmsiTunnelAttribute       RowPointer,
     mvpnSpmsiUpTime                TimeInterval,
     mvpnSpmsiExpTime               TimeInterval,
     mvpnSpmsiRefCnt                Unsigned32
     }

  mvpnSpmsiCmcastAddrType OBJECT-TYPE
     SYNTAX        InetAddressType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The Internet address type of mvpnSpmsiCmcastGroup/Source."
     ::= { mvpnSpmsiEntry 1 }

  mvpnSpmsiCmcastGroup OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "S-PMSI C-multicast group address.
          If it is 0 (or ::0), this is a wildcard group,
          and mvpnSpmsiCmcastGroupPrefixLen must be 32 (or 128)."
     ::= { mvpnSpmsiEntry 2 }

  mvpnSpmsiCmcastGroupPrefixLen OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "S-PMSI C-multicast group address prefix length."
     ::= { mvpnSpmsiEntry 3 }

  mvpnSpmsiCmcastSource OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "S-PMSI C-multicast source address
          If it is 0 (or ::0), this is a wildcard source,
          and mvpnSpmsiCmcastSourcePrefixLen must be 32 (or 128)."
     ::= { mvpnSpmsiEntry 4 }

  mvpnSpmsiCmcastSourcePrefixLen OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    not-accessible

Zhang, et al.           Expires September 1, 2017              [Page 24]
Internet-Draft             L3VPN Multicast MIB             February 2017

     STATUS        current
     DESCRIPTION
         "S-PMSI C-multicast source address prefix length."
     ::= { mvpnSpmsiEntry 5 }

  mvpnSpmsiOrigAddrType OBJECT-TYPE
     SYNTAX        InetAddressType
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The Internet address type of mvpnSpmsiOrigAddress."
     ::= { mvpnSpmsiEntry 6 }

  mvpnSpmsiOrigAddress OBJECT-TYPE
     SYNTAX        InetAddress
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The BGP address of the device that originated the S-PMSI."
     ::= { mvpnSpmsiEntry 7 }

  mvpnSpmsiTunnelAttribute OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "A row pointer to the l2L3VpnMcastPmsiTunnelAttributeTable"
     ::= { mvpnSpmsiEntry 8 }

  mvpnSpmsiUpTime OBJECT-TYPE
     SYNTAX        TimeInterval
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The time since this S-PMSI
          was first advertised/received by the device."
     ::= { mvpnSpmsiEntry 9 }

  mvpnSpmsiExpTime OBJECT-TYPE
     SYNTAX        TimeInterval
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
          "For UDP-based S-PMSI signaling for PIM-MVPN,
          the amount of time remaining before this
          received S-PMSI Join Message expires,
          or the next S-PMSI Join Message refresh is to be
          advertised again from the device.

Zhang, et al.           Expires September 1, 2017              [Page 25]
Internet-Draft             L3VPN Multicast MIB             February 2017

          Otherwise, it is 0."
     ::= { mvpnSpmsiEntry 10 }

  mvpnSpmsiRefCnt OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The number of c-multicast routes that are mapped to
          this S-PMSI."
     ::= { mvpnSpmsiEntry 11 }

  -- Table of multicast routes in an MVPN

  mvpnMrouteTable OBJECT-TYPE
     SYNTAX        SEQUENCE OF MvpnMrouteEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
            "This table augments ipMcastRouteTable, to provide some MVPN
             specific information."
     ::= { mvpnStates 4 }

  mvpnMrouteEntry OBJECT-TYPE
     SYNTAX        MvpnMrouteEntry
     MAX-ACCESS    not-accessible
     STATUS        current
     DESCRIPTION
         "The mvpnMrouteEntry matches and augments an ipMcastRouteEntry,
          with MVPN specific information, such as PMSI used."
     AUGMENTS      { ipMcastRouteEntry }
        ::= { mvpnMrouteTable 1 }

  MvpnMrouteEntry ::= SEQUENCE {
     mvpnMroutePmsiPointer               RowPointer,
     mvpnMrouteNumberOfLocalReplication  Unsigned32,
     mvpnMrouteNumberOfRemoteReplication Unsigned32
     }

  mvpnMroutePmsiPointer OBJECT-TYPE
     SYNTAX        RowPointer
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "The I-PMSI or S-PMSI this C-multicast route is using.
          This is important because an implementation may not have an
          interface corresponding to a provider tunnel,
          that can be used in ipMcastRouteNextHopEntry."

Zhang, et al.           Expires September 1, 2017              [Page 26]
Internet-Draft             L3VPN Multicast MIB             February 2017

     ::= { mvpnMrouteEntry 1 }

  mvpnMrouteNumberOfLocalReplication OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "Number of replications for local receivers.
          For example, if an ingress PE needs to send traffic out of
          N PE-CE interfaces, then mvpnMrouteNumberOfLocalReplication
          is N."
     ::= { mvpnMrouteEntry 2 }

  mvpnMrouteNumberOfRemoteReplication OBJECT-TYPE
     SYNTAX        Unsigned32
     MAX-ACCESS    read-only
     STATUS        current
     DESCRIPTION
         "Number of local replications for remote PEs. For example,
          if the number of remote PEs that need to receive traffic is N,
          then mvpnMrouteNumberOfRemoteReplication is N in case of
          Ingress Replication, but may be less than N in case of RSVP-TE
          or mLDP P2MP tunnels, depending on the actual number of
          replications the PE needs do."
     ::= { mvpnMrouteEntry 3 }

  -- MVPN Notifications

  mvpnMvrfChange NOTIFICATION-TYPE
     OBJECTS     {
                   mvpnGenOperStatusChange
                 }
     STATUS      current
     DESCRIPTION
         "A mvpnMvrfChange notification signifies a change about
          a MVRF in the device. The change event can be creation of
          the MVRF, deletion of the MVRF or an update on the I-PMSI
          or S-PMSI configuration of the MVRF. The change event
          is indicated by mvpnGenOperStatusChange embedded in
          the notification. The user can then query
          mvpnGeneralTable, and/or mvpnSpmsiConfigTable to
          get the details of the change as necessary.

          Note: Since the creation of a MVRF is often followed by
          configuration of I-PMSI and/or S-PMSIs for the MVRF,
          more than one (three at most) notifications for a MVRF may
          be generated serially, and it is really not necessary to
          generate all three of them. An agent may choose to generate a

Zhang, et al.           Expires September 1, 2017              [Page 27]
Internet-Draft             L3VPN Multicast MIB             February 2017

          notification for the last event only, that is for S-PMSI
          configuration.

          Similarly, deletion of I-PMSI and S-PMSI configuration on a
          MVRF happens before a MVRF is deleted and it is recommended
          that the agent send the notification for MVRF deletion
          event only."
     ::= { mvpnNotifications 1 }

  -- MVPN MIB Conformance Information

  mvpnGroups      OBJECT IDENTIFIER ::= { mvpnConformance 1 }
  mvpnCompliances OBJECT IDENTIFIER ::= { mvpnConformance 2 }

  -- Compliance Statements

      mvpnCompliance MODULE-COMPLIANCE
          STATUS  current
          DESCRIPTION
             "The compliance statement "
         MODULE  -- this module
         MANDATORY-GROUPS {
             mvpnScalarGroup,
             mvpnGeneralGroup,
             mvpnSpmsiConfigGroup,
             mvpnSpmsiGroup,
             mvpnMrouteGroup
             }

         GROUP mvpnIpmsiGroup
             DESCRIPTION
                 "This group is mandatory for systems that support
                  BGP signaling for I-PMSI."

         GROUP mvpnInterAsIpmsiGroup
             DESCRIPTION
                 "This group is mandatory for systems that support
                  Inter-AS Segmented I-PMSI."

         GROUP mvpnBgpGeneralGroup
             DESCRIPTION
                 "This group is mandatory for systems that support
                  BGP-MVPN."

         ::= { mvpnCompliances 1 }

  -- units of conformance

Zhang, et al.           Expires September 1, 2017              [Page 28]
Internet-Draft             L3VPN Multicast MIB             February 2017

      mvpnScalarGroup    OBJECT-GROUP
          OBJECTS {
              mvpnMvrfs,
              mvpnV4Mvrfs,
              mvpnV6Mvrfs,
              mvpnPimV4Mvrfs,
              mvpnPimV6Mvrfs,
              mvpnBgpV4Mvrfs,
              mvpnBgpV6Mvrfs,
              mvpnMldpMvrfs,
              mvpnNotificationEnable
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
             global MVPN parameters."
          ::= { mvpnGroups 1 }

      mvpnGeneralGroup    OBJECT-GROUP
          OBJECTS {
              mvpnGenOperStatusChange,
              mvpnGenOperChangeTime,
              mvpnGenCmcastRouteProtocol,
              mvpnGenIpmsiConfig,
              mvpnGenInterAsPmsiConfig,
              mvpnGenUmhSelection,
              mvpnGenSiteType,
              mvpnGenSptnlLimit,
              mvpnGenRowStatus
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              per-VRF MVPN parameters."
          ::= { mvpnGroups 2 }

      mvpnPmsiConfigGroup    OBJECT-GROUP
          OBJECTS {
              mvpnPmsiConfigEncapsType,
              mvpnPmsiConfigRowStatus
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              PMSI tunnel configurations."
          ::= { mvpnGroups 3 }

      mvpnSpmsiConfigGroup    OBJECT-GROUP

Zhang, et al.           Expires September 1, 2017              [Page 29]
Internet-Draft             L3VPN Multicast MIB             February 2017

          OBJECTS {
              mvpnSpmsiConfigThreshold,
              mvpnSpmsiConfigPmsiPointer,
              mvpnSpmsiConfigRowStatus
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              S-PMSI configurations."
          ::= { mvpnGroups 4 }

      mvpnIpmsiGroup    OBJECT-GROUP
          OBJECTS {
              mvpnIpmsiUpTime,
              mvpnIpmsiAttribute
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              Intra-AS I-PMSI attributes."
          ::= { mvpnGroups 5 }

      mvpnInterAsIpmsiGroup    OBJECT-GROUP
          OBJECTS {
              mvpnInterAsIpmsiAttribute
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              Inter-AS I-PMSI attributes."
          ::= { mvpnGroups 6 }

      mvpnSpmsiGroup    OBJECT-GROUP
          OBJECTS {
              mvpnSpmsiTunnelAttribute,
              mvpnSpmsiUpTime,
              mvpnSpmsiExpTime,
              mvpnSpmsiRefCnt
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              S-PMSI attributes."
          ::= { mvpnGroups 7 }

      mvpnMrouteGroup    OBJECT-GROUP
          OBJECTS {
              mvpnMrouteNumberOfLocalReplication,

Zhang, et al.           Expires September 1, 2017              [Page 30]
Internet-Draft             L3VPN Multicast MIB             February 2017

              mvpnMrouteNumberOfRemoteReplication
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage
              VPN multicast forwarding states."
          ::= { mvpnGroups 8 }

      mvpnBgpGeneralGroup    OBJECT-GROUP
          OBJECTS {
              mvpnBgpGenMode,
              mvpnBgpGenVrfRtImport,
              mvpnBgpGenSrcAs
              }
          STATUS      current
          DESCRIPTION
             "These objects are used to monitor/manage BGP-MVPN "
          ::= { mvpnGroups 9 }

      mvpnOptionalGroup OBJECT-GROUP
          OBJECTS {
              mvpnMroutePmsiPointer
          }
          STATUS      current
          DESCRIPTION
              "Support of these object is not required."
          ::= { mvpnGroups 10}

  END

4.  Security Considerations

   This MIB contains some read-only objects that may be deemed senstive
   by some though perhaps not all operators.  It also contains some
   read- write objects, whose setting will change the device's behavior
   related to MVPN.  Appropriate security procedures related to SNMP in
   general but not specific to this MIB need to be implemented by
   concerned operators.

   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 opens devices to attack.  These
   are the tables and objects and their sensitivity/vulnerability:

   o  mvpnNotificationEnable, mvpnGenCmcastRouteProtocol,
      mvpnGenIpmsiConfig, mvpnGenInterAsPmsiConfig, mvpnGenUmhSelection,

Zhang, et al.           Expires September 1, 2017              [Page 31]
Internet-Draft             L3VPN Multicast MIB             February 2017

      mvpnGenSiteType, mvpnGenSptnlLimit, mvpnBgpGenMode,
      mvpnBgpGenVrfRtImport, mvpnPmsiConfigEncapsType,
      mvpnSpmsiConfigThreshold, mvpnSpmsiConfigPmsiPointer

   o  mvpnGenRowStatus, mvpnPmsiConfigRowStatus,
      mvpnSpmsiConfigRowStatus

   Some of the readable objects in this MIB module (i.e., objects with a
   MAX-ACCESS other than not-accessible) may be considered sensitive or
   vulnerable in some network environments.  It is thus important to
   control even GET and/or NOTIFY access to these objects and possibly
   to even encrypt the values of these objects when sending them over
   the network via SNMP.  These are the tables and objects and their
   sensitivity/vulnerability:

   o  [TBD]

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPsec),
   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.

   Implementations SHOULD provide the security features described by the
   SNMPv3 framework (see [RFC3410]), and implementations claiming
   compliance to the SNMPv3 standard MUST include full support for
   authentication and privacy via the User-based Security Model (USM)
   [RFC3414] with the AES cipher algorithm [RFC3826].  Implementations
   MAY also provide support for the Transport Security Model (TSM)
   [RFC5591] in combination with a secure transport such as SSH
   [RFC5592] or TLS/DTLS [RFC6353].

   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.

5.  IANA Considerations

   IANA is requested to root MIB objects in the MIB module contained in
   this document under the mib-2 subtree.

Zhang, et al.           Expires September 1, 2017              [Page 32]
Internet-Draft             L3VPN Multicast MIB             February 2017

6.  Acknowledgement

   Some of the text has been taken almost verbatim from
   [I-D.svaidya-mcast-vpn-mib].  We would like to thank Yakov Rekhter,
   Jeffrey Haas, Huajin Jeng, Durga Prasad Velamuri for their helpful
   comments.

7.  References

7.1.  Normative References

   [I-D.ietf-bess-l2l3-vpn-mcast-mib]
              Zhang, Z. and H. Tsunoda, "L2L3 VPN Multicast MIB", draft-
              ietf-bess-l2l3-vpn-mcast-mib-06 (work in progress),
              February 2017.

   [RFC2119]  Bradner, S., "Key words for use in RFCs to Indicate
              Requirement Levels", BCP 14, RFC 2119, DOI 10.17487/
              RFC2119, March 1997,
              <http://www.rfc-editor.org/info/rfc2119>.

   [RFC2578]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
              Schoenwaelder, Ed., "Structure of Management Information
              Version 2 (SMIv2)", STD 58, RFC 2578, DOI 10.17487/
              RFC2578, April 1999,
              <http://www.rfc-editor.org/info/rfc2578>.

   [RFC2579]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
              Schoenwaelder, Ed., "Textual Conventions for SMIv2", STD
              58, RFC 2579, DOI 10.17487/RFC2579, April 1999,
              <http://www.rfc-editor.org/info/rfc2579>.

   [RFC2580]  McCloghrie, K., Ed., Perkins, D., Ed., and J.
              Schoenwaelder, Ed., "Conformance Statements for SMIv2",
              STD 58, RFC 2580, DOI 10.17487/RFC2580, April 1999,
              <http://www.rfc-editor.org/info/rfc2580>.

   [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, DOI 10.17487/
              RFC3414, December 2002,
              <http://www.rfc-editor.org/info/rfc3414>.

   [RFC3826]  Blumenthal, U., Maino, F., and K. McCloghrie, "The
              Advanced Encryption Standard (AES) Cipher Algorithm in the
              SNMP User-based Security Model", RFC 3826, DOI 10.17487/
              RFC3826, June 2004,
              <http://www.rfc-editor.org/info/rfc3826>.

Zhang, et al.           Expires September 1, 2017              [Page 33]
Internet-Draft             L3VPN Multicast MIB             February 2017

   [RFC4382]  Nadeau, T., Ed. and H. van der Linde, Ed., "MPLS/BGP Layer
              3 Virtual Private Network (VPN) Management Information
              Base", RFC 4382, DOI 10.17487/RFC4382, February 2006,
              <http://www.rfc-editor.org/info/rfc4382>.

   [RFC5132]  McWalter, D., Thaler, D., and A. Kessler, "IP Multicast
              MIB", RFC 5132, DOI 10.17487/RFC5132, December 2007,
              <http://www.rfc-editor.org/info/rfc5132>.

   [RFC5591]  Harrington, D. and W. Hardaker, "Transport Security Model
              for the Simple Network Management Protocol (SNMP)", STD
              78, RFC 5591, DOI 10.17487/RFC5591, June 2009,
              <http://www.rfc-editor.org/info/rfc5591>.

   [RFC5592]  Harrington, D., Salowey, J., and W. Hardaker, "Secure
              Shell Transport Model for the Simple Network Management
              Protocol (SNMP)", RFC 5592, DOI 10.17487/RFC5592, June
              2009, <http://www.rfc-editor.org/info/rfc5592>.

   [RFC6353]  Hardaker, W., "Transport Layer Security (TLS) Transport
              Model for the Simple Network Management Protocol (SNMP)",
              STD 78, RFC 6353, DOI 10.17487/RFC6353, July 2011,
              <http://www.rfc-editor.org/info/rfc6353>.

   [RFC6513]  Rosen, E., Ed. and R. Aggarwal, Ed., "Multicast in MPLS/
              BGP IP VPNs", RFC 6513, DOI 10.17487/RFC6513, February
              2012, <http://www.rfc-editor.org/info/rfc6513>.

   [RFC6514]  Aggarwal, R., Rosen, E., Morin, T., and Y. Rekhter, "BGP
              Encodings and Procedures for Multicast in MPLS/BGP IP
              VPNs", RFC 6514, DOI 10.17487/RFC6514, February 2012,
              <http://www.rfc-editor.org/info/rfc6514>.

   [RFC6625]  Rosen, E., Ed., Rekhter, Y., Ed., Hendrickx, W., and R.
              Qiu, "Wildcards in Multicast VPN Auto-Discovery Routes",
              RFC 6625, DOI 10.17487/RFC6625, May 2012,
              <http://www.rfc-editor.org/info/rfc6625>.

7.2.  Informative References

   [I-D.svaidya-mcast-vpn-mib]
              Vaidya, S., "Multicast in BGP/MPLS IP VPNs Management
              Information Base", draft-svaidya-mcast-vpn-mib-02 (work in
              progress), March 2005.

Zhang, et al.           Expires September 1, 2017              [Page 34]
Internet-Draft             L3VPN Multicast MIB             February 2017

   [RFC3410]  Case, J., Mundy, R., Partain, D., and B. Stewart,
              "Introduction and Applicability Statements for Internet-
              Standard Management Framework", RFC 3410, DOI 10.17487/
              RFC3410, December 2002,
              <http://www.rfc-editor.org/info/rfc3410>.

Authors' Addresses

   Zhaohui (Jeffrey) Zhang (editor)
   Juniper Networks, Inc.
   10 Technology Park Drive
   Westford, MA  01886
   USA

   Email: zzhang@juniper.net

   Saud Asif
   AT&T
   C5-3D30 200 South Laurel Avenue
   Middletown, NJ 07748
   USA

   Email: sasif@att.com

   Andy Green
   BT Design 21CN Converged Core IP & Data
   01473 629360 Adastral Park, Martlesham Heath, Ipswich IP5 3RE
   UK

   Email: andy.da.green@bt.com

   Sameer Gulrajani
   Cisco Systems
   Tasman Drive San Jose, CA  95134
   USA

   Email: sameerg@cisco.com

   Pradeep G. Jain
   Alcatel-Lucent Inc
   701 E Middlefield road Mountain view, CA 94043
   USA

   Email: pradeep.jain@alcatel-lucent.com

Zhang, et al.           Expires September 1, 2017              [Page 35]
Internet-Draft             L3VPN Multicast MIB             February 2017

   Hiroshi Tsunoda (editor)
   Tohoku Institute of Technology
   35-1, Yagiyama Kasumi-cho, Taihaku-ku
   Sendai  982-8577
   Japan

   Phone: +81-22-305-3411
   Email: tsuno@m.ieice.org

Zhang, et al.           Expires September 1, 2017              [Page 36]