Internet DRAFT - draft-sehgal-roll-rpl-mib

draft-sehgal-roll-rpl-mib






Internet Engineering Task Force                                 K. Korte
Internet-Draft                                          J. Schoenwaelder
Intended status: Standards Track                               A. Sehgal
Expires: August 26, 2013                               Jacobs University
                                                                 T. Tsou
                                               Huawei Technologies (USA)
                                                                 C. Zhou
                                                     Huawei Technologies
                                                       February 22, 2013


  Definition of Managed Objects for the IPv6 Routing Protocol for Low
                     Power and Lossy Networks (RPL)
                      draft-sehgal-roll-rpl-mib-06

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 defines objects for managing the IPv6 Routing
   Protocol for Low Power and Lossy Networks (RPL).

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 August 26, 2013.

Copyright Notice

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



Korte, et al.            Expires August 26, 2013                [Page 1]

Internet-Draft                   RPL-MIB                   February 2013


   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 . . . . . . . . . . . . . . . . . . . . . . . . .  3
   2.  The Internet-Standard Management Framework . . . . . . . . . .  3
   3.  Conventions  . . . . . . . . . . . . . . . . . . . . . . . . .  3
   4.  Overview . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
   5.  Relationship to Other MIB Modules  . . . . . . . . . . . . . .  5
   6.  Definitions  . . . . . . . . . . . . . . . . . . . . . . . . .  5
   7.  Security Considerations  . . . . . . . . . . . . . . . . . . . 29
   8.  IANA Considerations  . . . . . . . . . . . . . . . . . . . . . 30
   9.  Acknowledgements . . . . . . . . . . . . . . . . . . . . . . . 31
   10. References . . . . . . . . . . . . . . . . . . . . . . . . . . 31
     10.1.  Normative References  . . . . . . . . . . . . . . . . . . 31
     10.2.  Informative References  . . . . . . . . . . . . . . . . . 32
   Appendix A.  JSON Representation . . . . . . . . . . . . . . . . . 32






























Korte, et al.            Expires August 26, 2013                [Page 2]

Internet-Draft                   RPL-MIB                   February 2013


1.  Introduction

   This memo defines a portion of the Management Information Base (MIB)
   for use with network management protocols.  In particular it defines
   objects for managing the IPv6 Routing Protocol for Low Power and
   Lossy Networks (RPL) [RFC6550].  It also provides management access
   to the Trickle [RFC6206] parameters as they are used by RPL.

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

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

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in RFC 2119 [RFC2119].

4.  Overview

   The MIB module is organized into a group of scalars and tables.

  # RPL-MIB registration tree (generated by smidump 0.4.8)

  -rplMib(1.3.6.1.2.1.XXXX)
    +-rplNotifications(0)
    +-rplObjects(1)
       +-rplDefaults(1)
       |  +- rwn RplDISMode            rplDefaultDISMode(1)
       |  +- rwn Unsigned32            rplDefaultDISMessages(2)
       |  +- rwn Unsigned32            rplDefaultDISTimeout(3)
       |  +- rwn RplDAODelay           rplDefaultDAODelay(4)
       |  +- rwn TruthValue            rplDefaultDAOAckEnabled(5)
       |  +- rwn RplDodagPreference    rplDefaultPreference(6)
       |  +- rwn RplMinHopRankIncrease rplDefaultMinHopRankIncrease(7)
       |  +- rwn Unsigned32            rplDefaultMaxRankIncrease(8)
       |  +- rwn RplModeOfOperation    rplDefaultModeOfOperation(9)



Korte, et al.            Expires August 26, 2013                [Page 3]

Internet-Draft                   RPL-MIB                   February 2013


       |  +- rwn Unsigned32            rplDefaultIntervalDoublings(10)
       |  +- rwn Unsigned32            rplDefaultIntervalMin(11)
       |  +- rwn Unsigned32            rplDefaultRedundancyConstant(12)
       +-rplActive(2)
       |  +- rwn RplInstanceID   rplActiveInstance(1)
       |  +- rwn InetAddressIPv6 rplActiveDodag(2)
       |  +- rwn Unsigned32      rplActiveDodagTriggerSequence(3)
       +-rplOCPTable(3)
       |  +-rplOCPEntry(1) [rplOCPCodepoint]
       |     +- --- RplObjectiveCodePoint rplOCPCodepoint(1)
       |     +- rwn TruthValue            rplOCPEnabled(2)
       +-rplInstanceTable(4)
       |  +-rplInstanceEntry(1) [rplInstanceID]
       |     +- --- RplInstanceID         rplInstanceID(1)
       |     +- r-n RplDISMode            rplInstanceDISMode(2)
       |     +- r-n Unsigned32            rplInstanceDISMessages(3)
       |     +- r-n Unsigned32            rplInstanceDISTimeout(4)
       |     +- r-n RplModeOfOperation    rplInstanceModeOfOperation(5)
       +-rplDodagTable(5)
       |  +-rplDodagEntry(1) [rplInstanceID,rplDodagIndex]
       |     +- --- Unsigned32            rplDodagIndex(1)
       |     +- --- InetAddressIPv6       rplDodagRoot(2)
       |     +- r-n RplDodagVersionNumber rplDodagVersion(3)
       |     +- r-n RplRank               rplDodagRank(4)
       |     +- r-n Enumeration           rplDodagState(5)
       |     +- r-n RplObjectiveCodePoint rplDodagOCP(6)
       |     +- r-n RplDAODelay           rplDodagDAODelay(7)
       |     +- r-n TruthValue            rplDodagDAOAckEnabled(8)
       |     +- r-n RplDodagPreference    rplDodagPreference(9)
       |     +- r-n RplMinHopRankIncrease rplDodagMinHopRankIncrease(10)
       |     +- r-n Unsigned32            rplDodagMaxRankIncrease(11)
       |     +- r-n Unsigned32            rplDodagIntervalDoublings(12)
       |     +- r-n Unsigned32            rplDodagIntervalMin(13)
       |     +- r-n Unsigned32            rplDodagRedundancyConstant(14)
       |     +- r-n RplPathControlSize    rplDodagPathControlSize(15)
       +-rplDodagParentTable(6)
       |  +-rplDodagParentEntry(1) [rplInstanceID,rplDodagIndex,
       |     |                       rplDodagParentID]
       |     +- --- InetAddressIPv6 rplDodagParentID(1)
       |     +- r-n InterfaceIndex  rplDodagParentIf(2)
       +-rplDodagChildTable(7)
       |  +-rplDodagChildEntry(1) [rplInstanceID,rplDodagIndex,
       |     |                      rplDodagChildID]
       |     +- --- InetAddressIPv6 rplDodagChildID(1)
       |     +- r-n InterfaceIndex  rplDodagChildIf(2)
       +-rplStats(8)
       |  +- r-n Counter32 rplMemOverflows(1)
       |  +- r-n Counter32 rplParseErrors(2)



