tech-invite   World Map     

IETF     RFCs     Groups     SIP     ABNFs    |    3GPP     Specs     Glossaries     Architecture     IMS     UICC    |    search     info

RFC 7184

Proposed STD
Pages: 86
Top     in Index     Prev     Next
in Group Index     Prev in Group     Next in Group     Group: MANET

Definition of Managed Objects for the Optimized Link State Routing Protocol Version 2

Part 1 of 4, p. 1 to 9
None       Next RFC Part

 


Top       ToC       Page 1 
Internet Engineering Task Force (IETF)                        U. Herberg
Request for Comments: 7184               Fujitsu Laboratories of America
Category: Standards Track                                        R. Cole
ISSN: 2070-1721                                           US Army CERDEC
                                                              T. Clausen
                                                LIX, Ecole Polytechnique
                                                              April 2014


                   Definition of Managed Objects for
          the Optimized Link State Routing Protocol Version 2

Abstract

   This document defines the Management Information Base (MIB) module
   for configuring and managing the Optimized Link State Routing
   Protocol version 2 (OLSRv2).  The OLSRv2-MIB module is structured
   into configuration information, state information, performance
   information, and notifications.  This additional state and
   performance information is useful for troubleshooting problems and
   performance issues of the routing protocol.  Two levels of compliance
   allow this MIB module to be deployed on constrained routers.

Status of This Memo

   This is an Internet Standards Track document.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   Internet Engineering Steering Group (IESG).  Further information on
   Internet Standards is available in Section 2 of RFC 5741.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc7184.

