RFC 7184
Definition of Managed Objects for the Optimized Link State Routing Protocol Version 2
Pages: 86
Proposed Standard
Proposed Standard
Part 1 of 4 – Pages 1 to 9
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 2Abstract
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
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 ..........................841. 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.
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.
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.
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.
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)
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}.
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}.
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)