Network Working Group E. Stephan/J. Jewitt Internet Draft France Telecom R&D Document:draft-ietf-ippm-reporting-mib-02.txt March 1st,draft-ietf-ippm-reporting-mib-03.txt June, 2003 IPPM reporting MIB Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026 [1]. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or made obsolete 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." The list of current Internet-Drafts can be accessed at http://www.ietf.org/ietf/1id-abstracts.txt. The list of Internet-Draft Shadow Directories can be accessed at http://www.ietf.org/shadow.html. Abstract This memo defines a portion of the Management Information Base (MIB) designed for use with network management protocols in TCP/IP-based internets. In particular, this MIB specifies the objects used for managing the results of the IPPM metrics measures, for pushing alarms, and for reporting the measures results. Table of Contents 1.Introduction................................................3Introduction................................................2 2. The IPPM Framework..........................................3 3. The SNMP Management Framework...............................3 4. Overview....................................................5 4.1. Textual Conventions.........................................64.2.4.2 Structure of theMIB........................................8 4.3.MIB.........................................8 4.3 Row identification in an applicationnamespace.............10 4.4.namespace..............10 4.4 Relationship of IPPM REPORTING MIBtables............................11 5. IPPM-REPORTING-MIB conceptual presentation.................15 5.1. IPPM-REPORTING-MIB diagram.................................15 5.2. Conceptual programming interface...........................16 5.3. SNMP mapping...............................................16 6.tables...................11 5 Measurementarchitectures..................................17 6.1.architectures...................................12 5.1 Proxyarchitecture.........................................17 6.2.architecture..........................................12 5.2 Reportingarchitecture.....................................18 6.3.architecture......................................13 5.3 Gatewayarchitecture.......................................20 6.4. Security...................................................20 7.architecture........................................15 5.4 Security....................................................15 6 Reporting modeintegration.................................21 7.1. Integration................................................21 7.2.integration..................................16 6.1 Integration.................................................16 6.2 Setup of themeasure.......................................21 7.3.measure network................................16 6.3 Setup ofthea measurementreport............................22 7.4. Writingreport...............................16 6.4 Updating theresults inhistory of theIPPM-REPORTING-MIB..............22 7.5.MIB.............................17 6.5 Report download andupload.................................23 7.6.upload..................................17 6.6 Defaultvalue..............................................23 8. Definition.................................................24 9.value...............................................17 7 Definition..................................................17 8 SecurityConsiderations....................................67 9.1. Privacy....................................................67 9.2.Considerations.....................................71 8.1 VACM Access control.........................................71 8.2 Privacy.....................................................74 8.3 Measurementaspects........................................67 9.3.aspects.........................................74 8.4 Managementaspects.........................................68 10.aspects..........................................75 9 Documentmanagement........................................69 10.1.management.........................................75 9.1 Openissues.................................................69 10.2. changes since release 00....................................69 10.3.issues.................................................76 9.2 Changes done since release01....................................70 11. References.................................................72 12. Acknowledgments............................................73 13.02...............................76 10 References..................................................77 11 Acknowledgments.............................................78 12 AuthorsAddresses..........................................73Addresses...........................................78 1. Introduction This memo defines a MIB for managingmeasuresnetwork measurements based upon the IP performance metrics specified by the IPPM Working Group. The definition of objects in the IPPM MIB are built on notions introduced and discussed in the IPPM Framework document, RFC 2330 [ii]. This memo defines a Management Information Base (MIB), and as such it is intended to be respectful of the "Boilerplate for IETF MIBs" defined in http://www.ops.ietf.org/mib-boilerplate.html. There are companion documents to the IPPM-REPORTING-MIB both in the Transport Area (See section 2), and in the Operations and Management Area (See section 3). The reader should be familiar with these documents. 2. The IPPM Framework The IPPM Framework consists of 3 major components: A general framework for defining performance metrics, as described in the Framework for IP Performance Metrics, RFC 2330 [2]; A set of standardized metrics which conform to this framework: The IPPM Metrics for Measuring Connectivity, RFC 2678 [iii]; The One-way Delay Metric for IPPM, RFC 2679 [iv]; The One-way Packet Loss Metric for IPPM, RFC 2680 [v]; The Round-trip Delay Metric for IPPM, RFC 2681 [vi]. Emerging metrics that are being specified in respect of this framework. 3. The SNMP Management Framework The SNMP Management Framework consists of five major components: An overall architecture, described in RFC 2571[6].[2]. Mechanisms for describing and naming objects and events for the purpose of management. The first version of this Structure of Management Information (SMI) is called SMIv1 and described in STD 16, RFC 1155[7],[3], STD 16, RFC 1212[8][4] and RFC 1215[9].[5]. The second version, called SMIv2, is described in STD 58, RFC 2578[10],[6], STD 58, RFC 2579[11][7] and STD 58, RFC 2580[12].[8]. Message protocols for transferring management information. The first version of the SNMP message protocol is called SNMPv1 and described in STD 15, RFC 1157[13].[9]. A second version of the SNMP message protocol, which is not an Internet standards track protocol, is called SNMPv2c and described in RFC 1901[14][10] and RFC 1906[15].[11]. The third version of the message protocol is called SNMPv3 and described in RFC 1906[15],[11], RFC 2572[16][12] and RFC 2574[17].[13]. Protocol operations for accessing management information. The first set of protocol operations and associated PDU formats is described in STD 15, RFC 1157[13].[9]. A second set of protocol operations and associated PDU formats is described in RFC 1905[18].[14]. A set of fundamental applications described in RFC 2573[19][15] and the view-based access control mechanism described in RFC 2575[20].[16]. A more detailed introduction to the current SNMP Management Framework can be found in RFC 2570[21].[17]. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the mechanisms defined in the SMI. This memo specifies a MIB module that is compliant to the SMIv2. A MIB conforming to the SMIv1 can be produced through the appropriate translations. The resulting translated MIB must be semantically equivalent, except where objects or events are omitted because no translation is possible (use of Counter64). Some machine readable information in SMIv2 will be converted into textual descriptions in SMIv1 during the translation process. However, this loss of machine readable information is not considered to change the semantics of the MIB. Managed objects are accessed via a virtual information store, termed the Management Information Base or MIB. Objects in the MIB are defined using the subset of Abstract Syntax Notation One (ASN.1) defined in the SMI. In particular, each object type is named by an OBJECT IDENTIFIER, an administratively assigned name. The object type together with an object instance serves to uniquely identify a specific instantiation of the object. For human convenience, we often use a textual string, termed the descriptor, to refer to the object type. 4. Overview Although the number of measurement devices that implement IPPM metrics is growing, there is not currently any standardized management interface to manage remotely the measurement of these metrics. This memo defines a Management Information Base for managing the measurement of IPPM metrics. To permit metrics to be referenced by other MIBs and other protocols, the IPPM WG has defined a registry of the current metrics and a framework for the integration of future metrics in the [IPPM metrics registry]. As the specification of new metrics is a continuous process, this memo defines a framework for the integration of the future standardized metrics.To address future needs specialized tables may be created, while augmenting the definition of the ippmMeasureTable.The MIB architecture is inspired by the RMON model [xxiii],[xxiv] which specifies the MIB for the monitoring of a single point of measure. The IPPM-REPORTING-MIB differs from this model in that IPPM metrics measurement involves several points of measure and requires common references for time and for measure identification. The IPPM-REPORTING-MIB introduces a framework where each application identifies its measures in an owner namespace.Using the namespace framework, an applicationThe administrator may grantother ownersaccess toits measurement results fora measure, or set of measures to another owner via view based access control. As a result, one owner may compute aggregated metricscomputation, reporting, or alarming.on another ownerÆs network measures. Different architectures may be used to perform metric measurements, using a control protocol and a test protocol. Different control frameworks are suitable for performing measurements. The memo lists them, while also looking for a way to integrate them with the IPPM- REPORTING-MIB. This section is for informational purposes only, and is intended to help to specify the relationship among the test protocol, the control protocol and the IPPM-REPORTING-MIB. Special care has been taken to provide a reporting mode suitable for control protocols and test protocols. It addresses the need to provide access to results for the applications. Moreover, it may be used to reduce the number of control frameworks. This MIB is intended to handle multiple concurrent sessions by SNMP applications. However, the SNMP requests are not necessarily to be handled explicitly by the measurement devices, but can be sent to middleware performing an aggregation function. This allows for continuous collection of measurements and statistics computation. 4.1. Textual ConventionsFiveSeven types of data are introduced asatextualconventionconventions in this document:TypeP,IppmOwnerString, TimeUnit,TypeP, TypePaddress, GMTTimeStamp, IppmStandardMetrics and IppmReportDefinition.4.1.1.4.1.1 IppmOwnerString This octet string is used to represent the owners of the various measures and reports in the measurement system. 4.1.2 TimeUnit This textual convention is used to indicate a unit of time, ranging from nanosecond, microsecond, millisecond, second, hour, day, week, month, and year. 4.1.3 TypeP and TypePaddress Section 13 of the IPPM framework [2] introduces the generic notion of a "packet of type P" because in some contexts the metric's value depends on the type of the packets involved in the metric. In the definition of a metric, the type P will be explicitly defined, partially defined, or left generic. Measurement of metrics defined with generic type P are made specific when performing actual measurements.This naming convention serves as anIt is importantreminderthat onemustbe conscious of the exact type of traffic being measured. The standardization of the management of the IPPM measures relies on the capability to finely and unambiguously configure the type P of the packets, and the parameters of the protocol suites of the type P. RMON2 introduced the concept of protocol identifiers. RFC2895 [xxv] specifies a macro for the definition of protocol identifier. The RFC2896 [xxvi] defines the protocol identifiers for different protocol encapsulation trees. The type P implementation relies on the MACRO PROTOCOL-IDENTIFIER defined for identifying protocol suites in RMON2. It is achieved by defining the TypeP and the TypePaddress as new syntax in SMIv2 TEXTUAL-CONVENTION.4.1.1.1.4.1.3.1 Internet addresses The section 14 of the IPPM framework defines (for the usual case of a unidirectional path through the Internet) the term "Src" and "Dst". "Src" denotes the IP address of the beginning of the path, and "Dst" denotes the IP address of the end. The section 3 of the RMON PI Reference specifies the Protocol Identifier Encoding rules, which consists briefly in a recursive length value format. "Src" and "Dst" are protocol identifier parameters. Their values are encoded in separated fields using the encoding rules of the protocol identifier, but without trailing parameters. The packet encapsulation defined in an instance of TypeP embeds the format of "Src" and "Dst" and their values. The type and value of these addresses depend on the type P of the packet, IP version 4, IPV6, IP in IP... Both participate in the completion of the packet encoding. Examples: RFC2896 defines the protocol identifiers ip and ipip4. Should there be an Internet tunnel end-point of the IP address 192.168.1.1 in the tunnel 128.2.6.7. the TypeP of the source address of the tunnel, Src, is 'ip.ipip4'. The encoding of 'ip.ipip4' using the RFC2895 rules adds a trailer 2.0.0. It means that an instance of this protocol identifier has 2 parameters, which values will be set only when implemented. In the IPPM TypeP context these 2 parameters are provided in Src (or Dst). In the current example the value of Src is "192.168.1.1 128.2.6.7".4.1.2.4.1.4 GMTTimeStamp This textual convention defines the time at which an event occurred. It is very similar to the NTP timestamp format except that it represents the time elapsed since January 1st, 2000 instead of January 1st, 1900.4.1.3.4.1.5 IppmStandardMetrics Each standard metric is identified in the IPPM-METRICS-REGISTRY under the node rfc in a chronological order. This textual convention defines an octet string to permit several metrics to be performed in a single measure.4.1.4.4.1.6 Report definition A report consists of sending, or logging, a subset of results of measurements that have been taken over a period of time. The report consists of actions that are taken on the measurement results. An action is performed either: + For each result + On the results corresponding to a measurement cycle + On the results available at the measurement completion. To preserve the scalability of the whole measurement system, it limits: + The amount of data sent to the applications + The bandwidth consumption for uploading the result + The number of alarms sent to the applications + The amount of data saved in the point of measure The comparison of the measures results in a metric threshold that identifies particular measure values and times that directly impact service availability. The comparison of the duration of repeated events with a duration threshold identifies particular measure values and times that directly affect an SLA. The combination of IPPM metric results, threshold events, and event filtering provides a very efficient mechanism to report results, events, and alarms. A report is described using the TEXTUAL-CONVENTION IppmReportDefinition. The report setup must not dramatically increase the amount of data needed by the control protocol to setup a measure: + A basic report is defined in the object ippmReportSetupDefinition; + More elaborate reports are described using a metric threshold to generate alarms and events. + Pushing of alarms and reports requires a management station address to which the data will be sent. + SLA alarms are described using an events duration threshold. The TEXTUAL-CONVENTION IppmReportDefinition specifies the list of events and actions that are used to create a report.4.2.4.2 Structure of the MIB The MIB is arranged as follow: -ippmNotifications - ippmOwnersGroupippmSystem -ippmSystemGroupippmOwners -ippmMeasureGroupippmHistory -ippmHistoryGroupippmNetMeasure -ippmNetworkMeasureGroupippmAggrMeasure -ippmAggrMeasureGroupippmReport -ippmReportGroup 4.2.1. The ippmOwners Group This group identifies an owner, or group of owners that have access to measurements on a probe. 4.2.2.ippmNotifications 4.2.1 The ippmSystem Group This group consists of a set of parameters describing the clock synchronization at a particular point of measure overtime.time, as well as the system clock where the IPPM-REPORTING-MIB agent resides. This group is critical to the implementation of the IPPM MIB. Section 6.3. of the IPPM Framework states that "Those who develop such measurement methodologies should strive to: + Minimize their uncertainties/errors, + Understand and document the sources of uncertainty/error, and + Quantify the amounts of uncertainty/error." The aim of this group is to have these values available to compute reliable statistics. The implementation of this group is mandatory, whether the time synchronization is automatic or not.4.2.3.4.2.2 TheippmMeasureGroupippmOwners Group This groupdisplays all the measures configured on the measurement entity. It consists of the ippmMetricsTable and ippmMeasureTable. The ippmMeasureTable holds the common partidentifies an owner, or group of owners that have access to measurements on ameasure, whileprobe. 4.2.3 The ippmMeasure Group This group contains all thespecific parametersIPPM metrics that arehandled inregistered and available for use by thecorresponding auxiliary table (ippmNetworkMeasure, ippmAggrMeasureTable...) .agent. The measurement entity describes in the ippmMetricsTable of the SNMP agent the local implementation of the standardized metrics. All standardized metrics should be displayed in this table, with thecapabilityippmMetricCapabilities object defining whether the metric is implemented or not. 4.2.4 Thecontrol protocol registers a descriptionippmHistory Group The results ofthe existing measures in the ippmMeasureTable andany given measure are stored in theauxiliary measure tables.ippmHistoryTable. TheippmMeasureTable tableindexing isread-create, but only allows for the creation of "aggregated" measures when defined in conjunction with the ippmAggrMeasureTable. Network measures are not allowed to be created directly by the management entity, and assuchthe measurethat there is an entry in this tablevaluesforthese measures should be display only. The resultseach result ofthe measurements are logged in the ippmHistoryTable. 4.2.4.a given measure for a given metric. 4.2.5 TheippmNetworkMeasureippmNetMeasure Group The control protocol registers a description of the existing network measures in theippmNetworkMeasureTable and in the ippmMeasureTable.ippmNetMeasureTable. This group displays the network measures defined by the control protocol. The results are saved in the ippmHistoryTable.ippmNetworkMeasureTableippmNetMeasureTable isan auxiliary tablea reflection ofippmMeasureTable, and is responsible forthe configuration of the network measure.4.2.5.4.2.6 The ippmAggrMeasure Group ippmAggrMeasureTable isan auxiliary table of ippmMeasureTable, and isresponsible for theconsolidationconsolidation, or aggregation, oftheresults previously measured and saved in the ippmHistoryTable. The aggregated results are saved in the ippmHistoryTable and may be used for higher aggregated measures.4.2.6.4.2.7 The Report Group This group displays the existing reports of the measures collected. The ippmReportSetupTable isan auxiliary table of ippmMeasureTable, and isresponsible for the configuration of the reports. The reports are saved in the ippmReportTable, or sent directly to the applications.4.2.7.4.2.8 The Notification Group The Notification group specifies a list of valid notifications. They are used topush alarms or reportsgenerate alarms,or reports, to the applications.4.3.4.3 Row identification in an application namespace The controlprotocolprotocol, or the testprotocolprotocol, adds rows in the namespace of the corresponding measure. Anidentifier of an instance of an object is defined as a list of objects in the clause INDEX. Anobject instance identifier in an owner namespace is defined as a list of objects in the clause INDEX where the first object type is IppmOwnerString. As the OBJECT IDENTIFIER, which identifies the instance, begins with the owner value, the remaining values of the index fields may be chosen independently from one namespace to another. This allows the user to choose arbitrary values for the remaining fields of the INDEX clause without checking that the values of these fields exists in the MIB tables. This allows the owner to use the same values across MIB implementations. Thus, it avoids polling to determine the next free index. Also, as a consequence, two applications will never find the same free index value. The usage of owner namespace increases the speed of the management operations while reducing bandwidth consumption and CPU load in the agents and applications. Measurements are requested by management applications. An instance of an object managed by a management station is identified by the management station IppmOwnerString and the private index provided by the MS. As the MS manages its private range of indices, it simply chooses one when it wishes to create a new control entry. For the same reason, the setup of a measure on several points of measures consists of simply sending the same copy of the measure setup to the different points of measures involved.4.4.4.4 Relationship of IPPM REPORTING MIB tables There is inherently a relationship between various tables in the IPPMMib,REPORTING MIB, and as such, the data integrity must be assured. This relationship is depicted in the following examples.4.4.1.4.4.1 Relationship between the Owners Table and theMeasure Tableaggregated measure table The owners table contains the list of "owners" that can create and activateremote IPPM measurementsremotely aggregated measures in anagent. AsIPPM agent or read thetable is "Read/Create", these users and their associated "access" rights on metric measurements can be directly configured.existing network measures. It is recommended to make use of "view based access control" in order to restrict access to this table. For example, the master user"acme""administrator" may be given "write" privileges on the ippmOwnersTable, whereas all others are restricted to "read" access. The user"acme""administrator" can then setup the list of other users that have access to measures. There must be at least 1 owner in theownersowners' table. This owner may be either setup by default by the IPPM agent, or configured as stated above. An owner may have multiple corresponding entries in the network and aggregated measuretable.tables. Each entry in the measure tablemust beis associated with one, and only one, entry in theownersowners' table. That is to say, that a defined measure may NOT have multiple owners. Thus, we have a 1:N relationship between theownersowners' table andthea measure table.+---------------------+ +---------------------------+ | ippmOwnersTable | | ippmMeasureTable | +---------------------+ 1:N +---------------------------+ | OwnersOwner: "Acme" |--------------| Measure Owner: "Acme" | | "Foo" | | Measure Name:"OneWayDelay"| | . | |...... | | . | | Measure Owner: "Foo" | | . | | Measure Name: "PacketLoss"| | | | Measure Owner: "Foo" | +---------------------+ +---------------------------+ 4.4.2.4.4.2 Relationship between the Network Measure Table and theNetwork Measure Table/AggregatedAggregated Measure Table The network measure tableand the aggregated measureis read-only, thus entries in this tablecanmust beseen as logical "extensions" topopulated by themeasure table.agent upon startup. Themeasure tableagent could potentially read a database that containsinformation that is common to both types of measurements. The information found in the Network Measure Table and the Aggregated Measure Table is specific to each type of measure. As the network measure table is read-only, entries in this table must be populated by the agent upon startup. The agent could potentially read a database that contains network measures configured by a 3rd party proprietary management systemnetwork measures configured by a 3rd party proprietary management system that directly interacts with the points of measure.An entry can not be created in the network measure table without creating the corresponding entry in the measure table associated to the measure. This also implies thatHowever, the "owner" of the measure be defined in the owners table. The aggregated measure table allows for an "owner" to create aggregated measures (such as average, minimum, maximum) on existingmeasures that are in the measure table. If an "owner" (A) wishes tomeasures. An owner may even createanaggregatedmeasuremeasures ona measure "owned"network measures that are owned byanother "owner" (B), then "owner" (B) must grant "owner" (A) access to his measures. This can be done in the resultsharing table. Even though the Measure Tableother owners. However, it isread-create, an "owner" should only be able to create, or modify entries in the measure table that correspondrecommended toaggregated measure types. Should an "owner" attemptuse view based access control toupdate an entry in the measure table that correspondsgrant access of network measures toan entryowners in thenetwork measure table, than access should be denied. +---------------------------+ +----------------------------------+ | ippmMeasureTablesystem. 5 Measurement architectures There are three main measurement architectures. 5.1 Proxy architecture . +----+ +----+ . |NMS1| |NMS2| . +----+ +----+ . ^ ^ . | |ippmNetworkMeasureTable. +----------+ +----------+ . |+---------------------------+ +----------------------------------+|Measure Owner: "Acme". SNMP or Sibling . | |MeasureSrc: "Src1". v v . +--------------------------+ . | IPPM-REPORTING-MIB agent |Measure Name:"OneWayDelay. +--------------------------+ . ^ ^ . |---| MeasureDst: "Dst1"| . OWDP-Control . |.......| . +----------+ +----------+ . |........| . v v .+----------------+ +------------------+ .| Packets-Sender |--OWDP-Test-->| Packets-Receiver |Measure Owner: "Foo" | | MeasureSrc: "Src2".+----------------+ +------------------+ In this architecture, the different NMSÆs query the IPPM-REPORTING- MIB agent for measurements. The agent controls whether the NMS is granted access to perform the measure requested. Each NMS accesses the results of its measurements in the IPPM-REPORTING-MIB statistics table. The measurement setup/teardown and the data collection are done using the control protocol and the test protocol. In this mode the NMS does not depend on the control protocol nor on the test protocol. The entities involved in the measurement do not need to implement the IPPM-REPORTING-MIB nor SNMP. This mode allows for lightweight implementation in the point of measure, and also for heterogeneous control protocols to coexist. Finally, the proxy is a checkpoint where measurement activity may be logged, and where access to measurement setups may be tightly controlled. Thus, it provides a reliable architecture to manage the security of a measurement system. 5.2 Reporting architecture In this architecture the SNMP protocol is only used to read the results of the measurements in the IPPM-REPORTING-MIB History Table, and also to inform the NMS that an event has occurred. . +----+ +----+ . |NMS1| |NMS2| . +----+ +----+ . ^ ^ ^ ^ . | |Measure Name: "PacketLoss"||MeasureDst: "Dst2"| . SNMP| SNMP| . | |+----------------------------------+| | . | |+----------------------------------+| | . |ippmAggrMeasureTableOWDP | OWDP . |Control |Control . | |+----------------------------------+|Measure Owner: "Acme"| . |AMHistoryOwner: "Foo"| +------------------------------+ . |Measure Name: "AvgPLoss"|---| AMHistoryMetric: "PacketLoss" | +---------------------------+ +----------------------------------+ +---------------------------+ +----------------------------------+|ippmHistoryTable| |ippmResultSharingTable. | |(ex: with OWPL values)+--|---------------------------+ | . | |+---------------------------+ +----------------------------------+|Idx: Meas. Owner"Foo "| |SharingOwner: "Foo"| . |Measure Index: 1+--|--|------------------------+ | |SharingMeasureOwner:"PacketLoss"|. |Metrix Indx: 12| | | | | |SharingGrantedOwner: "Acme". +--------+---------------------+ | |HistorySqceNdx: 1. |+----------------------------------+|GMTTimeStampValue| |Value: 5|+---------------------------+|Idx: Meas. Owner "Foo"| |Mesure Index: 1. | |Metric Index: 12| |HistorySqceNdx: 2| |GMTTimeStampValue| |Value: 15. v v v v v v v v . +------------------+ +------------------+ . |IPPM-REPORTING-MIB| |IPPM-REPORTING-MIB| . | agent |Idx: Meas. "Acme"| agent |Measure Index: 3 | | Metric Index: 14 | | HistorySqceNdx: 1 | | GMTTimeStampValue |. +------------------+ +------------------+ . |Value: 10Packets-Sender |--OWDP-Test-->| Packets-Receiver |+---------------------------+ As. +------------------+ +------------------+ The activation of a measure by theaggregatedcontrol protocol or the test protocol creates a measure in the IPPM-REPORTING-MIB Network Measure table. The tableessentially "inherits" fromin question may be not accessible by SNMP. In this case, a list of the measuretable, one can not create an entryidentifiers (owner, index) isthis table without first creating an entry inhandled by the measurement software. Each timestamped result of the measuretable. Likewise, one can not delete an entryis logged in themeasureIPPM- REPORTING-MIB History tablewithout first deleting the corresponding rowin order to allow read access to the NMSÆs and event handling. On completion, the measurement results are managed according to theaggregatedmeasure setup: + The results may be sent to an NMS; + They may be dropped from the IPPM-REPORTING-MIB History table.This logicIn this mode, it is recommended to use an SNMPv2 Inform PDU to send reporting events because it ensures thatthere are no "orphaned" table entries intheaggregated measure table. 5. IPPM-REPORTING-MIB conceptual presentation 5.1. IPPM-REPORTING-MIB diagram Conceptual viewentire block ofobjects configuredthe result is received. There is no control using SNMP Trap PDU. 5.3 Gateway architecture The gateway architecture combines theIPPM-REPORTING-MIB +--------------------------------------------------------+proxy mode and the reporting mode. . +-------+ +------+ . |IPPM-REPORTING-MIB entityNMS1 | | NMS2 | . +-------+ +------+ . ^ ^ . |+---------------------+ +-------------------+| . SNMP SNMP . | | . | +----------------------------------------+ . | | | . +-------------+ +------------------+ . | |Measure scheduler| |Result storage| . +----------------------------------------+ | . | | | | | | . | |^v v | |^ ^^^. | | +------------------------+ | | . | | | IPPM-REPORTING-MIB ||||| | . |+----------|----------+ +-|---|||-----------+| | Gateway | ||||| . |+----------|--------------|---|||-----------+| +------------------------+ | | . |owner||||| control server | | | . |Acces||||+------------------------+ | | . | | ^ ^ |Control||||. | | |+----------|--------------|---|||-----------+| | | . |||| | +------------------|--------------|---|||----------------+ | | ||| | | ||| +----------------+ | +----------+-+ ||| +-------------+ | ControlMeasure | | | GetResult | ||| | CreateResult| |----------------+-+ |------------| ||+--+-------------| | | | | || | | | owner | | owner | || | owner | | privateNdx | | privateNdx | || | privateNdx | | metrics | | metric | || | metrics| OWDP-Control protocol |scheduler| . |timestamp||||timestamp| |addresses|+------------+ ||. |value| +-----+ +-------+ |status||| +-------------+ +----------------+ || || +---------------------------+|. | |+---------+---------+ +------+-----------------+ |GetMeasureResults||GetMeasureMetricResults||-------------------| |------------------------|| | . v v v v v v . +-------------+---------+ +--------+-------------+ . |ownerIPPM- | Packets |owner|Packets | IPPM |privateNdx. |REPORTING-MIB| Sender | |Receiver|REPORTING-MIB| . |privateNdxagent | |-OWDP-Test->| |metricagent |+-------------------+ +------------------------+. +-------------+---------+ +--------+-------------+ Themanaged objects ofNMS measurement queries are registered in the IPPM-REPORTING-MIBaregateway and performed by themeasurescontrol and theresults. 5.2. Conceptual programming interface This section describes a conceptual programming interface fortest protocol. The NMS directly consults theintegrationresult in the corresponding IPPM REPORTING MIB agent of theIPPM-REPORTING-MIB in a pointpoints of measure.5.2.1. Measure5.4 Security The proxy mode provides flexibility and controlA measure is created/deleted/suspended through the ControlMeasure() call. 5.2.2. Result log A resultofa measure is created intheIPPM-REPORTING-MIB History table using a CreateResult() call. Results belonging to a measure are managed accordingaccess to thesetuppoints of measure, while allowing lightweight control protocol and test protocol implementations in the points of measure.5.2.3. Reporting Results are reported usingDifferent security rules may be applied to themethod GetResult(), GetMeasureMetricResults()NMS domain andGetMeasureResults() respectivelytoget a singleton result, the singleton resultmeasurement system domains. The reporting mode has 2 security domains: + The control ofa metric measure,the measurement setups relies on the control andfinally to getthesingleton resulttest protocol security mechanisms; + The control ofa measure. 5.2.4. Logical calls Objects are managed using 5 main primitives: controlMeasure(); CreateResult(); GetResult(); GetMeasureMetricResults(); GetMeasureResults(). 5.3. SNMP mapping ControlMeasure() correspondsaccess toa SNMP set-request on a conceptual row of ippmMeasureEntry andthe results depends ona conceptual row of ippmNetworkMeasureEntry. CreateResult() is a internal interface for adding measure results intheippmHistoryTable. GetResult() corresponds to an SNMP get-request on a result. GetMeasureMetricResults() corresponds to aSNMPwalksecurity mechanisms such as community strings, but may also be restricted using VACM for customized access. The gateway mode security relies on theresultssecurity ofa metric measure subtree. GetMeasureResults() corresponds to a SNMP walk ontheresultsproxy mode and ofa measure subtree. 6. Measurement architectures There are four main measurement architectures. 6.1. Proxy architecture +----+ +----+ |NMS1| |NMS2| +----+ +----+ ^ ^ | | +----------+ +----------+ | | SNMP or Sibling | | v v +--------------------------+ |the reporting mode. 6 Reporting mode integration The IPPM-REPORTING-MIBagent | +--------------------------+ ^ ^ | | OWDP-Control | | +----------+ +----------+ | | v v +----------------+ +------------------+ | Packets-Sender |--OWDP-Test-->| Packets-Receiver | +----------------+ +------------------+ In this architecture,standardizes thedifferent NMSÆs queryparameters that: + Define theIPPM-REPORTING- MIB agent for measurements. The agent controls whetherconfiguration of theNMS is granted access to performIPPM metrics measures; + Define themeasure requested. Each NMS accessesformat of the results ofits measurements in the IPPM-REPORTING-MIB statistics table. The measurement setup/teardown andthedata collection are done usingmeasure; + Define thecontrol protocol andreport of thetest protocol. In this modeIPPM metric measures results. It introduces theNMS does not depend either onconcept of owner namespace to allow for fast configuration and reporting across multiple points of measurement. A measure is a distributed object describing a task to be performed by the controlprotocol nor onand the testprotocol. The entities involvedprotocols. A measure is identified by its owner and its owner index. This identifier is the same in all themeasurement do not need to implementpoints of measure. As theIPPM-REPORTING-MIB nor SNMP. This mode allowsowner chooses the index, there is no need forlightweight implementation innegotiation between thepointNMS and the points of measure before activating the measure. A measure is primarily defined by its identifier, the metrics to measure, the description of the end point addresses andalso for heterogeneous control protocols to coexist. Finally,theproxydescription of the scheduling of the measure. The description of the measure isa checkpoint where measurement activitydistributed to the points of measure involved. The distribution may not belogged,synchronized. 6.1 Integration The integration of the IPPM-REPORTING-MIB, andwhere access tothe test and control protocols consists in pushing the network measure setup/teardown parameters and the result values from the measurementsetups may be tightly controlled. Thus, it provides a reliable architecturesoftware tomanagethesecurityIPPM-REPORTING-MIB agent. 6.2 Setup of the measure network The measurement system updates the MIB on creation of a network measure. 6.3 Setup of a measurementsystem. 6.2. Reporting architecture In this architecturereport A measurement report setup describes events and data to include in theSNMP protocolreport. A report isonly used toread by an NMS in theresultsippmReportTable, or pushed to a NMS using a SNMP Inform PDU, an email, or a SMS. Different types of reports may be combined: + A trivial report defines themeasurementsresults to be saved in theIPPM-REPORTING-MIB History Table, and alsoippmReportTable; + A basic report defines the host toinformwhich theNMS that an event has occurred. +----+ +----+ |NMS1| |NMS2| +----+ +----+ ^ ^ ^ ^ | | | | SNMP| SNMP| | | | | | | | | | OWDP | OWDP |Control |Control | | | | | | +------------------------------+ | | | | | | | +--|---------------------------+ | | | | | | | | +--|--|------------------------+ | | | | | | | | | +--------+---------------------+ | | | | | | | | | | | | | | | | | | v v v v v v v v +------------------+ +------------------+ |IPPM-REPORTING-MIB| |IPPM-REPORTING-MIB| | agent | | agent | +------------------+ +------------------+ | Packets-Sender |--OWDP-Test-->| Packets-Receiver | +------------------+ +------------------+ The activationresults are pushed on completion of the measure; + An alarm report defines a threshold on the results of the measure. A message is sent to ameasure byhost when thecontrol protocolresult rises above, or falls below thetest protocol createsthreshold; + An SLA report defines ameasure inthreshold on theIPPM-REPORTING-MIB Measure table.results of the measure. Thetable in question may be not accessible by SNMP. In this case, a listreport consists of the results of the measureidentifiers (owner, index) is handled by(time and value) of the filtered events. The reports are sent at each measurementsoftware. Each timestamped result ofcycle, or when the measureis logged oncompletes. 6.4 Updating the history of the MIB Results have to be written by theflymeasurement task in theIPPM-REPORTING-MIB History tableagent implementing the IPPM REPORTING MIB. Adding the results of a measurement consists inorder to allow read access totheNMSÆs and event handling. On completion,transfer of the result from the measurementresults are managed accordingsoftware to themeasure setup: +SNMP agent. Theresultsprotocol that provides the result may besent to an NMSthe control protocol, or the test protocol. 6.5 Report download and upload A report is read in the ippmReportTable usinga SNMP Trap PDUSNMP, or pushed by the IPPM_MIB agent using a SNMP InformPDU. The NMS may be the sender entityPDU, an email orthe control entity;a SMS. 6.6 Default value The default values correspond to IP version 4. 7 Definition IPPM-REPORTING-MIB DEFINITIONS ::= BEGIN IMPORTS MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE, experimental ,Integer32 FROM SNMPv2-SMI -- -- ippm -- FROM IPPM-REGISTRY -- InetAddressType, InetAddress FROM INET-ADDRESS-MIB SnmpAdminString FROM SNMP-FRAMEWORK-MIB RowStatus, StorageType, TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF; ippmReportingMib MODULE-IDENTITY LAST-UPDATED "200306291200Z" -- June, 2003 ORGANIZATION "France Telecom - R&D" CONTACT-INFO "Emile Stephan France Telecom - R&D 2, Avenue Pierre Marzin Technopole Anticipa 22307 Lannion Cedex FRANCE Tel: +They may be dropped from33 2 96 05 36 10 E-mail: emile.stephan@francetelecom.com Jessie Jewitt France Telecom - R&D 801 Gateway Blvd. Suit 500 South San Francisco, CA 94080 Tel : 1 650 875-1524 E-mail : jessie.jewitt@rd.francetelecom.com" DESCRIPTION " This memo defines a portion of theIPPM-REPORTING-MIB History table.Management Information Base (MIB) for use with network management protocols in TCP/IP-based internets. Inthis mode,particular, itis recommended to use an SNMPv2 Inform PDU to sendspecifies theresult because it ensures thatobjects used for managing theentire blockresults of theresult is received. There is no control using SNMP Trap PDU. 6.3. Gateway architecture The gateway architecture combines the proxy modeIPPM metrics measurements, alarms andthereportingmode. +-------+ +------+ | NMS1 | | NMS2 | +-------+ +------+ ^ ^ | | SNMP SNMP | | | +----------------------------------------+ | | | +-------------+ +------------------+ | | | | | +----------------------------------------+ | | | | | | | | | v v | | | | +------------------------+ | | | | | IPPM-REPORTING-MIB | | | | | | scheduler | | | | | +------------------------+ | | | | | control server | | | | | +------------------------+ | | | | ^ ^ | | | | | | | | | | OWDP-Control protocol | | | | | | | | | | +-----+ +-------+ | | | | | | | | v v v v v v +-------------+---------+ +--------+-------------+ | IPPM- | Packets | |Packets | IPPM | |REPORTING-MIB| Sender | |Receiver|REPORTING-MIB| | agent | |-OWDP-Test->| | agent | +-------------+---------+ +--------+-------------+ The NMS measurement queries are registered in the IPPM-REPORTING-MIB scheduler and performed by the control and the test protocol. The NMS directly consults the result in the corresponding points of measure. 6.4. Security The proxy mode provides flexibility and control of the access to the points of measure, while allowing lightweight control protocol and test protocol implementations in the pointsofmeasure. Different security rules may be appliedmeasurement results." REVISION "200210181200Z" -- 18 October 2002 DESCRIPTION "General cleanup Change 5 tables tothe NMS domain andread write" REVISION "200302141200Z" -- 14 February 2003 DESCRIPTION "Modifications based upon feedback from IETF-55" REVISION "200306291200Z" -- 29 June 2003 DESCRIPTION "Adaptation tomeasurement system domains. The reporting mode has 2 security domains: +The control of the measurement setups relies on the control and the test protocol security mechanisms. + The controlVACM, preparation ofaccess totheresults depends onfinal version" ::= { experimental 10001 } ippm OBJECT IDENTIFIER ::= { experimental 10000 } -- -- TEXTUAL-CONVENTION -- IppmOwnerString ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An OwnerString, which length is limited to 32." SYNTAX OCTET STRING (SIZE (0..32)) TimeUnit ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "A enumerated list of time units." SYNTAX INTEGER { year(1), month(2), week(3), day(4), hour(5), second(6), millisecond(7), microsecond(8), nanosecond(9) } -- -- IppmStandardMetrics ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION " Each standard metric is identified in theSNMP security mechanisms. The gateway mode security relies onIPPM-METRICS- REGISTRY under thesecurity ofnode rfc in chronological order. In order to allow for several metrics to be calculated in a single measure, there is an need to describe in a bit string theproxy mode andmetrics to be measured. This textual convention defines an octet string that gathers in a bit string a sequence ofthe reporting mode. 7. Reporting mode integrationbits. TheIPPM-REPORTING-MIB standardizes the parameters that: + Definebit order corresponds to theconfigurationorder of theIPPM metrics measures; + Definemetric identifiers in theformatregistry. The first bit of theresults ofstring has themeasure; + Defineindex 0. The index 1 corresponds to thereportfirst metric of theIPPM metric measures results. It introducesregistry (instantaneousUnidirectionalConnectivity ). Example: One-way-Delay(6) is identified as theconceptleaf number 6 ofowner namespace to allow for fast configuration and reporting across multiple pointsthe node rfc ofmeasurement. A measurethe registry. One-way-Packet-Loss(12) isa distributed object describing a task to be performed byidentified as thecontrol andleaf number 12 of thetest protocols.node rfc of the registry. A network measureis identified by its ownerperforming both One-way- Delay(6) andits owner index. This identifier is the sameOne- way-Packet-Loss(12) will be described as '0001000001000000'b, '1040'B. " SYNTAX OCTET STRING GMTTimeStamp ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "The value at which a specific occurrence happened. The specific occurrence must be defined inallthepointsdescription of any object defined using this type. field octets contents range ----- ------ -------- ----- 1 1-4 second since 1 Jan 2000 0H00* 0..2^31 - 1 2 5-8 fractional part ofmeasure. Astheowner choosessecond* 0..2^32 - 1 * theindex, therevalue isno need for negotiation betweenin network-byte order The timestamp format is directly inspired from theNMS andNTP timestamp format. It differs because it counts thepointssecond since 1 Jan 2000 0H00 instead of 1 Jan 1900 0H00. The most significant bit ofmeasure before activatingthemeasure. A measure is primarily defined by its identifier,part that represents themetricssecond is reserved. It will wrap in year 2068 (The NTP timestamp will wrap in year 2036). This bit is set tomeasure,indicate if thedescriptionfractional part of theend point addressessecond contains a precision field and a synchronization field as initially proposed in thedescription of the scheduling ofOWAMP draft. When this bit is not set themeasure.resolution is maximal. Thedescriptionmaximal resolution is close to 250 picoseconds. The precision of themeasuretimestamp must be provided in another field. " SYNTAX OCTET STRING (SIZE (8)) TypeP ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "This textual convention isdistributeda display string used to describe thepointsprotocol encapsulation list ofmeasure involved. The distribution may not be synchronized. 7.1. Integration The control protocol, test protocola packet, and is used as theIPPM-REPORTING-MIB share the same semantic. The integrationvalue of theIPPM-REPORTING-MIB, andSYNTAX clause for thetesttype of the Src andcontrol protocols, relies onDst of an IPPM measure. The RFC2895 specifies a macro named PROTOCOL-IDENTIFIER for theusedefinition of protocol identifiers, while its companion document, theconceptual programming interface described in section 6.RFC2896 defines a set of protocol identifiers. TypeP is defined as a display string. It consistsin pushing the measure setup/teardown parameters andof a list of dot separated protocol names. Each protocol name has been previously defined using theresult values frommacro PROTOCOL-IDENTIFIER of themeasurement software toRFC 2895. Examples: The RFC2896 defines theIPPM-REPORTING-MIB agent. 7.2. Setupprotocol identifiers 'ether2', 'ip', 'ipip4', 'udp', 'tcp', 'telnet'... The TypeP of themeasuresource address corresponding to telnet is the string 'ip.tcp.telnet'. ThecreationTypeP of themeasure consists onlysource address corresponding to UDP packets sent intransferringan IP tunnel is the string 'ip.ipip4.udp'. Note: An IPPM measuredescription fromis active, so generally a TypeP value does not describe themeasurement softwarelink layer (i.e. ether2...). Valid Internet packets are sent from Src to Dst. Then theMIB. The managementchoice of themeasure is done usinglink layer relies on theControlMeasure(). The protocol, which providesInternet stack." SYNTAX OCTET STRING (SIZE (0..512)) TypePaddress ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "This textual convention is a Display string used to describe the parameters of themeasure to manage, may be the controlprotocol encapsulation list ofthe test protocol. Different frameworks may be used to setupameasure. 7.2.1. Synchronous setup The control protocol sets up the measure both in the sender andpacket, basically thereceiver before the measurement. 7.2.2. Asynchronous setup The control protocol sets up the measure onlyaddress. TypePaddress is defined as a display string. It consists inthe sender. In this case, the receiver hasaservice already activated (or pending )for the typePlist of space separated parameter list. Each parameter in themeasurement. As the first test packet includes the descriptionlist corresponds to a parameter ofthe measure, it may differ from regular test packets. If the first test packet is not consistent with the regular test packets, it must not be used for performing metrics measurement. 7.3. Setupa PROTOCOL-IDENTIFIER of themeasurement reportTypeP. Example: Thereport descriptionTypeP 'ip.ipip4' has 2 parameters. A valid TypePaddress value isan extension to the'192.168.1.1 128.2.6.7'." SYNTAX OCTET STRING (SIZE (0..512)) IppmReportDefinition ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION " A report definition is a list of statements describing ameasure. It describes the event and the data to include in thereport. Areportstatement isread by an NMSpart of this process if its bit in theippmReportTable, or pusheddefinition is set to '1'. For all bit values that are set to one, aNMS using a SNMP Trap PDU, a SNMP Inform PDU, an email, or a SMS. The control protocol, or the test protocol, includes the description of thereportin the setup of the measure. Different types of reports maywill becombined: + A trivialgenerated. The reportdefines theprocess uses resultsto besaved in theippmReportTable; + A basic report defines the host to which the resultshistory table. Threshold values arepushed on completion ofprovided by themeasure; + An alarmreportdefinessetup. Given that not all results from athreshold onmetric measurement are pertinent to a particular report, and that theresultssize of themeasure. A message is sent toreport must be limited whenever possible, the guidelines for the definition of ahost whenreport are as follows: + Select theresult raises or fallevents for consideration (1); + Configure filters to select pertinent values (2); + Describe thethreshold;way the report is delivered (3); +An SLADescribe clean up actions to perform on reportdefinescompletion (4); -1- events Events determine when athreshold on the resultsreport is processed. Events are exclusive. The possible values are: onSingleton: The report is processed each time a new result of themeasure.measurement occurs. onMeasureCycle: Theevents are filtered usingreport is processed each time astaircase method.cycle of measure is completed. onMeasureCompletion: The reportconsists inis processed at theresultsend of themeasure (timemeasurement. -2- filters Filters determine if a result belongs to a report. ReportInBandResults andvalue)ReportOutBandResults are exclusive. The usage of ReportInBandResults and ReportOutBandResults exclude thefiltered events. The reportsusage of ReportAboveResults and ReportBelowResults. Possible values are: reportUpAndDownResults: Report contiguous results that aresent at each measure cycle or when the measure completes. 7.4. Writingon opposite sides of the up and down metric threshold. ReportInBandResults: Report resultsin the IPPM-REPORTING-MIB Results have to be written bylower than themeasurement task inhigh metric threshold field of theagent implementingreport setup and greater than theIPPM MIB. Addinglow metric threshold field of the report setup. ReportOutBandResults: Report resultsof a measurement consists ingreater than thetransferhigh metric threshold field of theresult fromreport setup and lower than themeasurement software tolow metric threshold field of theagent. The protocol that providesreport setup. ReportAboveResults: Report results greater than theresult may behigh metric threshold field of thecontrol protocol, orreport setup. ReportBelowResults: Report results lower than thetest protocol. Writing a result is done usinglow metric threshold field of theCreateResult(). 7.5. Report download and upload Areportis read insetup. reportExceededEventsDuration: Save theippmReportTable using SNMP, or pushed byresults of theIPPM_MIB agent using a SNMP Trap PDU, ametric only if the current filter triggers repeatedly for a series of contiguous results during more than ippmReportSetupDurationThreshold seconds. -3- deliver Even though report delivery statements are not exclusive, care should be taken to limit the number of report methods to 2. The delivery methods are: inIppmReportTable: Store the report in the local ippmReportTable. NOTE WELL: Results are not stored in the report table if this flag is not set. inSNMPv2TrapPDU: Send the report using a SNMPv2-Trap-PDU. inInformRequestPDU: Send the report using a SNMPInform PDU,InformRequest-PDU. inEmail: Send the report using anemail oremail. inSMS: Send the report using a SMS.7.6. Default value The default values correspond-4- Cleanup onReportDeliveryClearReport(12): Remove all the results corresponding toIP version 4. 8. Definition IPPM-REPORTING-MIB DEFINITIONSthis measure from the ippmReportTable when the report has been delivered. " SYNTAX BITS { none(0), -- reserved onSingleton(1), onMeasureCycle(2), onMeasureCompletion(3), reportUpAndDownResults(4), reportInBandResults(5), reportOutBandResults(6), reportAboveResults(7), reportBelowResults(8), reportExceededEventsDuration(9), inIppmReportTable(10), inSNMPv2TrapPDU(11), inInformRequestPDU(12), inEmail(13), inSMS(14), onReportDeliveryClearReport(15) } -- -- IPPM Notifications -- ippmNotifications OBJECT IDENTIFIER ::=BEGIN IMPORTS MODULE-IDENTITY, NOTIFICATION-TYPE, OBJECT-TYPE, experimental ,Integer32 FROM SNMPv2-SMI{ ippm 0 } -- -- IPPM Conformance -- ippmConformance OBJECT IDENTIFIER ::= { ippm 1 } --FROM IPPM-REGISTRY--InetAddressType, InetAddress FROM INET-ADDRESS-MIB SnmpAdminString FROM SNMP-FRAMEWORK-MIB RowStatus, StorageType, TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF; ippmReportingMib MODULE-IDENTITY LAST-UPDATED "200203171200Z"IPPM Mib objects definitions --March 17, 2002 ORGANIZATION "France Telecom - R&D" CONTACT-INFO "Emile Stephan France Telecom - R&D 2, Avenue Pierre Marzin Technopole Anticipa 22307 Lannion Cedex FRANCE Tel: + 33 2 96 05 36 10 E-mail: emile.stephan@francetelecom.com Jessie Jewitt France Telecom - R&D 801 Gateway Blvd. Suit 500 South San Francisco, CA 94080 Tel :ippmSystem OBJECT IDENTIFIER ::= { ippmReportingMib 1650 875-1524 E-mail : jessie.jewitt@rd.francetelecom.com" DESCRIPTION " This memo defines a portion of the Management Information Base (MIB) for use with network management protocols in TCP/IP-based internets. In particular, it specifies the objects used for managing the results of the IPPM metrics measurements, alarms and reporting the measures results." REVISION "200210181200Z" -- 18 October 2002 DESCRIPTION "General cleanup Change 5 tables to read write" REVISION "200302141200Z" -- 14 February 2003 DESCRIPTION "Modifications based upon feedback from IETF-55"} ippmOwners OBJECT IDENTIFIER ::= {experimental 10001ippmReportingMib 2 }ippmippmHistory OBJECT IDENTIFIER ::= {experimental 10000ippmReportingMib 3 } ippmMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 4 } ippmReport OBJECT IDENTIFIER ::= { ippmReportingMib 5 } -- --TEXTUAL-CONVENTIONippmSystem Group --IppmOwnerString ::= TEXTUAL-CONVENTION-- ippmSystemTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION"An OwnerString, which length"The current time of the system running the IPPM REPORTING MIB SNMP agent. When the agent islimited to 32." SYNTAX OCTET STRING (SIZE (0..32)) TimeUnit ::= TEXTUAL-CONVENTION STATUSrunning in proxy mode is it the currentDESCRIPTION "A listtime of the proxy agent. When the agent is located in the probe, it is the current timeunits."of the probe agent. " ::= { ippmSystem 1 } ippmSystemSynchronizationType OBJECT-TYPE SYNTAX INTEGER {year(1), month(2), week(3), day(4), hour(5), second(6), millisecond(7), microsecond(8), nanosecond(9)other(0), ntp(1), gps(2), cdma(3) }-- -- IppmStandardMetrics ::= TEXTUAL-CONVENTIONMAX-ACCESS read-only STATUS current DESCRIPTION" Each standard metric is identified in the IPPM-METRICS- REGISTRY under"ippmSystemSynchronizationType describes thenode rfc in a chronological order. To permit several metricsmechanism used to synchronize the system running the IPPM REPORTING MIB SNMP agent. Other(0) The synchronization process must beperformeddefined ina single measure therethe ippmSystemSynchonizationDescription. Ntp(1) The system isan need to describe in a bit stringsynchronized using themetrics to be performed, granted... This textual convention defines an octet string that gatherednetwork time protocol. The NTP synchronization must be described ina bit string a sequence of bits.the ippmSystemSynchonizationDescription. Gps(2) Thebit order corresponds tosystem is synchronized using theorder ofGPS clocks. Cdma(3) The system is synchronized using themetrics identifiers inCDMA clocks." ::= { ippmSystem 2 } ippmSystemSynchronizationDesc OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The description of theregistry. The first bitsynchronization process of thestring hassystem running theindex 0. The index 1 corresponds toIPPM REPORTING MIB SNMP agent." ::= { ippmSystem 3 } ippmSystemClockResolution OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only -- UNITS "picoseconds" STATUS current DESCRIPTION "ippmSystemClockResolution provides thefirst metricprecision of theregistry (instantaneousUnidirectionalConnectivity ). Example: One-way-Delay(6)clock used for the measures . The unit isidentified astheleaf number 6 ofpicosecond. For example, thenode rfcclock on an old Unix host might advance only once every 10 msec, and thus have a resolution ofthe registry. One-way-Packet-Loss(12)10 msec. So its resolution isidentified as100000 picosecond and theleaf number 12value of ippmSystemClockResolution is 100000." ::= { ippmSystem 4 } ippmSystemOperationalStatus OBJECT-TYPE SYNTAX INTEGER { unknown(0), up(1), down(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object describes thenode rfcstatus of theregistry. A network measure performing both One-way- Delay(6)system running the IPPM REPORTING MIB SNMP agent. It does not describe end points measurement status. unknown(0) up(1) means service is operational andOne- way-Packet-Loss(12) will be described as '0001000001000000'b, '1040'B.available for general use. down(2) means the proxy is not available for use. "SYNTAX OCTET STRING GMTTimeStamp::=TEXTUAL-CONVENTION{ ippmSystem 5 } ippmSynchronizationTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmSynchronizationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"The value of"This table registers theippmSystemTime object at which a specific occurrence happened. The specific occurrence must be defined inevent related to thedescription of any object defined using this type. field octets contents range ----- ------ -------- ----- 1 1-4 second since 1 Jan 2000 0H00* 0..2^31 - 1 2 5-8 fractional partsynchronization of thesecond* 0..2^32 - 1 * the value is in network-byte order The timestamp format is directly inspired from the NTP timestamp format. It differs because it counts the second since 1 Jan 2000 0H00 instead of 1 Jan 1900 0H00. The most significant bitpoints ofthe part that represents the second is reserved. It will wrap in year 2068 (The NTP timestamp will wrap in year 2036). This bitmeasure. Each event isset to indicate if the fractional part of the second contains a precision field and a synchronization field as initially proposeddescribed inthe OWAMP draft. When this bit is not set the resolutionan ippmSynchronizationEntry. ippmSynchronizationTable ismaximal. The maximal resolutionmandatory. ippmSynchronizationTable content isclose to 250 picoseconds. The precision of the timestamp must be provided in another field. " SYNTAX OCTET STRING (SIZE (8)) TypePread only." ::=TEXTUAL-CONVENTION{ ippmSystem 6 } ippmSynchronizationEntry OBJECT-TYPE SYNTAX IppmSynchronizationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"This textual convention is a display string used to describe the protocol encapsulation list of"An entry describes apacket, and is used as the valuemodification of the synchronization status. " INDEX { ippmPointOfMeasureIndex, ippmSynchronizationIndex } ::= { ippmSynchronizationTable 1 } IppmSynchronizationEntry ::= SEQUENCE { ippmSynchronizationIndex Integer32, ippmSynchronizationTime GMTTimeStamp, ippmSynchronizationStratum Integer32, ippmSynchronizationResolution Integer32 } ippmSynchronizationIndexOBJECT-TYPE SYNTAXclause for the type of the Src and Dst of an IPPM measure. The RFC2895 specifies a macro named PROTOCOL-IDENTIFIER forInteger32 (1 .. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that identifies thedefinition of protocol identifiers while its companion document,synchronization events in chronological order." ::= { ippmSynchronizationEntry 1 } ippmSynchronizationTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The time when theRFC2896 defines a setsynchronization event occurs." ::= { ippmSynchronizationEntry 2 } ippmSynchronizationStratum OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The stratum level ofprotocol identifiers. TypePthe clock computed when the synchronization event occurs." ::= { ippmSynchronizationEntry 3 } ippmSynchronizationResolution OBJECT-TYPE SYNTAX Integer32 UNITS "NanoSeconds" MAX-ACCESS read-only STATUS current DESCRIPTION "The new time resolution computed after the synchronization event occurred." ::= { ippmSynchronizationEntry 4 } ippmPointOfMeasureTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmPointOfMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " This table isdefined as a display string. It consists in athe list ofdot separated protocol names. Each protocol name has been previously defined usingmeasurement end points available in themacro PROTOCOL-IDENTIFIERmeasurement system. Proxy mode: It is the list of theRFC 2895. Examples: The RFC2896 definesmeasurement end points of theprotocol identifiers 'ether2', 'ip', 'ipip4', 'udp', 'tcp', 'telnet'... The TypePset of probes for which thesource address corresponding to telnetIPPM proxy provides an SNMP interface. IPPM MIB implemented in a probe: It is thestring 'ip.tcp.telnet'. The TypePlist of thesource address corresponding to UDP packets sent in an IP tunnelmeasurement end points of the probe. The ippmPointOfMeasureTable content is read only. This implies that thestring 'ip.ipip4.udp'. Notes: An IPPM measuremeasurement software handles the table internally ippmPointOfMeasureTable isactive, so generally a TypeP value does not describe the link layer (i.e. ether2...). Valid Internet packets are sent from Src to Dst. Then the choice of the link layer relies on the Internet stack." SYNTAX OCTET STRING (SIZE (0..255)) TypePaddressmandatory." ::=TEXTUAL-CONVENTION DISPLAY-HINT "255a"{ ippmSystem 7 } ippmPointOfMeasureEntry OBJECT-TYPE SYNTAX IppmPointOfMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"This textual convention is a Display string used to describe the parameters of" An entry may be theprotocol encapsulation listmanagement address of apacket, basically the address. TypePaddress is defined as a display string. It consistsmiddleware ina listcharge ofspace separated parameter list. Each parameter inthelist corresponds a parametermanagement of aPROTOCOL-IDENTIFIERset of probes. It may theTypeP. Example: The TypeP 'ip.ipip4' has 2 parameters. A valid TypePaddress value is '192.168.1.1 128.2.6.7'." SYNTAX OCTET STRING (SIZE (0..255)) IppmReportDefinition ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "IppmReportDefinition is intended to be used for describing the report resulting frommanagement address of ameasurement. By default, allprobe that contains several line cards. An entry describes theresultscapability of ameasure belong to the reportpoint ofthismeasure. Thefirst step of the report definition sets up triggers ondescription may make thevalueuse ofthe measure, and on the distribution over timewildcards to define multiple capabilities." INDEX { ippmPointOfMeasureIndex } ::= { ippmPointOfMeasureTable 1 } IppmPointOfMeasureEntry ::= SEQUENCE { ippmPointOfMeasureIndex Integer32, ippmPointOfMeasureMgmtAddrType InetAddressType, ippmPointOfMeasureMgmtAddress InetAddress, ippmPointOfMeasureTypePAddress TypeP, ippmPointOfMeasureAddress InetAddress, ippmPointOfMeasureMetrics IppmStandardMetrics } ippmPointOfMeasureIndex OBJECT-TYPE SYNTAX Integer32 (1 .. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "A local index that identifies an entry of theevents generated by these triggers. The resultingpoints of measurescorresponding to an event are reported periodically, or sent in alarms as soon as the event occurs. The end of the description describes housekeeping tasks. An action is performed if the corresponding bit is set to 1. onSingleton(1): The actions are performed each time a new result oftable." ::= { ippmPointOfMeasureEntry 1 } ippmPointOfMeasureMgmtAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "The address type associated with themeasure occurs. onMeasureCycle(2): The actions are performedmanagement address." ::= { ippmPointOfMeasureEntry 2 } ippmPointOfMeasureMgmtAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (1..128)) MAX-ACCESS read-only STATUS current DESCRIPTION "The management address on theresultspoint of measure" ::= { ippmPointOfMeasureEntry 3 } ippmPointOfMeasureTypePAddress OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-only STATUS current DESCRIPTION "Defines themeasure at the end of each cycletype P address ofmeasure. onMeasureCompletion(3): The actions are performed ontheresultspoint of measure." DEFVAL { "ip" } ::= { ippmPointOfMeasureEntry 4 } ippmPointOfMeasureAddress OBJECT-TYPE SYNTAX InetAddress MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies themeasure at the endaddress of the point of measure.reportOnlyUptoDownMetricResults(4): ReportIt is represented as an octet string with specific semantics and length as identified by thecontiguous results that are on opposite sidesippmPointOfMeasureTypePAddress. For example, if the ippmPointOfMeasureTypePAddress indicates an encapsulation of 'ip', this object length is 4, followed by themetric threshold. reportOnlyExceededEventsDuration(5): Report4 octets of the IP address, in network byte order." ::= { ippmPointOfMeasureEntry 5} ippmPointOfMeasureMetrics OBJECT-TYPE SYNTAX IppmStandardMetrics MAX-ACCESS read-only STATUS currentresult of a seriesDESCRIPTION "Metrics supported by this point ofcontiguous results that exceedmeasure." ::= { ippmPointOfMeasureEntry 6 } ippmMetricTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table is mandatory. It describes the current implementation. Each IPPM standardized metricthreshold when the duration ofmust be described in theseriestable. ippmMetricTable content isover the events duration threshold seconds. inIppmReportTable(6): Store the report in the local ippmReportTable. inSNMPTrapPDU(7): Send the report using a SNMP-Trap-PDU. inSNMPv2TrapPDU(8): Send the report using a SNMPv2-Trap-PDU. inInformRequestPDU(9): Send the report using a SNMP InformRequest-PDU. inEmail(10): Send the report using an email. inSMS(11): Send the report using a SMS. onReportDeliveryClearHistory(12): Remove all the results corresponding to this measure from the ippmHistoryTable when the report has been delivered. onReportDeliveryClearReport(13): Remove all the results corresponding to this measure from the ippmReportTable when the report has been delivered. " SYNTAX BITS { none(0), -- reserved onSingleton(1), onMeasureCycle(2), onMeasureCompletion(3), reportOnlyUptoDownMetricResults(4), reportOnlyExceededEventsDuration(5), inIppmReportTable(6), inSNMPTrapPDU(7), inSNMPv2TrapPDU(8), inInformRequestPDU(9), inEmail(10), inSMS(11), onReportDeliveryClearHistory (12), onReportDeliveryClearReport (13) } -- -- IPPM Notifications -- ippmNotifications OBJECT IDENTIFIER ::= { ippm 0 } -- -- IPPM Conformance -- ippmConformance OBJECT IDENTIFIERread only." ::= {ippm 1 } -- -- IPPM Mib objects definitions --ippmSystemOBJECT IDENTIFIER ::= { ippmReportingMib 1 } ippmOwners OBJECT IDENTIFIER ::= { ippmReportingMib 2 } ippmMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 3 } ippmHistory OBJECT IDENTIFIER ::= { ippmReportingMib 4 } ippmNetworkMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 5 } ippmAggrMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 6 } ippmReport OBJECT IDENTIFIER ::= { ippmReportingMib 78 }-- -- ippmSystem Group -- -- ippmSystemTimeippmMetricEntry OBJECT-TYPE SYNTAXGMTTimeStampIppmMetricEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"The current time of"An entry describes themeasurement system."static capabilities of a metric implementation." INDEX { ippmMetricIndex } ::= {ippmSystemippmMetricTable 1 }ippmSystemSynchronizationType OBJECT-TYPE SYNTAX INTEGERIppmMetricEntry ::= SEQUENCE {other(0), ntp(1), gps(2), cdma(3)ippmMetricIndex Integer32, ippmMetricCapabilities INTEGER, ippmMetricType INTEGER, ippmMetricUnit INTEGER, ippmMetricDescription SnmpAdminString } ippmMetricIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"ippmSystemSynchronizationType describes the mechanism used to synchronize the system. Other(0) The synchronization process must be defined in"ippmMetricIndex defines an unambiguous index for each standardized metric. It identifies a metric. Its value is theippmSystemSynchonizationDescription. Ntp(1) The systemvalue of the node of the metric in an IPPM registry. This value issynchronized usingthenetwork time protocol. The NTP synchronization must be describedsame in any implementation of theippmSystemSynchonizationDescription. Gps (2) The system is synchronized usingIPPM REPORTING MIB. Example: In theGPS clocks. Cdma(3) The systemIPPM-METRICS-REGISTRY, onewayPacketLossAverage issynchronized usingregistered as theCDMA clocks." ::= { ippmSystem 2 } ippmSystemSynchronizationDesc OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The descriptionnode 14 of ippmMetricsRegistry.metrics.rfc. Consequently thesynchronization process."index of the metric onewayPacketLossAverage in the IppmMetricTable will always be '14'" ::= {ippmSystem 3ippmMetricEntry 1 }ippmSystemClockResolutionippmMetricCapabilities OBJECT-TYPE SYNTAXInteger32INTEGER { notImplemented(0), implemented(1) } MAX-ACCESS read-only STATUS current DESCRIPTION"ippmSystemClockResolution provides the precision"A value of notImplemented implies theclock used formetric is not implemented. A value of implemented implies themeasures. The unitmetric is implemented either in thepicosecond. For example,proxy or theclock on an old Unix host might advance only once every 10 msec, and thus have a resolutionpoint ofonly 10 msec. So its resolutionmeasure itself. Example: if the aggregated metric is100000 picosecond andnot implemented in thevaluepoint ofippmSystemClockResolution is 100000."measure it may be implemented in the proxy." DEFVAL { implemented } ::= {ippmSystem 4ippmMetricEntry 2 }ippmSystemCurrentSynchronizationippmMetricType OBJECT-TYPE SYNTAXInteger32INTEGER { network(0), aggregated(1) } MAX-ACCESS read-only STATUS current DESCRIPTION"The index on the last synchronization event in"Indicates theippmSynchronizationTable."metric type, whether it is network or aggregated" DEFVAL { aggregated } ::= {ippmSystem 5ippmMetricEntry 3 }ippmSynchronizationTableippmMetricUnit OBJECT-TYPE SYNTAXSEQUENCE OF IppmSynchronizationEntryINTEGER { noUnit(0), second(1), millisecond(2), microsecond(3), nanosecond(4), percentage(5), packet(6), byte(7), kilobyte(8), megabyte(9) } MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"This table registers"The unit used in theevent related tocurrent entity for thesynchronizationresults of thepointmeasurement ofmeasure. Each event is describedthis metric." ::= { ippmMetricEntry 4 } ippmMetricDescription OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "A textual description of the metric implementation following the exact name of this metric in the registry. For example: oneWayDelay: text ." ::= { ippmMetricEntry 5 } -- -- ippmOwners Group -- -- The ippmOwners objects are responsible for managing -- the owners access to the measurements. -- -- ippmOwnersTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmOwnersEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A management entity wishing to create and activate remote Ippm measurements in anippmSynchronizationEntry. ippmSynchronizationTable is mandatory. ippmSynchronizationTableagent must previously be registered in the ippmOwnersTable. ippmOwnersTable content isread only."read-create. It contains at least the owner 'monitor'. ææ ::= {ippmSystem 6ippmOwners 1 }ippmSynchronizationEntryippmOwnersEntry OBJECT-TYPE SYNTAXIppmSynchronizationEntryIppmOwnersEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION"An entry describes a modification"The description of thesynchronization status. "resources granted to an SNMP application. For example, an instance of ippmOwnersOwner with an IppmOwnerString 'acme', which represents the 14th owner created in ippmOwnersTable would be named ippmOwnersEntryOwner.14. Notes: The ippmOwnersIndex value is a local index managed directly by the agent. The management application must poll to get the next available index value. It is not used in anyway in other IPPM tables." INDEX {ippmSynchronizationIndexippmOwnersIndex } ::= {ippmSynchronizationTableippmOwnersTable 1 }IppmSynchronizationEntryIppmOwnersEntry ::= SEQUENCE {ippmSynchronizationIndexippmOwnersIndex Integer32,ippmSynchronizationTime GMTTimeStamp, ippmSynchronizationStratumippmOwnersOwner IppmOwnerString, ippmOwnersGrantedMetrics IppmStandardMetrics, ippmOwnersQuota Integer32,ippmSynchronizationResolution Integer32ippmOwnersIpAddressType InetAddressType, ippmOwnersIpAddress InetAddress, ippmOwnersEmail SnmpAdminString, ippmOwnersSMS SnmpAdminString, ippmOwnersStatus RowStatus }ippmSynchronizationIndexippmOwnersIndex OBJECT-TYPE SYNTAX Integer32(1 ..(1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary index that identifiesthe synchronization eventsan entry inchronological order."the owners table." ::= {ippmSynchronizationEntryippmOwnersEntry 1 }ippmSynchronizationTimeippmOwnersOwner OBJECT-TYPE SYNTAXGMTTimeStampIppmOwnerString MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "Thetime when the synchronization event occurs."owner described by this entry." ::= {ippmSynchronizationEntryippmOwnersEntry 2 }ippmSynchronizationStratumippmOwnersGrantedMetrics OBJECT-TYPE SYNTAXInteger32IppmStandardMetrics MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"The stratum level of the clock computed when" Defines thesynchronization event occurs."metrics granted to an owner for which measurements can be performed." ::= {ippmSynchronizationEntryippmOwnersEntry 3 }ippmSynchronizationResolutionippmOwnersQuota OBJECT-TYPE SYNTAX Integer32UNITS "NanoSeconds"MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"The new time resolution computed after" The maximum number of records that this owner may have in thesynchronization event occured."history table and/or in the report table.ÆÆ ::= {ippmSynchronizationEntryippmOwnersEntry 4 }ippmPointOfMeasureTableippmOwnersIpAddressType OBJECT-TYPE SYNTAXSEQUENCE OF IppmPointOfMeasureEntryInetAddressType { ipv4(1) , ipv6(2), dns(16) } MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION" A lookup table that identifies the management software in charge of the point"The IP address type ofmeasures. ippmPointOfMeasureTable content is read only. It means that the measurement software handlesthetable internally ippmPointOfMeasureTablemanagement entity corresponding to this owner. InetAddressType ismandatory."restricted to ipv4(1),ipv6(2)and dns(16). " ::= {ippmSystem 7ippmOwnersEntry 5 }ippmPointOfMeasureEntryippmOwnersIpAddress OBJECT-TYPE SYNTAXIppmPointOfMeasureEntryInetAddress (SIZE (1..128)) MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION" An entry may be the management"The IP address ofa middleware in charge of the management of a set of probes. It maythe managementaddress of a probe that contains several line cards. An entry describes the capability of a point of measure. The description may make the use of wildcardsentity corresponding todefine multiple capabilities." INDEX { ippmPointOfMeasureIndex } ::= { ippmPointOfMeasureTable 1 } IppmPointOfMeasureEntrythis owner." ::=SEQUENCE{ippmPointOfMeasureIndex Integer32, ippmPointOfMeasureMgmtAddrType InetAddressType, ippmPointOfMeasureMgmtAddress InetAddress, ippmPointOfMeasureTypePAddress TypeP, ippmPointOfMeasureAddress InetAddressippmOwnersEntry 6 }ippmPointOfMeasureIndexippmOwnersEmail OBJECT-TYPE SYNTAXInteger32 (1 .. 65535)SnmpAdminString MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION "Theindexemail address of theentry."management entity corresponding to this owner." ::= {ippmPointOfMeasureEntry 1ippmOwnersEntry 7 }ippmPointOfMeasureMgmtAddrTypeippmOwnersSMS OBJECT-TYPE SYNTAXInetAddressTypeSnmpAdminString MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "ThetypeSMS phone number ofaddress associated withthe managementaddress"entity corresponding to this owner." ::= {ippmPointOfMeasureEntry 2ippmOwnersEntry 8 }ippmPointOfMeasureMgmtAddressippmOwnersStatus OBJECT-TYPE SYNTAXInetAddress (SIZE (1..128))RowStatus MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "Themanagement address on the pointstatus ofmeasure"this table entry." ::= {ippmPointOfMeasureEntry 3ippmOwnersEntry 9 }ippmPointOfMeasureTypePAddress-- ippmHistory Group -- -- -- -- ippmHistoryTable -- ippmHistoryTable OBJECT-TYPE SYNTAXTypePSEQUENCE OF IppmHistoryEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"Defines the type P of the address of"The table containing thepoint of measure." DEFVAL { "ip" }measurement results." ::= {ippmPointOfMeasureEntry 4ippmHistory 1 }ippmPointOfMeasureAddressippmHistoryEntry OBJECT-TYPE SYNTAXInetAddressIppmHistoryEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"Specifies the address"An ippmHistoryEntry entry is one of thepointresults ofmeasure. It is represented as an octet string with specific semantics and length asa measure identified by ippmHistoryMeasureOwner, ippmHistoryMeasureIndex, ippmHistoryMetricIndex and ippmHistoryIndex. In theippmPointOfMeasureTypePAddress. For example, ifindex : + ippmHistoryMeasureOwner identifies theippmPointOfMeasureTypePAddress indicates an encapsulationowner of'ip', this object length is 4, followed bythe4 octets ofmeasure; + ippmHistoryMeasureIndex identifies theIP address,measure innetwork byte order." ::= { ippmPointOfMeasureEntry 5} -- -- ippmOwners Group -- -- The ippmOwners objects are responsible for managing --theowners access toowner namespace; + ippmHistoryMetricIndex identifies themeasurements. -- -- ippmOwnersTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmOwnersEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A management entity wishing to create and activate remote Ippm measurements in an agent must previously be registered inmetric measured by theippmOwnersTable. ippmOwnersTable contentmeasure. The metric isread-create. It contains at leastdescribed in theowner 'monitor'. It is mandatory, except ifcorresponding entry of theVACM frameworkn ippmMetricTable; + ippmHistoryIndex isused."the local index of the result on the history table." INDEX { ippmHistoryMeasureOwner, ippmHistoryMeasureIndex, ippmHistoryMetricIndex, ippmHistoryIndex } ::= {ippmOwnersippmHistoryTable 1 }ippmOwnersEntry OBJECT-TYPE SYNTAX IppmOwnersEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The description of the resources granted to an SNMP application. For example, an instance of ippmOwnersOwner with an IppmOwnerString 'acme', which represents the 14th owner created in ippmOwnersTable would be named ippmOwnersEntryOwner.14. Notes: The ippmOwnersIndex value is a local index managed directly by the agent. The management application must poll to get the next available index value. It is not used in anyway in the other IPPM tables." INDEX { ippmOwnersIndex } ::= { ippmOwnersTable 1 } IppmOwnersEntryIppmHistoryEntry ::= SEQUENCE {ippmOwnersIndexippmHistoryMeasureOwner IppmOwnerString, ippmHistoryMeasureIndex Integer32,ippmOwnersOwner SnmpAdminString, ippmOwnersGrantedMetrics IppmStandardMetrics, ippmOwnersGrantedRules BITS, ippmOwnersIpAddressType InetAddressType, ippmOwnersIpAddress InetAddress, ippmOwnersEmail SnmpAdminString, ippmOwnersSMS SnmpAdminString, ippmOwnersStatus RowStatusippmHistoryMetricIndex Integer32, ippmHistoryIndex Integer32, ippmHistorySequence Integer32, ippmHistoryTimestamp GMTTimeStamp, ippmHistoryValue Integer32 }ippmOwnersIndexippmHistoryMeasureOwner OBJECT-TYPE SYNTAXInteger32 (1.. 65535)IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION"An arbitrary index"The owner of the measure thatidentifies an entry inproduced thistable"result." ::= {ippmOwnersEntryippmHistoryEntry 1 }ippmOwnersOwnerippmHistoryMeasureIndex OBJECT-TYPE SYNTAXSnmpAdminStringInteger32 (1.. 65535) MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION"The" The ownerdescribed byindex of the measure that produced thisentry."result." ::= {ippmOwnersEntryippmHistoryEntry 2 }ippmOwnersGrantedMetricsippmHistoryMetricIndex OBJECT-TYPE SYNTAXIppmStandardMetricsInteger32 (1.. 65535) MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION "DefinesippmHistoryMetricIndex identifies themetrics granted to an owner."metric measured by the measure. The metric is described in the corresponding entry of the ippmMetricTable." ::= {ippmOwnersEntryippmHistoryEntry 3 }ippmOwnersGrantedRulesippmHistoryIndex OBJECT-TYPE SYNTAXBITS { all(0), readonly(1), permanent(2), sender(3), receiver(4), report(5), alarm(6) }Integer32 (1.. 65535) MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION"Defines the rules this owner may act on" A local index that identifies a result in the history table." ::= { ippmHistoryEntry 4 } ippmHistorySequence OBJECT-TYPE SYNTAX Integer32 (0.. 65535) MAX-ACCESS read-only STATUS currentIPPM MIB instance. all(0): The ownerDESCRIPTION "ippmHistorySequence isgranted alltherules. readonly(1): The measures (not onlysequence index of themetrics) that this owner may access are setup bymeasurement results for a metric. Network metrics: It's themanagersequence index of a measurement packet. Typically, it identifies thepointorder ofmeasure. The owner can not add new measures for these metrics. The creation andtheconfiguration ofpacket in themeasures corresponding to these metrics are managedstream of packets sends by themanager ofsource. Aggregated metrics: It is thepointsequence index ofmeasure. permanent(2): The measures (not onlythemetrics) that this owner may access are determined bycomputed aggregated metric result." ::= { ippmHistoryEntry 5 } ippmHistoryTimestamp OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The timestamp when themanagermeasurement occured." ::= { ippmHistoryEntry 6 } ippmHistoryValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The observed value of thepoint of measure. The owner can not add newmeasurement." ::= { ippmHistoryEntry 7 } -- -- ippmMeasure Group -- -- -- -- ippmNetMeasureTable -- -- ippmNetMeasureTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmNetMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A entry is a measurement that performs network measuresfor these metrics.and provides results. It performs several metric measurements per packet exchange. Each step of a measure produces a singleton result per metric. Thecreationtime of the measurement and thefirst configurationvalue of themeasures corresponding to these metricsmetric aremanaged bysaved in themanager ofippmHistoryTable." ::= { ippmMeasure 1 } ippmNetMeasureEntry OBJECT-TYPE SYNTAX IppmNetMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " Typically thepointconfiguration operation sets both the values ofmeasure.the new IppmNetMeasureEntry. Theowner may modifyIppmNetMeasureTable is mandatory. The IppmNetMeasureTable content is read only. It means that themeasures parameters ofmeasurement software handles theentriestable internally. The setup of thecorresponding ippmMeasureEntry whose accessnetwork measure isread-write. Typically this allows the owner to suspendnot permitted through themeasures,IPPM REPORTING MIB. OWAP provides a setup protocol tochange the beginningenable andend of the measures. sender(3): The owner may only activate measures for those metrics that send packets from the current point of measure. This flag is only suitable for networkteardown networks measures.It shall be ignored for derived metrics. receiver(4):Theowner may only activate measures for those metrics that receive packets on the current point of measure. This flagippmNetMeasureMetrics isonly suitable for network measures. It shallset to a list of metrics to beignored for derived metrics. Such control increases the security. The owner may not generate packetscomputed from theprobe. report(5):same raw packet exchange. Each step of measurement delivers a singleton per chosen metric. Results are timestamped and saved in the ippmHistoryTable. Theowner may setupippmNetMeasureTable typical usage consists in providing network measure indices in order to allow aggregatedmetrics on themeasurescorrespondingtothese metrics. alarm(6): The owner may setup alarmsperform aggregation on the results ofthe measures metrics. e.g.: if the owner Acme is granted with the metric Instantaneous- Unidirectional-Connectivity as a Receiver in the current point of measure, then Acme can not setup a Instantaneous-Unidirectional- Connectivity to another point of measure." DEFVALnetwork measures.ÆÆ INDEX { ippmNetMeasureOwner, ippmNetMeasureIndex } ::= { ippmNetMeasureTable 1 } IppmNetMeasureEntry ::= SEQUENCE {ippmOwnersEntry 4ippmNetMeasureOwner IppmOwnerString, ippmNetMeasureIndex Integer32, ippmNetMeasureName SnmpAdminString, ippmNetMeasureMetrics IppmStandardMetrics, ippmNetMeasureBeginTime GMTTimeStamp, ippmNetMeasureCollectionRateUnit TimeUnit, ippmNetMeasureCollectionRate Integer32, ippmNetMeasureDurationUnit TimeUnit, ippmNetMeasureDuration Integer32, ippmNetMeasureHistorySize Integer32, ippmNetMeasureFailureMgmtMode INTEGER, ippmNetMeasureResultsMgmt Integer32, ippmNetMeasureSrcTypeP TypeP, ippmNetMeasureSrc TypePaddress, ippmNetMeasureDstTypeP TypeP, ippmNetMeasureDst TypePaddress, ippmNetMeasureTxMode Integer32, ippmNetMeasureTxPacketRateUnit Integer32, ippmNetMeasureTxPacketRate INTEGER, ippmNetMeasureDevtnOrBurstSize Integer32, ippmNetMeasureMedOrIntBurstSize Integer32, ippmNetMeasureLossTimeout Integer32, ippmNetMeasureL3PacketSize Integer32, ippmNetMeasureDataPattern OCTET STRING, ippmNetMeasureMap SnmpAdminString, ippmNetMeasureSingletons INTEGER, ippmNetMeasureOperState INTEGER }ippmOwnersIpAddressTypeippmNetMeasureOwner OBJECT-TYPE SYNTAXInetAddressTypeIppmOwnerString MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION "TheIP address typeowner of themanagement entity corresponding to this owner."network measurement." ::= {ippmOwnersEntry 5ippmNetMeasureEntry 1 }ippmOwnersIpAddressippmNetMeasureIndex OBJECT-TYPE SYNTAXInetAddress (SIZE (1..128))Integer32 (1.. 65535) MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION "TheIP addressowner index of themanagement entity corresponding to this owner. The address is human readable and is represented using the dot format."network measure. " ::= {ippmOwnersEntry 6ippmNetMeasureEntry 2 }ippmOwnersEmailippmNetMeasureName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESSread-createread-only STATUS current DESCRIPTION "Theemail addressname of themanagement entity corresponding to this owner."metric instance. It illustrates the specificity of the metric and includes the metric and the TypeP. Example: IP-TCP-HTTP-One-way-Delay: free text " ::= {ippmOwnersEntry 7ippmNetMeasureEntry 3 }ippmOwnersSMSippmNetMeasureMetrics OBJECT-TYPE SYNTAXSnmpAdminStringIppmStandardMetrics MAX-ACCESSread-createread-only STATUS current DESCRIPTION"The SMS phone number of"Defines themanagement entity correspondingmetrics to compute within thisowner." ::= { ippmOwnersEntry 8 } ippmOwnersStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The statusmeasure. ONLY network metrics of the same type are allowed in thistable entry." ::= { ippmOwnersEntry 9 } -- -- ippmResultSharingTable -- ippmResultSharingTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmResultSharingEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " The ippmResultSharingTable controlsfield. A measure may be configured for theaccessresult ofan ownerdifferent metric singletons to be archived in themeasure resultsippmHistoryTable. The ippmMetricIndex ofother owners. An owner may grant another access to readthe created result has the value ofits measure. Entries may existthe bit index of the corresponding ippmMeasureMetrics as explained above inippmResultSharingTable even ifthemeasures to be shared are not yet defined. Deleting aippmMetricIndex definition. Example: A measureentryasking for One-way-Delay(6) and One-way-Packet-Loss(12) generated a flow of singletons which are logged in theippmMeasureTable does not deleteippmHistoryTable. The singletons created for theentries corresponding to thisOne-way-Delay measureinhave a value of ippmMetricIndex of 6 while theippmResultSharingTable. This table is optional. ippmResultSharingTable content is read-create. If this table is not implemented thencreated singletons for theowner has only access to its own measurement results."One-way-Packet-Loss measure have a value of ippmMetricIndex of 12. One measure may perform simultaneously either several network metrics either several aggregated metrics " -- { one-way-Delay, one-way-Packet-Loss } DEFVAL { ææ0000001000001ÆÆ } ::= {ippmOwners 2ippmNetMeasureEntry 4 }ippmResultSharingEntryippmNetMeasureBeginTime OBJECT-TYPE SYNTAXIppmResultSharingEntryGMTTimeStamp MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"An entry allows an owner to read"Specifies theresults of a measure owned by another owner. It permits 2 typical usages: 1) Creating derived measurements on these results 2) Reading the results from a remote management station. Example: if acme.12 is a One-way-Delay(6) measure, Acme may allow Peter to make derived metrics ontime at which theresults of this measure." INDEX { ippmResultSharingOwner, ippmResultSharingIndex} ::= { ippmResultSharingTable 1 } IppmResultSharingEntrymeasurement begins." ::=SEQUENCE{ippmResultSharingOwner IppmOwnerString, ippmResultSharingIndex Integer32, ippmResultSharingMeasureOwner IppmOwnerString, ippmResultSharingMeasureIndex Integer32, ippmResultSharingGrantedOwner IppmOwnerString, ippmResultSharingStatus RowStatusippmNetMeasureEntry 5 }ippmResultSharingOwnerippmNetMeasureCollectionRateUnit OBJECT-TYPE SYNTAXIppmOwnerStringTimeUnit MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION" The owner"Specifies the unit ofthis result control entry. Typicallytheowner who created this conceptual row."measurement period." DEFVAL { second } ::= {ippmResultSharingEntry 1ippmNetMeasureEntry 6 }ippmResultSharingIndexippmNetMeasureCollectionRate OBJECT-TYPE SYNTAX Integer32(1.. 65535)MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION" The index"Gives the period used to collect singletons from the point ofthis result control entry. Themeasures. This value ismanaged byused as theowner. On creation a SNMP error 'inconsistentValue' is returned if this value is alreadycycle period inuse by this owner."the report." DEFVAL { 60 } ::= {ippmResultSharingEntry 2ippmNetMeasureEntry 7 }ippmResultSharingMeasureOwnerippmNetMeasureDurationUnit OBJECT-TYPE SYNTAXIppmOwnerStringTimeUnit MAX-ACCESSread-createread-only STATUS current DESCRIPTION"The owner of"Specifies themeasure to be shared. The couple ippmResultSharingMeasureOwner, ippmResultSharingMeasureIndex identifies absolutely a measure"measurement duration unit." DEFVAL { second } ::= {ippmResultSharingEntry 3ippmNetMeasureEntry 8 }ippmResultSharingMeasureIndexippmNetMeasureDuration OBJECT-TYPE SYNTAX Integer32(1.. 65535)MAX-ACCESSread-createread-only STATUS current DESCRIPTION"The index of"Specifies themeasure to be shared."measurement duration." DEFVAL { 120 } ::= {ippmResultSharingEntry 4ippmNetMeasureEntry 9 }ippmResultSharingGrantedOwnerippmNetMeasureHistorySize OBJECT-TYPE SYNTAXIppmOwnerStringInteger32 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"The owner who is granted access to"Specifies theresultmaximum number ofthe measure describedresults saved for each metric of this measure. Overflow condition will be managed by thecouple ippmResultSharingMeasureOwner, ippmResultSharingMeasureIndex."object ippmNetMeasureResultsMgmt. " ::= {ippmResultSharingEntry 5ippmNetMeasureEntry 10 }ippmResultSharingStatusippmNetMeasureFailureMgmtMode OBJECT-TYPE SYNTAXRowStatus MAX-ACCESS read-create STATUS current DESCRIPTION " The status of this table entry. Once the entry status is set to active." ::=INTEGER {ippmResultSharingEntry 6auto(1), manual(2), discarded(3) }-- -- -- -- ippmMeasure Group -- -- -- ippmMetricTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmMetricEntryMAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Thistable describes the current implementationobject defines whether this row and the measure controlled by this row are kept in volatile storage and lost upon reboot or if this row ismandatory. Each IPPM standardized metric must be describedbacked up by non-volatile or permanent storage. 'auto' continue the measurement and erase the older entries in thetable. In reporting mode,history. 'manual' continue the measurement and erase the older entriesof this table may be not accessible. It means thatin the history. 'discarded' continue the measurementsoftware handlesand erase thetable internally. ippmMetricTable is mandatory. ippmMetricTable content is read only." ::= { ippmMeasure 1 } ippmMetricEntry OBJECT-TYPE SYNTAX IppmMetricEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describesolder entries in thestatic capabilities of a metric implementation." INDEX { ippmMetricIndex } ::=history. Possible values are: other(1), volatile(2), nonVolatile(3), permanent(4) Network: " DEFVAL {ippmMetricTable 1auto }IppmMetricEntry::=SEQUENCE{ippmMetricIndex Integer32, ippmMetricCapabilities INTEGER, ippmMetricUnit INTEGER, ippmMetricDescription SnmpAdminString, ippmMetricMaxHistorySize Integer32ippmNetMeasureEntry 11 }ippmMetricIndexippmNetMeasureResultsMgmt OBJECT-TYPE SYNTAXInteger32 (1.. 65535)INTEGER { wrap(1), suspend(2), delete(3) } MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"ippmMetricIndex defines an unambiguous index for each standardized metric. Its value is" Action to take when thevalue oflog is full. The user may choose to either wrap, in which case thenode ofagent writes over existing records. The user may choose to suspend writing to themetriclog in theIPPM-REPORTING-MIB metrics registry ippmMib.metrics.rfc. Each metric registered inevent that he wishes to archive thestandard registry must be presentdata. The resume action causes the agent to begin to write inthis table.thelog, and assumes the data has been cleared. Thisindex is used to identifyobject indicates themetric calculated betweenway theIPPM-REPORTING-MIB entities involvedmeasurement results are managed when the owner quota has been exceeded: 'wrap' continue the measurement and erase the older entries in themeasure. Example: The index ofhistory. 'suspend' stop themetric onewayPacketLossAverage which is registered as ippmMib.metrics.rfc.onewayPacketLossAverage will always havemeasure and keep thevalue 14."results in the history. 'delete' remove the results from the history. " ::= {ippmMetricEntry 1ippmNetMeasureEntry 12 }ippmMetricCapabilitiesippmNetMeasureSrcTypeP OBJECT-TYPE SYNTAXINTEGER { notImplemented(0), implemented(1) }TypeP MAX-ACCESS read-only STATUS current DESCRIPTION"A value"Defines the type P ofnotImplemented impliesthemetric is not implemented. A valuesource address ofimplemented impliesthemetric is implemented."packets sent by the measure." DEFVAL {implemented"ip" } ::= {ippmMetricEntry 2ippmNetMeasureEntry 13 }ippmMetricUnitippmNetMeasureSrc OBJECT-TYPE SYNTAXINTEGER { noUnit(0), second(1), ms(2), us(3), ns(4), percentage(5), packets(6), byte(7), kbyte(8), megabyte(9) }TypePaddress MAX-ACCESS read-only STATUS current DESCRIPTION"The unit used in"Specifies thecurrent entity foraddress of theresultssource of themeasurementmeasure. It is represented as a list ofthis metric."parameters corresponding to those of the PROTOCOL IDENTIFIER sets in ippmNetMeasureSrcTypeP." ::= {ippmMetricEntry 3 } ippmMetricDescriptionippmNetMeasureEntry 14} ippmNetMeasureDstTypeP OBJECT-TYPE SYNTAXSnmpAdminStringTypeP MAX-ACCESS read-only STATUS current DESCRIPTION"A textual description"Defines the type P of themetric implementation."destination address of the packets sent by the measure." DEFVAL { "ip" } ::= {ippmMetricEntry 4ippmNetMeasureEntry 15 }ippmMetricMaxHistorySizeippmNetMeasureDst OBJECT-TYPE SYNTAXInteger32TypePaddress MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies themaximum numberaddress ofresults thatthe destination of the measure. It is represented as ametric measure can save inlist of parameters corresponding to those of theippmHistoryTable." DEFVAL { 200 }PROTOCOL IDENTIFIER set in ippmNetMeasureDstTypeP." ::= {ippmMetricEntry 5ippmNetMeasureEntry 16 }-- -- ippmMeasureTable -- -- ippmMeasureTableippmNetMeasureTxMode OBJECT-TYPE SYNTAXSEQUENCE OF IppmMeasureEntryINTEGER { other(0), periodic(1), poisson(2), multiburst(3) } MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Thetable of alltransmit mode used to send theIPPM measures which are running inpackets: 'other' The rule used to send thedevice. They may not all be active. A measure consists ofpackets is unknown. 'periodic' Packets are sent periodically at ippmNetMeasureTxPacketRate rate. 'poisson' Packets are sent using asubset of metrics to compute. The results ofPoisson law, themeasure may be saved inmedian is theippmHistoryTable. The configurationvalue of ippmNetMeasureMedOrIntBurstSize, themeasure sets thedeviation is ippmNetMeasureDevtnOrBurstSize. 'multiburst' Packets are sent bursty at ippmNetMeasureTxPacketRate. The size of thehistory requested in ippmMeasureHistorySize. The maximum numberburst is made ofMIB objects to be collected in the portion of ippmHistoryTable associated with this metric depends on the value of the ippmMetricMaxHistorySize. The value of each metric ippmMeasureHistorySize must not be over the value of ippmMetricMaxHistorySize corresponding to this metric in the ippmMetricTable. The ippmMeasureTable is mandatory. ippmMeasureTable content is read-create. The table is handled internally by the measurement software for network measures. The setup of network is not permitted throughippmNetMeasureDevtnOrBurstSize packets. Between 2 consecutive bursts, transmission stops during theIPPM REPORTING MIB. OWAP provides a setup protocoltime needed toenable and teardown networks measures."send ippmNetMeasureInterBurstPacketsNb. " ::= {ippmMeasure 2ippmNetMeasureEntry 17 }ippmMeasureEntryippmNetMeasureTxPacketRateUnit OBJECT-TYPE SYNTAXIppmMeasureEntryTimeUnit MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Themeasure entries are created/deleted internally bypacket rate unit used to send themeasurement software." INDEX { ippmMeasureOwner, ippmMeasureIndex } ::= { ippmMeasureTable 1 } IppmMeasureEntrypackets." ::=SEQUENCE{ippmMeasureOwner IppmOwnerString, ippmMeasureIndex Integer32, ippmMeasureName SnmpAdminString, ippmMeasureMetrics IppmStandardMetrics, ippmMeasureBeginTime GMTTimeStamp, ippmMeasureClockPeriodUnit TimeUnit, ippmMeasureClockPeriod Integer32, ippmMeasureDurationUnit TimeUnit, ippmMeasureDuration Integer32, ippmMeasureHistorySize Integer32, ippmMeasureStorageType StorageType, ippmMeasureStatus RowStatusippmNetMeasureEntry 18 }ippmMeasureOwnerippmNetMeasureTxPacketRate OBJECT-TYPE SYNTAXIppmOwnerStringInteger32 MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION "Theowner who has configured this entry."rate the packets are sent." ::= {ippmMeasureEntry 1ippmNetMeasureEntry 19 }ippmMeasureIndexippmNetMeasureDevtnOrBurstSize OBJECT-TYPE SYNTAX Integer32(1.. 65535)MAX-ACCESSnot-accessibleread-only STATUS current DESCRIPTION"The owner index of the measure. The value is managed by"Indicates theowner."average number of packets per seconds sent using a poisson law. ippmNetMeasurePoissonRate can not be used conjointly with ippmNetMeasureClockPattern." DEFVAL { 30 } ::= {ippmMeasureEntry 2ippmNetMeasureEntry 20 }ippmMeasureNameippmNetMeasureMedOrIntBurstSize OBJECT-TYPE SYNTAXSnmpAdminStringInteger32 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"The name of the instance of"According to themetric. It illustratestransmit mode, this value indicates thespecificityaverage number of packets per seconds sent using a poisson law, or themetric and includes the metric and the typeP. example: IP-port-HTTP-connectivity"number of packets to wait between consecutive bursts." DEFVAL { 30 } ::= {ippmMeasureEntry 3ippmNetMeasureEntry 21 }ippmMeasureMetricsippmNetMeasureLossTimeout OBJECT-TYPE SYNTAXIppmStandardMetricsInteger32 MAX-ACCESSread-createread-only STATUS current -- UNITS "Milliseconds" DESCRIPTION"Defines"Specifies themetrics to compute within this measure. A measure may be configured fordelay after which theresult of different metric singletons to be archived in the ippmHistoryTable. The ippmMetricIndex ofpacket is considered lost by thecreated result hassink." DEFVAL { 10 } ::= { ippmNetMeasureEntry 22 } ippmNetMeasureL3PacketSize OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies thevaluesize of thebit index ofpackets counted at thecorresponding ippmMeasureMetrics as explained aboveIP network layer in regards to theippmMetricIndexTypeP definition. Example:A measure asking for One-way-Delay(6) and One-way-Packet-Loss(12) generatedFor aflow of singletons which are logged inTypeP 'ip ipip4' theippmHistoryTable. The singletons created forL3 size will be theOne-way-Delay measure have a value of ippmMetricIndexsize of6 while the created singletons fortheOne-way-Packet-Loss measure have a value of ippmMetricIndex of 12." -- { one-way-Delay, one-way-Packet-Loss }packet at ipip4 level. " DEFVAL {'0001000001000000'b64 } ::= {ippmMeasureEntry 4ippmNetMeasureEntry 23 }ippmMeasureBeginTimeippmNetMeasureDataPattern OBJECT-TYPE SYNTAXGMTTimeStampOCTET STRING MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Specifies"The pattern used to fill thetime at whichpayload of themeasure starts."packet." DEFVAL { 'FF'H } ::= {ippmMeasureEntry 5ippmNetMeasureEntry 24 }ippmMeasureClockPeriodUnitippmNetMeasureMap OBJECT-TYPE SYNTAXTimeUnitSnmpAdminString MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Specifies the unit"A administrative name of a network management map to which the measureperiod."belongs." DEFVAL {second"" } ::= {ippmMeasureEntry 6ippmNetMeasureEntry 25 }ippmMeasureClockPeriodippmNetMeasureSingletons OBJECT-TYPE SYNTAX Integer32 MAX-ACCESSread-createread-only STATUS current DESCRIPTION"Specifies"Reports theamountnumber oftime between 2 measurement action intervals. The action is specific tosingletons performed per metric by thesemanticmeasure since the beginning of the measure.Network metrics: The ippmNetworkMeasureClockPattern transformsThis parameters is required for aggregation." ::= { ippmNetMeasureEntry 26 } ippmNetMeasureOperState OBJECT-TYPE SYNTAX INTEGER { unknown(0), running(1), stopped(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "Reports theflow of periodical instants as a flow of unpredictable instantsoperational status ofmeasurement packet emission. As the source and the sink sharethedefinition ofnetwork measure.ÆÆ ::= { ippmNetMeasureEntry 27 } -- -- -- ippmAggrMeasureTable -- -- ippmAggrMeasureTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmAggrMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " An aggregated measure summarizes theclockresults of previous network or aggregated measures. The results may be saved in themeasure, as the sending timestamp is part of the measurement packet, the sink have the information to verify that the streamippmHistoryTable. Each step ofpackets generated bythesource respectscalculation for theclock law. Aggregated metrics: They are performed periodically onmeasure produces asequence of results of other measures. The period corresponds tosingleton result per metric." ::= { ippmMeasure 2 } ippmAggrMeasureEntry OBJECT-TYPE SYNTAX IppmAggrMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "Typically theinterval between two successive computations ofconfiguration operation sets themetric. Thevalue ofippmHistoryTimestamp result of a aggregatedtheIppmAggrMeasureEntry. ippmAggrMeasureTable is mandatory. The ippmAggrMeasureMetrics defines the metriccomputed correspondstothe value of the ippmHistoryTimestampcompute. The results of thelast metricmeasure to summarize are identified by: + ippmAggrMeasureHistoryOwner, + ippmAggrMeasureHistoryOwnerIndex and + ippmAggrMeasureHistoryMetric The aggregated task starts at ippmMeasureBeginTime and ends after ippmMeasureDuration. An aggregated resultof the sequence usedis performed and saved into computetheaggregated metric." DEFVALippmHistoryTable for each ippmMeasureCollectionRate tick. " INDEX {60ippmAggrMeasureOwner, ippmAggrMeasureIndex } ::= {ippmMeasureEntry 7ippmAggrMeasureTable 1 } IppmAggrMeasureEntry ::= SEQUENCE { ippmAggrMeasureOwner IppmOwnerString, ippmAggrMeasureIndex Integer32, ippmAggrMeasureName SnmpAdminString, ippmAggrMeasureMetrics IppmStandardMetrics, ippmAggrMeasureBeginTime GMTTimeStamp, ippmAggrMeasureAggrPeriodUnit TimeUnit, ippmAggrMeasureAggrPeriod Integer32, ippmAggrMeasureDurationUnit TimeUnit, ippmAggrMeasureDuration Integer32, ippmAggrMeasureHistorySize Integer32, ippmAggrMeasureStorageType StorageType, ippmAggrMeasureHistoryOwner IppmOwnerString, ippmAggrMeasureHistoryOwnerIndex Integer32, ippmAggrMeasureHistoryMetric Integer32, ippmAggrMeasureAdminState Integer32, ippmAggrMeasureFastReport OBJECT IDENTIFIER, ippmAggrMeasureMap SnmpAdminString, ippmAggrMeasureResultsMgmt Integer32, ippmAggrMeasureStatus RowStatus }ippmMeasureDurationUnitippmAggrMeasureOwner OBJECT-TYPE SYNTAXTimeUnitIppmOwnerString MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION"Specifies the unit of the measure duration." DEFVAL { second }"The owner who has configured this entry." ::= {ippmMeasureEntry 8ippmAggrMeasureEntry 1 }ippmMeasureDurationippmAggrMeasureIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESSread-createnot-accessible STATUS current DESCRIPTION"Specifies the duration"The owner index of themeasure." DEFVAL { 120 }measure. The value is managed by the owner." ::= {ippmMeasureEntry 9ippmAggrMeasureEntry 2 }ippmMeasureHistorySizeippmAggrMeasureName OBJECT-TYPE SYNTAXInteger32SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION"Specifies"The name of themaximum numberinstance ofresults saved for each metricthe metric. It illustrates the specificity of the metric and includes the metric and the typeP. example: IP-port-HTTP-connectivity" ::= { ippmAggrMeasureEntry 3 } ippmAggrMeasureMetrics OBJECT-TYPE SYNTAX IppmStandardMetrics MAX-ACCESS read-create STATUS current DESCRIPTION "Defines the metrics to compute within this aggregated measure.The historyONLY aggregated metrics ofeachthe same type are allowed in this field. A measure may be configured for the result of different metricis managed as a circular table.singletons to be archived in the ippmHistoryTable. ThenewestippmMetricIndex of the created resultoverwriteshas theoldest one whenvalue of thehistory granted to this metricbit index of the corresponding ippmAggrMeasureMetrics as explained above in the ippmMetricIndex definition. Example: A measureis full.asking for One-way-Delay(6) and One-way-Packet-Loss(12) generated a flow of singletons which are logged in the ippmHistoryTable. Themanagementsingletons created for the One-way-Delay measure have a value of ippmMetricIndex of 6 while theresults may be optimized if synchronized withcreated singletons for thereports stepsOne-way-Packet-Loss measure have a value ofthis measure.ippmMetricIndex of 12. "DEFVAL::= {120ippmAggrMeasureEntry 4 } ippmAggrMeasureBeginTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the time at which the aggregated measure starts." ::= {ippmMeasureEntry 10ippmAggrMeasureEntry 5 }ippmMeasureStorageTypeippmAggrMeasureAggrPeriodUnit OBJECT-TYPE SYNTAXStorageTypeTimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION"This object defines whether this row and"Specifies the unit of the aggregated measurecontrolled by this row are kept in volatile storage and lost upon reboot or if this row is backed up by non-volatile or permanent storage. Possible values are: other(1), volatile(2), nonVolatile(3), permanent(4), readOnly(5)"period." DEFVAL {nonVolatilesecond } ::= {ippmMeasureEntry 11ippmAggrMeasureEntry 6 }ippmMeasureStatusippmAggrMeasureAggrPeriod OBJECT-TYPE SYNTAXRowStatusInteger32 MAX-ACCESS read-create STATUS current DESCRIPTION"The status of this table entry. Once"Specifies theentry status is set to active, the associate entry cannot be modified." ::= { ippmMeasureEntry 12 } -- -- ippmHistory Group -- -- -- -- ippmHistoryTable -- ippmHistoryTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmHistoryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The tableamount of time between 2 measurement action intervals. The action is specific to theresultssemantic of themeasures." ::= { ippmHistory 1 } ippmHistoryEntry OBJECT-TYPE SYNTAX IppmHistoryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An ippmHistoryEntry entry is one ofmeasure. Network metrics: The ippmNetMeasureClockPattern transforms theresultsflow of periodical instants as ameasure identified by ippmMeasureOwner, ippmMeasureIndex, ippmMetricIndexflow of unpredictable instants of measurement packet emission. As the source andippmHistoryIndex. Intheindex : + ippmMeasureOwner identifiessink share theownerdefinition of themeasure; + ippmMeasureIndex identifiesclock of themeasure inmeasure, as theowner namespace; + ippmMetricIndex identifiessending timestamp is part of the measurement packet, the sink have the information to verify that the stream of packets generated by the source respects the clock law. Aggregated metrics: They are performed periodically on a sequence of results of other measures. The period corresponds to the interval between two successive computations of the metric. The value of ippmHistoryTimestamp result of a aggregated metricmeasured in ippmMetricTable; + ippmHistoryIndex iscomputed corresponds to thelocal indexvalue of the ippmHistoryTimestamp of the last metric resultonof thehistory table." INDEXsequence used in to compute the aggregated metric." DEFVAL {ippmMeasureOwner, ippmMeasureIndex, ippmMetricIndex, ippmHistoryIndex60 } ::= {ippmHistoryTable 1ippmAggrMeasureEntry 7 } ippmAggrMeasureDurationUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the unit of the measure duration." DEFVAL { second }IppmHistoryEntry::=SEQUENCE{ippmHistoryIndex Integer32, ippmHistorySequence Integer32, ippmHistoryTimestamp GMTTimeStamp, ippmHistoryValue Integer32ippmAggrMeasureEntry 8 }ippmHistoryIndexippmAggrMeasureDuration OBJECT-TYPE SYNTAX Integer32(1.. 65535)MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION" A local index that only identifies a result in"Specifies thehistory table."duration of the measure." DEFVAL { 120 } ::= {ippmHistoryEntry 1ippmAggrMeasureEntry 9 }ippmHistorySequenceippmAggrMeasureHistorySize OBJECT-TYPE SYNTAX Integer32(1.. 65535)MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"ippmHistorySequence is"Specifies thesequence indexmaximum number ofthe measurementresults saved for each metric of this measure. Overflow condition will be managed by the object ippmAggrMeasureResultsMgmt. " ::= { ippmAggrMeasureEntry 10 } ippmAggrMeasureStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "This object defines whether this row and the measureof a metric. Network metrics: It'scontrolled by this row are kept in volatile storage and lost upon reboot or if this row is backed up by non-volatile or permanent storage. Possible values are: other(1), volatile(2), nonVolatile(3), permanent(4), readOnly(5)." DEFVAL { nonVolatile } ::= { ippmAggrMeasureEntry 11 } ippmAggrMeasureResultsMgmt OBJECT-TYPE SYNTAX INTEGER { wrap(1), suspend(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object displays thesequence index of a measurement packet. Typically, it identifiesway theorderhistory of thepacket inaggregated measure is managed. 'wrap' continue thestream of packets sends bymeasure and erase thesource. Aggregated metrics: It isolder entries in thesequence index ofhistory. 'suspend' stop the measure and keep theaggregated metricresultscomputed."in the history. " DEFVAL { wrap } ::= {ippmHistoryEntry 2ippmAggrMeasureEntry 12 }ippmHistoryTimestampippmAggrMeasureHistoryOwner OBJECT-TYPE SYNTAXGMTTimeStampIppmOwnerString MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "Theinstantowner of the measure to summarize. " ::= { ippmAggrMeasureEntry 13 } ippmAggrMeasureHistoryOwnerIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The owner index of theresult."measure to summarize. " ::= {ippmHistoryEntry 3ippmAggrMeasureEntry 14 }ippmHistoryValueippmAggrMeasureHistoryMetric OBJECT-TYPE SYNTAX Integer32 MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "Thevaluemetric of themeasure."measure to summarize. " ::= {ippmHistoryEntry 4ippmAggrMeasureEntry 15 }ippmOnHistoryFullActionippmAggrMeasureAdminState OBJECT-TYPE SYNTAX INTEGER {wrap(1), suspend(2), resume(3)start(0), stop(1) } MAX-ACCESSread-writeread-create STATUS current DESCRIPTION"Action to take when"This object controls thehistory logactivity of the aggregated measure. 'start' The aggregated measure isfull.started. 'stop' Theuser may choose to either wrap, in which case the agent writes over existing records. The user may choose to suspend writing to the log in the event that he wishes to archive the data. The resume action causes the agent to begin to write in the history log, and assumes the data has been cleared."aggregated measure is stopped. " ::= {ippmHistory 2ippmAggrMeasureEntry 16 }-- -- ippmNetworkMeasure Group -- -- -- -- ippmNetworkMeasureTable -- -- ippmNetworkMeasureTableippmAggrMeasureFastReport OBJECT-TYPE SYNTAXSEQUENCE OF IppmNetworkMeasureEntryOBJECT IDENTIFIER MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION "Aentryfast report is required in order to verify quickly that a measurewhich performs network measuresis running well. The feature 'fast report' is active if IppmAggrMeasureFastReport is not null andprovidespoints to aflownotification. A fast report consists ofresults. This table extendssending by email to theippmMeasureTable. It performs several metric measurements per packet exchange. Each stepowner of the measure, ameasure produces a singleton result per metric. The timetable of themeasure and the valueresults of all themetric are saved in the ippmHistoryTable." ::= { ippmNetworkMeasure 1 } ippmNetworkMeasureEntry OBJECT-TYPE SYNTAX IppmNetworkMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " Typicallymetrics computed by this aggregated measure. The owner email address is read from theconfiguration operation sets bothippmOwnersTable. ippmAggrMeasureFastReport identifies thevalues ofnotification which defines thenew ippmMeasureEntry andheader of thenew IppmNetworkMeasureEntry. IppmNetworkMeasureTable is mandatory. IppmNetworkMeasureTable content is read only. It means that the measurement software handles the table internally.report. Thesetupresults part ofnetwork is not permitted throughtheIPPM REPORTING MIB. OWAP provides a setup protocol to enable and teardown networks measures. The ippmMeasureMetricsreport isset to a listmade ofmetrics to be computed fromthesame raw packet exchange. Each step of measurement deliversasingletoncolumn of results perchosen metric.metrics. Results aretimestamped and saved in the ippmHistoryTable. The ippmNetworkMeasureTable typical usage consists is providing network measure indexes to permitsseparated using commas. To avoid disaster, an aggregated measureto perform aggregation on the results of network measures. An obvious usage of the ippmNetworkMeasureTable consists in the verificationusing a fast report must have a cycle ofthe network measures states." INDEX { ippmMeasureOwner, ippmMeasureIndex } ::= { ippmNetworkMeasureTableaggregation greater than or equal to 1 second and should not sent more than an email every 5 minutes and should not sent more than 12 emails." -- DEFVAL { 0.0 }IppmNetworkMeasureEntry::=SEQUENCE{ippmNetworkMeasureSrcTypeP TypeP, ippmNetworkMeasureSrc TypePaddress, ippmNetworkMeasureDstTypeP TypeP, ippmNetworkMeasureDst TypePaddress, ippmNetworkMeasureClockPattern OCTET STRING, ippmNetworkMeasurePoissonRate Integer32, ippmNetworkMeasureTimeoutDelay Integer32, ippmNetworkMeasureL3PacketSize Integer32, ippmNetworkMeasureDataPattern OCTET STRINGippmAggrMeasureEntry 17 }ippmNetworkMeasureSrcTypePippmAggrMeasureMap OBJECT-TYPE SYNTAXTypePSnmpAdminString MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Defines the type P of the source address"This object allows for classification of thepackets sent bymeasure. It is typically themeasure."name of an administrative map. " DEFVAL {'04000080001000'H"" }-- ->ip: 4.0.0.8.0.1.0::= {ippmNetworkMeasureEntry 1ippmAggrMeasureEntry 18 }ippmNetworkMeasureSrcippmAggrMeasureStatus OBJECT-TYPE SYNTAXTypePaddressRowStatus MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Specifies the address of the source"The status of this table entry. Once themeasure. Itentry status isrepresented as a list of parameters correspondingset tothoseactive, the associate entry cannot be modified. The creation of an aggregated measure forced the creation of thePROTOCOL IDENTIFIER setscorresponding entry inippmNetworkMeasureSrcTypeP."ippmMeasureTable." ::= {ippmNetworkMeasureEntry 2} ippmNetworkMeasureDstTypePippmAggrMeasureEntry 19 } -- -- ippmReport Group -- ippmReportPathToResults OBJECT-TYPE SYNTAXTypePSnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION"Defines the type P of the destination address of" It is typically an URL describing thepackets sent byfile location where themeasure."results are logged. " ::= {ippmNetworkMeasureEntry 3ippmReport 1 }ippmNetworkMeasureDst-- -- -- ippmReportSetupTable -- -- ippmReportSetupTable OBJECT-TYPE SYNTAXTypePaddressSEQUENCE OF IppmReportSetupEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"Specifies the address of the source of the measure. It"The ippmReportSetupTable isrepresented asa list ofparameters corresponding to thosedefinition of reports. It defines thePROTOCOL IDENTIFIER setsresults of network or aggregated measures that are to be reported. A report is saved inippmNetworkMeasureSrcTypeP."the ippmReportTable, or sent to an application using a SNMP Trap, a SNMP inform PDU, an email, or a SMS. The reporting task is not intended to be a batch action processed at the end of the measure. It is coupled with threshold detections and event filtering to deliver application level events and data, while preserving scalability. " ::= {ippmNetworkMeasureEntry 4ippmReport 2 }ippmNetworkMeasureClockPatternippmReportSetupEntry OBJECT-TYPE SYNTAXOCTET STRINGIppmReportSetupEntry MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION"This cyclic clock shapes"The report applies to theprofileresults of a measure as defined in either theinstants of measurement action provided by ippmMeasureClockPeriod according to an arbitrary distribution law. The clock resolution is ippmMeasureClockPeriod.network measure table, or the aggregated measure table. Thebits ofippmReportSetupDefinition describes theclock pattern setdata and the events to include in thevalue 1 determinereport. The definition consists of a list of tasks to perform on thevalid instantsresults ofmeasurement action.the measure. Ameasurereport is associated tobe processed if and only ifa network measure or to an aggregated measure. Note 1: To associate a report to an existing measure thecurrent bit value is 1. This pseudo-random clock pattern allowsmanager suspends theconfigurationmeasure by setting either theNMS of numerous kind of time sampling law such as periodic, pseudo randomippmNetMeasureStatus orPoisson. The source ofthemeasure sendsippmAggrMeasureStatus to 'notInService'. Then one sets thestream of measurement packets synchronously withreport fields and activates thestream of instants selectedmeasure by setting theclock pattern sampling. ippmNetworkMeasureClockPattern can not be used conjointly with ippmNetworkMeasurePoissonRate." DEFVALcorresponding MeasureStatus to 'active'. Note 2: A report is tied to a measure. The period of the measure" INDEX {"11111111"ippmReportSetupOwner, ippmReportSetupIndex }-- 100% periodic::= {ippmNetworkMeasureEntry 5ippmReportSetupTable 1 }ippmNetworkMeasurePoissonRate OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the average number of packets per seconds sent using a poisson law. ippmNetworkMeasurePoissonRate can not be used conjointly with ippmNetworkMeasureClockPattern." DEFVALIppmReportSetupEntry ::= SEQUENCE {30ippmReportSetupOwner IppmOwnerString, ippmReportSetupIndex Integer32, ippmReportSetupMeasureOwner IppmOwnerString, ippmReportSetupMeasureIndex Integer32, ippmReportSetupMeasureMetric Integer32, ippmReportSetupDefinition IppmReportDefinition, ippmReportSetupUpDownThreshold Integer32, ippmReportSetupLowThreshold Integer32, ippmReportSetupHighThreshold Integer32, ippmReportSetupDurationThresUnit TimeUnit, ippmReportSetupDurationThreshold Integer32, ippmReportSetupReportSize Integer32, ippmReportSetupResultsMgmt Integer32, ippmReportSetupNMS SnmpAdminString, ippmReportSetupNotification OBJECT IDENTIFIER, ippmReportSetupMap SnmpAdminString, ippmReportSetupStatus RowStatus } ippmReportSetupOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION "The owner who has configured this report entry." ::= {ippmNetworkMeasureEntry 6ippmReportSetupEntry 1 }ippmNetworkMeasureTimeoutDelayippmReportSetupIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESSread-onlynot-accessible STATUS current-- UNITS "Milliseconds"DESCRIPTION"Specifies the delay after which"The owner index of thepacketreport entry. The value isconsidered lostmanaged by thesink." DEFVAL { 1 }owner." ::= {ippmNetworkMeasureEntry 7ippmReportSetupEntry 2 }ippmNetworkMeasureL3PacketSizeippmReportSetupMeasureOwner OBJECT-TYPE SYNTAXInteger32IppmOwnerString MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION"Specifies the size"The owner of thepackets sent at the last network layer in regardsmeasure tothe TypeP definition." DEFVAL { 64 }report." ::= {ippmNetworkMeasureEntry 8ippmReportSetupEntry 3 }ippmNetworkMeasureDataPatternippmReportSetupMeasureIndex OBJECT-TYPE SYNTAXOCTET STRINGInteger32 (1.. 65535) MAX-ACCESSread-onlyread-create STATUS current DESCRIPTION "Thecurrent field definesindex of theround robin pattern usedmeasure tofill the packet." DEFVAL { 'FF'H }report." ::= {ippmNetworkMeasureEntry 9ippmReportSetupEntry 4 }-- -- -- ippmAggrMeasure Group -- -- -- -- -- ippmAggrMeasureTable -- -- ippmAggrMeasureTableippmReportSetupMeasureMetric OBJECT-TYPE SYNTAXSEQUENCE OF IppmAggrMeasureEntryInteger32 (1.. 65535) MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION" This table extends the ippmMeasureTable. An aggregated measure summarizes the results of previous network or aggregated measures. The results may be saved in the ippmHistoryTable. Each step"The metric of thecalculation for themeasureproduces a singleton result per metric."to report." ::= {ippmAggrMeasure 1ippmReportSetupEntry 5 }ippmAggrMeasureEntryippmReportSetupDefinition OBJECT-TYPE SYNTAXIppmAggrMeasureEntryIppmReportDefinition MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION"Typically the configuration operation sets both"In order to properly define a report, one must provide information to: + Select thevalues ofevents to consider for reporting; + Configure filters to select pertinent values; + Describe thenew ippmMeasureEntry and ofway thenew IppmAggrMeasureEntry. ippmAggrMeasureTablereport ismandatory. ippmAggrMeasureTable contentdelivered; + Describe clean up actions to perform on report completion; The format of a report sent to a NMS isread only. It means that the measure software handlesdescribed in a notification defined in thetable internally.ippmNotifications node. TheippmMeasureMetrics definesevent and themetric to compute. The results offilter selected in themeasurereport definition determines the notification tosummarize are identified by: + ippmAggrMeasureHistoryOwner,refer: +ippmAggrMeasureHistoryOwnerIndexUp and Down filter report format is ippmUpAndDownReport; +ippmAggrMeasureHistoryMetric The aggregated task starts at ippmMeasureBeginTimeInband filter report format is ippmInBandReport; + Outband filter report format is ippmOutBandReport; + Above filter report format is ippmAboveReport; + Below filter report format is ippmBelowReport; + Any filter andends after ippmMeasureDuration. An aggregated resultreportExceededEventsDuration report format isperformedippmEventsDurationExceededReport; + Any filter andsaved intheippmHistoryTable for each ippmMeasureClockPeriod tick. " INDEX { ippmMeasureOwner, ippmMeasureIndex } ::= { ippmAggrMeasureTable 1 } IppmAggrMeasureEntry ::= SEQUENCE { ippmAggrMeasureHistoryOwner IppmOwnerString, ippmAggrMeasureHistoryOwnerIndex Integer32, ippmAggrMeasureHistoryMetric Integer32 } ippmAggrMeasureHistoryOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The owner ofevent onMeasureCompletion report format is ippmCompletedMeasureReport; Example 1: Consider a report definition, which reports on themeasure to summarize. " ::= { ippmAggrMeasureEntry 1 } ippmAggrMeasureHistoryOwnerIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The owner indexfly, up and down result events ofthe measure to summarize. " ::=a metric measure: ippmReportSetupDefinition {ippmAggrMeasureEntry 2onSingleton, reportUpAndDownMetricResults, inSNMPv2TrapPDU }ippmAggrMeasureHistoryMetric OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "The metricThe value of themeasure to summarize. " ::= { ippmAggrMeasureEntry 3 } -- -- ippmReport Group -- -- -- -- ippmReportSetupTable -- -- ippmReportSetupTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmReportSetupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ippmReportSetupTablethreshold isa list of definition of reports.given by ippmReportSetupUpDownThreshold. Itdefineshas theresults ofvalue '5' in this example. Being anetwork or aggregated measures that are to be reported. Aflow of results { 3.3 3.2 3.2 5.1 5.3 5.6 6.3 5.2 4.0 3.8 ...}, the reportis saved inprocess will send 2 traps: + The first one carries theippmReportTable, or sentresults 3.2 and 5.1 corresponding toan application using a SNMP Trap, a SNMP inform PDU, an email oraSMS. The reporting task is not intendeddown tobe a batch action processed atup event; + The second one carries theendresults 5.2 and 4.0 of themeasure. It is coupled with threshold detections and event filteringup todeliver application level events and data, while preserving scalability. It extendsdown event UpAndDown Example 2: Consider thedefinitionreport definition, which reports per measure cycle in a SNMP informRequestPDU, up and down results events of a metric measure: : ippmReportSetupDefinition { onMeasureCycle, reportUpAndDownMetricResults, inInformRequestPDU, onReportDeliveryClearReport } The value of thedefinitionthreshold is given by ippmReportSetupUpDownThreshold. It has the value '5' in this example. The cycle ofameasuremay include the definitionof the measure setup is set to 10 results. Being areport."flow of 10 results { 3.3 3.2 3.2 5.1 5.3 5.6 6.3 5.2 4.0 3.8 ... }, the report process will send one InformRequestPDU that carries the couples (3.2, 5.1) and (5.2 ,4.0) corresponding to the first down to up event and to the second up to down event, respectively. " ::= {ippmReport 1 }ippmReportSetupEntry 6 } ippmReportSetupUpDownThreshold OBJECT-TYPE SYNTAXIppmReportSetupEntryInteger32 MAX-ACCESSnot-accessibleread-create STATUS current DESCRIPTION"The report applies to the results of the measure which"An event isextended by the current report definition. Typically the creation of a report sets bothgenerated when thevaluesresult of thenewmeasureand those ofexceeds thenew IppmReportSetupEntry.value of ippmReportSetupMetricThreshold. TheippmReportSetupDefinition describes the data andthreshold has theevents to include insame unit as thereport.metric. Thedefinition consistsmetric unit is recorded ina list of tasks to perform ontheresultsobject ippmMetricsUnit of this metric entry in themeasure. A report is associated to a network measure or to an aggregated measure. Note 1 : To associate a report to an existing measureippmMetricTable. " ::= { ippmReportSetupEntry 7 } ippmReportSetupLowThreshold OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when themanager suspendsresult of the measurewhile settingof theippmMeasureStatus to 'notInService'. Then he setupsmetric is lower that thereport fields and activatesvalue of ippmReportSetupLowThreshold. The threshold has themeasure while settingsame unit as theippmMeasureStatus to 'active'. Note 2 : A report is tied to a measure.metric. Theperiodmetric unit is recorded in the object ippmMetricsUnit of this metric entry in themeasureippmMetricTable. "INDEX { ippmMeasureOwner, ippmMeasureIndex } ::= { ippmReportSetupTable 1 } IppmReportSetupEntry::=SEQUENCE{ippmReportSetupDefinition IppmReportDefinition, ippmReportSetupMetricThreshold Integer32, ippmReportSetupDurationThreshold Integer32, ippmReportSetupNMS SnmpAdminString, ippmReportSetupNotification OBJECT IDENTIFIER, ippmReportSetupStatus RowStatusippmReportSetupEntry 8 }ippmReportSetupDefinitionippmReportSetupHighThreshold OBJECT-TYPE SYNTAXIppmReportDefinitionInteger32 MAX-ACCESS read-create STATUS current DESCRIPTION"The description"An event is generated when the result of theevents and actions that are used inmeasure of thedefinitionmetric exceeds the value of ippmReportSetupHighThreshold. The threshold has thereport. Sendsame unit as thereport usingmetric. The metric unit is recorded in thetypeobject ippmMetricsUnit ofmessage selected bythis metric entry in thebits 8 to 12. The report consistsippmMetricTable. " ::= { ippmReportSetupEntry 9 } ippmReportSetupDurationThresUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION "The unit of the duration threshold." ::= { ippmReportSetupEntry 10 } ippmReportSetupDurationThreshold OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when contiguous results of the measurewhich have been saved inare over theippmReportTable. IfippmReportSetupUpDownThreshold, during ippmReportSetupDurationThreshold seconds. Performance: To improve theonEventSendReport(7) bit is unset,performance of the system, the reportis not saved. The message sent is a notification defined inprocess may be synchronized with theippmNotifications node. The notification sent depends on the step of the measure: + Singleton events are sent using the notification ippmSingletonAlarm + Exceeded events durations are sent using the notification ippmEventsDurationExceededAlarm + A report of acycle ofmeasure is sent using the notification ippmCycleOfMeasureReport + A reportcollection ofa completenetwork measureis sent usingor with thenotification ippmCompletedMeasureReport Example 1: The report setupperiod of aggregation of analarm to be sent to the owner in a SNMP Trap each timeaggregate measure." DEFVAL { 15 } ::= { ippmReportSetupEntry 11 } ippmReportSetupReportSize OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies thetwomaximum number of resultsare found onsaved for eachside of themetricthreshold valueof5: ippmReportSetupMetricThreshold 5 ippmReportSetupDefinition { onSingleton(1), reportOnlyUptoDownMetricResults(4), inSNMPTrapPDU(8) } Example 2:this measure. Thesetuphistory ofa report to be sent to the owner in a SNMP informRequestPDU per measure cycle. It reports the two results found oneachside of themetricthreshold of 5: ippmReportSetupMetricThreshold 5 ippmReportSetupDefinition { onMeasureCycle(2), reportOnlyUptoDownMetricResults(4), inInformRequestPDU(10), onReportDeliveryClearHistory(13) } Default report:is managed as a circular table. Thedefault report provides the control protocol with an implicit mechanism to forward thenewest resultof a cycle of measure to the owner ofoverwrites themeasure while deletingoldest one when theresults correspondinghistory granted to thiscycle ofmetric measurefrom the ippmHistoryTable on receptionis full. The management of theresponse toresults may be optimized if synchronized with theInformRequestPDU : ippmReportSetupDefinition { onMeasureCycle(2), inInformRequestPDU(10), onReportDeliveryClearHistory(13) }reports steps of this measure. "DEFVAL { { onMeasureCycle, inInformRequestPDU, onReportDeliveryClearHistory} }::= { ippmReportSetupEntry112 }ippmReportSetupMetricThresholdippmReportSetupResultsMgmt OBJECT-TYPE SYNTAXInteger32INTEGER { wrap(1), suspend(2), delete(3) } MAX-ACCESS read-create STATUS current DESCRIPTION"An event is generated" Action to take when theresult of the measure exceeds the value of ippmReportSetupMetricThreshold.report log is full. Thethreshold hasuser may choose to either wrap, in which case thesame unit as the metric.agent writes over existing records. Themetric unit is recorded inuser may choose to suspend writing to theobject ippmMetricsUnit of this metric entrylog in theippmMetricTable. " ::= { ippmReportSetupEntry 2 } ippmReportSetupDurationThreshold OBJECT-TYPE SYNTAX Integer32 UNITS "Seconds" MAX-ACCESS read-create STATUS current DESCRIPTION "Aneventis generated when contiguous results ofthat he wishes to archive themeasure are overdata. The resume action causes theippmReportSetupMetricThreshold, during ippmReportSetupDurationThreshold seconds. Performance: To improveagent to begin to write in theperformancereport log, and assumes theippmReportSetupDurationThreshold may havedata has been cleared This object indicates thesame value asway theippmMeasurePeriod. The default value of ippmReportSetupDurationThresholdmeasure results are managed when the owner quota isippmMeasurePeriod. That improvesover: 'wrap' continue theperformance becausemeasure and erase thethreshold comparison is synchronized witholder entries in theippmMeasurePeriod aggregation cycle. That improveshistory. 'suspend' stop theperformance because it synchronizedmeasure and keep thereport exportation withresults in themanagement ofhistory. 'delete' remove thehistory and report records of a measure." DEFVAL { 15 }results from the history. " ::= { ippmReportSetupEntry313 } ippmReportSetupNMS OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The recipient of the report may be provided in the setup. By default the recipient of the report is the owner of the measure. Its addresses are recorded in the ippmOwnersTable. The type of ippmReportSetupNMS is not InetAddress because the report may be sent using SMS or fax. " ::= { ippmReportSetupEntry414 } ippmReportSetupNotification OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION" ippmReportSetupNotification identifies"Even though the notificationusedtosend the report. The definition of the notification definesuse is defined in thecontent andreport definition, theformatobject ippmReportSetupNotification provides flexibility to select another notification. " -- DEFVAL { 0.0 } ::= { ippmReportSetupEntry 15 } ippmReportSetupMap OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "An administrative name of a map to which thereport. "report belongs." DEFVAL { "" } ::= { ippmReportSetupEntry516 } ippmReportSetupStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this table entry. " ::= { ippmReportSetupEntry617 } -- -- ippmReportTable -- ippmReportTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmReportEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ippmReportTable logs the results of the reports. The results consist of a subset of the results of a measure as described in the report definition. The activation of an up and down filtering in the report definition limits the results logged to those corresponding to major events. Otherwise, the ippmReportTable is identical to the ippmHistoryTable." ::= { ippmReport23 } ippmReportEntry OBJECT-TYPE SYNTAX IppmReportEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "A report is a list of results of a measure. This sample is associated with the ippmReportSetupEntry which has set up the report. An ippmReportEntry entry is one of the results of a measure to report. An ippmReportEntry entry is one of the results of a measure identified byippmReportOwner, ippmReportIndex, ippmReportIndexippmReportMeasureOwner, ippmReportMeasureIndex, ippmReportMetricIndex andippmHistoryIndex.ippmReportIndex. In the index: +ippmMeasureOwnerippmReportMeasureOwner identifies the owner of the measure; +ippmMeasureIndexippmReportMeasureIndex identifies the measure in the owner namespace; +ippmMetricIndexippmReportMetricIndex identifies the metric measured in ippmMetricTable; + ippmReportIndex is the local index of the result on the report table." INDEX {ippmMeasureOwner, ippmMeasureIndex, ippmMetricIndex,ippmReportMeasureOwner, ippmReportMeasureIndex, ippmReportMetricIndex, ippmReportIndex } ::= { ippmReportTable 1 } IppmReportEntry ::= SEQUENCE { ippmReportMeasureOwner IppmOwnerString, ippmReportMeasureIndex Integer32, ippmReportMetricIndex Integer32, ippmReportIndex Integer32, ippmReportSequence Integer32, ippmReportTimestamp GMTTimeStamp, ippmReportValue Integer32 }ippmReportIndexippmReportMeasureOwner OBJECT-TYPE SYNTAXInteger32 (1.. 65535)IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION "Thelocal indexowner of theresult of a metric measure"measure that produced this result." ::= { ippmReportEntry 1 }ippmReportSequenceippmReportMeasureIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESSread-onlynot-accessible STATUS current DESCRIPTION "ippmReportSequence is the sequenceThe owner index of themeasurement results of themeasureof a metric. Network metrics: It'sthat produced this result." ::= { ippmReportEntry 2 } ippmReportMetricIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION " ippmReportMetricIndex identifies the metric measured by the measure. The metric is described in the corresponding entry of the ippmMetricTable." ::= { ippmReportEntry 3 } ippmReportIndex OBJECT-TYPE SYNTAX Integer32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The local index of the result of a metric measure" ::= { ippmReportEntry 4 } ippmReportSequence OBJECT-TYPE SYNTAX Integer32 (0.. 65535) MAX-ACCESS read-only STATUS current DESCRIPTION " ippmReportSequence is the sequence index of the measurement results of the measure of a metric. Network metrics: It's the sequence index of a measurement packet. Typically, it identifies the order of the packet in the stream of packets sends by the source. Aggregated metrics: It is the sequence index of the aggregated metric results computed." ::= { ippmReportEntry25 } ippmReportTimestamp OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The instant of the measure of the result." ::= { ippmReportEntry36 } ippmReportValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The value." ::= { ippmReportEntry4 } ippmOnReportFullAction OBJECT-TYPE SYNTAX INTEGER { wrap(1), suspend(2), resume(3) } MAX-ACCESS read-write STATUS current DESCRIPTION "Action to take when the report log is full. The user may choose to either wrap, in which case the agent writes over existing records. The user may choose to suspend writing to the log in the event that he wishes to archive the data. The resume action causes the agent to begin to write in the report log, and assumes the data has been cleared." ::= { ippmReport 37 } -- -- IPPM Notifications --ippmSingletonAlarmippmUpAndDownReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, ippmMetricType, ippmMetricUnit,ippmReportTimestamp, ippmReportValueippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sent because 2 contiguous results are on opposite sides of the metric threshold value. The notification contains the instances of theippmReportValueippmHistoryValue object that exceeded the threshold. The notification contains the instances of theippmReportTimestampippmHistoryTimestamp identifying the time the eventoccurred."occurred. ippmReportPathToResults is a link to the file name, which contains detailled results corresponding to this event." ::= { ippmNotifications 1 }ippmEventsDurationExceededAlarmippmInBandReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, ippmMetricType, ippmMetricUnit,ippmReportTimestamp, ippmReportValueippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sentwhenbecause thedurationvalue ofcontiguous raising ippmReportSetupMetricThreshold exceedstheippmReportSetupDurationThresholdmeasure is under the high threshold value and greater than the low threshold value. The notification contains the instances of theippmReportValueippmHistoryValue object that exceeded the threshold. The notification contains the instances of theippmReportTimestampippmHistoryTimestamp identifying the time the eventoccurred."occurred. ippmReportPathToResults is a link to the file name, which contains detailled results corresponding to this event." ::= { ippmNotifications 2 }ippmCycleOfMeasureReportippmOutBandReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp,ippmHistoryValueippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sentwhen a measure cycle completes.because the result of the measure is either greater than the high threshold or lower than the low threshold. The notification contains the instances of theippmReportValue objects saved inippmHistoryValue object that exceeded theippmReportTable for this measure cycle.threshold. TheippmHistoryTimestampnotification contains the instances of theindex identifiesippmHistoryTimestamp identifying the time themeasures where performed."event occurred. ippmReportPathToResults is a link to the file name, which contains detailled results corresponding to this event." ::= { ippmNotifications 3 }ippmCompletedMeasureReportippmAboveReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp,ippmHistoryValueippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION"A notification sent when a measure completes." Theindexnotification contains the instances of theincluded ippmReportSetupDefinitionippmHistoryValue objectidentifies the ippmMeasureEntry and the ippmResultSetupEntrythatspecifiedexceeded thereport.threshold. The notification contains the instances of theippmReportValue objects saved in the ippmReportTable for this measure cycle. TheippmHistoryTimestampof the index identifiesidentifying the time themeasures where performed."event occurred. ippmReportPathToResults is a link to the file name, which contains detailled results corresponding to this event." ::= { ippmNotifications 4 }ippmHistoryLogFullippmBelowReport NOTIFICATION-TYPE OBJECTS {ippmOnHistoryFullActionippmReportSetupDefinition, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION"A" The notificationsent when the history log is full. It indicates what action is to be taken. If the action is wrap the agent will write over existing records incontains thebeginninginstances of thelog file. IfippmHistoryValue object that exceeded theaction is suspend,threshold. The notification contains theagent halts all recordinginstances ofmeasures inthehistory table. IfippmHistoryTimestamp identifying theaction is resume,time theagent begins writing measures again inevent occurred. ippmReportPathToResults is a link to thehistory log"file name, which contains detailled results corresponding to this event." ::= { ippmNotifications 5 }ippmReportLogFullippmEventsDurationExceededReport NOTIFICATION-TYPE OBJECTS {ippmOnReportFullActionippmReportSetupDefinition, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue } STATUS current DESCRIPTION "A notification sent when thereport log is full. It indicates what action is to be taken. If the action is wrapduration of continuously rising metric threshold exceeds theagent will write over existing records inippmReportSetupDurationThreshold value. The notification contains thebeginninginstances of thelog file. IfippmReportValue object that exceeded theaction is suspend,threshold. The notification contains theagent halts all recordinginstances ofmeasures inthereport table. IfippmReportTimestamp identifying theactiontime the event occurred. ippmReportPathToResults isresume,a link to the file name, which contains detailled results corresponding to this event. " ::= { ippmNotifications 6 } ippmCompletedMeasureReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sent when a measure completes. The index of the included ippmReportSetupDefinition object identifies the ippmMeasureEntry and the ippmResultSetupEntry that specified the report. ippmReportPathToResults is a link to the file name, which contains the results of this measure cycle." ::= { ippmNotifications 7 } ippmAggrMeasureHistoryFull NOTIFICATION-TYPE OBJECTS { ippmAggrMeasureName, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue } STATUS current DESCRIPTION " A notification sent when the size of the history of a metric of a aggregated measure exceeds ippmAggrMeasureHistorySize. The agentbegins writing measures againwill then manage the reports according to the policy described in ippmAggrMeasureResultsMgmt." ::= { ippmNotifications 8 } ippmNetMeasureHistoryFull NOTIFICATION-TYPE OBJECTS { ippmNetMeasureName, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, ippmHistorySequence, ippmHistoryValue } STATUS current DESCRIPTION " A notification sent when the size of the history of a metric of a network measure exceeded ippmNetMeasureHistorySize. Then the agent manages the records according to the policy described in ippmNetMeasureResultsMgmt." ::= { ippmNotifications 9 } ippmReportLogFull NOTIFICATION-TYPE OBJECTS { -- iIppmReportMetricIndex, ippmReportSetupResultsMgmt, ippmReportTimestamp, ippmReportSequence, ippmReportValue } STATUS current DESCRIPTION "A notification sent when the size of the reportlog"of a metric of a measure exceeded ippmReportSetupReportSize. Then the agent manages the reports according to the policy described in ippmReportSetupResultsMgmt." ::= { ippmNotifications610 } -- -- IPPM MIB Conformance statements -- ippmCompliances OBJECT IDENTIFIER ::={ ippmConformance 1 } ippmGroups OBJECT IDENTIFIER ::={ ippmConformance 2 } ippmProxyInterDomainCompliances MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the IPPM MIB as a proxy in interdomain. The implementation of the VACM control is mandatory." MODULE -- this module MANDATORY-GROUPS { ippmSystemGroup,ippmMeasureGroup, ippmNetworkMeasureGroup,ippmNetMeasureGroup, ippmHistoryGroup, ippmAggrMeasureGroup, ippmReportGroup, ippmNotificationGroup } ::= { ippmCompliances 1 } ippmProxyCompliances MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the IPPM MIB as a proxy." MODULE -- this module MANDATORY-GROUPS { ippmSystemGroup,ippmMeasureGroup, ippmNetworkMeasureGroup,ippmNetMeasureGroup, ippmHistoryGroup, ippmAggrMeasureGroup, ippmReportGroup, ippmNotificationGroup } GROUP ippmOwnersGroup DESCRIPTION "The ippmOwnersGroup is needed if VACM is not implemented." ::= { ippmCompliances 2 } ippmProbeCompliances MODULE-COMPLIANCE STATUS current DESCRIPTION "The compliance statement for SNMP entities which implement the IPPM MIB in a probe." MODULE -- this module MANDATORY-GROUPS { ippmSystemGroup,ippmMeasureGroup, ippmNetworkMeasureGroup,ippmNetMeasureGroup, ippmHistoryGroup } ::= { ippmCompliances 3 } ippmSystemGroup OBJECT-GROUP OBJECTS { ippmSystemSynchronizationDesc, ippmSystemTime, ippmSystemSynchronizationType, ippmSystemClockResolution,ippmSystemCurrentSynchronization,ippmSynchronizationTime, ippmSynchronizationStratum, ippmSynchronizationResolution, ippmPointOfMeasureMgmtAddrType, ippmPointOfMeasureMgmtAddress, ippmPointOfMeasureTypePAddress,ippmPointOfMeasureAddress } STATUS current DESCRIPTION "The IPPM System Group" ::= { ippmGroups 1} ippmMeasureGroup OBJECT-GROUP OBJECTS {ippmPointOfMeasureAddress, ippmSystemOperationalStatus, ippmPointOfMeasureMetrics, ippmMetricCapabilities, ippmMetricType, ippmMetricUnit,ippmMetricDescription, ippmMetricMaxHistorySize, ippmMeasureName, ippmMeasureMetrics, ippmMeasureBeginTime, ippmMeasureClockPeriodUnit, ippmMeasureClockPeriod, ippmMeasureDurationUnit, ippmMeasureDuration, ippmMeasureHistorySize, ippmMeasureStorageType, ippmMeasureStatusippmMetricDescription } STATUS current DESCRIPTION "The IPPMMeasureSystem Group" ::= { ippmGroups2} ippmNetworkMeasureGroup1} ippmNetMeasureGroup OBJECT-GROUP OBJECTS {ippmNetworkMeasureSrcTypeP, ippmNetworkMeasureSrc, ippmNetworkMeasureDstTypeP, ippmNetworkMeasureDst, ippmNetworkMeasureClockPattern, ippmNetworkMeasurePoissonRate, ippmNetworkMeasureTimeoutDelay, ippmNetworkMeasureL3PacketSize, ippmNetworkMeasureDataPatternippmNetMeasureName, ippmNetMeasureMetrics, ippmNetMeasureBeginTime, ippmNetMeasureCollectionRateUnit, ippmNetMeasureCollectionRate, ippmNetMeasureDurationUnit, ippmNetMeasureDuration, ippmNetMeasureHistorySize, ippmNetMeasureFailureMgmtMode, ippmNetMeasureResultsMgmt, ippmNetMeasureSrcTypeP, ippmNetMeasureSrc, ippmNetMeasureDstTypeP, ippmNetMeasureDst, ippmNetMeasureTxMode, ippmNetMeasureTxPacketRateUnit, ippmNetMeasureTxPacketRate, ippmNetMeasureDevtnOrBurstSize, ippmNetMeasureMedOrIntBurstSize, ippmNetMeasureLossTimeout, ippmNetMeasureL3PacketSize, ippmNetMeasureDataPattern, ippmNetMeasureMap, ippmNetMeasureSingletons, ippmNetMeasureOperState } STATUS current DESCRIPTION "The IPPM Network Measure Group" ::= { ippmGroups 3} ippmHistoryGroup OBJECT-GROUP OBJECTS { ippmHistorySequence, ippmHistoryTimestamp,ippmOnHistoryFullAction,ippmHistoryValue } STATUS current DESCRIPTION "The IPPM History Group" ::= { ippmGroups 4} ippmAggrMeasureGroup OBJECT-GROUP OBJECTS { ippmAggrMeasureName, ippmAggrMeasureMetrics, ippmAggrMeasureBeginTime, ippmAggrMeasureAggrPeriodUnit, ippmAggrMeasureAggrPeriod, ippmAggrMeasureDurationUnit, ippmAggrMeasureDuration, ippmAggrMeasureHistorySize, ippmAggrMeasureStorageType, ippmAggrMeasureHistoryOwner, ippmAggrMeasureHistoryOwnerIndex,ippmAggrMeasureHistoryMetricippmAggrMeasureHistoryMetric, ippmAggrMeasureAdminState, ippmAggrMeasureFastReport, ippmAggrMeasureMap, ippmAggrMeasureResultsMgmt, ippmAggrMeasureStatus } STATUS current DESCRIPTION "The IPPM AggregatedMeasure Group" ::= { ippmGroups 5} ippmReportGroup OBJECT-GROUP OBJECTS { ippmReportSetupMeasureOwner, ippmReportSetupMeasureIndex, ippmReportSetupMeasureMetric, ippmReportSetupDefinition,ippmReportSetupMetricThreshold,ippmReportSetupUpDownThreshold, ippmReportSetupLowThreshold, ippmReportSetupHighThreshold, ippmReportSetupDurationThresUnit, ippmReportSetupDurationThreshold, ippmReportSetupReportSize, ippmReportSetupResultsMgmt, ippmReportSetupNMS, ippmReportSetupNotification, ippmReportSetupMap, ippmReportSetupStatus, ippmReportPathToResults, ippmReportSequence, ippmReportTimestamp,ippmReportValue, ippmOnReportFullActionippmReportValue } STATUS current DESCRIPTION "The IPPM Report Group" ::= { ippmGroups 6} ippmOwnersGroup OBJECT-GROUP OBJECTS { ippmOwnersOwner, ippmOwnersGrantedMetrics,ippmOwnersGrantedRules,ippmOwnersQuota, ippmOwnersIpAddressType, ippmOwnersIpAddress, ippmOwnersEmail, ippmOwnersSMS,ippmOwnersStatus, ippmOwnersIpAddressType, ippmResultSharingMeasureOwner, ippmResultSharingMeasureIndex, ippmResultSharingGrantedOwner, ippmResultSharingStatusippmOwnersStatus } STATUS current DESCRIPTION "The IPPM Owners Group" ::= { ippmGroups 7} ippmNotificationGroup NOTIFICATION-GROUP NOTIFICATIONS {ippmSingletonAlarm, ippmCycleOfMeasureReport,ippmUpAndDownReport, ippmInBandReport, ippmOutBandReport, ippmAboveReport, ippmBelowReport, ippmEventsDurationExceededReport, ippmCompletedMeasureReport,ippmEventsDurationExceededAlarm, ippmHistoryLogFull,ippmAggrMeasureHistoryFull, ippmNetMeasureHistoryFull, ippmReportLogFull } STATUS current DESCRIPTION "The IPPM Notification Group" ::= { ippmGroups 8} END9.8 Security Considerations9.1.8.1 VACM Access control View Based Access Control, or VACM may be used to restrict access to certain objects, or even object instances within tables. For example, one may: + Give an 'administrator' write access to the ippmOwnersTable, whereas all other users may only have read access + Give access to individual rows in the network measure, aggregated measure, history, and report table to particular owners based upon indexing on an 'owners name', and even upon a particular measure. This will be illustrated below. + Give access of one ownerÆs measure, and associated results, to another owner in order to create an aggregated measure based upon the results. 8.1.1 Example of implementing VACM control for the IPPM-REPORTING-MIB The following example illustrates how one could use VACM to restrict access to particular objects within the MIB. It uses syntax specific to a particular agent development toolkit, but may be generalized using the concepts as defined in the VACM MIB. In this example, we have two NMS users, namely user1=owner1 and user2=owner2: 1) First we define the two users and their host addresses: com2sec owner1 owner1computer@ private com2sec owner2 owner2computer@ private 2) We then define SNMPv2c groups group owner1 v2c owner1 group owner2 v2c owner2 view notif included ippmNotifications ff 3.1) For the user owner1, we now define the views for which he will have read access # covers PointOfMeasureTable SynchronizationTable and all scalars view owner1read included ippmSystem ff # covers OwnersTable view owner1read included ippmOwners ff # covers MetricsTable view owner1read included ippmMeasure ff # covers NetworkMeasureTable view owner1read included ippmNetMeasureOwner.6.111.119.110.101.114.49 ff.df.c0 # covers AggrMeasureTable view owner1read included ippmAggrMeasureOwner.6.111.119.110.101.114.49 ff.df.c0 3.2) We will now define the views for which owner1 will have write access view owner1write included ippmAggrMeasureOwner.6.111.119.110.101.114.49 ff.df.c0 # covers ReportSetupTable view owner1read included ippmReportSetupOwner.6.111.119.110.101.114.49 ff.df.c0 view owner1write included ippmReportSetupOwner.6.111.119.110.101.114.49 ff.df.c0 # covers HistoryTable view owner1read included ippmHistoryMeasureOwner.6.111.119.110.101.114.49 ff.df.c0 # covers ReportTable view owner1read included ippmReportOwner.6.111.119.110.101.114.49 ff.df.c0 3.3) For owner2, we will define the views for which he has read access view owner2read included ippmSystem ff view owner2read included ippmOwners ff view owner2read included ippmMeasure ff # covers NetworkMeasureTable plus let's say the owner1 network measure of index X view owner2read included ippmNetMeasureOwner.6.111.119.110.101.114.50 ff.df.c0 view owner2read included ippmNetMeasureOwner.6.111.119.110.101.114.49.X ff.df.e0 # covers AggrMeasureTable plus let's say the OWNER1 aggregated measure of index Y view owner2read included ippmAggrMeasureOwner.6.111.119.110.101.114.50 ff.df.c0 view owner2read included ippmAggrMeasureOwner.6.111.119.110.101.114.49.Y ff.df.e0 3.4) For owner2, we will define the views for which he has write access view owner2write included ippmAggrMeasureOwner.6.111.119.110.101.114.50 ff.df.c0 # covers ReportSetupTable view owner2read included ippmReportSetupOwner.6.111.119.110.101.114.50 ff.df.c0 view owner2write included ippmReportSetupOwner.6.111.119.110.101.114.50 ff.df.c0 # covers HistoryTable plus OWNER1 related X network measure results and OWNER1 related Y aggregated measure results view owner2read included ippmHistoryMeasureOwner.6.111.119.110.101.114.50 ff.df.c0 view owner2read included ippmHistoryMeasureOwner.6.111.119.110.101.114.49.X ff.df.e0 view owner2read included ippmHistoryMeasureOwner.6.111.119.110.101.114.49.Y ff.df.e0 # covers ReportTable view owner2read included ippmReportOwner.6.111.119.110.101.114.50 ff.df.c0 3.5) Now we give the two users access to the views defined above. Note that owner1 and owner2 have read access to owner1read and owner2read views respectively. They have write access to owner1write and owner2write view respectively. And they both have access to all the notifications. access owner1 "" any noauth exact owner1read owner1write notif access owner2 "" any noauth exact owner2read owner2write notif 8.2 Privacy The privacy concerns of network measurement are intrinsically limited by the active measurements. Unlike passive measurements, there can be no release of existing user data.9.2.8.3 Measurement aspects Conducting Internet measurements raises both security and privacy concerns. This memo does not specify an implementation of the metrics, so it does not directly affect the security of the Internet nor of applications that run on the Internet. However, implementations of these metrics must be mindful of security and privacy concerns. There are two types of security concerns: potential harm caused by the measurements, and potential harm to the measurements. The measurements could cause harm because they are active, and inject packets into the network. The measurement parameters MUST be carefully selected so that the measurements inject trivial amounts of additional traffic into the networks they measure. If they inject "too much" traffic, they can skew the results of the measurement, and in extreme cases cause congestion and denial of service. The measurements themselves could be harmed by routers giving measurement traffic a different priority than "normal" traffic, or by an attacker injecting artificial measurement traffic. If routers can recognize measurement traffic and treat it separately, the measurements will not reflect actual user traffic. If an attacker injects artificial traffic that is accepted as legitimate, the loss rate will be artificially lowered. Therefore, the measurement methodologies SHOULD include appropriate techniques to reduce the probability measurement traffic can be distinguished from "normal" traffic. Authentication techniques, such as digital signatures, may be used where appropriate to guard against injected traffic attacks.9.3.8.4 Management aspects There are a number of management objects defined in this MIB that have a MAX-ACCESS clause of read-write and/or read-only. 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. SNMPv1 by itself is not a secure environment. Even if the network itself is secure (for example by using IPSec), eventhen, 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. It is recommended that the implementors consider the security features as provided by the SNMPv3 framework. Specifically, the use of the User-based Security Model RFC 2574 [18] and the View-based Access Control Model RFC 2575 [21] is recommended. It is then a customer/user responsibility to ensure that the SNMP entity giving access to an instance of this MIB, 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. 10. Document management 10.1. Open issues Describe incompatible bit combinations in IPPMreport and granted metric Run SMIlint. Discussion on the management of the history size. 10.2. changes since release 00 + Put in a description of the relationship of certain tables, particularly the measure/network measure/aggregated measure table. + The TC GMTTimeStamp is the common type to define timestamp objects. + ippmHisoryTable index simplified: ippmHistoryTimestamp replaced with ippmHistorySqceNdx in the index. + The MIB has been compiled using net-snmp. + Snmpadminstring replaces Displaystring. + IP addresses defined using INETaddresstype. + Sharing table is optional to permit the VACM framework to be used. + The description of the network measure table emphases that the set up of network measure is not permitted using SNMP. + The TC StandardMetricsthen, there isremoved and replaced withno control as to who on thetable ippmMetricsTable. + The table pointOfMeasureTablesecure network isadded to describe multiples interfaces devices + 5 tables have been changedallowed toread/create: ippmOwnersTable, ippmMeasureTable, ippmAggrMeasureTable, ippmResultSharingTable, and ippmReportSetupTable. + IppmHistoryTableaccess andippmReportTable index reviews: IppmHistorySqceNdx field added inGET/SET (read/change/create/delete) theippmHistoryTable. INDEX modified. IppmHistorySqceNdx replaces IppmHistoryTimemark. + IppmSystem group refurbished: IppmSystemTimer renamed ippmSystemTime. Current and last synch event concept generalizedobjects in this MIB. It is recommended that theippmSynchronizationTable. 10.3. Changes since release 01 + Document Format: Make use ofimplementors consider theregular MIB object indentation. + Typos correction: ippmMeasureHystorySize and so on. + Time unit textual convention: Enumerations listed in description clauses (e.g. ms, us, ns may not be universally understood so explicitly namedsecurity features asmillisecond, microsecond, nanosecond) + Clarify ClearHistory and ClearReport definition: OnReportDeliveryClearHistory and OnReportDeliveryClearReport options + Added scalars ippmOnReportFullAction and ippmOnHistoryFullAction: To take action when the tables are full. A scalar, which is read- write and indicatesprovided by theaction to be taken whenSNMPv3 framework. Specifically, thelog is full. Options are: wrap, suspend, resume. Same was done for report group. + Conformance section: Addeduse of theMODULE-COMPLIANCE macroUser-based Security Model RFC 2574 [18] and thecorresponding OBJECT- GROUPS instances. AddedView-based Access Control Model RFC 2575 [21] is recommended. It is then acompliance instances for proxy mode, proxy inter-domain mode and probe mode. + PointOfMeasure: Put in ippmPointOfMeasureMgmtAddrType-> InetAddressType with ippmPointOfMeasureMgmtAddress-> InetAddress. Changed point of measure addresscustomer/user responsibility tobe INET also. + Took out default pointensure that the SNMP entity giving access to an instance ofmeasure address: Added OwnersIpAddressTypethis MIB, is properly configured to give access tobe in pair with OwnersIpAddress + Added ippmSynchronizationResolution in the ppmSynchronizationTable: It indicatesthenew time resolution (Henk request). + Addedobjects only to those principals (users) that have legitimate rights to indeed GET or SET (change/create/delete) them. 9 Document management 9.1 Open issues Defval 0 for anobject ippmReportSetupNotification in the report setup.OID ? Usage of accessible-for-notify for an index ? Subtype of InetAddress ? 9.2 Changes done since release 02 +IppmHistoryIndex addedSecurity/VACM: sharing table removed; ippmMeasure merged with networkMeasure and AggrMeasure to have all networkMeasure objects in read only. Indexes belong to thehistory table: To differentiate the result index from the test packet order.table; remove all reference to SNMPv1 ...inSNMPTrapPDU +IppmReportIndexSystem: ippmSystemOperationalStatus addedin the report table: To differentiateippmSynchronizationTable adapted for proxy mode: ippmPointOfMeasureIndex added to theresultindex of ippmSystemCurrentSynchronization removed fromthe test packet order.system capabilities: ippmPointOfMeasureMetrics added to IppmPointOfMeasureEntry; ippmMetricType added to ippmMetricsTable; +Smilint:Owners ippmMetricMaxHistorySize replaced withthe option -s -l6: Name length exceeded 32 chars: Prefix: + ippmAggregatedMeasure -> ippmAggrMeasure; + IppmSystemSynchronizationDescription -> ippmSystemSynchronizationDescr; + IppmReportSetupEventsDurationThreshold -> ippmReportSetupDurationThreshold. + ippmNotifications identified under ippmquota in ippmOwnersTable; +TC OwnerStringippmOnHistoryFullAction replaced withIppmOwnerString to fix a warning of the key length; + Gain 0 error and warning ! + ippmAggrMeasureStatus removed: The status of the row is managedresultsMgmt inthe ippmMeasureTable + Notifications: definition clarified; ippmReportTimestamp added to notification ippmEventsDurationExceededAlarm, ippmSingletonAlarm, ippmCycleOfMeasureReport, ippmCompletedMeasureReport.aggr and network.; +IppmNetworkMeasureEntry : ippmNetworkMeasurePoissonRatenetwork measure: ippmNetMeasureOperState addedas the average rates. + TypeP redefined as a SnmpAdminString instead of a raw OCTET STRING e.g: '080000080000000011020000'H -> "ip.ipip4". open issue: is there a needto indicate thenumber of parametersstate of theprotocol identifier ? "ip.ipip4.2" or "ip.ipip4" ? + TypePaddress Textual convention created: Dst and Src value is a display string insteadnetwork measure state; added burst mode; state ofa raw OCTET STRING. It isthelist of parametersmeasure: nb ofa TypeP. e.g: Src address TypeP is "ip.ipip4": 128.2.6.7 in 192.168.1.1. Src value was '0A04C0A801010480020607'H. Src is now "192.168.1.1 128.2.6.7". open issue: is there any potential parameter with onesingletons collected and oper status added; +aggregated metric: fast report added to get raw results by email; + report setup: onReportDeliveryClearHistory removed from IppmReportDefinition; + Map field added to network, aggr and report tables to help to map on topology map ormore space inside ? 11.admin view. 10 References [1] Bradner, S., "The Internet Standards Process -- Revision 3", BCP 9, RFC 2026, October 1996. [2]Mahdavi J. and V. Paxson, "IPPM Metrics for Measuring Connectivity", RFC 2678, September 1999. [3] Almes, G., Kalidindi, S. and M. Zekauskas, "A One-way Delay Metric for IPPM", RFC 2679, September 1999. [4] Almes, G., Kalidindi, S. and M. Zekauskas, "A One-way Packet Loss Metric for IPPM", RFC 2680, September 1999. [5]Almes, G., Kalidindi, S. and M. Zekauskas, "A Round-trip Delay Metric for IPPM.", RFC 2681, September 1999. [6]Harrington, D., Presuhn, R., and B. Wijnen, "An Architecture for Describing SNMP Management Frameworks", RFC 2571, April 1999.[7][3] Rose, M., and K. McCloghrie, "Structure and Identification of Management Information for TCP/IP-based Internets", STD 16, RFC 1155, May 1990.[8][4] Rose, M., and K. McCloghrie, "Concise MIB Definitions", STD 16, RFC 1212, March 1991.[9][5] M. Rose, "A Convention for Defining Traps for use with the SNMP", RFC 1215, March 1991.[10][6] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999.[11][7] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Textual Conventions for SMIv2", STD 58, RFC 2579, April 1999.[12][8] McCloghrie, K., Perkins, D., Schoenwaelder, J., Case, J., Rose, M., and S. Waldbusser, "Conformance Statements for SMIv2", STD 58, RFC 2580, April 1999.[13][9] Case, J., Fedor, M., Schoffstall, M., and J. Davin, "Simple Network Management Protocol", STD 15, RFC 1157, May 1990.[14][10] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Introduction to Community-based SNMPv2", RFC 1901, January 1996.[15][11] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Transport Mappings for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1906, January 1996.[16]Case,[12]Case, J., Harrington D., Presuhn R., and B. Wijnen, "Message Processing and Dispatching for the Simple Network Management Protocol (SNMP)", RFC 2572, April 1999.[17][13] Blumenthal, U., and B. Wijnen, "User-based Security Model (USM) for version 3 of the Simple Network Management Protocol (SNMPv3)", RFC 2574, April 1999.[18][14] Case, J., McCloghrie, K., Rose, M., and S. Waldbusser, "Protocol Operations for Version 2 of the Simple Network Management Protocol (SNMPv2)", RFC 1905, January 1996.[19][15] Levi, D., Meyer, P., and B. Stewart, "SNMPv3 Applications", RFC 2573, April 1999.[20][16] Wijnen, B., Presuhn, R., and K. McCloghrie, "View-basedAccess Control Model (VACM) for the Simple Network Management Protocol (SNMP)", RFC 2575, April 1999.[21][17] Case, J., Mundy, R., Partain, D., and B. Stewart, "Introduction to Version 3 of the Internet-standard Network Management Framework", RFC 2570, April 1999.12.11 Acknowledgments A Kerbe.13.12 Authors Addresses Emile STEPHAN France Telecom R & D 2 avenue Pierre Marzin F-22307 Lannion cedex Phone: (+ 33) 2 96 05 11 11 Email: emile.stephan@francetelecom.com Jessie Jewitt France Telecom R & D 801 Gateway Blvd. Suit 500 South San Francisco, CA 94080 Tel : 1 650 875-1524 Email : jessie.jewitt@francetelecom.com Full Copyright Statement "Copyright (C) The Internet Society (2001). All Rights Reserved. This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist its implementation may be prepared, copied, published and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this paragraph are included on all such copies and derivative works. However, this document itself may not be modified in any way, such as by removing the copyright notice or references to the Internet Society or other Internet organizations, except as needed for the purpose of developing Internet standards in which case the procedures for copyrights defined in the Internet Standards process must be followed, or as required to translate it into languages other than English. The limited permissions granted above are perpetual and will not be revoked by the Internet Society or its successors or assigns. This document and the information contained herein is provided on an "AS IS" basis and THE INTERNET SOCIETY AND THE INTERNET ENGINEERING TASK FORCE DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.