Korte, et al.            Expires August 26, 2013                [Page 4]

Internet-Draft                   RPL-MIB                   February 2013


       |  +- r-n Counter32 rplUnknownMsgTypes(3)
       |  +- r-n Counter32 rplSecurityPolicyViolations(4)
       |  +- r-n Counter32 rplIntegrityCheckFailures(5)
       |  +- r-n Counter32 rplReplayProtectionFailures(6)
       |  +- r-n Counter32 rplValidParentFailures(7)
       |  +- r-n Counter32 rplNoInstanceIDs(8)
       |  +- r-n Counter32 rplTriggeredLocalRepairs(9)
       |  +- r-n Counter32 rplTriggeredGlobalRepairs(10)
       |  +- r-n Counter32 rplNoParentSecs(11)
       |  +- r-n Counter32 rplActiveNoParentSecs(12)
       |  +- r-n Counter32 rplOBitSetDownwards(13)
       |  +- r-n Counter32 rplOBitClearedUpwards(14)
       |  +- r-n Counter32 rplFBitSet(15)
       |  +- r-n Counter32 rplRBitSet(16)
       |  +- r-n Counter32 rplTrickleTimerResets(17)
       +-rplMsgStatsTable(9)
          +-rplMsgStatsEntry(1) [rplMsgStatsType]
             +- --- RplMessageType rplMsgStatsType(1)
             +- r-n Counter32      rplMsgStatsInMsgs(2)
             +- r-n Counter32      rplMsgStatsOutMsgs(3)

5.  Relationship to Other MIB Modules

   The MIB module IMPORTS definitions from SNMPv2-SMI [RFC2578],
   SNMPv2-TC [RFC2579], SNMPv2-CONF [RFC2580], IF-MIB [RFC2863] and the
   INET-ADDRESS-MIB [RFC4001].

   The IPv6 routing table SHOULD be exposed via the inetCidrRouteTable
   defined in the IP-FORWARD-MIB [RFC4292].  Since an RPL node can
   participate in multiple RPL instances, the inetCidrRoutePolicy object
   SHOULD carry the OID of the rplInstanceID instance, including the
   value of rplInstanceID.

   The prefixes used by DODAGs SHOULD be exported via the
   ipAddressPrefixTable of the IP-MIB [RFC4293].  The value of
   ipAddressPrefixOrigin should be routeradv(5).

6.  Definitions

RPL-MIB DEFINITIONS ::= BEGIN

IMPORTS
    MODULE-IDENTITY, OBJECT-TYPE, Unsigned32, Counter32, mib-2
        FROM SNMPv2-SMI                                 -- RFC 2578
    TEXTUAL-CONVENTION, TruthValue
        FROM SNMPv2-TC                                  -- RFC 2579
    OBJECT-GROUP, MODULE-COMPLIANCE
        FROM SNMPv2-CONF                                -- RFC 2580



Korte, et al.            Expires August 26, 2013                [Page 5]

Internet-Draft                   RPL-MIB                   February 2013


    InterfaceIndex
        FROM IF-MIB                                     -- RFC 2863
    InetAddressIPv6
        FROM INET-ADDRESS-MIB;                          -- RFC 4001

rplMib MODULE-IDENTITY
    LAST-UPDATED "201302200000Z"
    ORGANIZATION
        "Jacobs University Bremen"
    CONTACT-INFO
        "Kevin Dominik Korte
         Jacobs University Bremen
         Email: k.korte@jacobs-university.de

         Anuj Sehgal
         Jacobs University Bremen
         Email: s.anuj@jacobs-university.de

         Juergen Schoenwaelder
         Jacobs University Bremen
         Email: j.schoenwaelder@jacobs-university.de

         Tina Tsou
         Huawei Technologies
         Email: tina.tsou.zouting@huawei.com

         Cathy Zhou
         Huawei Technologies
         Email: cathyzhou@huawei.com"
    DESCRIPTION
        "The MIB module for monitoring nodes implementing the IPv6
         routing protocol for low power and lossy networks (RPL).

         Copyright (c) 2013 IETF Trust and the persons identified as
         authors of the code.  All rights reserved.

         Redistribution and use in source and binary forms, with or
         without modification, is permitted pursuant to, and subject
         to the license terms contained in, the Simplified BSD
         License set forth in Section 4.c of the IETF Trust's
         Legal Provisions Relating to IETF Documents
         (http://trustee.ietf.org/license-info)."

    REVISION "201302200000Z"
    DESCRIPTION
        "Initial version, published as RFC XXXX."
    -- RFC Ed.: replace XXXX with actual RFC number & remove this note




Korte, et al.            Expires August 26, 2013                [Page 6]

Internet-Draft                   RPL-MIB                   February 2013


    ::= { mib-2 XXXX }

RplMessageType ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The type of an RPL control message as defined in Section
         6 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..255)

RplInstanceID ::=  TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "A global or local RPLInstanceID as defined in Section 5.1
         of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..255)

RplDodagVersionNumber ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The version number of a DODAG as defined in Section 6.3 of
         RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..255)

RplRank ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The rank of a node within a DODAG as defined in Section 6.3
         of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..65535)

RplObjectiveCodePoint ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The Objective Code Point of a DODAG as defined in
         Section 6.7.6 of RFC 6550."



Korte, et al.            Expires August 26, 2013                [Page 7]

Internet-Draft                   RPL-MIB                   February 2013


    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..65535)