Copyright Notice

   Copyright (c) 2014 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (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

Page 2 
   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
   2. The Internet-Standard Management Framework ......................3
   3. Conventions .....................................................3
   4. Overview ........................................................3
      4.1. Terms ......................................................4
   5. Structure of the MIB Module .....................................4
      5.1. The Configuration Group ....................................5
      5.2. The State Group ............................................5
      5.3. The Performance Group ......................................5
      5.4. The Notifications Group ....................................5
      5.5. Tables and Indexing ........................................6
   6. Relationship to Other MIB Modules ...............................9
      6.1. Relationship to the SNMPv2-MIB .............................9
      6.2. Relationship to the NHDP-MIB ...............................9
      6.3. MIB Modules Required for IMPORTS ...........................9
   7. Definitions ....................................................10
   8. Security Considerations ........................................77
   9. Applicability Statement ........................................80
   10. IANA Considerations ...........................................81
   11. Acknowledgements ..............................................81
   12. References ....................................................82
      12.1. Normative References .....................................82
      12.2. Informative References ...................................83
   Appendix A. IANAolsrv2LinkMetricType-MIB ..........................84

1.  Introduction

   This document defines the Management Information Base (MIB) module
   for configuring and managing the Optimized Link State Routing
   Protocol version 2 (OLSRv2).  The OLSRv2-MIB module is structured
   into configuration information, state information, performance
   information, and notifications.  In addition to configuration, this
   additional state and performance information is useful for
   troubleshooting problems and performance issues of the routing
   protocol.  Different levels of compliance allow implementers to use
   smaller subsets of all defined objects, allowing for this MIB module
   to be deployed on more constrained routers.

Top      ToC       Page 3 
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
   [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 module are defined using the mechanisms defined in
   the Structure of Management Information (SMI).  This document
   specifies a MIB module that is compliant to the SMIv2, which is
   described in STD 58, [RFC2578], STD 58, [RFC2579] and STD 58
   [RFC2580].

3.  Conventions

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

4.  Overview

   The Optimized Link State Routing Protocol version 2 (OLSRv2)
   [RFC7181] is a table-driven, proactive routing protocol, i.e., it
   exchanges topology information with other routers in the network
   periodically.  OLSRv2 is an optimization of the classical link state
   routing protocol.  Its key concept is that of multipoint relays
   (MPRs).  Each router selects a set of its neighbor routers (which
   "cover" all of its symmetrically connected 2-hop neighbor routers) as
   MPRs.  MPRs are then used to achieve both flooding reduction and
   topology reduction.

   This document provides management and control capabilities of an
   OLSRv2 instance, allowing management applications to monitor the
   state and performance of an OLSRv2 router, as well as to change
   settings of the OLSRv2 instance (e.g., router or interface parameters
   such as message intervals, etc.).

   As OLSRv2 relies on the neighborhood information discovered by the
   "Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol
   (NHDP)" [RFC6130], the OLSRv2-MIB module is aligned with the NHDP-MIB
   module [RFC6779] and augments several of the tables and objects in
   the NHDP-MIB.  In particular, common indexes for router interfaces
   and discovered neighbors are used, as described in Section 5.2.

Top      ToC       Page 4 
4.1.  Terms

   The following definitions apply throughout this document:

   o  Configuration Objects - switches, tables, and objects that are
      initialized to default settings or set through the management
      interface defined by this MIB module.

   o  State Objects - automatically generated values that define the
      current operating state of the OLSRv2 protocol instance in the
      router.

   o  Performance Objects - automatically generated values that help an
      administrator or automated tool to assess the performance of the
      OLSRv2 process on the router.

   o  Notification Objects - objects that define triggers and associated
      notification messages allowing for asynchronous tracking of
      predefined events on the managed router.

5.  Structure of the MIB Module

   This section presents the structure of the OLSRv2-MIB module.  The
   objects are arranged into the following structure:

   o  olsrv2MIBObjects - defines objects forming the basis for the
      OLSRv2-MIB module.  These objects are divided up by function into
      the following groups:

      *  Configuration Group - defining objects related to the
         configuration of the OLSRv2 instance on the router.

      *  State Group - defining objects that reflect the current state
         of the OLSRv2 instance running on the router.

      *  Performance Group - defining objects that are useful to a
         management system when characterizing the performance of OLSRv2
         on the router and in the MANET.

   o  olsrv2MIBNotifications - objects defining OLSRv2-MIB module
      notifications.

   o  olsrv2MIBConformance - defining the minimal and maximal
      conformance requirements for implementations of this MIB module.

Top      ToC       Page 5 
5.1.  The Configuration Group

   The OLSRv2 router is configured with a set of controls.  The
   authoritative list of configuration controls within the OLSRv2-MIB
   module is found within the MIB module itself.  Generally, an attempt
   was made in developing the OLSRv2-MIB module to support all
   configuration objects defined in [RFC7181].  For all of the
   configuration parameters, the same constraints and default values of
   these parameters as defined in [RFC7181] are followed.

5.2.  The State Group

   The State Group reports current state information of a router running
   [RFC7181].  The OLSRv2-MIB module State Group tables were designed to
   contain the complete set of state information defined within the
   Information Bases in [RFC7181].

   The OLSRv2-MIB module State Group tables are constructed as
   extensions to the corresponding tables within the State Group of the
   NHDP-MIB module [RFC6779].  Use of the AUGMENTS clause is made, when
   possible, to accomplish these table extensions.  Further, the State
   Group tables defined in this MIB module are aligned with the
   corresponding tables in the NHDP-MIB module [RFC6779], as described
   in Section 6.2.

5.3.  The Performance Group

   The Performance Group reports values relevant to system performance.
   Frequent changes of sets or frequent recalculation of the Routing Set
   or the MPRs can have a negative influence on the performance of
   OLSRv2.  This MIB module defines several objects that can be polled,
   e.g., in order to calculate histories or monitor frequencies of
   changes.  This may help the network administrator to determine
   unusual topology changes or other changes that affect stability and
   reliability of the MANET.  One such framework is specified in REPORT-
   MIB [REPORT-MIB].

5.4.  The Notifications Group

   The Notifications Group contains Control
   (olsrv2NotificationsControl), Objects (olsrv2NotificationsObjects),
   and States (olsrv2NotificationsStates), where the Control contains
   definitions of objects to control the frequency of notifications
   being generated.  The Objects define the supported notifications, and
   the State is used to define additional information to be carried
   within the notifications.

Top      ToC       Page 6 
   The olsrv2NotificationsObjects sub-tree contains the list of
   notifications supported within the OLSRv2-MIB module and their
   intended purpose or utility.

   The same mechanisms for improving the network performance by reducing
   the number of notifications apply as defined in Section 5.1 of
   [RFC6779].  The following objects are used to define the thresholds
   and time windows for specific notifications defined in the NHDP-MIB
   module: olsrv2RoutingSetRecalculationCountThreshold,
   olsrv2RoutingSetRecalculationCountWindow,
   olsrv2MPRSetRecalculationCountThreshold, and
   olsrv2MPRSetRecalculationCountWindow.

5.5.  Tables and Indexing

   The OLSRv2-MIB module's tables are indexed by the following
   constructs:

   o  nhdpIfIndex - the ifIndex of the local router on which NHDP is
      configured.  This is defined in the NHDP-MIB.

   o  nhdpDiscIfIndex - a locally managed index representing a known
      interface on a neighboring router.  This is defined in the NHDP-
      MIB.

   o  nhdpDiscRouterIndex - a locally managed index representing an ID
      of a known neighboring router.  This is defined in the NHDP-MIB.

   o  {olsrv2LibOrigSetIpAddrType, olsrv2LibOrigSetIpAddr} - this index
      (pair) uniquely identifies recently used originator addresses
      found within the olsrv2LibOrigSetTable.

   o  {olsrv2LibLocAttNetSetIpAddrType, olsrv2LibLocAttNetSetIpAddr,
      olsrv2LibLocAttNetSetIpAddrPrefixLen} - this index (triplet)
      uniquely identifies local attached networks reachable through
      local (non-OLSRv2) interfaces on this router.  These are recorded
      in the olsrv2LibLocAttNetSetTable.

   o  {olsrv2TibAdRemoteRouterSetIpAddrType,
      olsrv2TibAdRemoteRouterSetIpAddr} - this index (pair) uniquely
      identifies each router in the network that transmits Topology
      Control (TC) messages received by this router.  These records are
      recorded in the olsrv2TibAdRemoteRouterSetIpAddr.

   o  {olsrv2TibRouterTopologySetFromOrigIpAddrType,
      olsrv2TibRouterTopologySetFromOrigIpAddr,
      olsrv2TibRouterTopologySetToOrigIpAddrType,
      olsrv2TibRouterTopologySetToOrigIpAddr} - this index (quadruplet)

Top      ToC       Page 7 
      uniquely identifies discovered links within the network recorded
      by this router.  Information associated with each link is stored
      in the olsrv2TibRouterTopologySetTable.

   o  {olsrv2TibRoutableAddressTopologySetFromOrigIpAddrType,
      olsrv2TibRoutableAddressTopologySetFromOrigIpAddr,
      olsrv2TibRoutableAddressTopologySetFromDestIpAddrType,
      olsrv2TibRoutableAddressTopologySetFromDestIpAddr} - this index
      (quadruplet) uniquely identifies reachable addresses within the
      network and the router's advertising of these addresses.  This
      information is stored in the
      olsrv2TibRoutableAddressTopologySetTable.

   o  {olsrv2TibAttNetworksSetOrigIpAddrType,
      olsrv2TibAttNetworksSetOrigIpAddr,
      olsrv2TibAttNetworksSetNetIpAddrType,
      olsrv2TibAttNetworksSetNetIpAddr,
      olsrv2TibAttNetworksSetNetIpAddrPrefixLen} - this index
      (quintuplet) uniquely identifies the networks (which may be
      outside the MANET) and the routers through which these networks
      can be reached.  This information is stored in the
      olsrv2TibAttNetworksSetTable.

   o  {olsrv2TibRoutingSetDestIpAddrType, olsrv2TibRoutingSetDestIpAddr,
      olsrv2TibRoutingSetDestIpAddrPrefixLen} - this index (triplet)
      uniquely identifies the address of a reachable destination in the
      network.  This indexes the olsrv2TibRoutingSetTable, which
      contains the next-hop information to reach the indexed addresses.

   These tables and their indexing are:

   o  olsrv2InterfaceTable - describes the OLSRv2 status on the NHDP
      interfaces of this router.  This table augments nhdpInterfaceEntry
      and, as such, it is indexed by the {nhdpIfIndex} from the NHDP-
      MIB.

   o  olsrv2IibLinkSetTable - records all links from other routers that
      are, or recently were, 1-hop neighbors.  This table augments
      nhdpIibLinkSetEntry and, as such, it is indexed by nhdpIfIndex and
      nhdpDiscIfIndex.

   o  olsrv2Iib2HopSetTable - records network addresses of symmetric
      2-hop neighbors and the links to the associated 1-hop neighbors.
      This table augments nhdpIib2HopSetEntry and, as such, it is
      indexed by {nhdpIfIndex, nhdpDiscIfIndex,
      nhdpIib2HopSetIpAddressType, nhdpIib2HopSetIpAddress}.

Top      ToC       Page 8 
   o  olsrv2LibOrigSetTable - records addresses that were recently used
      as originator addresses by this router.  This table is indexed by
      {olsrv2LibOrigSetIpAddrType, olsrv2LibOrigSetIpAddr}.

   o  olsrv2LibLocAttNetSetTable - records its local non-OLSRv2
      interfaces via which it can act as a gateway to other networks.
      This table is indexed by {olsrv2LibLocAttNetSetIpAddrType,
      olsrv2LibLocAttNetSetIpAddr,
      olsrv2LibLocAttNetSetIpAddrPrefixLen}.

   o  olsrv2NibNeighborSetTable - records all network addresses of each
      1-hop neighbor.  This table augments nhdpNibNeighborSetEntry and,
      as such, it is indexed by the {nhdpDiscRouterIndex}.

   o  olsrv2TibAdRemoteRouterSetTable - records information describing
      each remote router in the network that transmits TC messages.
      This table is indexed by {olsrv2TibAdRemoteRouterSetIpAddrType,
      olsrv2TibAdRemoteRouterSetIpAddr}.

   o  olsrv2TibRouterTopologySetTable - records topology information
      about the network.  This table is indexed by
      {olsrv2TibRouterTopologySetFromOrigIpAddrType,
      olsrv2TibRouterTopologySetFromOrigIpAddr,
      olsrv2TibRouterTopologySetToOrigIpAddrType,
      olsrv2TibRouterTopologySetToOrigIpAddr}.

   o  olsrv2TibRoutableAddressTopologySetTable - records topology
      information about the routable addresses within the MANET and via
      which routers they may be reached.  This table is indexed by
      {olsrv2TibRoutableAddressTopologySetFromOrigIpAddrType,
      olsrv2TibRoutableAddressTopologySetFromOrigIpAddr,
      olsrv2TibRoutableAddressTopologySetFromDestIpAddrType,
      olsrv2TibRoutableAddressTopologySetFromDestIpAddr}.

   o  olsrv2TibAttNetworksSetTable - records information about networks
      (which may be outside the MANET) attached to other routers and
      their routable addresses.  This table is indexed by
      {olsrv2TibAttNetworksSetOrigIpAddrType,
      olsrv2TibAttNetworksSetOrigIpAddr,
      olsrv2TibAttNetworksSetNetIpAddrType,
      olsrv2TibAttNetworksSetNetIpAddr,
      olsrv2TibAttNetworksSetNetIpAddrPrefixLen}.

   o  olsrv2TibRoutingSetTable - records the first hop along a selected
      path to each destination for which any such path is known.  This
      table is indexed by {olsrv2TibRoutingSetDestIpAddrType,
      olsrv2TibRoutingSetDestIpAddr,
      olsrv2TibRoutingSetDestIpAddrPrefixLen}.

Top      ToC       Page 9 
   o  olsrv2InterfacePerfTable - records performance counters for each
      active OLSRv2 interface on this device.  This table augments
      nhdpInterfacePerfEntry and, as such, it is indexed by
      {nhdpIfIndex} from the NHDP-MIB.

6.  Relationship to Other MIB Modules

   This section specifies the relationship of the MIB modules contained
   in this document to other standards, particularly to standards
   containing other MIB modules.  MIB modules and specific definitions
   imported from MIB modules that SHOULD be implemented in conjunction
   with the MIB module contained within this document are identified in
   this section.

6.1.  Relationship to the SNMPv2-MIB

   The System group in the SNMPv2-MIB module [RFC3418] is defined as
   being mandatory for all systems, and the objects apply to the entity
   as a whole.  The System group provides identification of the
   management entity and certain other system-wide data.  The OLSRv2-MIB
   module does not duplicate those objects.

6.2.  Relationship to the NHDP-MIB

   OLSRv2 depends on the neighborhood information that is discovered by
   [RFC6130].  An instance of OLSRv2 MUST have an associated instance of
   NHDP running on the same device for proper operations of the
   discovery and routing system.  In order for the OLSRv2-MIB module to
   correctly populate the objects relating to discovered neighbors, the
   State Group tables of the NHDP-MIB module [RFC6779] are aligned with
   the State Group tables of this MIB module.  This is accomplished
   through the use of the AUGMENTS capability of SMIv2 (where
   appropriate).  This will allow for cross referencing of information
   between the two MIB modules within a given SNMP context.

6.3.  MIB Modules Required for IMPORTS

   The following OLSRv2-MIB module IMPORTS objects from NHDP-MIB
   [RFC6779], SNMPv2-SMI [RFC2578], SNMPv2-TC [RFC2579], SNMPv2-CONF
   [RFC2580], IF-MIB [RFC2863], and INET-ADDRESS-MIB [RFC4001].  The
   OLSRv2-MIB module also IMPORTS objects from the
   IANAolsrv2LinkMetricType-MIB, which is available at <http://
   www.iana.org/assignments/ianaolsrv2linkmetrictype-mib>.


Next RFC Part