| TOC |
|
This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes objects for configuring parameters of the Neighborhood Discovery Protocol (NHDP) process on a router. The MIB defined in this memo, denoted NHDP-MIB, also reports state, performance information and notifications. This additional state and performance information is useful to troubleshoot problems and performance issues during neighbor discovery.
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 July 7, 2011.
Copyright (c) 2011 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.
1.
Introduction
2.
The Internet-Standard Management Framework
3.
Conventions
4.
Overview
4.1.
Terms
5.
Structure of the MIB Module
5.1.
Notifications
5.1.1.
Introduction
5.1.2.
Notification Generation
5.1.3.
Limiting Frequency of Notifications
5.2.
The Configuration Group
5.3.
The State Group
5.4.
The Performance Group
6.
Relationship to Other MIB Modules
6.1.
Relationship to the SNMPv2-MIB
6.2.
Relationship to Routing Protocol MIBs relying on the NHDP-MIB
6.3.
Relationship to the REPORT-MIB
6.4.
MIB modules required for IMPORTS
7.
Definitions
8.
Security Considerations
9.
IANA Considerations
10.
Contributors
11.
References
11.1.
Normative References
11.2.
Informative References
Appendix A.
Open Issues
Appendix B.
| TOC |
This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in the Internet community. In particular, it describes objects for configuring parameters of the Neighborhood Discovery Protocol [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.) process on a router. The MIB defined in this memo, denoted NHDP-MIB, also reports state, performance information and notifications. This additional state and performance information is useful to troubleshoot problems and performance issues during neighbor discovery.
| TOC |
For a detailed overview of the documents that describe the current Internet-Standard Management Framework, please refer to Section 7 of [RFC3410] (Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” December 2002.).
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 [RFC2578] (McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Structure of Management Information Version 2 (SMIv2),” April 1999.), [RFC2579] (McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Textual Conventions for SMIv2,” April 1999.) and [RFC2580] (McCloghrie, K., Perkins, D., and J. Schoenwaelder, “Conformance Statements for SMIv2,” April 1999.).
| TOC |
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] (Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” March 1997.).
| TOC |
[NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.) allows a router in a Mobile Ad Hoc Network (MANET) to discover and track topological information of routers up to two hops away by virtue of exchanging HELLO messages. This information is useful for routers running various routing and multicast flooding protocols developed within the IETF MANET Working Group.
| TOC |
The following definitions apply throughout this document:
| TOC |
This section presents the structure of the NHDP-MIB module. The MIB is arranged into the following structure:
| TOC |
This section describes the use of notifications, and mechanisms to enhance the ability to manage NHDP networks.
| TOC |
Notifications can be emitted by an NHDP router as a reaction to a specific event. This allows a network manager to efficiently determine the source of problems or significant changes of configuration or topology, instead of polling a possibly large number of NHDP routers.
| TOC |
When an exception event occurs, the application notifies the local agent, which sends a notification to the appropriate SNMP management stations. The message includes the notification type and may include a list of notification-specific variables. Section 7 (Definitions) contains, amongst others, the notification definitions, which includes the variable lists. At least one IP address of the NHDP router that originates the notification is included in the variable list so that the network manager may determine the source of the notification.
| TOC |
To limit the frequency of notifications, the following additional mechanisms are suggested, similar to those in [RFC4750] (Joyal, D., Galecki, P., Giacalone, S., Coltun, R., and F. Baker, “OSPF Version 2 Management Information Base,” December 2006.):
| TOC |
The majority of critical events occur when NHDP is enabled on a router, at which time the symmetric neighbors and two-hop neighbors of the NHDP router are discovered. During this initial period, a potential flood of notifications is unnecessary since the events are expected. To avoid unnecessary notifications, a router should not originate expected notifications until a certain time interval has elapsed, which is to be predefined by the network manager.
| TOC |
The mechanism for throttling the notifications is the same as in [RFC4750] (Joyal, D., Galecki, P., Giacalone, S., Coltun, R., and F. Baker, “OSPF Version 2 Management Information Base,” December 2006.) (i.e. the amount of transmitted notifications per time is bounded).
Appropriate values for the window time and upper bound are to be selected by the network manager and depend on the deployment of the MANET.
| TOC |
Similar to the according mechanism in [RFC4750] (Joyal, D., Galecki, P., Giacalone, S., Coltun, R., and F. Baker, “OSPF Version 2 Management Information Base,” December 2006.), only one notification is sent per event.
| TOC |
The NHDP router is configured with a set of controls. The authoritative list of configuration controls within the NHDP-MIB are found within the MIB module itself. Generally, an attempt was made in developing the NHDP-MIB module to support all configuration objects defined in [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.). For all of the configuration parameters, the same constraints and default values of these parameters as defined in [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.) are followed.
| TOC |
The State Group reports current state information of a router running [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.). The NHDP-MIB State Group tables were designed to contain the complete set of state information defined within the information bases in [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.).
Two constructs, i.e., TEXTUAL CONVENTIONs, are defined in support of the tables in the State Group. These are NeighborIfIndex and NeighborRouterId. These are locally (to the NHDP router) defined, unique identifiers. They are used to define indexes to the appropriate State Group tables and to correlate table entries to interface addresses, interfaces and routers within the MANET. NeighborIfIndex is a unique identifier of discovered NHDP interfaces on all routers within the MANET. NeighborRouterId is a unique identifier of discovered NHDP routers within the MANET.
| TOC |
The Performance Group reports values relevant to system performance. This section lists objects for NHDP performance monitoring, some of which are explicitly defined in the NHDP-MIB and others which are obtainable through a combination of base objects from this MIB and reports available through the REPORT-MIB (Cole, R., Macker, J., and A. Morton, “Definition of Managed Objects for Performance Reporting,” July 2010.) [REPORT]. Throughout this section, those objects will be pointed out that are intended as base objects which are explicitly defined within this MIB and those objects which are derived through a combination of the base objects and capabilities offered by the REPORT-MIB.
Unstable neighbors or 2-hop neighbors and frequent changes of sets can have a negative influence on the performance of NHDP. The following objects allow management applications to acquire information related to the stability and performance of NHDP:
The following objects return statistics related to HELLO messages:
- This is a Base Object.
- Object name: nhdpIfHelloMessageXmits
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessageRecvd
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessagePeriodicXmits
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessageTriggeredXmits
- Object type: Counter32
- It is desirable to develop the history of the exact timestamps of each HELLO message that has been sent as well as the type of the message (triggered or periodical). The list of events starts at the given point of time t0 and ends at the given time t1.
- This is a Derived Object to be pulled from the REPORT-MIB. It is derived from, e.g., the nhdpIfHelloMessagePeriodicXmits Base Object from the NHDP-MIB along with the capabilities derived from the reportHistoryGroup from the REPORT-MIB.
- It is desirable to track the values (in a 2-dimensional array) that represent a histogram of intervals between HELLO messages, separated by periodic and triggered types. The histogram would display the distribution of intervals between two consecutive HELLOs of the same type (triggered or periodical) using a given bin size. It includes all HELLOs that have been sent after the given time t0 and before the given time t1.
- This is a Derived Object to be pulled from the REPORT-MIB. It can be derived from, e.g., the nhdpIfHelloMessagePeriodicXmits Base Object from the NHDP-MIB along with the capabilities derived from the reportHistoryGroup from the REPORT-MIB. The network management application could convert this information into the desired histogram.
- This object will divide the given time interval from t0 to t1 into a given number of equal parts. It then creates a histogram for each part and calculates the distances (e.g. using the Bhattacharyya distance) between each two adjacent histograms in time. A higher value between two histograms means more difference between the histograms. For instance, this is representative of an event that suddenly sends many triggered HELLO messages, whereas before there have been only very few such triggered messages.
- This is a Derived Object to be pulled from the REPORT-MIB, as previously discussed, albeit this is a bit more complex with respect to the management application.
- This is a Derived Object to be pulled from the reportSampledGroup from the REPORT-MIB. It is derived from, e.g., the nhdpIfHelloMessageXmits Base Object.
- This is a Derived Object to be pulled from the REPORT-MIB. See the previous discussion.
- This is a Base Object.
- Object name: nhdpIfHelloMessageXmitAccumulatedSize
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessageRecvdAccumulatedSize
- Object type: Counter32
- This is a Derived Object to be pulled from the reportSampledGroup from the REPORT-MIB. It is derived from, e.g., the nhdpIfHelloMessageRecvdAccumulatedSize Base Object from this NHDP-MIB.
- This is a Derived Object to be pulled from the REPORT-MIB. See previous discussion.
- This is a Base Object.
- Object name: nhdpIfHelloMessageXmitAccumulatedSymmetricNeighborCount
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessageXmitAccumulatedHeardNeighborCount
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpIfHelloMessageXmitAccumulatedLostNeighborCount
- Object type: Counter32
- This is a Base Object.
- Object name: nhdpDiscIfExpectedPackets
- Object type: Counter32
- This is a Derived Object to be pulled from this NHDP-MIB. It is derived from, e.g., the nhdpDiscIfRecvdPackets and the nhdpDiscIfExpectedPackets Base Objects defined in this MIB. This metric is then computed by the network management application.
The following objects inspect the frequency of all Neighbor Set changes:
- This object counts each Neighbor Set change. A change occurs whenever a new Neighbor Tuple has been added, a Neighbor Tuple has been removed or any entry of a Neighbor Tuple has been modified.
- This is a Base Object.
- Object name: nhdpNibNeighborSetChanges
- Object type: Counter32
- This object returns the history of the exact timestamps of each time the Neighbor Set has been changed.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from the previously discussed Base Object.
- Returns the values (in a 2-dimensional array) that represent a histogram of intervals between Neighbor Set changes.
- This is a Derived Object to be pulled from the reportHistoryGroup from the REPORT-MIB. It is derived from the previously discussed Base Object. The network management application would develop the histograms based upon lists obtained from the REPORT-MIB.
- This object will divide the given time interval from t0 to t1 into a given number of equal parts. It then creates a histogram for each part and calculates the distances (e.g. using the Bhattacharyya distance) between each two adjacent histograms in time. A higher value between two histograms means more difference between the histograms.
- This is a Derived Object to be pulled from the reportHistoryGroup from the REPORT-MIB. It is derived from the previously discussed Base Object. The network management application could then compute the desired metrics.
The next objects examine the uptime of a given neighbor:
- Returns the number of changes to the given Neighbor Tuple.
- This is a Base Object.
- Object name: nhdpDiscNeighborNibNeighborSetChanges
- Object type: Counter32
- Returns the number of hundredths of a second since the Neighbor Tuple corresponding to the given neighbor exists.
- This is a Base Object.
- Object name: nhdpDiscNeighborNibNeighborSetUpTime
- Object type: TimeTicks
- This object returns the history of the exact timestamps of each time the neighbor becomes onlink or offlink. A neighbor is said to become "onlink" if a new Neighbor Tuple is created that corresponds to the given neighbor. It becomes "offlink" if such a tuple has been deleted.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from, e.g., the nhdpDiscNeighborNibNeighborSetChanges Base Object defined in this MIB.
- Returns the values that represent a histogram of intervals between a change of the onlink status of a given neighbor. The histogram includes all changes that have been made after the given time t0 and before the given time t1.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from, e.g. the nhdpDiscNeighborNibNeighborSetChanges Base Object defined in this MIB. This object sits in the nhdpDiscNeighborSetPerfTable which is indexed by the nhdpDiscNeighborSetRouterId.
The following objects examine the stability of a neighbor. A neighbor is said to be unstable if it "flaps" frequently between several links. It is said to be stable if the set of Link Tuples that correspond to the given neighbor is stationary.
- This object counts each time the neighbor changes the interface over which it is reachable. That means that the corresponding Link Tuple of the given link moves from the Link Set of one interface to another interface.
- This is a Base Object.
- Object name: nhdpDiscNeighborNibNeighborSetReachableLinkChanges
- Object type: Counter32
- This object returns the history of the exact timestamps of each time the neighbor changes the interface over which it is reachable. That means that the corresponding Link Tuple of the given link moves from the Link Set of one interface to another interface.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from, e.g., the nhdpDiscNeighborNibNeighborSetReachableLinkChanges Base Object. The network management could develop the desired histogram based upon the information retrieved from the REPORT-MIB.
- Returns the values that represent a histogram of intervals between a change of the interface over which a given neighbor is reachable after the given time t0 and before the given time t1.
- This is a Derived Object to be pulled from the reportHistoryGroup from the REPORT-MIB. It is derived from the previously discussed Base Object, nhdpDiscNeighborNibNeighborSetChanges counter. The network management application would develop the histograms based upon lists obtained from the REPORT-MIB.
The following objects inspect the stability of a given 2-hop neighbor:
- This object returns the count of the times the 2-hop neighbor changes its N2_neighbor_iface_addr_list, i.e. the neighbor over which it is reachable.
- This is a Base Object.
- Object name: nhdpIib2HopSetPerfChanges
- Object type: Counter32
- This object returns the history of the exact timestamps of each time the 2-hop neighbor changes its N2_neighbor_iface_addr_list, i.e. the neighbor over which it is reachable.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from the previously discussed Base Object, nhdpIib2HopSetPerfChanges counter.
- Returns the values that represent a histogram of intervals between a change of the 2-hop neighbor's N2_neighbor_iface_addr_list after the given time t0 and before the given time t1.
- This is a Derived Object to be pulled from the reportHistoryGroup from the REPORT-MIB. It is derived from the previously discussed Base Object, nhdpIib2HopSetPerfChanges counter. The network management application would develop the histograms based upon lists obtained from the REPORT-MIB.
The next objects examine the uptime of a given 2-hop neighbor:
- Returns the number of hundredths of a second since the 2-Hop Tuple corresponding to the given 2-hop neighbor IP address was registered.
- This is a Base Object.
- Object name: nhdpIib2HopSetPerfUpTime
- Object type: TimeTicks
- This object returns the history of the exact timestamps of each time the 2-hop neighbor becomes onlink or offlink. A 2-hop neighbor is said to become "onlink" if a new 2-hop Tuple is created that corresponds to the given 2-hop neighbor. It becomes "offlink" if such a tuple has been deleted.
- This is a Derived Object to be pulled from the reportHistoryGroup of the REPORT-MIB. It is derived from the previously discussed Base Object, nhdpIib2HopSetPerfChanges counter.
- Returns the values that represent a histogram of intervals between a change of the onlink status of a given 2-hop neighbor. The histogram includes all changes that have been made after the given time t0 and before the given time t1.
- This is a Derived Object to be pulled from the reportHistoryGroup from the REPORT-MIB. It is derived from the previously discussed Base Object, nhdpIib2HopSetPerfChanges counter. The network management application would develop the histograms based upon lists obtained from the REPORT-MIB.
| TOC |
This section specifies the relationship of the MIB modules contained in this document to other standards, particularly to standards containing other MIB modules. Definitions imported from other MIB modules and other MIB modules that SHOULD be implemented in conjunction with the MIB module contained within this document are identified in this section.
| TOC |
The 'system' group in the SNMPv2-MIB [RFC3418] (Presuhn, R., “Management Information Base (MIB) for the Simple Network Management Protocol (SNMP),” December 2002.) 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 NHDP-MIB does not duplicate those objects.
| TOC |
[NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.) allows routing protocols to rely on the neighborhood information that is discovered by means of HELLO message exchange. In order to allow for troubleshoot, fault isolate, and manage such routing protocols through a routing protocol MIB, it may be desired to align the State Group tables of the NHDP-MIB and the routing protocol MIB. This is accomplished through the definition of two TEXTUAL-CONVENTIONS in the NHDP-MIB: the NeighborInterfaceId and the NeighborRouterId. These object types are used to develop indexes into common NHDP-MIB and routing protocol State Group tables. These objects are locally significant but should be locally common to the NHDP-MIB and the routing protocol MIB implemented on a common networked router. This will allow for improved cross referencing of information across the two MIBs.
| TOC |
This document describes several Performance Management metrics for the management of NHDP network routers. However, not all of these metrics are explicitly defined solely within the context of this NHDP-MIB. Some of these metrics are obtained through joint interaction between this MIB and the REPORT-MIB [REPORT] (Cole, R., Macker, J., and A. Morton, “Definition of Managed Objects for Performance Reporting,” July 2010.). This NHDP-MIB defines the minimum necessary objects (often of type COUNTER) which form the underlying basis for more sophisticated Performance Management reporting available in conjunction with the REPORT-MIB. See Section 5.4 (The Performance Group) for a discussion of the performance metrics for NHDP management.
| TOC |
The following NHDP-MIB module IMPORTS objects from SNMPv2-SMI [RFC2578] (McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Structure of Management Information Version 2 (SMIv2),” April 1999.), SNMPv2-TC [RFC2579] (McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Textual Conventions for SMIv2,” April 1999.), SNMPv2-CONF [RFC2580] (McCloghrie, K., Perkins, D., and J. Schoenwaelder, “Conformance Statements for SMIv2,” April 1999.), IF-MIB [RFC2863] (McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” June 2000.), INET-ADDRESS-MIB [RFC4001] (Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, “Textual Conventions for Internet Network Addresses,” February 2005.), and SMIng [RFC3781] (Strauss, F. and J. Schoenwaelder, “Next Generation Structure of Management Information (SMIng) Mappings to the Simple Network Management Protocol (SNMP),” May 2004.).
| TOC |
This section contains the MIB module defined by the specification.
NHDP-MIB DEFINITIONS ::= BEGIN
IMPORTS
MODULE-IDENTITY, OBJECT-TYPE, NOTIFICATION-TYPE,
Counter32, Integer32, Unsigned32, mib-2, TimeTicks
FROM SNMPv2-SMI --[RFC2578]
TEXTUAL-CONVENTION, TruthValue, TimeStamp,
RowStatus
FROM SNMPv2-TC --[RFC2579]
MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP
FROM SNMPv2-CONF --[STD58]
InetAddressType, InetAddress,
InetAddressPrefixLength
FROM INET-ADDRESS-MIB --[RFC4001]
InterfaceIndexOrZero
FROM IF-MIB --[RFC2863]
Float32TC
FROM FLOAT-TC-MIB --[RFCXXXX]
;
nhdpMIB MODULE-IDENTITY
LAST-UPDATED "201101031000Z" -- January 3, 2011
ORGANIZATION "IETF MANET working group"
CONTACT-INFO
"WG E-Mail: manet@ietf.org
WG Chairs: ian.chakeres@gmail.com
jmacker@nrl.navy.mil
Editors: Ulrich Herberg
Ecole Polytechnique
LIX
91128 Palaiseau Cedex
France
+33 1 69 33 41 26
ulrich@herberg.name
http://www.herberg.name/
Robert G. Cole
US Army CERDEC
Space and Terrestrial Communications
328 Hopkins Road
Bldg 245, Room 16
Aberdeen Proving Ground, MD 21005
USA
+1 410 278-6779
robert.g.cole@us.army.mil
http://www.cs.jhu.edu/~rgcole/
Ian D Chakeres
CenGen
9250 Bendix Road North
Columbia, Maryland 21045
USA
ian.chakeres@gmail.com
http://www.ianchak.com/"
DESCRIPTION
"This NHDP-MIB module is applicable to routers
implementing the Neighborhood Discovery Protocol
defined in [RFC XXXX].
Copyright (C) The IETF Trust (2009). This version
of this MIB module is part of RFC xxxx; see the RFC
itself for full legal notices."
-- revision
REVISION "201101031000Z" -- January 3, 2011
DESCRIPTION
"The tenth version of this MIB module,
published as draft-ietf-manet-nhdp-mib-07.txt.
Added FLOAT32TC from FLOAT-TC-MIB using this
for representing the link quality parameters.
Added a threshold (number) and window (time
interval) within the nhdpNotificationsControl
for the nhdpNbrStateChange, nhdp2HopNbrStateChange
and nhdpIfRxBadPacket notifications.
"
REVISION "201011111000Z" -- November 11, 2010
DESCRIPTION
"The ninth version of this MIB module,
published as draft-ietf-manet-nhdp-mib-06.txt.
Corrected editorial issues, fixed some small
bugs in the MIB."
REVISION "201011081000Z" -- November 08, 2010
DESCRIPTION
"The eight version of this MIB module,
published as draft-ietf-manet-nhdp-mib-05.txt.
Cleaned up defaults and interdependence's
between objects."
REVISION "201007071000Z" -- July 07, 2010
DESCRIPTION
"The seventh version of this MIB module,
published as draft-ietf-manet-nhdp-mib-04.txt.
Cleaned up and condensed the textual material
in the earlier sections of this draft. Checked
consistency with NHDP draft, i.e.,
draft-ietf-manet-nhdp-12.txt."
REVISION "201003081000Z" -- March 08, 2010
DESCRIPTION
"The sixth version of this MIB module,
published as draft-ietf-manet-nhdp-mib-03.txt.
Added the local nhdpIfIndex to the
nhdpIibLinkSetTable."
REVISION "200911091000Z" -- November 09, 2009
DESCRIPTION
"The fifth version of this MIB module,
published as draft-ietf-manet-nhdp-mib-02.txt.
Cleaned up a few things and updated to newest
revision of NHDP draft."
REVISION "200910211000Z" -- October 21, 2009
DESCRIPTION
"The fourth version of this MIB module,
published as draft-ietf-manet-nhdp-mib-01.txt.
Added objects pertaining to the performance
group."
REVISION "200905031500Z" -- May 3, 2009
DESCRIPTION
"The third version of this MIB module,
published as draft-ietf-manet-nhdp-mib-00.txt.
No major revisions to this draft. Mainly rev'd
as a new working group document. But also cleaned
syntax errors, typos and other issues discovered
with 'smilint'."
REVISION "200902151500Z" -- February 15, 2009
DESCRIPTION
"The second version of this MIB module,
published as draft-cole-manet-nhdp-mib-01.txt. Major
update adding objects for configuration and state."
REVISION "200804251500Z" -- April 25, 2008
DESCRIPTION
"The original version of this MIB module,
published as draft-cole-manet-nhdp-mib-00.txt."
-- RFC-Editor assigns XXXX
::= { mib-2 998 } -- to be assigned by IANA
--
-- Top-Level Components of this MIB
--
nhdpNotifications OBJECT IDENTIFIER ::= { nhdpMIB 0 }
nhdpObjects OBJECT IDENTIFIER ::= { nhdpMIB 1 }
nhdpConformance OBJECT IDENTIFIER ::= { nhdpMIB 2 }
--
-- Textual Conventions
--
NeighborIfIndex ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
STATUS current
DESCRIPTION
"A locally arbitrary unique identifier associated with an
NHDP neighbor interface.
All objects of type NeighborIfIndex are assigned by the agent
out of a common number space. In other words, NeighborIfIndex
values assigned to entries in one table must not overlap with
NeighborIfIndex values assigned to entries in another
table.
The NeighborIfIndex defines a discovered interface of a 1-hop
or 2-hop neighbor of the local router. The agent identifies a
unique neighbor interface through the receipt of an address
lists advertised through an NHDP HELLO message.
The value for each discovered neighbor interface must remain
constant at least from one re-initialization of the entity's
network management system to the next re-initialization, except
that if an application is deleted and re-created.
The specific value is meaningful only within a given SNMP
entity. An NeighborIfIndex value must not be re-used until the
next agent restart."
SYNTAX Unsigned32 (1..2147483647)
NeighborRouterId ::= TEXTUAL-CONVENTION
DISPLAY-HINT "d"
STATUS current
DESCRIPTION
"A locally arbitrary unique identifier associated with an
NHDP discovered peer router.
All objects of type NeighborRouterId are assigned by the agent
out of a common number space.
The NeighborRouterId defines a discovered NHDP peer of
the local router. The agent identifies a
unique neighbor interface through the receipt of an address
list advertised through an NHDP HELLO message.
The value for each discovered neighbor ID must remain
constant at least from one re-initialization of the entity's
network management system to the next re-initialization, except
that if an application is deleted and re-created.
The specific value is meaningful only within a given SNMP
entity. An NeighborRouterId value must not be re-used until the
next agent restart."
SYNTAX Unsigned32 (1..2147483647)
--
-- nhdpObjects
--
-- 1) Configuration Objects Group
-- 2) State Objects Group
-- 3) Performance Objects Group
--
-- nhdpConfigurationObjGrp
--
-- Contains the NHDP objects which configure specific options
-- which determine the overall performance and operation of the
-- discovery protocol.
nhdpConfigurationObjGrp OBJECT IDENTIFIER ::= { nhdpObjects 1 }
nhdpInterfaceTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"nhdpInterfaceTable describes the
configuration of the interfaces of this NHDP router.
The ifIndex is from the interfaces group
defined in the Interfaces Group MIB.
nhdpIfStatus provides the functionality
expected by the NHDP in the Local Interface Base (LIB)
Local Interface Set Table. Hence, the Local Interface
Set Table will not be defined below.
The objects in this table are persistent and when
written the entity SHOULD save the change to
non-volatile storage."
REFERENCE
"RFC 2863 - The Interfaces Group MIB, McCloghrie,
K., and F. Kastenholtz, June 2000."
::= { nhdpConfigurationObjGrp 1 }
nhdpInterfaceEntry OBJECT-TYPE
SYNTAX NhdpInterfaceEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"nhdpInterfaceEntry describes one NHDP
local interface configuration as indexed by
its ifIndex as defined in the Standard MIB II
Interface Table (RFC2863)."
INDEX { nhdpIfIndex }
::= { nhdpInterfaceTable 1 }
NhdpInterfaceEntry ::=
SEQUENCE {
nhdpIfIndex
InterfaceIndexOrZero,
nhdpIfStatus
TruthValue,
nhdpHelloInterval
Unsigned32,
nhdpHelloMinInterval
Unsigned32,
nhdpRefreshInterval
Unsigned32,
nhdpLHoldTime
Unsigned32,
nhdpHHoldTime
Unsigned32,
nhdpHystAcceptQuality
Float32TC,
nhdpHystRejectQuality
Float32TC,
nhdpInitialQuality
Float32TC,
nhdpInitialPending
TruthValue,
nhdpHpMaxJitter
Unsigned32,
nhdpHtMaxJitter
Unsigned32,
nhdpIfRowStatus
RowStatus
}
nhdpIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The ifIndex for this interface."
::= { nhdpInterfaceEntry 1 }
nhdpIfStatus OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhpdIfStatus indicates whether this interface is
a MANET interface. A value of true(1) indicates
that the interface is a MANET interface. A value of
false(2) indicates that the interface is not a MANET
interface. This corresponds to the I_manet parameter
in the Local Interface Set, which is omitted in this MIB
due to the redundancy with the nhdpInterfaceTable."
DEFVAL { 2 }
::= { nhdpInterfaceEntry 2 }
--
-- Interface Parameters - Message Intervals
--
nhdpHelloInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhpdHelloInterval corresponds to
HELLO_INTERVAL of NHDP.
The following constraint applies to this
parameter:
nhpdHelloInterval >= nhdpHelloMinInterval"
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 2000 }
::= { nhdpInterfaceEntry 3 }
nhdpHelloMinInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhpdHelloMinInterval corresponds to
HELLO_MIN_INTERVAL of NHDP."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 500 }
::= { nhdpInterfaceEntry 4 }
nhdpRefreshInterval OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhpdRefreshInterval corresponds to
REFRESH_INTERVAL of NHDP.
The following constraint applies to this
parameter:
nhdpRefreshInterval >= nhdpHelloInterval"
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 2000 }
::= { nhdpInterfaceEntry 5 }
--
-- Interface Parameters - Information Validity times
--
nhdpLHoldTime OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpLHoldTime corresponds to
L_HOLD_TIME of NHDP."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 6000 }
::= { nhdpInterfaceEntry 6 }
nhdpHHoldTime OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpHHoldTime corresponds to
H_HOLD_TIME of NHDP.
This object is persistent and when written
the entity SHOULD save the change to
non-volatile storage."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 6000 }
::= { nhdpInterfaceEntry 7 }
--
-- Interface Parameters - Link Quality
-- (is optional and settings define operation)
--
nhdpHystAcceptQuality OBJECT-TYPE
SYNTAX Float32TC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpHystAcceptQuality corresponds to
HYST_ACCEPT of NHDP.
The following constraint applies to this
parameter:
0 <= nhdpHystRejectQuality
<= nhdpHystAcceptQuality <= 1.0"
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
-- DEFVAL { 1.0 }
::= { nhdpInterfaceEntry 8 }
nhdpHystRejectQuality OBJECT-TYPE
SYNTAX Float32TC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpHystRejectQuality corresponds to
HYST_REJECT of NHDP.
The following constraint applies to this
parameter:
0 <= nhdpHystRejectQuality
<= nhdpHystAcceptQuality <= 1.0"
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
-- DEFVAL { 0.0 }
::= { nhdpInterfaceEntry 9 }
nhdpInitialQuality OBJECT-TYPE
SYNTAX Float32TC
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpInitialQuality corresponds to
INITIAL_QUALITY of NHDP.
The following constraint applies to this
parameter:
0 <= nhdpInitialQuality <= 1.0"
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
-- DEFVAL { 1.0 }
::= { nhdpInterfaceEntry 10 }
nhdpInitialPending OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpInitialPending corresponds to
INITIAL_PENDING of NHDP."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 2 } -- i.e. false
::= { nhdpInterfaceEntry 11 }
--
-- Interface Parameters - Jitter
--
nhdpHpMaxJitter OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpHpMaxJitter corresponds to
HP_MAXJITTER of NHDP."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 500 }
::= { nhdpInterfaceEntry 12 }
nhdpHtMaxJitter OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpHtMaxJitter corresponds to
HT_MAXJITTER of NHDP."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 500 }
::= { nhdpInterfaceEntry 13 }
nhdpIfRowStatus OBJECT-TYPE
SYNTAX RowStatus
MAX-ACCESS read-create
STATUS current
DESCRIPTION
"This object permits management of the table
by facilitating actions such as row creation,
construction, and destruction. The value of
this object has no effect on whether other
objects in this conceptual row can be
modified."
REFERENCE
"The NHDP draft."
::= { nhdpInterfaceEntry 14 }
--
-- Router Parameters - Information Validity Time
--
nhdpNHoldTime OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpNHoldTime corresponds to
N_HOLD_TIME of NHDP.
This object is persistent and when written
the entity SHOULD save the change to
non-volatile storage."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 6000 }
::= { nhdpConfigurationObjGrp 2 }
nhdpIHoldTime OBJECT-TYPE
SYNTAX Unsigned32
UNITS "milliseconds"
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"nhdpIHoldTime corresponds to
I_HOLD_TIME of NHDP.
This object is persistent and when written
the entity SHOULD save the change to
non-volatile storage."
REFERENCE
"The NHDP draft.
Section 5 on Protocol Parameters and
Constraints."
DEFVAL { 6000 }
::= { nhdpConfigurationObjGrp 3 }
--
-- nhdpStateObjGrp
--
-- Contains information describing the current state of the NHDP
-- process.
nhdpStateObjGrp OBJECT IDENTIFIER ::= { nhdpObjects 2 }
-- Two new constructs have been defined in this MIB for
-- indexing into the following
-- tables and indexing into other tables in other MIBs.
-- The NeighborIfIndex defines a unique (to the local router)
-- index referencing a discovered interface on another
-- router within the MANET. The NeighborRouterId defines a
-- unique (to the local router) index referencing a discovered
-- router within the MANET.
-- This table is indexed by an IpAddr associated with
-- NeighborIfIndex. Multiple addresses can be associated
-- with a given NeighborIfIndex. Each NeighborIfIndex is
-- associated with a NeighborRouterId. Throughout this MIB,
-- the NeighborIfIndex and the NeighborRouterId are used
-- to define the set of IpAddrs related to the interface
-- in discussion.
nhdpUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The number of hundredths of a second since the
current NHDP process was initialized."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 1 }
nhdpDiscIfSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpDiscIfSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's set of discovered interfaces on
neighboring routers."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 2 }
nhdpDiscIfSetEntry OBJECT-TYPE
SYNTAX NhdpDiscIfSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The entries include the nhdpDiscRouterId of
the discovered router, the nhdpDiscIfIndex
of the discovered interface and the
current set of addresses associated
with this neighbor interface. The
nhdpDiscIfIndex has to uniquely identify
the remote interface address sets. It
does not need to be unique across the MANET.
It must be unique within this router."
REFERENCE
"This document."
INDEX { nhdpDiscIfSetIpAddrType,
nhdpDiscIfSetIpAddr }
::= { nhdpDiscIfSetTable 1 }
NhdpDiscIfSetEntry ::=
SEQUENCE {
nhdpDiscIfSetRouterId
NeighborRouterId,
nhdpDiscIfSetIndex
NeighborIfIndex,
nhdpDiscIfSetIpAddrType
InetAddressType,
nhdpDiscIfSetIpAddr
InetAddress,
nhdpDiscIfSetIpAddrPrefixLen
InetAddressPrefixLength
}
nhdpDiscIfSetRouterId OBJECT-TYPE
SYNTAX NeighborRouterId
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The NHDP router ID (locally created)
of a neighboring router. Used for cross
indexing into other NHDP tables and other
MIBs."
REFERENCE
"This document."
::= { nhdpDiscIfSetEntry 1 }
nhdpDiscIfSetIndex OBJECT-TYPE
SYNTAX NeighborIfIndex
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The NHDP interface index (locally created)
of a neighbor's interface. Used for cross
indexing into other NHDP tables and other
MIBs."
REFERENCE
"This document."
::= { nhdpDiscIfSetEntry 2 }
nhdpDiscIfSetIpAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The type of the nhdpDiscIfSetIpAddr
in the InetAddress MIB [RFC 4001]."
REFERENCE
"The NHDP draft."
::= { nhdpDiscIfSetEntry 3 }
nhdpDiscIfSetIpAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The nhdpDiscIfSetIpAddr is a
recently used address of a neighbor
of this router."
REFERENCE
"The NHDP draft."
::= { nhdpDiscIfSetEntry 4 }
nhdpDiscIfSetIpAddrPrefixLen OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of leading one bits that form the
mask to be logical-ANDed with the destination address
before being compared to the value in the
nhdpDiscIfSetAddr field. If the resulting
address block is contained in a block in this
table, then a match should be returned."
REFERENCE
"The NHDP draft."
::= { nhdpDiscIfSetEntry 5 }
-- An NHDP router's Local Information Base (LIB)
-- Note: Local IF Set Table is not specified in this
-- MIB because the table would be redundant with
-- information in nhdpInterfaceTable.
-- Removed Interface Addr Set Table
-- Entry (foreach Addr): (IfAddrRemoved,
-- ExpirationTime)
nhdpLibRemovedIfAddrSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpLibRemovedIfAddrSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Removed Interface Address Set records
network addresses which were recently used as local
interface network addresses. If a router's interface
network addresses are immutable then the Removed
Interface Address Set is always empty and MAY be omitted.
It consists of Removed Interface Address Tuples, one
per network address."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 3 }
nhdpLibRemovedIfAddrSetEntry OBJECT-TYPE
SYNTAX NhdpLibRemovedIfAddrSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Removed Interface Address Set consists
of Removed Interface Address Tuples, one per network
address:
(IR_local_iface_addr, IR_time)
The association between these addrs and
the router's Interface is found in the
Standard MIB II's IP address table
(RFC1213)."
REFERENCE
"The NHDP draft."
INDEX { nhdpLibRemovedIfAddrSetIpAddrType,
nhdpLibRemovedIfAddrSetIpAddr }
::= { nhdpLibRemovedIfAddrSetTable 1 }
NhdpLibRemovedIfAddrSetEntry ::=
SEQUENCE {
nhdpLibRemovedIfAddrSetIpAddrType
InetAddressType,
nhdpLibRemovedIfAddrSetIpAddr
InetAddress,
nhdpLibRemovedIfAddrSetIpAddrPrefixLen
InetAddressPrefixLength,
nhdpLibRemovedIfAddrSetIfIndex
InterfaceIndexOrZero,
nhdpLibRemovedIfAddrSetIrTime
TimeStamp
}
nhdpLibRemovedIfAddrSetIpAddrType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The type of the nhdpLibRemovedIfAddrSetIpAddr
in the InetAddress MIB [RFC 4001]."
REFERENCE
"The NHDP draft."
::= { nhdpLibRemovedIfAddrSetEntry 1 }
nhdpLibRemovedIfAddrSetIpAddr OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"nhdpLibRemovedIfAddrSetAddr is a
recently used address of an interface of
this router."
REFERENCE
"The NHDP draft."
::= { nhdpLibRemovedIfAddrSetEntry 2 }
nhdpLibRemovedIfAddrSetIpAddrPrefixLen OBJECT-TYPE
SYNTAX InetAddressPrefixLength
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Indicates the number of leading one bits that form the
mask to be logical-ANDed with the address
to determine the network address to which
this interface is attached."
REFERENCE
"The NHDP draft."
::= { nhdpLibRemovedIfAddrSetEntry 3 }
nhdpLibRemovedIfAddrSetIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Specifies the local IfIndex from which this
IP address was recently removed."
REFERENCE
"The NHDP draft."
::= { nhdpLibRemovedIfAddrSetEntry 4 }
nhdpLibRemovedIfAddrSetIrTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"Specifies when this Tuple expires and MUST be removed
from this table."
REFERENCE
"The NHDP draft."
::= { nhdpLibRemovedIfAddrSetEntry 5 }
-- Interface Information Base (IIB)
--
-- NHDP Interface Information Base (IIB)
--
-- IIB Link Set
-- Entry (foreach 1-H neighbor): (NeighborIfAddrList,
-- HeardTime,
-- SymTime,
-- Quality,
-- Pending,
-- Lost,
-- ExpireTime)
nhdpIibLinkSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpIibLinkSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A Link Set of an interface records links from
other routers which are, or recently
were, 1-hop neighbors."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 4 }
nhdpIibLinkSetEntry OBJECT-TYPE
SYNTAX NhdpIibLinkSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A Link Set consists of Link Tuples, each
representing a single link indexed by the
local and remote interface pair:
(L_neighbor_iface_addr_list, L_HEARD_time,
L_SYM_time, L_quality, L_pending,
L_lost, L_time).
Note that L_quality is not included in the
entries below, because updates may be
required too frequently."
REFERENCE
"This document."
INDEX { nhdpIfIndex,
nhdpIibLinkSet1HopIfIndex }
::= { nhdpIibLinkSetTable 1 }
NhdpIibLinkSetEntry ::=
SEQUENCE {
nhdpIibLinkSet1HopIfIndex
NeighborIfIndex,
nhdpIibLinkSetIfIndex
InterfaceIndexOrZero,
nhdpIibLinkSetLHeardTime
TimeStamp,
nhdpIibLinkSetLSymTime
TimeStamp,
nhdpIibLinkSetLPending
TruthValue,
nhdpIibLinkSetLLost
TruthValue,
nhdpIibLinkSetLTime
TimeStamp
}
nhdpIibLinkSet1HopIfIndex OBJECT-TYPE
SYNTAX NeighborIfIndex
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"nhdpIibLinkSet1HopIfIndex is
the value of the NeighborIfIndex (from
nhdpDiscIfSetTable). This
object is repeated here to support
table walks to view the set of neighbors
of this router."
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 1 }
nhdpIibLinkSetIfIndex OBJECT-TYPE
SYNTAX InterfaceIndexOrZero
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetIfIndex is
the local router's interface
index associated with the symmetric
link to this entrie's neighbor
interface.
The set of IP addresses associated with
this neighbor's interface is found in
nhdpDiscIfSetTable."
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 2 }
nhdpIibLinkSetLHeardTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetLHeardTime corresponds
to L_HEARD_time of NHDP."
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 3 }
nhdpIibLinkSetLSymTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetLSymTime corresponds
to L_SYM_time of NHDP."
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 4 }
nhdpIibLinkSetLPending OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetLPending corresponds
to L_pending of NHDP"
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 5 }
nhdpIibLinkSetLLost OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetLLost corresponds
to L_lost of NHDP"
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 6 }
nhdpIibLinkSetLTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIibLinkSetLTime specifies
when this Tuple expires and MUST
be removed."
REFERENCE
"The NHDP draft."
::= { nhdpIibLinkSetEntry 7 }
--
-- IIB 2-Hop Set
-- Entry (foreach IF on a 2-H neighbor):
-- (1NeighIfAddrList,
-- 2NeighIfAddr,
-- ExpireTime)
--
nhdpIib2HopSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpIib2HopSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A 2-Hop Set of an interface records network
addresses of symmetric 2-hop neighbors, and
the symmetric links to symmetric 1-hop neighbors
through which these symmetric 2-hop neighbors
can be reached. It consists of 2-Hop Tuples,
each representing a single network address of
a symmetric 2-hop neighbor, and a single MANET
interface of a symmetric 1-hop neighbor.
(N2_neighbor_iface_addr_list,
N2_2hop_addr, N2_time)."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 5 }
nhdpIib2HopSetEntry OBJECT-TYPE
SYNTAX NhdpIib2HopSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The entries include the 2-hop neighbor addresses,
which act as the table index, and associated
1-hop symmetric link address set, designated
through nhdpDiscIfIndex, and an expiration time."
REFERENCE
"This document."
INDEX { nhdpIib2HopSetIpAddressType,
nhdpIib2HopSetIpAddress }
::= { nhdpIib2HopSetTable 1 }
NhdpIib2HopSetEntry ::=
SEQUENCE {
nhdpIib2HopSetIpAddressType
InetAddressType,
nhdpIib2HopSetIpAddress
InetAddress,
nhdpIib2HopSet1HopIfIndex
NeighborIfIndex,
nhdpIib2HopSetN2Time
TimeStamp
}
nhdpIib2HopSetIpAddressType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The type of the nhdpIib2HopSetIpAddress
in the InetAddress MIB [RFC 4001]."
REFERENCE
"The NHDP draft."
::= { nhdpIib2HopSetEntry 1 }
nhdpIib2HopSetIpAddress OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIib2HopSetIpAddr corresponds
to N2_2hop_addr of NHDP."
REFERENCE
"The NHDP draft."
::= { nhdpIib2HopSetEntry 2 }
nhdpIib2HopSet1HopIfIndex OBJECT-TYPE
SYNTAX NeighborIfIndex
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIib2HopSet1HopIfIndex is
NeighborIfIndex of the one hop
neighbor which communicated the ipAddress
of the 2-hop neighbor in this row entry."
REFERENCE
"The NHDP draft."
::= { nhdpIib2HopSetEntry 3 }
nhdpIib2HopSetN2Time OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpIib2HopSetN2Time specifies
when this column entry expires and
MUST be removed."
REFERENCE
"The NHDP draft."
::= { nhdpIib2HopSetEntry 4 }
--
-- Neighbor Information Base (NIB)
--
-- Each router maintains a Neighbor Information Base
-- that records information about addresses of
-- current and recently symmetric 1-hop neighbors.
-- NIB Neighbor Set
-- Entry (foreach 1-H Neighbor):
-- (AllIfAddrListOfIhNeighbor,
-- SymmetricIndicator)
-- The NIB Neighbor Set Table is small because
-- most of the corresponding information is found
-- in the nhdpDiscoveredIfTable above.
--
nhdpNibNeighborSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpNibNeighborSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Neighbor Set records all network
addresses of each 1-hop neighbor."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 6 }
nhdpNibNeighborSetEntry OBJECT-TYPE
SYNTAX NhdpNibNeighborSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Neighbor Set consists
of Neighbor Tuples, each representing
a single 1-hop neighbor:
(N_neighbor_addr_list,
N_symmetric)"
REFERENCE
"This document."
INDEX { nhdpDiscIfSetRouterId }
::= { nhdpNibNeighborSetTable 1 }
NhdpNibNeighborSetEntry ::=
SEQUENCE {
nhdpNibNeighborSetNSymmetric
TruthValue
}
nhdpNibNeighborSetNSymmetric OBJECT-TYPE
SYNTAX TruthValue
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpNibNeighborNSymmetric corresponds
to N_symmetric of NHDP."
REFERENCE
"The NHDP draft."
::= { nhdpNibNeighborSetEntry 1 }
-- Lost Neighbor Set
-- Entry ( foreach IF foreach 1-H Neighbor): (IfAddr,
-- ExpireTime)
--
nhdpNibLostNeighborSetTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpNibLostNeighborSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Lost Neighbor Set records network
addresses of routers which recently were
symmetric 1-hop neighbors, but which are now
advertised as lost."
REFERENCE
"The NHDP draft."
::= { nhdpStateObjGrp 7 }
nhdpNibLostNeighborSetEntry OBJECT-TYPE
SYNTAX NhdpNibLostNeighborSetEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's Lost Neighbor Set consists of
Lost Neighbor Tuples, each representing a
single such network address:
(NL_neighbor_addr, NL_time)"
REFERENCE
"This document."
INDEX { nhdpDiscIfSetRouterId }
::= { nhdpNibLostNeighborSetTable 1 }
NhdpNibLostNeighborSetEntry ::=
SEQUENCE {
nhdpNibLostNeighborSetNLTime
TimeStamp
}
nhdpNibLostNeighborSetNLTime OBJECT-TYPE
SYNTAX TimeStamp
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"nhdpNibLostNeighborSetNLTime
specifies when this Tuple expires
and MUST be removed."
REFERENCE
"The NHDP draft."
::= { nhdpNibLostNeighborSetEntry 1 }
--
-- nhdpPerformanceObjGrp
--
-- Contains objects which help to characterize the performance of
-- the NHDP process, typically counters.
--
nhdpPerformanceObjGrp OBJECT IDENTIFIER ::= { nhdpObjects 3 }
--
-- Objects per local interface
--
nhdpInterfacePerfTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpInterfacePerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table summarizes performance objects that are
measured per local NHDP interface."
REFERENCE
"The NHDP draft."
::= { nhdpPerformanceObjGrp 1 }
nhdpInterfacePerfEntry OBJECT-TYPE
SYNTAX NhdpInterfacePerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A single entry contains performance counters for
a local NHDP interface."
INDEX { nhdpIfIndex }
::= { nhdpInterfacePerfTable 1 }
NhdpInterfacePerfEntry ::=
SEQUENCE {
nhdpIfHelloMessageXmits
Counter32,
nhdpIfHelloMessageRecvd
Counter32,
nhdpIfHelloMessageXmitAccumulatedSize
Counter32,
nhdpIfHelloMessageRecvdAccumulatedSize
Counter32,
nhdpIfHelloMessageTriggeredXmits
Counter32,
nhdpIfHelloMessagePeriodicXmits
Counter32,
nhdpIfHelloMessageXmitAccumulatedSymmetricNeighborCount
Counter32,
nhdpIfHelloMessageXmitAccumulatedHeardNeighborCount
Counter32,
nhdpIfHelloMessageXmitAccumulatedLostNeighborCount
Counter32
}
nhdpIfHelloMessageXmits OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented each time a HELLO
message has been transmitted on that interface."
::= { nhdpInterfacePerfEntry 1 }
nhdpIfHelloMessageRecvd OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented each time a
HELLO message has been received on that interface."
::= { nhdpInterfacePerfEntry 2 }
nhdpIfHelloMessageXmitAccumulatedSize OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented by the number of octets in
a HELLO message each time a
HELLO message has been sent."
::= { nhdpInterfacePerfEntry 3 }
nhdpIfHelloMessageRecvdAccumulatedSize OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented by the number of octets in
a HELLO message each time a
HELLO message has been received."
::= { nhdpInterfacePerfEntry 4 }
nhdpIfHelloMessageTriggeredXmits OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented each time a triggered
HELLO message has been sent."
::= { nhdpInterfacePerfEntry 5 }
nhdpIfHelloMessagePeriodicXmits OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented each time a periodic
HELLO message has been sent."
::= { nhdpInterfacePerfEntry 6 }
nhdpIfHelloMessageXmitAccumulatedSymmetricNeighborCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented by the number of advertised
symmetric neighbors in a HELLO each time a HELLO
message has been sent."
::= { nhdpInterfacePerfEntry 7 }
nhdpIfHelloMessageXmitAccumulatedHeardNeighborCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented by the number of advertised
heard neighbors in a HELLO each time a HELLO
message has been sent."
::= { nhdpInterfacePerfEntry 8 }
nhdpIfHelloMessageXmitAccumulatedLostNeighborCount OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"A counter is incremented by the number of advertised
lost neighbors in a HELLO each time a HELLO
message has been sent."
::= { nhdpInterfacePerfEntry 9 }
--
-- Objects per discovered neighbor interface
--
nhdpDiscIfSetPerfTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpDiscIfSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's set of performance properties for
each discovered interface of a neighbor."
REFERENCE
"The NHDP draft."
::= { nhdpPerformanceObjGrp 2 }
nhdpDiscIfSetPerfEntry OBJECT-TYPE
SYNTAX NhdpDiscIfSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"There is an entry for each discovered
interface of a neighbor."
REFERENCE
"This document."
INDEX { nhdpDiscIfSetIndex }
::= { nhdpDiscIfSetPerfTable 1 }
NhdpDiscIfSetPerfEntry ::=
SEQUENCE {
nhdpDiscIfRecvdPackets
Counter32,
nhdpDiscIfExpectedPackets
Counter32
}
nhdpDiscIfRecvdPackets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments each
time this router receives a packet from that interface
of the neighbor."
REFERENCE
"The NHDP draft."
::= { nhdpDiscIfSetPerfEntry 1 }
nhdpDiscIfExpectedPackets OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments by the number
of missed packets from this neighbor based
on the packet sequence number each time this
router receives a packet from that interface
of the neighbor."
REFERENCE
"The NHDP draft."
::= { nhdpDiscIfSetPerfEntry 2 }
--
-- Objects concerning the neighbor set
--
nhdpNibNeighborSetChanges OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments each time the Neighbor Set changes.
A change occurs whenever a new Neighbor Tuple has been
added, a Neighbor Tuple has been removed or any entry of
a Neighbor Tuple has been modified."
::= { nhdpPerformanceObjGrp 3 }
--
-- Objects per discovered neighbor
--
nhdpDiscNeighborSetPerfTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpDiscNeighborSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"A router's set of discovered neighbors and
their properties."
REFERENCE
"The NHDP draft."
::= { nhdpPerformanceObjGrp 4 }
nhdpDiscNeighborSetPerfEntry OBJECT-TYPE
SYNTAX NhdpDiscNeighborSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The entries include the nhdpDiscRouterId of
the discovered router, as well as performance
objects related to changes of the Neighbor
Set."
REFERENCE
"This document."
INDEX { nhdpDiscIfSetRouterId }
::= { nhdpDiscNeighborSetPerfTable 1 }
NhdpDiscNeighborSetPerfEntry ::=
SEQUENCE {
nhdpDiscNeighborNibNeighborSetChanges
Counter32,
nhdpDiscNeighborNibNeighborSetUpTime
TimeTicks,
nhdpDiscNeighborNibNeighborSetReachableLinkChanges
Counter32
}
nhdpDiscNeighborNibNeighborSetChanges OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments each time the neighbor becomes
onlink or offlink. A neighbor is said to become
'onlink' if a new nhdpNibNeighborSetEntry is created
for a particular nhdpNibNeighborSetRouterId. It becomes
'offlink' if the entry for that neighbor has been deleted."
REFERENCE
"The NHDP draft."
::= { nhdpDiscNeighborSetPerfEntry 1 }
nhdpDiscNeighborNibNeighborSetUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object returns the time in hundredths of a second since
the neighbor becomes 'onlink'. A neighbor is
said to become 'onlink' if a new nhdpNibNeighborSetEntry
is created for a particular nhdpNibNeighborSetRouterId.
It becomes 'offlink' if the entry for that neighbor
has been deleted."
REFERENCE
"This document."
::= { nhdpDiscNeighborSetPerfEntry 2 }
nhdpDiscNeighborNibNeighborSetReachableLinkChanges OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments each
time the neighbor changes the interface over which it is
reachable. That means that the corresponding Link Tuple of the
given link moves from the Link Set of one interface to another
interface."
REFERENCE
"The NHDP draft."
::= { nhdpDiscNeighborSetPerfEntry 3 }
--
-- Objects per discovered 2-hop neighbor
--
nhdpIib2HopSetPerfTable OBJECT-TYPE
SYNTAX SEQUENCE OF NhdpIib2HopSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"This table contains performance objects per
discovered 2-hop neighbor."
REFERENCE
"The NHDP draft."
::= { nhdpPerformanceObjGrp 5 }
nhdpIib2HopSetPerfEntry OBJECT-TYPE
SYNTAX NhdpIib2HopSetPerfEntry
MAX-ACCESS not-accessible
STATUS current
DESCRIPTION
"The entries contain performance objects per
discovered 2-hop neighbor."
REFERENCE
"This document."
INDEX { nhdpDiscIfSetRouterId }
::= { nhdpIib2HopSetPerfTable 1 }
NhdpIib2HopSetPerfEntry ::=
SEQUENCE {
nhdpIib2HopSetPerfChanges
Counter32,
nhdpIib2HopSetPerfUpTime
TimeTicks
}
nhdpIib2HopSetPerfChanges OBJECT-TYPE
SYNTAX Counter32
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This counter increments each
time this 2-hop neighbor changes its
N2_neighbor_iface_addr_list in the
nhdpIib2HopSetTable."
REFERENCE
"The NHDP draft."
::= { nhdpIib2HopSetPerfEntry 1 }
nhdpIib2HopSetPerfUpTime OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"This object returns the time in hundredths of
a second when the 2-Hop Tuple
corresponding to the given 2-hop neighbor IP address
was registered in the nhdpIib2HopSetTable."
REFERENCE
"This document."
::= { nhdpIib2HopSetPerfEntry 2 }
--
-- nhdpNotifications
--
nhdpNotificationsControl OBJECT IDENTIFIER ::= { nhdpNotifications 1 }
nhdpNotificationsObjects OBJECT IDENTIFIER ::= { nhdpNotifications 2 }
nhdpNotificationsStates OBJECT IDENTIFIER ::= { nhdpNotifications 3 }
-- nhdpNotificationsControl
nhdpSetNotification OBJECT-TYPE
SYNTAX OCTET STRING (SIZE(4))
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A 4-octet string serving as a bit map for
the notification events defined by the NHDP
notifications. This object is used to enable
and disable specific NHDP notifications where
a 1 in the bit field represents enabled. The
right-most bit (least significant) represents
notification 0.
This object is persistent and when written
the entity SHOULD save the change to
non-volatile storage.
"
::= { nhdpNotificationsControl 1 }
nhdpNbrStateChangeThreshold OBJECT-TYPE
SYNTAX Integer32 (0..255)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A threshold value for the
nhdpNbrStateChange object. If the
number of occurences exceeds this threshold
within the previous nhdpNbrStateChangeWindow,
then the nhdpNbrStateChange notification
is to be sent.
"
::= { nhdpNotificationsControl 2 }
nhdpNbrStateChangeWindow OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A time window for the
nhdpNbrStateChange object. If the
number of occurences exceeds the
nhdpNbrStateChangeThreshold
within the previous nhdpNbrStateChangeWindow,
then the nhdpNbrStateChange notification
is to be sent.
This object represents the time in hundredths
of a second.
"
::= { nhdpNotificationsControl 3 }
nhdp2HopNbrStateChangeThreshold OBJECT-TYPE
SYNTAX Integer32 (0..255)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A threshold value for the
nhdp2HopNbrStateChange object. If the
number of occurences exceeds this threshold
within the previous nhdp2HopNbrStateChangeWindow,
then the nhdp2HopNbrStateChange notification
is to be sent.
"
::= { nhdpNotificationsControl 4 }
nhdp2HopNbrStateChangeWindow OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A time window for the
nhdp2HopNbrStateChange object. If the
number of occurences exceeds the
nhdp2HopNbrStateChangeThreshold
within the previous nhdp2HopNbrStateChangeWindow,
then the nhdp2HopNbrStateChange notification
is to be sent.
This object represents the time in hundredths
of a second.
"
::= { nhdpNotificationsControl 5 }
nhdpIfRxBadPacketThreshold OBJECT-TYPE
SYNTAX Integer32 (0..255)
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A threshold value for the
nhdpIfRxBadPacket object. If the
number of occurences exceeds this threshold
within the previous nhdpIfRxBadPacketWindow,
then the nhdpIfRxBadPacket notification
is to be sent.
"
::= { nhdpNotificationsControl 6 }
nhdpIfRxBadPacketWindow OBJECT-TYPE
SYNTAX TimeTicks
MAX-ACCESS read-write
STATUS current
DESCRIPTION
"A time window for the
nhdpIfRxBadPacket object. If the
number of occurences exceeds the
nhdpIfRxBadPacketThreshold
within the previous nhdpIfRxBadPacketWindow,
then the nhdpIfRxBadPacket notification
is to be sent.
This object represents the time in hundredths
of a second.
"
::= { nhdpNotificationsControl 7 }
-- nhdpNotificationsObjects
nhdpNbrStateChange NOTIFICATION-TYPE
OBJECTS { nhdpDiscIfSetRouterId, -- The originator of
-- the notification.
nhdpNbrState -- The new state
}
STATUS current
DESCRIPTION
"nhdpNbrStateChange is a notification sent when a
significant number of neighbors change their status
(i.e. down, asymmetric, or symmetric) in a short
time. The network administrator should select
appropriate values for 'significant number of
neighbors' and 'short time'."
::= { nhdpNotificationsObjects 1 }
nhdp2HopNbrStateChange NOTIFICATION-TYPE
OBJECTS { nhdpIib2HopSetIpAddress, -- The originator
-- of the notification
nhdp2HopNbrState -- The new state
}
STATUS current
DESCRIPTION
"nhdp2HopNbrStateChange is a notification sent
when a significant number of 2-hop neighbors
change their status (i.e. up or down) in a short
time. The network administrator should select
appropriate values for 'significant number of
neighbors' and 'short time'."
::= { nhdpNotificationsObjects 2 }
nhdpIfRxBadPacket NOTIFICATION-TYPE
OBJECTS { nhdpDiscIfSetRouterId, -- The originator of
-- the notification
nhdpDiscIfSetIndex, -- The interface on which the
-- packet has been received
nhdpPacketSrcType, -- The type of the source IP
-- address of the packet
nhdpPacketSrc -- The source IP address of
-- the packet
}
STATUS current
DESCRIPTION
"nhdpIfRxBadPacket is a notification sent when a
significant number of incoming packets have not
been successfully parsed in a short time. The
network administrator should select appropriate
values for 'significant number of neighbors'
and 'short time'."
::= { nhdpNotificationsObjects 3 }
nhdpIfStateChange NOTIFICATION-TYPE
OBJECTS { nhdpIfIndex, -- The local interface
nhdpIfState -- The new state
}
STATUS current
DESCRIPTION
"nhdpIfStateChange is a notification sent when
the status of an interface of this router has
changed (i.e. an IP address has been added or
removed to the interface, or the interface has
changed its status from up to down or vice versa)."
::= { nhdpNotificationsObjects 4 }
-- nhdpNotificationStates
nhdpNbrState OBJECT-TYPE
SYNTAX INTEGER {
down (0),
asymmetric (1),
symmetric(2)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"NHDP neighbor states."
DEFVAL { down }
::= { nhdpNotificationsStates 1 }
nhdp2HopNbrState OBJECT-TYPE
SYNTAX INTEGER {
down (0),
up (1)
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"NHDP 2hop neighbor states."
DEFVAL { down }
::= { nhdpNotificationsStates 2 }
nhdpIfState OBJECT-TYPE
SYNTAX INTEGER {
down (0),
up (1),
addresschange(2) -- If a new address has been
-- added or an address has
-- been removed
}
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"NHDP interface states."
DEFVAL { down }
::= { nhdpNotificationsStates 3 }
nhdpPacketSrcType OBJECT-TYPE
SYNTAX InetAddressType
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The IP address type of the
address of an inbound packet that
cannot be identified by a neighbor instance."
::= { nhdpNotificationsStates 4 }
nhdpPacketSrc OBJECT-TYPE
SYNTAX InetAddress
MAX-ACCESS read-only
STATUS current
DESCRIPTION
"The IP address of an inbound packet that
cannot be identified by a neighbor instance. When
the last value of a notification using this object is
needed, but no notifications of that type have been sent,
this value pertaining to this object should
be returned as 0.0.0.0 or :: respectively."
::= { nhdpNotificationsStates 5 }
--
-- nhdpConformance information
--
nhdpCompliances OBJECT IDENTIFIER ::= { nhdpConformance 1 }
nhdpMIBGroups OBJECT IDENTIFIER ::= { nhdpConformance 2 }
-- Compliance Statements
nhdpBasicCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The basic implementation requirements for
managed network entities that implement
NHDP."
MODULE -- this module
MANDATORY-GROUPS { nhdpConfigurationGroup }
::= { nhdpCompliances 1 }
nhdpFullCompliance MODULE-COMPLIANCE
STATUS current
DESCRIPTION
"The full implementation requirements for
managed network entities that implement
NHDP."
MODULE -- this module
MANDATORY-GROUPS { nhdpConfigurationGroup,
nhdpStateGroup,
nhdpPerformanceGroup,
nhdpNotificationObjectGroup,
nhdpNotificationGroup,
nhdpPerformanceGroup }
::= { nhdpCompliances 2 }
--
-- Units of Conformance
--
nhdpConfigurationGroup OBJECT-GROUP
OBJECTS {
nhdpIfIndex,
nhdpIfStatus,
nhdpHelloInterval,
nhdpHelloMinInterval,
nhdpRefreshInterval,
nhdpLHoldTime,
nhdpHHoldTime,
nhdpHystAcceptQuality,
nhdpHystRejectQuality,
nhdpInitialQuality,
nhdpInitialPending,
nhdpHpMaxJitter,
nhdpHtMaxJitter,
nhdpNHoldTime,
nhdpIHoldTime,
nhdpIfRowStatus
}
STATUS current
DESCRIPTION
"Set of NHDP configuration objects implemented
in this module."
::= { nhdpMIBGroups 2 }
nhdpStateGroup OBJECT-GROUP
OBJECTS {
nhdpUpTime,
nhdpDiscIfSetRouterId,
nhdpDiscIfSetIndex,
nhdpDiscIfSetIpAddrPrefixLen,
nhdpLibRemovedIfAddrSetIpAddrPrefixLen,
nhdpLibRemovedIfAddrSetIfIndex,
nhdpLibRemovedIfAddrSetIrTime,
nhdpIibLinkSetIfIndex,
nhdpIibLinkSetLHeardTime,
nhdpIibLinkSetLSymTime,
nhdpIibLinkSetLPending,
nhdpIibLinkSetLLost,
nhdpIibLinkSetLTime,
nhdpIib2HopSetIpAddressType,
nhdpIib2HopSetIpAddress,
nhdpIib2HopSet1HopIfIndex,
nhdpIib2HopSetN2Time,
nhdpNibNeighborSetNSymmetric,
nhdpNibLostNeighborSetNLTime
}
STATUS current
DESCRIPTION
"Set of NHDP state objects implemented
in this module."
::= { nhdpMIBGroups 3 }
nhdpPerformanceGroup OBJECT-GROUP
OBJECTS {
nhdpIfHelloMessageXmits,
nhdpIfHelloMessageRecvd,
nhdpIfHelloMessageXmitAccumulatedSize,
nhdpIfHelloMessageRecvdAccumulatedSize,
nhdpIfHelloMessageTriggeredXmits,
nhdpIfHelloMessagePeriodicXmits,
nhdpIfHelloMessageXmitAccumulatedSymmetricNeighborCount,
nhdpIfHelloMessageXmitAccumulatedHeardNeighborCount,
nhdpIfHelloMessageXmitAccumulatedLostNeighborCount,
nhdpDiscIfRecvdPackets,
nhdpDiscIfExpectedPackets,
nhdpNibNeighborSetChanges,
nhdpDiscNeighborNibNeighborSetChanges,
nhdpDiscNeighborNibNeighborSetUpTime,
nhdpDiscNeighborNibNeighborSetReachableLinkChanges,
nhdpIib2HopSetPerfChanges,
nhdpIib2HopSetPerfUpTime
}
STATUS current
DESCRIPTION
"Set of NHDP performance objects implemented
in this module."
::= { nhdpMIBGroups 4 }
nhdpNotificationObjectGroup OBJECT-GROUP
OBJECTS {
nhdpSetNotification,
nhdpNbrStateChangeThreshold,
nhdpNbrStateChangeWindow,
nhdp2HopNbrStateChangeThreshold,
nhdp2HopNbrStateChangeWindow,
nhdpIfRxBadPacketThreshold,
nhdpIfRxBadPacketWindow,
nhdpIfState,
nhdpNbrState,
nhdp2HopNbrState,
nhdpPacketSrcType,
nhdpPacketSrc
}
STATUS current
DESCRIPTION
"Set of NHDP notification objects implemented
in this module."
::= { nhdpMIBGroups 5 }
nhdpNotificationGroup NOTIFICATION-GROUP
NOTIFICATIONS {
nhdpNbrStateChange,
nhdp2HopNbrStateChange,
nhdpIfRxBadPacket,
nhdpIfStateChange
}
STATUS current
DESCRIPTION
"Set of NHDP notifications implemented
in this module."
::= { nhdpMIBGroups 6 }
END
| TOC |
This MIB defines objects for the configuration, monitoring and notification of the Neighborhood Discovery Protocol [NHDP] (Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” December 2010.). NHDP allows routers to acquire topological information up to two hops away by virtue of exchanging HELLO messages. The information acquired by NHDP may be used by routing protocols. The neighborhood information, exchanged between routers using NHDP, serves these routing protocols as a baseline for calculating paths to all destinations in the MANET, relay set selection for network-wide transmissions etc.
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:
Some of the readable objects in this MIB module (i.e., objects with a MAX-ACCESS other than not-accessible) may be considered sensitive or vulnerable in some network environments. It is thus important to control even GET and/or NOTIFY access to these objects and possibly to even encrypt the values of these objects when sending them over the network via SNMP. These are the tables and objects and their sensitivity/vulnerability:
MANET technology is often deployed to support communications of emergency services or military tactical applications. In these applications, it is imperative to maintain the proper operation of the communications network and to protect sensitive information related to its operation. Therefore, when implementing these capabilities, the full use of SNMPv3 cryptographic mechanisms for authentication and privacy is RECOMMENDED.
SNMP versions prior to SNMPv3 did not include adequate security. Even if the network itself is secure (for example by using IPSec), there is no control as to who on the secure network is allowed to access and GET/SET (read/change/create/delete) the objects in this MIB module.
It is RECOMMENDED that implementers consider the security features as provided by the SNMPv3 framework (see [RFC3410] (Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” December 2002.), 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.
| TOC |
Editor's Note (to be removed prior to publication): the 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. Note well: prior to official assignment by the IANA, a draft document MUST use placeholders (such as "XXXX" above) rather than actual numbers. See RFC4181 Section 4.5 for an example of how this is done in a draft MIB module.
| TOC |
This MIB document uses the template authored by D. Harrington which is based on contributions from the MIB Doctors, especially Juergen Schoenwaelder, Dave Perkins, C.M.Heard and Randy Presuhn.
| TOC |
| TOC |
| [RFC2863] | McCloghrie, K. and F. Kastenholz, “The Interfaces Group MIB,” RFC 2863, June 2000 (TXT). |
| [RFC3418] | Presuhn, R., “Management Information Base (MIB) for the Simple Network Management Protocol (SNMP),” STD 62, RFC 3418, December 2002 (TXT). |
| [RFC2119] | Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels,” BCP 14, RFC 2119, March 1997 (TXT, HTML, XML). |
| [RFC2578] | McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Structure of Management Information Version 2 (SMIv2),” STD 58, RFC 2578, April 1999 (TXT). |
| [RFC2579] | McCloghrie, K., Ed., Perkins, D., Ed., and J. Schoenwaelder, Ed., “Textual Conventions for SMIv2,” STD 58, RFC 2579, April 1999 (TXT). |
| [RFC2580] | McCloghrie, K., Perkins, D., and J. Schoenwaelder, “Conformance Statements for SMIv2,” STD 58, RFC 2580, April 1999 (TXT). |
| [NHDP] | Clausen, T., Dearlove, C., and J. Dean, “Mobile Ad Hoc Network (MANET) Neighborhood Discovery Protocol (NHDP),” draft-ietf-manet-nhdp-15 (work in progress), December 2010 (TXT). |
| [RFC4001] | Daniele, M., Haberman, B., Routhier, S., and J. Schoenwaelder, “Textual Conventions for Internet Network Addresses,” RFC 4001, February 2005 (TXT). |
| TOC |
| [REPORT] | Cole, R., Macker, J., and A. Morton, “Definition of Managed Objects for Performance Reporting,” draft-ietf-manet-report-mib-00 (work in progress), July 2010 (TXT). |
| [RFC4750] | Joyal, D., Galecki, P., Giacalone, S., Coltun, R., and F. Baker, “OSPF Version 2 Management Information Base,” RFC 4750, December 2006 (TXT). |
| [RFC3410] | Case, J., Mundy, R., Partain, D., and B. Stewart, “Introduction and Applicability Statements for Internet-Standard Management Framework,” RFC 3410, December 2002 (TXT). |
| [RFC3781] | Strauss, F. and J. Schoenwaelder, “Next Generation Structure of Management Information (SMIng) Mappings to the Simple Network Management Protocol (SNMP),” RFC 3781, May 2004 (TXT). |
| TOC |
This section contains the set of open issues related to the development and design of the NHDP-MIB. This section will not be present in the final version of the MIB and will be removed once all the open issues have been resolved.
| TOC |
*************************************************************** * Note to the RFC Editor (to be removed prior to publication) * * * * 1) The reference to RFCXXXX within the DESCRIPTION clauses * * of the MIB module point to this draft and are to be * * assigned by the RFC Editor. * * * * 2) The reference to RFCXXX2 throughout this document point * * to the current draft-ietf-manet-nhdp-mib-xx.txt. This * * need to be replaced with the XXX RFC number. * * * ***************************************************************
| TOC |
| Ulrich Herberg | |
| LIX, Ecole Polytechnique | |
| Palaiseau Cedex, 91128 | |
| France | |
| EMail: | ulrich@herberg.name |
| URI: | http://www.herberg.name/ |
| Robert G. Cole | |
| US Army CERDEC | |
| 328 Hopkins Road, Bldg 245 | |
| Aberdeen Proving Ground, Maryland 21005 | |
| USA | |
| Phone: | +1 410 278 6779 |
| EMail: | robert.g.cole@us.army.mil |
| URI: | http://www.cs.jhu.edu/~rgcole/ |
| Ian D Chakeres | |
| CenGen | |
| 9250 Bendix Road North | |
| Columbia, Maryland 560093 | |
| USA | |
| EMail: | ian.chakeres@gmail.com |
| URI: | http://www.ianchak.com/ |