RplDISMode ::= TEXTUAL-CONVENTION
    STATUS      current
    DESCRIPTION
        "Determines whether a DIS message is send upon boot-up
         or not as defined in Section 18.2.1.1 of RFC 6550:

         silent(1)  do not send DIS messages
         send(2)    send DIS messages"
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      INTEGER {
                    silent(1),
                    send(2)
                }

RplModeOfOperation ::= TEXTUAL-CONVENTION
    STATUS      current
    DESCRIPTION
        "The mode of operation of an RPL instance as defined in
         Section 6.3.1 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      INTEGER {
                    noDownwardRoutes(0),
                    nonStoringMode(1),
                    storingWithoutMulticastSupport(2),
                    storingWithMulticastSupport(3)
                }

RplDAODelay ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The delay time used for aggregation before a DAO message
         is send."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32

RplDodagPreference ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The preference of a DODAG compared to another DODAG of the



Korte, et al.            Expires August 26, 2013                [Page 8]

Internet-Draft                   RPL-MIB                   February 2013


         same instance as defined in Section 6.3 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..7)

RplMinHopRankIncrease ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The minimal increase of a rank within a single hop as
         defined in Section 6.7.6 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..131071)

RplPathControlSize ::= TEXTUAL-CONVENTION
    DISPLAY-HINT "d"
    STATUS      current
    DESCRIPTION
        "The Path Control Size within a DODAG as defined in
         Section 6.7.6 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    SYNTAX      Unsigned32 (0..7)

-- object definitions

rplNotifications OBJECT IDENTIFIER ::= { rplMib 0 }
rplObjects       OBJECT IDENTIFIER ::= { rplMib 1 }
rplConformance   OBJECT IDENTIFIER ::= { rplMib 2 }

rplDefaults OBJECT IDENTIFIER ::= { rplObjects 1 }

rplDefaultDISMode OBJECT-TYPE
    SYNTAX      RplDISMode
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "Determines whether a DIS message is send upon boot-up.
         Changes to this value may not persist across restarts."
    ::= { rplDefaults 1 }

rplDefaultDISMessages OBJECT-TYPE
    SYNTAX      Unsigned32 (1..255)
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The number of DIS messages that are sent as an initial



Korte, et al.            Expires August 26, 2013                [Page 9]

Internet-Draft                   RPL-MIB                   February 2013


         probe for nearby DODAGs if the DIS mode is 'send'. The
         value of this object is ignored if the DIS mode is
         'silent'. Changes to this value may not persist across
         restarts."
    DEFVAL      { 1 }
    ::= { rplDefaults 2 }

rplDefaultDISTimeout OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    UNITS       "seconds"
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The number of seconds after which a node in DIS mode 'send'
         in the absence of DIO messages may decide to root a
         floating DODAG. Changes to this value may not persist
         across restarts."
    DEFVAL      { 60 }
    ::= { rplDefaults 3 }

rplDefaultDAODelay OBJECT-TYPE
    SYNTAX      RplDAODelay
    UNITS       "milliseconds"
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default delay for aggregations before a DAO is send.
         Changes to this value may not persist across restarts."
    DEFVAL      { 1000 }
    ::= { rplDefaults 4 }

rplDefaultDAOAckEnabled OBJECT-TYPE
    SYNTAX      TruthValue
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "Indicates whether DAO Acknowledgements are sent on this
         RPL instance. Changes to this value may not persist
         across restarts."
    DEFVAL      { false }
    ::= { rplDefaults 5 }

rplDefaultPreference OBJECT-TYPE
    SYNTAX      RplDodagPreference
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default preference of this DODAG compared to other



Korte, et al.            Expires August 26, 2013               [Page 10]

Internet-Draft                   RPL-MIB                   February 2013


         DODAGs within the same instance. Changes to this value
         may not persist across restarts."
    DEFVAL      { 0 }
    ::= { rplDefaults 6 }

rplDefaultMinHopRankIncrease OBJECT-TYPE
    SYNTAX      RplMinHopRankIncrease
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default minimum increase of the rank in a single hop.
         Changes to this value may not persist across restarts."
    DEFVAL      { 256 }
    ::= { rplDefaults 7 }

rplDefaultMaxRankIncrease OBJECT-TYPE
    SYNTAX      Unsigned32 (0..65535)
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default maximum allowable increase in rank in support
         of local repair.  If DAGMaxRankIncrease is 0 then this
         mechanism is disabled. Changes to this value may not
         persist across restarts."
    DEFVAL      { 65535 }
    ::= { rplDefaults 8 }

rplDefaultModeOfOperation OBJECT-TYPE
    SYNTAX      RplModeOfOperation
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The mode of operation of the RPL instance. Changes to this
         value may not persist across restarts."
    DEFVAL      { storingWithoutMulticastSupport }
    ::= { rplDefaults 9 }

rplDefaultIntervalDoublings OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default Imax parameter of the DIO trickle timer. Changes
         to this value may not persist across restarts."
    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    DEFVAL      { 20 }
    ::= { rplDefaults 10 }



Korte, et al.            Expires August 26, 2013               [Page 11]

Internet-Draft                   RPL-MIB                   February 2013


rplDefaultIntervalMin OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default Imin parameter of the DIO trickle timer. Changes
         to this value may not persist across restarts."
    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    DEFVAL      { 3 }
    ::= { rplDefaults 11 }

rplDefaultRedundancyConstant OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The default k parameter of the DIO trickle timer. Changes to
         this value may not persist across restarts."
    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    DEFVAL      { 10 }
    ::= { rplDefaults 12 }

rplActive OBJECT IDENTIFIER ::= { rplObjects 2 }

rplActiveInstance OBJECT-TYPE
    SYNTAX       RplInstanceID
    MAX-ACCESS   read-write
    STATUS       current
    DESCRIPTION
        "The currently active RPL Instance. Changes to this value
         may not persist across restarts."
    ::= { rplActive 1 }

rplActiveDodag OBJECT-TYPE
    SYNTAX      InetAddressIPv6
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "The currently active RPL DODAG in the active RPL Instance.
         Changes to this value may not persist across restarts."
    ::= { rplActive 2 }

rplActiveDodagTriggerSequence OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-write
    STATUS      current



Korte, et al.            Expires August 26, 2013               [Page 12]

