Tech-invite3GPPspaceIETFspace
959493929190898887868584838281807978777675747372717069686766656463626160595857565554535251504948474645444342414039383736353433323130292827262524232221201918171615141312111009080706050403020100
in Index   Prev   Next

RFC 7184

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

Pages: 86
Proposed Standard
Part 1 of 4 – Pages 1 to 9
None   None   Next

Top   ToC   RFC7184 - 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
Top   ToC   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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   RFC7184 - 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 page on part 2)

Next Section