Internet-Draft                   RPL-MIB                   February 2013


    DESCRIPTION
        "The DAO Trigger Sequence Number (DTSN) of the active
         DODAG as defined in Section 6.3.1 of RFC 6550. Changes to
         this value may not persist across restarts."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplActive 3 }

rplOCPTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF RplOCPEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The table of all supported Objective Code Points (OCPs)."
    ::= { rplObjects 3 }

rplOCPEntry OBJECT-TYPE
    SYNTAX      RplOCPEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "An entry representing a supported Objective Code Point."
    INDEX { rplOCPCodepoint }
    ::= { rplOCPTable 1 }

RplOCPEntry ::= SEQUENCE {
    rplOCPCodepoint  RplObjectiveCodePoint,
    rplOCPEnabled    TruthValue
}

rplOCPCodepoint OBJECT-TYPE
    SYNTAX      RplObjectiveCodePoint
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "A supported Objective Code Point."
    ::= { rplOCPEntry 1 }

rplOCPEnabled OBJECT-TYPE
    SYNTAX      TruthValue
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
        "Enables the usage of this Objective Code Point. Changes to
         this value may not persist across restarts."
    ::= { rplOCPEntry 2 }

rplInstanceTable OBJECT-TYPE



Korte, et al.            Expires August 26, 2013               [Page 13]

Internet-Draft                   RPL-MIB                   February 2013


    SYNTAX      SEQUENCE OF RplInstanceEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The table represents information about all known
         RPL Instances."
    ::= { rplObjects 4 }

rplInstanceEntry OBJECT-TYPE
    SYNTAX      RplInstanceEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "An entry representing information about a RPL Instance."
    INDEX { rplInstanceID }
    ::= { rplInstanceTable 1 }

RplInstanceEntry ::= SEQUENCE {
    rplInstanceID               RplInstanceID,
    rplInstanceDISMode          RplDISMode,
    rplInstanceDISMessages      Unsigned32,
    rplInstanceDISTimeout       Unsigned32,
    rplInstanceModeOfOperation  RplModeOfOperation
}

rplInstanceID OBJECT-TYPE
    SYNTAX      RplInstanceID
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The InstanceID of this RPL Instance."
    ::= { rplInstanceEntry 1 }

rplInstanceDISMode OBJECT-TYPE
    SYNTAX      RplDISMode
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Reports whether a DIS message is send for this instance
         upon boot-up."
    ::= { rplInstanceEntry 2 }

rplInstanceDISMessages OBJECT-TYPE
    SYNTAX      Unsigned32 (1..255)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of DIS messages that are sent as an initial



Korte, et al.            Expires August 26, 2013               [Page 14]

Internet-Draft                   RPL-MIB                   February 2013


         probe for nearby DODAGs if the DIS mode is 'send'."
    ::= { rplInstanceEntry 3 }

rplInstanceDISTimeout OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    UNITS       "seconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of seconds after which a node in DIS mode 'send'
         in the absence of DIO messages may decide to root a
         floating DODAG."
    ::= { rplInstanceEntry 4 }

rplInstanceModeOfOperation OBJECT-TYPE
    SYNTAX      RplModeOfOperation
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The mode of operation of the RPL instance."
    ::= { rplInstanceEntry 5 }

rplDodagTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF RplDodagEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The table represents information about all locally known
         DODAGs."
    ::= { rplObjects 5 }

rplDodagEntry OBJECT-TYPE
    SYNTAX      RplDodagEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "An entry representing information about a DODAG."
    INDEX { rplInstanceID, rplDodagIndex }
    ::= { rplDodagTable 1 }

RplDodagEntry ::= SEQUENCE {
    rplDodagIndex               Unsigned32,
    rplDodagID                  InetAddressIPv6,
    rplDodagVersion             RplDodagVersionNumber,
    rplDodagRank                RplRank,
    rplDodagState               INTEGER,
    rplDodagOCP                 RplObjectiveCodePoint,
    rplDodagDAODelay            RplDAODelay,



Korte, et al.            Expires August 26, 2013               [Page 15]

Internet-Draft                   RPL-MIB                   February 2013


    rplDodagDAOAckEnabled       TruthValue,
    rplDodagPreference          RplDodagPreference,
    rplDodagMinHopRankIncrease  RplMinHopRankIncrease,
    rplDodagMaxRankIncrease     Unsigned32,
    rplDodagIntervalDoublings   Unsigned32,
    rplDodagIntervalMin         Unsigned32,
    rplDodagRedundancyConstant  Unsigned32,
    rplDodagPathControlSize     RplPathControlSize
}

rplDodagIndex OBJECT-TYPE
    SYNTAX      Unsigned32 (1..4294967295)
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The index identifying a DODAG within an RPL instance. This
         index is used to keep the table indexes short. The RPL protocol
         identifies a DODAG within an RPL instance by the DODAGID."
    ::= { rplDodagEntry 1 }

rplDodagID OBJECT-TYPE
    SYNTAX      InetAddressIPv6
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The identifier of a DODAG root (DODAGID) of this RPL
         instance. The root of the DODAG reports its own IPv6
         address as the DODAG root. This is uniquely identifying
         a DODAG within an RPL instance."
    ::= { rplDodagEntry 2 }

rplDodagVersion OBJECT-TYPE
    SYNTAX      RplDodagVersionNumber
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The version of the DODAG in this RPL instance."
    ::= { rplDodagEntry 3 }

rplDodagRank OBJECT-TYPE
    SYNTAX      RplRank
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The rank of the node within the DODAG."
    ::= { rplDodagEntry 4 }

rplDodagState OBJECT-TYPE



Korte, et al.            Expires August 26, 2013               [Page 16]

Internet-Draft                   RPL-MIB                   February 2013


    SYNTAX      INTEGER {
                    other(0),
                    grounded(1),
                    floating(2)
                }
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The status of the DODAG:

         other(0)      An unknown state.

         grounded(1)   The DODAG is grounded.

         floating(2)   The DODAG is floating (not grounded)."
    ::= { rplDodagEntry 5 }

rplDodagOCP OBJECT-TYPE
    SYNTAX      RplObjectiveCodePoint
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The Objective Code Point of this DODAG."
    ::= { rplDodagEntry 6 }

rplDodagDAODelay OBJECT-TYPE
    SYNTAX      RplDAODelay
    UNITS       "milliseconds"
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The delay for aggregations before a DAO is send."
    ::= { rplDodagEntry 7 }

rplDodagDAOAckEnabled OBJECT-TYPE
    SYNTAX      TruthValue
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Indicates whether DAO Acknowledgements are sent on this
         DODAG."
    ::= { rplDodagEntry 8 }

rplDodagPreference OBJECT-TYPE
    SYNTAX      RplDodagPreference
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION



Korte, et al.            Expires August 26, 2013               [Page 17]

Internet-Draft                   RPL-MIB                   February 2013


        "How preferred this DODAG is compared to other DODAGs
         within the same instance."
    ::= { rplDodagEntry 9 }

rplDodagMinHopRankIncrease OBJECT-TYPE
    SYNTAX      RplMinHopRankIncrease
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The minimum increase of the rank in a single hop."
    ::= { rplDodagEntry 10 }

rplDodagMaxRankIncrease OBJECT-TYPE
    SYNTAX      Unsigned32 (0..65535)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
         "The maximum allowable increase in rank in support of local
          repair.  If DAGMaxRankIncrease is 0 then this mechanism is
          disabled."
    ::= { rplDodagEntry 11 }

rplDodagIntervalDoublings OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The Imax parameter of the DIO trickle timer."
    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    ::= { rplDodagEntry 12 }

rplDodagIntervalMin OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The Imin parameter of the DIO trickle timer."
    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    ::= { rplDodagEntry 13 }

rplDodagRedundancyConstant OBJECT-TYPE
    SYNTAX      Unsigned32 (0..255)
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The k parameter of the DIO trickle timer."



Korte, et al.            Expires August 26, 2013               [Page 18]

Internet-Draft                   RPL-MIB                   February 2013


    REFERENCE
        "RFC 6206: The Trickle Algorithm"
    ::= { rplDodagEntry 14 }

rplDodagPathControlSize OBJECT-TYPE
    SYNTAX      RplPathControlSize
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The Path Control Size of this DODAG."
    ::= { rplDodagEntry 15 }

rplDodagParentTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF RplDodagParentEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The list of parents of a DODAG."
    ::= { rplObjects 6 }

rplDodagParentEntry OBJECT-TYPE
    SYNTAX      RplDodagParentEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "Information about a known DODAG parent."
    INDEX { rplInstanceID, rplDodagIndex, rplDodagParentID }
    ::= { rplDodagParentTable 1 }

RplDodagParentEntry ::= SEQUENCE {
    rplDodagParentID     InetAddressIPv6,
    rplDodagParentIf     InterfaceIndex
}

rplDodagParentID OBJECT-TYPE
    SYNTAX      InetAddressIPv6
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The address of a parent associated with this DODAG."
    ::= { rplDodagParentEntry 1 }

rplDodagParentIf OBJECT-TYPE
    SYNTAX      InterfaceIndex
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The interface over which the parent can be reached."



Korte, et al.            Expires August 26, 2013               [Page 19]

Internet-Draft                   RPL-MIB                   February 2013


    ::= { rplDodagParentEntry 2 }

rplDodagChildTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF RplDodagChildEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The list of children of a DODAG."
    ::= { rplObjects 7 }

rplDodagChildEntry OBJECT-TYPE
    SYNTAX      RplDodagChildEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "Information about a known DODAG child."
    INDEX { rplInstanceID, rplDodagIndex, rplDodagChildID }
    ::= { rplDodagChildTable 1 }

RplDodagChildEntry ::= SEQUENCE {
    rplDodagChildID     InetAddressIPv6,
    rplDodagChildIf     InterfaceIndex
}

rplDodagChildID OBJECT-TYPE
    SYNTAX      InetAddressIPv6
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The address of an RPL child associated with this DODAG."
    ::= { rplDodagChildEntry 1 }

rplDodagChildIf OBJECT-TYPE
    SYNTAX      InterfaceIndex
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The interface over which the child can be reached."
    ::= { rplDodagChildEntry 2 }

rplStats OBJECT IDENTIFIER ::= { rplObjects 8 }

rplMemOverflows OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of memory allocation failures (e.g., routing table



Korte, et al.            Expires August 26, 2013               [Page 20]

Internet-Draft                   RPL-MIB                   February 2013


         overflows)."
    ::= { rplStats 1 }

rplParseErrors OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of received malformed messages."
    ::= { rplStats 2 }

rplUnknownMsgTypes OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of received RPL messages that we dropped because
         the message type is not recognized by the implementation."
    ::= { rplStats 3 }

rplSecurityPolicyViolations OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of messages discarded because the described level
         of security for the message type and originator is unknown or
         does not meet locally maintained security policies as defined
         in Section 10.7 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 4 }

rplIntegrityCheckFailures OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of messages discarded because the integrity
         check failed against the received message authentication
         code (MAC) as defined in Section 10.7 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 5 }

rplReplayProtectionFailures OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only



Korte, et al.            Expires August 26, 2013               [Page 21]

Internet-Draft                   RPL-MIB                   February 2013


    STATUS      current
    DESCRIPTION
        "The number of messages discarded because the received
         message Counter value is non-zero and less than the
         maintained incoming Counter watermark or because the
         received Timestamp Counter value indicates a message
         transmission time that is earlier than the Current time
         less the acceptable packet delay as defined in Section
         10.7 of RFC 6550. This counter is also incremented if the
         temporal consistency check of the message fails as defined
         in Section 10.7.1."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 6 }

rplValidParentFailures OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times a packet could not be sent to a DODAG
         parent flagged as valid."
    ::= { rplStats 7 }

rplNoInstanceIDs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times a packet could not be sent because of
         a missing RPLInstanceID."
    ::= { rplStats 8 }

rplTriggeredLocalRepairs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times a local repair procedure was triggered."
    ::= { rplStats 9 }

rplTriggeredGlobalRepairs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of times a global repair procedure was triggered."
    ::= { rplStats 10 }



Korte, et al.            Expires August 26, 2013               [Page 22]

Internet-Draft                   RPL-MIB                   February 2013


rplNoParentSecs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of seconds without a next hop (DODAG parent)."
    ::= { rplStats 11 }

rplActiveNoParentSecs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of seconds with packets to forward without a
         next hop (DODAG parent)."
    ::= { rplStats 12 }

rplOBitSetDownwards OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Number of packets received with the 'O' bit set from
         a node with a higher rank as defined in Section 18.3.2
         of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 13 }

rplOBitClearedUpwards OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Number of packets received with the 'O' bit cleared
         from a node with a lower rank as defined in Section 18.3.2
         of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 14 }

rplFBitSet OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Number of packets received with the 'F' bit set as
         defined in Section 18.3.2 of RFC 6550."



Korte, et al.            Expires August 26, 2013               [Page 23]

Internet-Draft                   RPL-MIB                   February 2013


    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 15 }

rplRBitSet OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "Number of packets received with the 'R' bit set as
         defined in Section 18.3.2 of RFC 6550."
    REFERENCE
        "RFC 6550: RPL: IPv6 Routing Protocol for LLNs"
    ::= { rplStats 16 }

rplTrickleTimerResets OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of trickle timer resets."
    ::= { rplStats 17 }

rplMsgStatsTable OBJECT-TYPE
    SYNTAX      SEQUENCE OF RplMsgStatsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "Basic RPL message statistics by message type."
    ::= { rplObjects 9 }

rplMsgStatsEntry OBJECT-TYPE
    SYNTAX      RplMsgStatsEntry
    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "Statistics for a specific RPL message type."
    INDEX { rplMsgStatsType }
    ::= { rplMsgStatsTable 1 }

RplMsgStatsEntry ::= SEQUENCE {
    rplMsgStatsType    RplMessageType,
    rplMsgStatsInMsgs  Counter32,
    rplMsgStatsOutMsgs Counter32
}

rplMsgStatsType OBJECT-TYPE
    SYNTAX      RplMessageType



Korte, et al.            Expires August 26, 2013               [Page 24]

Internet-Draft                   RPL-MIB                   February 2013


    MAX-ACCESS  not-accessible
    STATUS      current
    DESCRIPTION
        "The RPL message type being counted by this row."
    ::= { rplMsgStatsEntry 1 }

rplMsgStatsInMsgs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of RPL messages received of this type."
    ::= { rplMsgStatsEntry 2 }

rplMsgStatsOutMsgs OBJECT-TYPE
    SYNTAX      Counter32
    MAX-ACCESS  read-only
    STATUS      current
    DESCRIPTION
        "The number of RPL messages sent of this type."
    ::= { rplMsgStatsEntry 3 }

-- conformance definitions

rplGroups      OBJECT IDENTIFIER ::= { rplConformance 1 }
rplCompliances OBJECT IDENTIFIER ::= { rplConformance 2 }

rplFullCompliance MODULE-COMPLIANCE
    STATUS      current
    DESCRIPTION
        "Compliance statement for implementations supporting
         read/write access, according to the object definitions."
    MODULE      -- this module
    MANDATORY-GROUPS {
        rplGeneralGroup,
        rplInstanceGroup,
        rplStatsGroup
    }
    ::= { rplCompliances 1 }

rplReadOnlyCompliance MODULE-COMPLIANCE
    STATUS      current
    DESCRIPTION
        "Compliance statement for implementations supporting
         only readonly access."
    MODULE      -- this module
    MANDATORY-GROUPS {
        rplGeneralGroup,



Korte, et al.            Expires August 26, 2013               [Page 25]

Internet-Draft                   RPL-MIB                   February 2013


        rplInstanceGroup,
        rplStatsGroup
    }

    OBJECT rplDefaultDISMode
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultDISMessages
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultDISTimeout
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultDAODelay
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultDAOAckEnabled
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultPreference
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultMinHopRankIncrease
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultMaxRankIncrease
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultModeOfOperation
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."



Korte, et al.            Expires August 26, 2013               [Page 26]

Internet-Draft                   RPL-MIB                   February 2013


    OBJECT rplDefaultIntervalDoublings
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultIntervalMin
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplDefaultRedundancyConstant
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplActiveInstance
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplActiveDodag
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplActiveDodagTriggerSequence
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    OBJECT rplOCPEnabled
    MIN-ACCESS  read-only
    DESCRIPTION
        "Write access is not required."

    ::= { rplCompliances 2 }

rplGeneralGroup OBJECT-GROUP
    OBJECTS {
        rplDefaultDISMode,
        rplDefaultDISMessages,
        rplDefaultDISTimeout,
        rplDefaultDAODelay,
        rplDefaultDAOAckEnabled,
        rplDefaultPreference,
        rplDefaultMinHopRankIncrease,
        rplDefaultMaxRankIncrease,
        rplDefaultModeOfOperation,



Korte, et al.            Expires August 26, 2013               [Page 27]

Internet-Draft                   RPL-MIB                   February 2013


        rplDefaultIntervalDoublings,
        rplDefaultIntervalMin,
        rplDefaultRedundancyConstant,
        rplActiveInstance,
        rplActiveDodag,
        rplActiveDodagTriggerSequence,
        -- rplOCPCodepoint,
        rplOCPEnabled
    }
    STATUS      current
    DESCRIPTION
        "A collection of objects providing general information about
         the RPL implementation."
    ::= { rplGroups 1 }

rplInstanceGroup OBJECT-GROUP
    OBJECTS {
        -- rplInstanceID,
        rplInstanceDISMode,
        rplInstanceDISMessages,
        rplInstanceDISTimeout,
        rplInstanceModeOfOperation,
        -- rplDodagIndex,
        rplDodagID,
        rplDodagVersion,
        rplDodagRank,
        rplDodagState,
        rplDodagOCP,
        rplDodagDAODelay,
        rplDodagDAOAckEnabled,
        rplDodagPreference,
        rplDodagMinHopRankIncrease,
        rplDodagMaxRankIncrease,
        rplDodagIntervalDoublings,
        rplDodagIntervalMin,
        rplDodagRedundancyConstant,
        rplDodagPathControlSize,
        -- rplDodagParentID,
        rplDodagParentIf,
        -- rplDodagChildID,
        rplDodagChildIf
    }
    STATUS      current
    DESCRIPTION
        "A collection of objects providing insight into RPL
         Instances and RPL DODAGs."
    ::= { rplGroups 2 }




Korte, et al.            Expires August 26, 2013               [Page 28]

Internet-Draft                   RPL-MIB                   February 2013


rplStatsGroup OBJECT-GROUP
    OBJECTS {
        rplMemOverflows,
        rplParseErrors,
        rplUnknownMsgTypes,
        rplSecurityPolicyViolations,
        rplIntegrityCheckFailures,
        rplReplayProtectionFailures,
        rplValidParentFailures,
        rplNoInstanceIDs,
        rplTriggeredLocalRepairs,
        rplTriggeredGlobalRepairs,
        rplNoParentSecs,
        rplActiveNoParentSecs,
        rplOBitSetDownwards,
        rplOBitClearedUpwards,
        rplFBitSet,
        rplRBitSet,
        rplTrickleTimerResets,
        -- rplMsgStatsType,
        rplMsgStatsInMsgs,
        rplMsgStatsOutMsgs
    }
    STATUS      current
    DESCRIPTION
        "A collection of objects providing statistics about the
         RPL implementation."
    ::= { rplGroups 3 }

END

7.  Security Considerations

   There are a number of management objects defined in this MIB module
   with a MAX-ACCESS clause of read-write and/or read-create.  Such
   objects may be considered sensitive or vulnerable in some network
   environments.  The support for SET operations in a non-secure
   environment without proper protection can have a negative effect on
   network operations.  These are the tables and objects and their
   sensitivity/vulnerability:

   o  The objects below rplDefaults control the operation of RPL.
      Unauthorized access to these objects can either make RPL
      inefficient or even fail to converge.

   o  The objects below rplActive select the currently active RPL DODAG
      in the currently active RPL Instance.  Unauthorized changes may
      prevent communication or cause loss of efficiency.



Korte, et al.            Expires August 26, 2013               [Page 29]

Internet-Draft                   RPL-MIB                   February 2013


   o  The rplOCPTable controls which objective functions can be used by
      an RPL implementation.  Unauthorized access may prevent certain
      RPL instances to be established or less it may cause less
      efficient RPL instances to be used.

   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 tables and objects provide detailed
   information about the structure and operation of RPL instances and
   the topology of the DODAGs.  This information may be exploited to
   target attacks or to gain insights about the structure of a certain
   deployment.

   The counters of the RPL-MIB are provided primarily to assist in
   troubleshooting problems in RPL deployments.  The counters, however,
   may also be used to gain insights into certain active attacks on RPL
   itself.

   SNMP versions prior to SNMPv3 did not include adequate security.
   Even if the network itself is secure (for example by using IPsec),
   even then, there is no control as to who on the secure network is
   allowed to access and GET/SET (read/change/create/delete) the objects
   in this MIB module.

   It is RECOMMENDED that implementers consider the security features as
   provided by the SNMPv3 framework (see [RFC3410], section 8),
   including full support for the SNMPv3 cryptographic mechanisms (for
   authentication and privacy).

   Further, deployment of SNMP versions prior to SNMPv3 is NOT
   RECOMMENDED.  Instead, it is RECOMMENDED to deploy SNMPv3 and to
   enable cryptographic security.  It is then a customer/operator
   responsibility to ensure that the SNMP entity giving access to an
   instance of this MIB module is properly configured to give access to
   the objects only to those principals (users) that have legitimate
   rights to indeed GET or SET (change/create/delete) them.

8.  IANA Considerations

   IANA is requested to assign a value for "XXXX" 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
   "XXXX" (here and in the MIB module) with the assigned value and to
   remove this note.




Korte, et al.            Expires August 26, 2013               [Page 30]

Internet-Draft                   RPL-MIB                   February 2013


   IANA has allocated a number for RPL in the IANAipRouteProtocol
   textual convention of the IANA-RTPROTO-MIB.

9.  Acknowledgements

   The authors like to thank Michael Richardson for providing helpful
   comments during the development of this specification.

   Juergen Schoenwaelder and Anuj Sehgal were partly funded by Flamingo,
   a Network of Excellence project (ICT-318488) supported by the
   European Commission under its Seventh Framework Programme.

10.  References

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

   [RFC2863]                      McCloghrie, K. and F. Kastenholz, "The
                                  Interfaces Group MIB", RFC 2863,
                                  June 2000.

   [RFC4001]                      Daniele, M., Haberman, B., Routhier,
                                  S., and J. Schoenwaelder, "Textual
                                  Conventions for Internet Network
                                  Addresses", RFC 4001, February 2005.

   [RFC4292]                      Haberman, B., "IP Forwarding Table
                                  MIB", RFC 4292, April 2006.




Korte, et al.            Expires August 26, 2013               [Page 31]

Internet-Draft                   RPL-MIB                   February 2013


   [RFC4293]                      Routhier, S., "Management Information
                                  Base for the Internet Protocol (IP)",
                                  RFC 4293, April 2006.

   [RFC6206]                      Levis, P., Clausen, T., Hui, J.,
                                  Gnawali, O., and J. Ko, "The Trickle
                                  Algorithm", RFC 6206, March 2011.

   [RFC6550]                      Winter, T., Thubert, P., Brandt, A.,
                                  Hui, J., Kelsey, R., Levis, P.,
                                  Pister, K., Struik, R., Vasseur, JP.,
                                  and R. Alexander, "RPL: IPv6 Routing
                                  Protocol for Low-Power and Lossy
                                  Networks", RFC 6550, March 2012.

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

   [RFC6643]                      Schoenwaelder, J., "Translation of
                                  Structure of Management Information
                                  Version 2 (SMIv2) MIB Modules to YANG
                                  Modules", RFC 6643, July 2012.

   [I-D.lhotka-netmod-yang-json]  Lhotka, L., "Modeling JSON Text with
                                  YANG",
                                  draft-lhotka-netmod-yang-json-00 (work
                                  in progress), October 2012.

Appendix A.  JSON Representation

   Using the translation algorithm defined in [RFC6643], the SMIv2
   module can be translated to YANG.  Using the JSON representation of
   data modeled in YANG defined in [I-D.lhotka-netmod-yang-json], the
   objects defined in the MIB module can be represented in JSON as shown
   below.  The compact representation without any white space uses XXXX
   octets.  (Of course, this number depends on the number of octets
   needed for the counter values.)

   {
       "RPL-MIB:RPL-MIB": {
           "rplGeneral": {
               "rplDefaultDISMode": "silent",
               "rplDefaultDISMessages": 1,



Korte, et al.            Expires August 26, 2013               [Page 32]

Internet-Draft                   RPL-MIB                   February 2013


               "rplDefaultDISTimeout": 60,
               "rplDefaultDAODelay": 1000,
               "rplDefaultDAOAckEnabled": false,
               "rplDefaultPreference": 0,
               "rplDefaultMinHopRankIncrease": 256,
               "rplDefaultMaxRankIncrease": 65535,
               "rplDefaultModeOfOperation":
                  "storingWithoutMulticastSupport",
               "rplDefaultIntervalDoublings": 20,
               "rplDefaultIntervalMin": 3,
               "rplDefaultRedundancyConstant": 10
           },
           "rplActive": {
               "rplActiveInstance": 0,
               "rplActiveDodag": "2001:db8:bad:cafe::1",
               "rplActiveDodagTriggerSequence": 4
           },
           "rplStats": {
               "rplMemOverflows": 0,
               "rplParseErrors": 0,
               "rplUnknownMsgTypes": 1,
               "rplSecurityPolicyViolations": 0,
               "rplIntegrityCheckFailures": 0,
               "rplReplayProtectionFailures": 0,
               "rplValidParentFailures": 1,
               "rplNoInstanceIDs": 0,
               "rplTriggeredLocalRepairs": 3,
               "rplTriggeredGlobalRepairs": 0,
               "rplNoParentSecs": 15,
               "rplActiveNoParentSecs": 0,
               "rplOBitSetDownwards": 0,
               "rplOBitClearedUpwards": 0,
               "rplFBitSet": 0,
               "rplRBitSet": 0,
               "rplTrickleTimerResets": 42
           },
           "rplOCPTable": {
               "rplOCPEntry": [
                   {
                       "rplOCPCodepoint": 0,
                       "rplOCPEnabled": true
                   }
               ]
           },
           "rplInstanceTable": {
               "rplInstanceEntry": [
                   {
                       "rplInstanceID": 0,



Korte, et al.            Expires August 26, 2013               [Page 33]

Internet-Draft                   RPL-MIB                   February 2013


                       "rplInstanceDISMode": "send",
                       "rplInstanceDISMessages": 1,
                       "rplInstanceDISTimeout": 60,
                       "rplInstanceModeOfOperation":
                            "storingWithoutMulticastSupport"
                   }
               ]
           },
           "rplDodagTable": {
               "rplDodagEntry": [
                   {
                       "rplInstanceID": 0,
                       "rplDodagIndex": 1,
                       "rplDodagID": "2001:db8:bad:cafe::1",
                       "rplDodagVersion": 3,
                       "rplDodagRank": 2,
                       "rplDodagState": "grounded",
                       "rplDodagOCP": 0,
                       "rplDodagDAODelay": 1000,
                       "rplDodagDAOAckEnabled": false,
                       "rplDodagPreference": 0,
                       "rplDodagMinHopRankIncrease": 256,
                       "rplDodagMaxRankIncrease": 0,
                       "rplDodagIntervalDoublings": 20,
                       "rplDodagIntervalMin": 3,
                       "rplDodagRedundancyConstant": 10,
                       "rplDodagPathControlSize": 0
                   }
               ]
           },
           "rplDodagParentTable": {
                "rplDodagParentEntry": [
                    {
                        "rplRPLInstanceID": 0,
                        "rplDodagIndex": 1,
                        "rplDodagParentID": "2001:db8:bad:cafe::8",
                        "rplDodagParentIf": 1
                    }
                ]
           },
           "rplDodagChildTable": {
               "rplDodagChildEntry": [
                   {
                       "rplRPLInstanceID": 0,
                       "rplDodagIndex": 1,
                       "rplDodagChildID": "2001:db8:bad:cafe::a"
                       "rplDodagChildIf": 1
                   },



Korte, et al.            Expires August 26, 2013               [Page 34]

Internet-Draft                   RPL-MIB                   February 2013


                   {
                       "rplRPLInstanceID": 0,
                       "rplDodagIndex": 1,
                       "rplDodagChildID": "2001:db8:bad:cafe::b"
                       "rplDodagChildIf": 2
                   }
               ]
           },
           "rplMsgStatsTable": {
               "rplMsgStatsEntry": [
                   {
                       "rplMsgStatsType": 0,
                       "rplMsgStatsInMsgs": 78,
                       "rplMsgStatsOutMsgs": 23
                   },
                   {
                       "rplMsgStatsType": 1,
                       "rplMsgStatsInMsgs": 11,
                       "rplMsgStatsOutMsgs": 54
                   },
                   {
                       "rplMsgStatsType": 2,
                       "rplMsgStatsInMsgs": 87,
                       "rplMsgStatsOutMsgs": 28
                   },
                   {
                       "rplMsgStatsType": 4,
                       "rplMsgStatsInMsgs": 47,
                       "rplMsgStatsOutMsgs": 38
                   }
               ]
           }
       }
   }

Authors' Addresses

   Kevin Korte
   Jacobs University
   Campus Ring 1
   Bremen  28759
   Germany

   EMail: k.korte@jacobs-university.de







Korte, et al.            Expires August 26, 2013               [Page 35]

Internet-Draft                   RPL-MIB                   February 2013


   Juergen Schoenwaelder
   Jacobs University
   Campus Ring 1
   Bremen  28759
   Germany

   EMail: j.schoenwaelder@jacobs-university.de


   Anuj Sehgal
   Jacobs University
   Campus Ring 1
   Bremen  28759
   Germany

   EMail: s.anuj@jacobs-university.de


   Tina Tsou
   Huawei Technologies (USA)
   2330 Central Expressway
   Santa Clara  CA 95050
   USA

   EMail: tina.tsou.zouting@huawei.com


   Cathy Zhou
   Huawei Technologies
   Bantian, Longgang District
   Shenzhen  518129
   P.R. China

   EMail: cathyzhou@huawei.com

















Korte, et al.            Expires August 26, 2013               [Page 36]