--- 1/draft-ietf-ippm-reporting-mib-03.txt 2006-02-04 23:46:26.000000000 +0100 +++ 2/draft-ietf-ippm-reporting-mib-04.txt 2006-02-04 23:46:26.000000000 +0100 @@ -1,14 +1,15 @@ Network Working Group E. Stephan/J. Jewitt Internet Draft France Telecom R&D -Document: draft-ietf-ippm-reporting-mib-03.txt June, 2003 +Document: draft-ietf-ippm-reporting-mib-04.txt October, 2003 +Category: Informational 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 @@ -49,31 +50,32 @@ 5.3 Gateway architecture........................................15 5.4 Security....................................................15 6 Reporting mode integration..................................16 6.1 Integration.................................................16 6.2 Setup of the measure network................................16 6.3 Setup of a measurement report...............................16 6.4 Updating the history of the MIB.............................17 6.5 Report download and upload..................................17 6.6 Default value...............................................17 7 Definition..................................................17 - 8 Security Considerations.....................................71 - 8.1 VACM Access control.........................................71 - 8.2 Privacy.....................................................74 - 8.3 Measurement aspects.........................................74 - 8.4 Management aspects..........................................75 - 9 Document management.........................................75 - 9.1 Open issues.................................................76 - 9.2 Changes done since release 02...............................76 - 10 References..................................................77 - 11 Acknowledgments.............................................78 - 12 Authors Addresses...........................................78 + 8 Security Considerations.....................................70 + 8.1 VACM Access control.........................................70 + 8.2 Privacy.....................................................72 + 8.3 Measurement aspects.........................................73 + 8.4 Management aspects..........................................73 + 9 Document management.........................................74 + 9.1 Open issues.................................................74 + 9.2 Changes done since release 03...............................74 + 9.3 Changes done since release 02...............................75 + 10 References..................................................76 + 11 Acknowledgments.............................................77 + 12 Authors' Addresses..........................................77 1. Introduction This memo defines a MIB for managing network 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 @@ -178,29 +180,29 @@ 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. The administrator may grant access to a measure, or set of measures to another owner via view based access control. As a result, one owner may compute - aggregated metrics on another ownerÆs network measures. + aggregated metrics 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. + is intended to help 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 @@ -213,37 +215,37 @@ GMTTimeStamp, IppmStandardMetrics and IppmReportDefinition. 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. + from nanosecond, microsecond, millisecond, second, hour, day, and + week. 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 + 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. It is important that one be 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. + The standardization of the management of IPPM measures relies on the + capability to 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. @@ -283,83 +285,85 @@ 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.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. + the node rfc in chronological order. This textual convention defines + an octet string to permit several metrics to be performed in a single + measure. 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: + defines 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. + Metric thresholds (low, high, inband, outband...) may be defined that + indicate when measure values should be reported. These values and + their associated time may 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. + One may also want to report when particular values (i.e. constantly + over a threshold) repeatedly occur over a period of time. For + example, if one-way-day is constantly over a specified acceptable + threshold value for 10 minutes, then the values should be reported. The combination of IPPM metric results, threshold events, and event - filtering provides a very efficient mechanism to report results, - events, and alarms. + filtering provides a very efficient mechanism to report measurement + 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 + + The generation 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 Structure of the MIB The MIB is arranged as follow: - ippmSystem - ippmOwners + - ippmMeasure + - ippmHistory - ippmNetMeasure - ippmAggrMeasure - - ippmReport - 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 over time, as well as the system clock where the IPPM-REPORTING-MIB agent resides. @@ -370,21 +374,21 @@ + 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.2 The ippmOwners Group - This group identifies an owner, or group of owners that have access + This group identifies an owner, or group of owners, that have access to measurements on a probe. 4.2.3 The ippmMeasure Group This group contains all the IPPM metrics that are registered and available for use by the 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 the @@ -413,27 +417,27 @@ ippmAggrMeasureTable is responsible for the consolidation, or aggregation, of results 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.7 The Report Group This group displays the existing reports of the measures collected. The ippmReportSetupTable is responsible for the configuration of the reports. - The reports are saved in the ippmReportTable, or sent directly to the - applications. + The reports are saved in the ippmReportTable, or sent directly to + management applications. 4.2.8 The Notification Group The Notification group specifies a list of valid notifications. They - are used to generate alarms,or reports, to the applications. + are used to generate alarms, or reports, to management applications. 4.3 Row identification in an application namespace The control protocol, or the test protocol, adds rows in the namespace of the corresponding measure. An object instance identifier in an owner namespace is defined as a list of objects in the clause INDEX where the first object type is IppmOwnerString. @@ -452,74 +456,69 @@ 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 Relationship of IPPM REPORTING MIB tables - There is inherently a relationship between various tables in the IPPM REPORTING MIB, and as such, the data integrity must be assured. This relationship is depicted in the following examples. 4.4.1 Relationship between the Owners Table and the aggregated measure table The owners table contains the list of "owners" that can create and - activate remotely aggregated measures in an IPPM agent or read the + activate remotely aggregated measures in an IPPM agent, or read the 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 "administrator" may be given "write" privileges on the ippmOwnersTable, whereas all others are restricted to "read" access. The user "administrator" can then setup the list of other users that have access to measures. There must be at least 1 owner in the owners' 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 measure tables. Each entry in the measure table is + aggregated measure tables. Each entry in a measure table is associated with one, and only one, entry in the owners' table. That is to say, that a defined measure may NOT have multiple owners. Thus, we have a 1:N relationship between the owners' table and a measure table. 4.4.2 Relationship between the Network Measure Table and the Aggregated Measure Table The network measure table is read-only, thus 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 system that directly interacts with the points of measure. However, the "owner" - of the measure be defined in the owners table. + of the measure must be defined in the owners table. It may be either + configured directly, or exported to the agent by the external + measurement tool. The aggregated measure table allows for an "owner" to create aggregated measures (such as average, minimum, maximum) on existing measures. An owner may even create aggregated measures on network measures that are owned by other owners. However, it is recommended to use view based access control to grant access of network measures - to owners in the system. + to other owners in the system. 5 Measurement architectures There are three main measurement architectures. 5.1 Proxy architecture . +----+ +----+ . |NMS1| |NMS2| . +----+ +----+ @@ -537,24 +536,24 @@ . | | . OWDP-Control . | | . +----------+ +----------+ . | | . v v .+----------------+ +------------------+ .| Packets-Sender |--OWDP-Test-->| Packets-Receiver | .+----------------+ +------------------+ - In this architecture, the different NMSÆs query the IPPM-REPORTING- + 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 + granted access to perform the measure requested. Each NMS may access + the results of its measurements in the IPPM-REPORTING-MIB history 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. @@ -580,40 +579,40 @@ . | | | | . | 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 activation of a measure by the control protocol or the test protocol creates a measure in the IPPM-REPORTING-MIB Network Measure table. The table in question may be not accessible by SNMP. In this case, a list of the measure identifiers (owner, index) is handled by the measurement software. Each timestamped result of the measure is logged in the IPPM- REPORTING-MIB History table in order to allow read access to the - NMSÆs and event handling. + NMS’s and event handling. On completion, the measurement results are managed according to the measure setup: + The results may be sent to an NMS; + They may be dropped from the IPPM-REPORTING-MIB History table. In this mode, it is recommended to use an SNMPv2 Inform PDU to send reporting events because it ensures that the entire block of the result is received. There is no control using SNMP Trap PDU. @@ -663,36 +662,36 @@ 5.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 points of measure. Different security rules may be applied to the NMS domain and to measurement 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 control of the measurement setup relies on the control and + the test protocol security mechanisms; + The control of access to the results depends on the SNMP security mechanisms such as community strings, but may also be restricted using VACM for customized access. The gateway mode security relies on the security of the proxy mode and of the reporting mode. 6 Reporting mode integration The IPPM-REPORTING-MIB standardizes the parameters that: - + Define the configuration of the IPPM metrics measures; + + Define the configuration of the IPPM metric measures; + Define the format of the results of the measure; - + Define the report of the IPPM metric measures results. + + Define the report of the IPPM metric measure results. It introduces the concept 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 control and the test protocols. A measure is identified by its owner and its owner index. This identifier is the same in all the points of measure. As the owner chooses the index, there is no need for negotiation between the NMS and the points of measure before activating the measure. @@ -706,70 +705,70 @@ 6.1 Integration The integration of the IPPM-REPORTING-MIB, and the test and control protocols consists in pushing the network measure setup/teardown parameters and the result values from the measurement software to the IPPM-REPORTING-MIB agent. 6.2 Setup of the measure network - The measurement system updates the MIB on creation of a network - measure. +The measurement system updates the MIB on creation of a network measure. 6.3 Setup of a measurement report A measurement report setup describes events and data to include in the report. A report is read by an NMS in the ippmReportTable, or - pushed to a NMS using a SNMP Inform PDU, an email, or a SMS. + exported to an NMS using an SNMP trap, SNMP Inform PDU, an email, or + an SMS. Different types of reports may be combined: + A trivial report defines the results to be saved in the ippmReportTable; - + A basic report defines the host to which the results are pushed + + A basic report defines the host to which the results are sent on completion of the measure; + An alarm report defines a threshold on the results of the measure. A message is sent to a host when the result rises above, or falls below the threshold; + An SLA report defines a threshold on the results of the measure. The report consists of the results of the measure (time and value) of the filtered events. The reports are sent at each measurement cycle, or when the measure completes. 6.4 Updating the history of the MIB Results have to be written by the measurement task in the agent implementing the IPPM REPORTING MIB. Adding the results of a measurement consists in the transfer of the result from the measurement software to the SNMP agent. The protocol that provides the result may be the control protocol, or the test - protocol. + protocol, or another mechanism. 6.5 Report download and upload - A report is read in the ippmReportTable using SNMP, or pushed by the - IPPM_MIB agent using a SNMP Inform PDU, an email or a SMS. + A report is read in the ippmReportTable using SNMP, or generated by + the IPPM_MIB agent using a SNMP Inform PDU, an email or 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 + experimental ,Integer32, zeroDotZero, Counter64, Unsigned32 FROM SNMPv2-SMI -- -- ippm -- FROM IPPM-REGISTRY -- InetAddressType, InetAddress FROM INET-ADDRESS-MIB SnmpAdminString @@ -777,21 +776,21 @@ RowStatus, StorageType, TEXTUAL-CONVENTION FROM SNMPv2-TC MODULE-COMPLIANCE, OBJECT-GROUP, NOTIFICATION-GROUP FROM SNMPv2-CONF; ippmReportingMib MODULE-IDENTITY - LAST-UPDATED "200306291200Z" -- June, 2003 + LAST-UPDATED "200310141200Z" -- 14 October 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: + 33 2 96 05 36 10 E-mail: emile.stephan@francetelecom.com @@ -815,106 +814,107 @@ "General cleanup Change 5 tables to read write" REVISION "200302141200Z" -- 14 February 2003 DESCRIPTION "Modifications based upon feedback from IETF-55" REVISION "200306291200Z" -- 29 June 2003 DESCRIPTION "Adaptation to VACM, preparation of the final version" - ::= { experimental 10001 } + REVISION "200310241200Z" -- 24 October 2003 + DESCRIPTION + "Modifications based upon feedback from experimental + implementation." + + ::= { experimental 10001 } -- XXX to be assigned by IANA ippm OBJECT IDENTIFIER ::= { experimental 10000 } -- -- TEXTUAL-CONVENTION -- IppmOwnerString ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION - "An OwnerString, which length is limited to 32." + "An OwnerString. The length is limited to 32 bytes." 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) + week(1), + day(2), + hour(3), + minute(4), + second(5), + millisecond(6), + microsecond(7), + nanosecond(8) } -- -- IppmStandardMetrics ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION " Each standard metric is identified in the IPPM-METRICS- REGISTRY under the node 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 the metrics to be measured. + allow for several metrics to be calculated in a single measure, + there is a need to describe in a bit string the metrics to be + measured. + This textual convention defines an octet string that gathers in a bit string a sequence of bits. The bit order corresponds to the - order - of the metric identifiers in the registry. + order of the metric identifiers in the registry. The first bit of the string has the index 0. The index 1 corresponds to the first metric of the registry (instantaneousUnidirectionalConnectivity ). Example: One-way-Delay(6) is identified as the leaf number 6 of the node - rfc of the - registry. One-way-Packet-Loss(12) is identified as the leaf - number 12 of the node + rfc of the registry. One-way-Packet-Loss(12) is identified as the + leaf number 12 of the node rfc of the registry. A network measure performing both One-way- - Delay(6) and One- - way-Packet-Loss(12) will be described as '0001000001000000'b, - '1040'B. + Delay(6) and One-way-Packet-Loss(12) will be described as + '0000001000001000'b, '1040'B. " - SYNTAX OCTET STRING + SYNTAX OCTET STRING (SIZE (1..64)) GMTTimeStamp ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION - "The value at which a specific occurrence happened. The specific - occurrence must be defined in the description of any object - defined using this type. + "The time value at which a specific occurrence took place. The + specific occurrence must be defined in the description 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 of the second* 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 + It differs in that it counts the seconds since 1 Jan 2000 0H00 instead of 1 Jan 1900 0H00. The most significant bit of the part that represents the second is reserved. It will wrap in year 2068 (The NTP timestamp will wrap in year 2036). This bit is set to indicate if the fractional part of the second contains a precision field and a synchronization field as initially proposed in the OWAMP draft. - When this bit is not set the resolution is maximal. + When this bit is not set, the resolution is maximal. The maximal resolution is close to 250 picoseconds. The precision of the timestamp must be provided in another field. " SYNTAX OCTET STRING (SIZE (8)) TypeP ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION @@ -949,35 +949,35 @@ TypePaddress ::= TEXTUAL-CONVENTION DISPLAY-HINT "255a" STATUS current DESCRIPTION "This textual convention is a Display string used to describe the parameters of the protocol encapsulation list of a packet, basically the address. TypePaddress is defined as a display string. It consists in a - list of space separated parameter list. Each parameter in the - list corresponds to a parameter of a PROTOCOL-IDENTIFIER of the - TypeP. + list of blank separated addresses that reflect the encapsulation + of the TypeP. Each parameter in the list corresponds to a + parameter of a PROTOCOL-IDENTIFIER of the TypeP. 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..512)) IppmReportDefinition ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION " A report definition is a list of statements describing a report. A - statement is part of this process if its bit in the definition is set - to '1'. For all bit values that are set to one, a report will be - generated. + statement is part of this process if a corresponding bit in the + definition is set to '1'. For all bit values that are set to one, a + report will be generated. The report process uses results saved in the history table. Threshold values are provided by the report setup. Given that not all results from a metric measurement are pertinent to a particular report, and that the size of the report must be limited whenever possible, the guidelines for the definition of a report are as follows: + Select the events for consideration (1); @@ -1013,21 +1013,21 @@ the up and down metric threshold. ReportInBandResults: Report results lower than the high metric threshold field of the report setup and greater than the low metric threshold field of the report setup. ReportOutBandResults: Report results greater than the high metric threshold - field of the report setup and lower than the low metric + field of the report setup or lower than the low metric threshold field of the report setup. ReportAboveResults: Report results greater than the high metric threshold field of the report setup. ReportBelowResults: Report results lower than the low metric threshold field of the report setup. @@ -1058,21 +1058,22 @@ Send the report using an email. inSMS: Send the report using a SMS. -4- Cleanup onReportDeliveryClearReport(12): Remove all the results corresponding to this measure from the ippmReportTable when the report has been - delivered. + delivered. This must be set in conjunction with + inIppmReportTable, and onMeasureCompletion. " SYNTAX BITS { none(0), -- reserved onSingleton(1), onMeasureCycle(2), onMeasureCompletion(3), reportUpAndDownResults(4), reportInBandResults(5), reportOutBandResults(6), @@ -1091,45 +1092,44 @@ -- IPPM Notifications -- ippmNotifications OBJECT IDENTIFIER ::= { ippm 0 } -- -- IPPM Conformance -- ippmConformance OBJECT IDENTIFIER ::= { ippm 1 } -- --- IPPM Mib objects definitions +-- IPPM MIB Object definitions -- ippmSystem OBJECT IDENTIFIER ::= { ippmReportingMib 1 } ippmOwners OBJECT IDENTIFIER ::= { ippmReportingMib 2 } ippmHistory OBJECT IDENTIFIER ::= { ippmReportingMib 3 } ippmMeasure OBJECT IDENTIFIER ::= { ippmReportingMib 4 } ippmReport OBJECT IDENTIFIER ::= { ippmReportingMib 5 } -- -- ippmSystem Group -- -- ippmSystemTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "The current time of the system running the IPPM REPORTING MIB - SNMP agent. - When the agent is running in proxy mode is it the current time of the -proxy agent. - When the agent is located in the probe, it is the current time -of the probe agent. " + SNMP agent. When the agent is running in proxy mode, it is the + current time of the proxy agent. + When the agent is located in the probe, it is the current time of + the probe agent. " ::= { ippmSystem 1 } ippmSystemSynchronizationType OBJECT-TYPE SYNTAX INTEGER { other(0), ntp(1), gps(2), cdma(3) } MAX-ACCESS read-only @@ -1158,48 +1158,48 @@ ippmSystemSynchronizationDesc OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION "The description of the synchronization process of the system running the IPPM REPORTING MIB SNMP agent." ::= { ippmSystem 3 } ippmSystemClockResolution OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 + UNITS "Nanoseconds" MAX-ACCESS read-only - -- UNITS "picoseconds" STATUS current DESCRIPTION "ippmSystemClockResolution provides the precision of the clock - used for the measures . The unit is the picosecond. For example, + used for the measures . The unit is the nanosecond. For example, the clock on an old Unix host might advance only once every 10 msec, and thus have a resolution of 10 msec. So its resolution is - 100000 picosecond and the value of ippmSystemClockResolution is - 100000." + 10000000 nanoseconds and the value of ippmSystemClockResolution + is 10000000." ::= { ippmSystem 4 } ippmSystemOperationalStatus OBJECT-TYPE SYNTAX INTEGER { unknown(0), up(1), down(2) } MAX-ACCESS read-only STATUS current DESCRIPTION "This object describes the status of the system running the IPPM -REPORTING MIB SNMP agent. It does not describe end points measurement + REPORTING MIB SNMP agent. It does not describe end point measurement status. unknown(0) up(1) means service is operational and available for general use. - down(2) means the proxy is not available for use. + down(2) means the agent is not available for use. " ::= { ippmSystem 5 } ippmSynchronizationTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmSynchronizationEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "This table registers the event related to the synchronization of the points of measure. Each event is described in an @@ -1213,155 +1213,148 @@ MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describes a modification of the synchronization status. " INDEX { ippmPointOfMeasureIndex, ippmSynchronizationIndex } ::= { ippmSynchronizationTable 1 } IppmSynchronizationEntry ::= SEQUENCE { - ippmSynchronizationIndex Integer32, + ippmSynchronizationIndex Unsigned32, ippmSynchronizationTime GMTTimeStamp, - ippmSynchronizationStratum Integer32, - ippmSynchronizationResolution Integer32 + ippmSynchronizationStratum Unsigned32, + ippmSynchronizationResolution Unsigned32 } ippmSynchronizationIndexOBJECT-TYPE - SYNTAX Integer32 (1 .. 65535) + SYNTAX Unsigned32 (1 .. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An index that identifies the synchronization events in chronological order." ::= { ippmSynchronizationEntry 1 } ippmSynchronizationTime OBJECT-TYPE SYNTAX GMTTimeStamp - MAX-ACCESS read-only STATUS current DESCRIPTION "The time when the synchronization event occurs." ::= { ippmSynchronizationEntry 2 } ippmSynchronizationStratum OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "The stratum level of the clock computed when the synchronization event occurs." ::= { ippmSynchronizationEntry 3 } ippmSynchronizationResolution OBJECT-TYPE - SYNTAX Integer32 - UNITS "NanoSeconds" + SYNTAX Unsigned32 + 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 is the list of measurement end points available in the measurement system. Proxy mode: It is the list of the measurement end points of the set of probes - for which the IPPM proxy provides an SNMP interface. + for which the IPPM agent provides an SNMP interface. IPPM MIB implemented in a probe: It is the list of the measurement end points of the probe. The ippmPointOfMeasureTable content is read only. This implies that the measurement software handles the table internally ippmPointOfMeasureTable is mandatory." ::= { ippmSystem 7 } ippmPointOfMeasureEntry OBJECT-TYPE SYNTAX IppmPointOfMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION - " An entry may be the management address of a middleware in + " An entry may be the management address of some middleware in charge of the management of a set of probes. It may the management address 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 wildcards to define multiple capabilities." INDEX { ippmPointOfMeasureIndex } ::= { ippmPointOfMeasureTable 1 } IppmPointOfMeasureEntry ::= SEQUENCE { - ippmPointOfMeasureIndex Integer32, + ippmPointOfMeasureIndex Unsigned32, ippmPointOfMeasureMgmtAddrType InetAddressType, ippmPointOfMeasureMgmtAddress InetAddress, - ippmPointOfMeasureTypePAddress TypeP, - ippmPointOfMeasureAddress InetAddress, + ippmPointOfMeasureTestAddrTypeP TypeP, + ippmPointOfMeasureTestAddr TypePaddress, ippmPointOfMeasureMetrics IppmStandardMetrics } ippmPointOfMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1 .. 65535) + SYNTAX Unsigned32 (1 .. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION - "A local index that identifies an entry of the points of measures + "A local index that identifies an entry in the point of measure table." ::= { ippmPointOfMeasureEntry 1 } ippmPointOfMeasureMgmtAddrType OBJECT-TYPE SYNTAX InetAddressType MAX-ACCESS read-only STATUS current DESCRIPTION "The address type associated with the management address." ::= { ippmPointOfMeasureEntry 2 } ippmPointOfMeasureMgmtAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (1..128)) MAX-ACCESS read-only STATUS current DESCRIPTION "The management address on the point of measure" ::= { ippmPointOfMeasureEntry 3 } -ippmPointOfMeasureTypePAddress OBJECT-TYPE +ippmPointOfMeasureTestAddrTypeP OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-only STATUS current DESCRIPTION - "Defines the type P address of the point of measure." - DEFVAL { "ip" } + "Defines the address type of the measurement interface of the + point of measure." ::= { ippmPointOfMeasureEntry 4 } -ippmPointOfMeasureAddress OBJECT-TYPE - SYNTAX InetAddress +ippmPointOfMeasureTestAddr OBJECT-TYPE + SYNTAX TypePaddress MAX-ACCESS read-only STATUS current DESCRIPTION - "Specifies the address of the point of measure. - - It is represented as an octet string with specific semantics and - length as identified by the ippmPointOfMeasureTypePAddress. - - For example, if the ippmPointOfMeasureTypePAddress indicates an - encapsulation of 'ip', this object length is 4, followed by the 4 - octets of the IP address, in network byte order." + "Specifies the address of the measurement interface for the point + of measure." ::= { ippmPointOfMeasureEntry 5} ippmPointOfMeasureMetrics OBJECT-TYPE SYNTAX IppmStandardMetrics MAX-ACCESS read-only STATUS current DESCRIPTION "Metrics supported by this point of measure." ::= { ippmPointOfMeasureEntry 6 } @@ -1381,36 +1374,37 @@ MAX-ACCESS not-accessible STATUS current DESCRIPTION "An entry describes the static capabilities of a metric implementation." INDEX { ippmMetricIndex } ::= { ippmMetricTable 1 } IppmMetricEntry ::= SEQUENCE { - ippmMetricIndex Integer32, + ippmMetricIndex Unsigned32, ippmMetricCapabilities INTEGER, ippmMetricType INTEGER, ippmMetricUnit INTEGER, ippmMetricDescription SnmpAdminString } ippmMetricIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "ippmMetricIndex defines an unambiguous index for each - standardized metric. It identifies a metric. Its value is the - value of the node of the metric in an IPPM registry. This value - is the same in any implementation of the IPPM REPORTING MIB. + standardized metric. It identifies a metric, and as such its + value is the value of the node of the metric in an IPPM registry. + This value is the same in any implementation of the IPPM + REPORTING MIB. Example: In the IPPM-METRICS-REGISTRY, onewayPacketLossAverage is registered as the node 14 of ippmMetricsRegistry.metrics.rfc. Consequently the index of the metric onewayPacketLossAverage in the IppmMetricTable will always be '14'" ::= { ippmMetricEntry 1 } ippmMetricCapabilities OBJECT-TYPE SYNTAX INTEGER { @@ -1418,33 +1412,31 @@ implemented(1) } MAX-ACCESS read-only STATUS current DESCRIPTION "A value of notImplemented implies the metric is not implemented. A value of implemented implies the metric is implemented either in the proxy or the point of measure itself. Example: if the aggregated metric is not implemented in the point of measure it may be implemented in the proxy." - DEFVAL { implemented } ::= { ippmMetricEntry 2 } ippmMetricType OBJECT-TYPE SYNTAX INTEGER { network(0), aggregated(1) } MAX-ACCESS read-only STATUS current DESCRIPTION "Indicates the metric type, whether it is network or aggregated" - DEFVAL { aggregated } ::= { ippmMetricEntry 3 } ippmMetricUnit OBJECT-TYPE SYNTAX INTEGER { noUnit(0), second(1), millisecond(2), microsecond(3), nanosecond(4), percentage(5), @@ -1458,42 +1450,41 @@ DESCRIPTION "The unit used in the current entity for the results of the measurement of this 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 ." + "A textual description of the metric implementation following the + exact name of this metric in the registry. For example: + oneWayDelay: OWD Metric ." ::= { 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 +"A management entity wishing to access or aggregate remote Ippm measurements in an agent must previously be registered in the - ippmOwnersTable. - ippmOwnersTable content is read-create. It contains at least the - owner 'monitor'. ææ +ippmOwnersTable. This table is read-create and contains at least the +owner 'monitor'." ::= { ippmOwners 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 @@ -1503,33 +1494,33 @@ 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 { ippmOwnersIndex } ::= { ippmOwnersTable 1 } IppmOwnersEntry ::= SEQUENCE { - ippmOwnersIndex Integer32, + ippmOwnersIndex Unsigned32, ippmOwnersOwner IppmOwnerString, ippmOwnersGrantedMetrics IppmStandardMetrics, - ippmOwnersQuota Integer32, + ippmOwnersQuota Unsigned32, ippmOwnersIpAddressType InetAddressType, ippmOwnersIpAddress InetAddress, ippmOwnersEmail SnmpAdminString, ippmOwnersSMS SnmpAdminString, ippmOwnersStatus RowStatus } ippmOwnersIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "An arbitrary index that identifies an entry in the owners table." ::= { ippmOwnersEntry 1 } ippmOwnersOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS read-create @@ -1541,49 +1532,46 @@ ippmOwnersGrantedMetrics OBJECT-TYPE SYNTAX IppmStandardMetrics MAX-ACCESS read-create STATUS current DESCRIPTION " Defines the metrics granted to an owner for which measurements can be performed." ::= { ippmOwnersEntry 3 } ippmOwnersQuota OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION -" The maximum number of records that this owner may have in the history -table and/or in the report table.ÆÆ + " The maximum number of records that this owner may have in the + history table and in the report table." ::= { ippmOwnersEntry 4 } ippmOwnersIpAddressType OBJECT-TYPE - SYNTAX InetAddressType { - ipv4(1) , - ipv6(2), - dns(16) - } + SYNTAX InetAddressType MAX-ACCESS read-create STATUS current DESCRIPTION "The IP address type of the management entity corresponding to this owner. InetAddressType is restricted to ipv4(1),ipv6(2)and dns(16). " ::= { ippmOwnersEntry 5 } ippmOwnersIpAddress OBJECT-TYPE SYNTAX InetAddress (SIZE (1..128)) MAX-ACCESS read-create STATUS current DESCRIPTION "The IP address of the management entity corresponding to this - owner." + owner. For example, the IP address of the management console used + to send SNMP requests." ::= { ippmOwnersEntry 6 } ippmOwnersEmail OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The email address of the management entity corresponding to this owner." ::= { ippmOwnersEntry 7 } @@ -1595,21 +1583,23 @@ DESCRIPTION "The SMS phone number of the management entity corresponding to this owner." ::= { ippmOwnersEntry 8 } ippmOwnersStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION - "The status of this table entry." + "The status of this table entry. Once this status is set to + active, the corresponding entry in the table may not be + modified." ::= { ippmOwnersEntry 9 } -- ippmHistory Group -- -- -- -- ippmHistoryTable -- @@ -1621,223 +1611,213 @@ "The table containing the measurement results." ::= { ippmHistory 1 } ippmHistoryEntry OBJECT-TYPE SYNTAX IppmHistoryEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "An ippmHistoryEntry entry is one of the results of a measure identified by ippmHistoryMeasureOwner, ippmHistoryMeasureIndex, - ippmHistoryMetricIndex and ippmHistoryIndex. + ippmHistoryMetricIndex and ippmHistorySequence. In the index : + ippmHistoryMeasureOwner identifies the owner of the measure; + ippmHistoryMeasureIndex identifies the measure in the owner namespace; + ippmHistoryMetricIndex identifies the metric measured by the measure. The metric is described in the corresponding entry of - the n ippmMetricTable; + the ippmMetricTable; - + ippmHistoryIndex is the local index of the result on the - history table." + + ippmHistorySeqence is the sequence number of the measurement + result for an entry in the history table." INDEX { ippmHistoryMeasureOwner, ippmHistoryMeasureIndex, - ippmHistoryMetricIndex, ippmHistoryIndex } + ippmHistoryMetricIndex, ippmHistorySequence } ::= { ippmHistoryTable 1 } IppmHistoryEntry ::= SEQUENCE { ippmHistoryMeasureOwner IppmOwnerString, - ippmHistoryMeasureIndex Integer32, - ippmHistoryMetricIndex Integer32, - ippmHistoryIndex Integer32, - ippmHistorySequence Integer32, + ippmHistoryMeasureIndex Unsigned32, + ippmHistoryMetricIndex Unsigned32, + ippmHistorySequence Unsigned32, ippmHistoryTimestamp GMTTimeStamp, ippmHistoryValue Integer32 } ippmHistoryMeasureOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION "The owner of the measure that produced this result." ::= { ippmHistoryEntry 1 } ippmHistoryMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION " The owner index of the measure that produced this result." ::= { ippmHistoryEntry 2 } ippmHistoryMetricIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION " ippmHistoryMetricIndex identifies the metric measured by the measure. The metric is described in the corresponding entry of the ippmMetricTable." ::= { ippmHistoryEntry 3 } -ippmHistoryIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) - MAX-ACCESS not-accessible - STATUS current - DESCRIPTION - " A local index that identifies a result in the history table." - ::= { ippmHistoryEntry 4 } - ippmHistorySequence OBJECT-TYPE - SYNTAX Integer32 (0.. 65535) - MAX-ACCESS read-only + SYNTAX Unsigned32 (0..4294967295) + MAX-ACCESS not-accessible STATUS current DESCRIPTION - "ippmHistorySequence is the sequence index of the measurement + "ippmHistorySequence is the sequence number of the measurement results for 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 + It's the sequence number of a measurement packet. Typically, it + identifies the order of the packet in the stream of packets sent by the source. Aggregated metrics: - It is the sequence index of the computed aggregated metric + It is the sequence number of the computed aggregated metric result." - ::= { ippmHistoryEntry 5 } + ::= { ippmHistoryEntry 4 } ippmHistoryTimestamp OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION - "The timestamp when the measurement occured." - ::= { ippmHistoryEntry 6 } + "The timestamp when the measurement occurred." + ::= { ippmHistoryEntry 5 } ippmHistoryValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The observed value of the measurement." - ::= { ippmHistoryEntry 7 } + ::= { ippmHistoryEntry 6 } -- -- 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 measures and + "An entry is a measurement that performs network measures and provides results. It performs several metric measurements per packet exchange. Each step of a measure produces a singleton result per metric. The time of the measurement and the value of the metric are saved in the ippmHistoryTable." ::= { ippmMeasure 1 } ippmNetMeasureEntry OBJECT-TYPE SYNTAX IppmNetMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION - " Typically the configuration operation sets both the values of - the new IppmNetMeasureEntry. -The IppmNetMeasureTable is mandatory. - - The IppmNetMeasureTable content is read only. It means that the - measurement software handles the table internally. The setup of - the network measure is not permitted through the IPPM REPORTING - MIB. OWAP provides a setup protocol to enable and teardown - networks measures. + " The IppmNetMeasureTable is mandatory, and its content is read + only. It means that the measurement software handles the table + internally. The setup of the network measure is not permitted + through the IPPM REPORTING MIB. As an example, OWAP provides a + setup protocol to setup and tear down networks measures. The ippmNetMeasureMetrics is set to a list of metrics to be computed from the same raw packet exchange. Each step of measurement delivers a singleton per chosen metric. Results are timestamped and saved in the ippmHistoryTable. - The ippmNetMeasureTable typical usage consists in providing - network measure indices in order to allow aggregated measures to - perform aggregation on the results of network measures.ÆÆ + One may create aggregated measures by using the results of + network measures. They may be referenced by their table index + values. " INDEX { ippmNetMeasureOwner, ippmNetMeasureIndex } ::= { ippmNetMeasureTable 1 } IppmNetMeasureEntry ::= SEQUENCE { ippmNetMeasureOwner IppmOwnerString, - ippmNetMeasureIndex Integer32, + ippmNetMeasureIndex Unsigned32, ippmNetMeasureName SnmpAdminString, ippmNetMeasureMetrics IppmStandardMetrics, ippmNetMeasureBeginTime GMTTimeStamp, ippmNetMeasureCollectionRateUnit TimeUnit, - ippmNetMeasureCollectionRate Integer32, + ippmNetMeasureCollectionRate Unsigned32, ippmNetMeasureDurationUnit TimeUnit, - ippmNetMeasureDuration Integer32, - ippmNetMeasureHistorySize Integer32, + ippmNetMeasureDuration Unsigned32, + ippmNetMeasureHistorySize Unsigned32, ippmNetMeasureFailureMgmtMode INTEGER, - ippmNetMeasureResultsMgmt Integer32, + ippmNetMeasureResultsMgmt INTEGER, ippmNetMeasureSrcTypeP TypeP, ippmNetMeasureSrc TypePaddress, ippmNetMeasureDstTypeP TypeP, ippmNetMeasureDst TypePaddress, - ippmNetMeasureTxMode Integer32, - ippmNetMeasureTxPacketRateUnit Integer32, - ippmNetMeasureTxPacketRate INTEGER, - ippmNetMeasureDevtnOrBurstSize Integer32, - ippmNetMeasureMedOrIntBurstSize Integer32, - ippmNetMeasureLossTimeout Integer32, - ippmNetMeasureL3PacketSize Integer32, + ippmNetMeasureTxMode INTEGER, + ippmNetMeasureTxPacketRateUnit TimeUnit, + ippmNetMeasureTxPacketRate Unsigned32, + ippmNetMeasureMedOrBurstSize Unsigned32, + ippmNetMeasureDevOrIntBurstSize Unsigned32, + ippmNetMeasureLossTimeout Unsigned32, + ippmNetMeasureL3PacketSize Unsigned32, ippmNetMeasureDataPattern OCTET STRING, ippmNetMeasureMap SnmpAdminString, - ippmNetMeasureSingletons INTEGER, + ippmNetMeasureTotalPktsRecv Counter64, + ippmNetMeasureLastUpdate GMTTimeStamp, ippmNetMeasureOperState INTEGER } ippmNetMeasureOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION - "The owner of the network measurement." + "The owner of the network measure." ::= { ippmNetMeasureEntry 1 } ippmNetMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The owner index of the network measure. " ::= { ippmNetMeasureEntry 2 } ippmNetMeasureName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION - "The name of the metric instance. It illustrates the specificity - of the metric and includes the metric and the TypeP. + "The name of the metric instance(s)as defined in + ippmNetMeasureMetrics. It illustrates the specificity of the + metric(s) and includes the metric(s) and the TypeP. Example: + IP-TCP-HTTP-One-way-Delay: free text " ::= { ippmNetMeasureEntry 3 } ippmNetMeasureMetrics OBJECT-TYPE SYNTAX IppmStandardMetrics MAX-ACCESS read-only STATUS current DESCRIPTION "Defines the metrics to compute within this measure. ONLY network metrics of the same type are allowed in this field. @@ -1848,173 +1828,149 @@ in the ippmMetricIndex definition. Example: A measure asking for One-way-Delay(6) and One-way-Packet-Loss(12) generated a flow of singletons which are logged in the ippmHistoryTable. The singletons created for the One-way-Delay measure have a value of ippmMetricIndex of 6 while the created singletons for the 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ÆÆ } ::= { ippmNetMeasureEntry 4 } ippmNetMeasureBeginTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the time at which the measurement begins." ::= { ippmNetMeasureEntry 5 } ippmNetMeasureCollectionRateUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the unit of the measurement period." - DEFVAL { second } ::= { ippmNetMeasureEntry 6 } ippmNetMeasureCollectionRate OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Gives the period used to collect singletons from the point of - measures. - This value is used as the cycle period in the report." - DEFVAL { 60 } + measures. This value is used as the cycle period in the report." ::= { ippmNetMeasureEntry 7 } ippmNetMeasureDurationUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the measurement duration unit." - DEFVAL { second } ::= { ippmNetMeasureEntry 8 } ippmNetMeasureDuration OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the measurement duration." - DEFVAL { 120 } ::= { ippmNetMeasureEntry 9 } ippmNetMeasureHistorySize OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the maximum number of results saved for each metric of this measure. Overflow condition will be managed by the object ippmNetMeasureResultsMgmt. " ::= { ippmNetMeasureEntry 10 } ippmNetMeasureFailureMgmtMode OBJECT-TYPE SYNTAX INTEGER { auto(1), manual(2), discarded(3) } MAX-ACCESS read-only STATUS current DESCRIPTION - "This object defines whether this row and the measure controlled - 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. + "This object defines whether this row (and the measure controlled + by this row) is restarted automatically, manually, or discarded + upon failure, or reboot of the measurement system. 'auto' - continue the measurement and erase the older entries in the - history. + The measure is restarted automatically. 'manual' - continue the measurement and erase the older entries in the - history. + The measure has to be restarted manually. 'discarded' - continue the measurement and erase the older entries in the - history. - - Possible values are: other(1), volatile(2), nonVolatile(3), - permanent(4) + The measure and it results are discarded. - Network: " - DEFVAL { auto } + " ::= { ippmNetMeasureEntry 11 } ippmNetMeasureResultsMgmt OBJECT-TYPE SYNTAX INTEGER { wrap(1), - suspend(2), - delete(3) + suspend(2) } MAX-ACCESS read-only STATUS current DESCRIPTION " - Action to take when the 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 thelog, and assumes the - data has been cleared. + Action to take when the log is full. The measurement system owner + 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 log, and assumes + the data has been cleared. This object indicates the way the measurement results are managed when the owner quota has been exceeded: 'wrap' continue the measurement and erase the older entries in the history. 'suspend' stop the measure and keep the results in the history. - 'delete' - remove the results from the history. " ::= { ippmNetMeasureEntry 12 } ippmNetMeasureSrcTypeP OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-only STATUS current DESCRIPTION "Defines the type P of the source address of the packets sent by the measure." - DEFVAL { "ip" } ::= { ippmNetMeasureEntry 13 } ippmNetMeasureSrc OBJECT-TYPE SYNTAX TypePaddress MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the address of the source of the measure. It is represented as a list of parameters corresponding to those - of the PROTOCOL IDENTIFIER sets in ippmNetMeasureSrcTypeP." + of the PROTOCOL IDENTIFIER set in ippmNetMeasureSrcTypeP." ::= { ippmNetMeasureEntry 14} ippmNetMeasureDstTypeP OBJECT-TYPE SYNTAX TypeP MAX-ACCESS read-only STATUS current DESCRIPTION "Defines the type P of the destination address of the packets sent by the measure." - DEFVAL { "ip" } ::= { ippmNetMeasureEntry 15 } ippmNetMeasureDst OBJECT-TYPE SYNTAX TypePaddress MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the address of the destination of the measure. It is represented as a list of parameters corresponding to those of the PROTOCOL IDENTIFIER set in ippmNetMeasureDstTypeP." @@ -2031,217 +1987,245 @@ STATUS current DESCRIPTION "The transmit mode used to send the packets: 'other' The rule used to send the packets is unknown. 'periodic' Packets are sent periodically at ippmNetMeasureTxPacketRate rate. 'poisson' Packets are sent using a Poisson law, the median is the value - of ippmNetMeasureMedOrIntBurstSize, the deviation is - ippmNetMeasureDevtnOrBurstSize. + of ippmNetMeasureDevOrIntBurstSize, the deviation is + ippmNetMeasureMedOrBurstSize. 'multiburst' Packets are sent bursty at ippmNetMeasureTxPacketRate. The - size of the burst is made of ippmNetMeasureDevtnOrBurstSize + size of the burst is made of ippmNetMeasureMedOrBurstSize packets. Between 2 consecutive bursts, transmission stops during the time - needed to send ippmNetMeasureInterBurstPacketsNb. + needed to send ippmNetMeasureDevOrIntBurstSize. " ::= { ippmNetMeasureEntry 17 } ippmNetMeasureTxPacketRateUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-only STATUS current DESCRIPTION "The packet rate unit used to send the packets." ::= { ippmNetMeasureEntry 18 } ippmNetMeasureTxPacketRate OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 + UNITS "Packets" MAX-ACCESS read-only STATUS current DESCRIPTION "The rate the packets are sent." ::= { ippmNetMeasureEntry 19 } -ippmNetMeasureDevtnOrBurstSize OBJECT-TYPE - SYNTAX Integer32 +ippmNetMeasureMedOrBurstSize OBJECT-TYPE + SYNTAX Unsigned32 + UNITS "Packets" MAX-ACCESS read-only STATUS current DESCRIPTION - "Indicates the average number of packets per seconds sent using a - poisson law. + " + Multi-burst mode: This field represents the burst size in number + of packets. + Poisson mode: This field indicates the number of packets sent, on + average, during each period corresponding to the median. + The median is therefore + MedOrBurstSize*TxPacketRateUnit/TxPacketRate. - ippmNetMeasurePoissonRate can not be used conjointly with - ippmNetMeasureClockPattern." - DEFVAL { 30 } + Example: + If TxPacketRateUnit/TxPacketRate is 100 packets/second, and if + MedOrBurstSize, the number of packets sent during the period + corresponding to the median is 50 packets, then the median equals + 50*1/100 = 1/2 seconds. + " ::= { ippmNetMeasureEntry 20 } -ippmNetMeasureMedOrIntBurstSize OBJECT-TYPE - SYNTAX Integer32 +ippmNetMeasureDevOrIntBurstSize OBJECT-TYPE + SYNTAX Unsigned32 + UNITS "Packets" MAX-ACCESS read-only STATUS current DESCRIPTION - "According to the transmit mode, this value indicates the average - number of packets per seconds sent using a poisson law, or the - number of packets to wait between consecutive bursts." - DEFVAL { 30 } + " + Multi-burst mode: This field indicates the gap between 2 + bursts, in number of packets. + Example: + If TxPacketRateUnit/TxPacketRate is 100 packets/second, + and DevOrIntBurstSize equals 50 packets, then the gap + between 2 bursts is + equal to 50*1/100, or 1/2 second. + + Poisson mode: + + This field indicates the typical difference between the packets + of the period corresponding to the median. + + " ::= { ippmNetMeasureEntry 21 } ippmNetMeasureLossTimeout OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 + UNITS "Milliseconds" MAX-ACCESS read-only STATUS current - -- UNITS "Milliseconds" DESCRIPTION - "Specifies the delay after which the packet is considered lost by the - sink." - DEFVAL { 10 } + "Specifies the delay after which the packet is considered lost + by the sink." ::= { ippmNetMeasureEntry 22 } ippmNetMeasureL3PacketSize OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 + UNITS "Bytes" MAX-ACCESS read-only STATUS current DESCRIPTION "Specifies the size of the packets counted at the IP network layer in regards to the TypeP definition. - Example: For a TypeP 'ip ipip4' the L3 size will be the size of the packet at ipip4 level. " - DEFVAL { 64 } ::= { ippmNetMeasureEntry 23 } ippmNetMeasureDataPattern OBJECT-TYPE SYNTAX OCTET STRING MAX-ACCESS read-only STATUS current DESCRIPTION "The pattern used to fill the payload of the packet." - DEFVAL { 'FF'H } + ::= { ippmNetMeasureEntry 24 } ippmNetMeasureMap OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION -"A administrative name of a network management map to which the measure -belongs." - DEFVAL { "" } - + "An administrative name of a network management map to which the + measure belongs." ::= { ippmNetMeasureEntry 25 } -ippmNetMeasureSingletons OBJECT-TYPE - SYNTAX Integer32 +ippmNetMeasureTotalPktsRecv OBJECT-TYPE + SYNTAX Counter64 + UNITS "Packets" MAX-ACCESS read-only STATUS current DESCRIPTION - "Reports the number of singletons performed per metric by the - measure since the beginning of the measure. This parameters is - required for aggregation." + "Reports the current number of packets received since the + beginning of the measure. + This parameters is useful to monitor the measure and it is needed +to compute statistics." ::= { ippmNetMeasureEntry 26 } +ippmNetMeasureLastUpdate OBJECT-TYPE +SYNTAX GMTTimeStamp + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The time when the last aggregation was computed." + ::= { ippmNetMeasureEntry 27 } + ippmNetMeasureOperState OBJECT-TYPE SYNTAX INTEGER { unknown(0), running(1), stopped(2) } MAX-ACCESS read-only STATUS current DESCRIPTION - "Reports the operational status of the network measure.ÆÆ - ::= { ippmNetMeasureEntry 27 } + "Reports the operational status of the network measure." + ::= { ippmNetMeasureEntry 28 } -- -- -- ippmAggrMeasureTable -- -- ippmAggrMeasureTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmAggrMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION " An aggregated measure summarizes the results of previous - network or aggregated measures. The results may be saved in the + network or aggregated measures. The results are saved in the ippmHistoryTable. Each step of the calculation for the measure produces a singleton result per metric." ::= { ippmMeasure 2 } ippmAggrMeasureEntry OBJECT-TYPE SYNTAX IppmAggrMeasureEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION - "Typically the configuration operation sets the value of + "Typically, the configuration operation sets the value of theIppmAggrMeasureEntry. - ippmAggrMeasureTable is mandatory. - The ippmAggrMeasureMetrics defines the metric to compute. The results of the measure to summarize are identified by: - + ippmAggrMeasureHistoryOwner, - + ippmAggrMeasureHistoryOwnerIndex and - + ippmAggrMeasureHistoryMetric + + ippmAggrMeasureOwner, + + ippmAggrMeasureIndex - The aggregated task starts at ippmMeasureBeginTime and ends after - ippmMeasureDuration. An aggregated result is performed and saved - in the ippmHistoryTable for each ippmMeasureCollectionRate tick. - " + The aggregated task starts at ippmAggrMeasureBeginTime and ends + after ippmAggrMeasureDuration. An aggregated result is performed + and saved in the ippmHistoryTable for each + ippmMeasureCollectionRate tick. " INDEX { ippmAggrMeasureOwner, ippmAggrMeasureIndex } ::= { ippmAggrMeasureTable 1 } IppmAggrMeasureEntry ::= SEQUENCE { ippmAggrMeasureOwner IppmOwnerString, - ippmAggrMeasureIndex Integer32, + ippmAggrMeasureIndex Unsigned32, ippmAggrMeasureName SnmpAdminString, ippmAggrMeasureMetrics IppmStandardMetrics, ippmAggrMeasureBeginTime GMTTimeStamp, ippmAggrMeasureAggrPeriodUnit TimeUnit, - ippmAggrMeasureAggrPeriod Integer32, + ippmAggrMeasureAggrPeriod Unsigned32, ippmAggrMeasureDurationUnit TimeUnit, - ippmAggrMeasureDuration Integer32, - ippmAggrMeasureHistorySize Integer32, + ippmAggrMeasureDuration Unsigned32, + ippmAggrMeasureHistorySize Unsigned32, ippmAggrMeasureStorageType StorageType, ippmAggrMeasureHistoryOwner IppmOwnerString, - ippmAggrMeasureHistoryOwnerIndex Integer32, - ippmAggrMeasureHistoryMetric Integer32, - ippmAggrMeasureAdminState Integer32, + ippmAggrMeasureHistoryOwnerIndex Unsigned32, + ippmAggrMeasureHistoryMetric Unsigned32, + ippmAggrMeasureAdminState INTEGER, ippmAggrMeasureFastReport OBJECT IDENTIFIER, ippmAggrMeasureMap SnmpAdminString, - ippmAggrMeasureResultsMgmt Integer32, + ippmAggrMeasureResultsMgmt INTEGER, + ippmAggrMeasureLastUpdate GMTTimeStamp, + ippmAggrMeasureOperState INTEGER, + ippmAggrMeasureNbPktsTreated Counter64, ippmAggrMeasureStatus RowStatus } ippmAggrMeasureOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS not-accessible STATUS current DESCRIPTION "The owner who has configured this entry." ::= { ippmAggrMeasureEntry 1 } ippmAggrMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION - "The owner index of the measure. The value is managed by the + "The index of the aggregated measure. The value is managed by the owner." ::= { ippmAggrMeasureEntry 2 } ippmAggrMeasureName OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "The name of the instance of the metric. It illustrates the specificity of the metric and includes the metric and the typeP. @@ -2258,26 +2242,26 @@ ONLY aggregated metrics of the same type are allowed in this field. A measure may be configured for the result of different metric singletons to be archived in the ippmHistoryTable. The ippmMetricIndex of the created result has the value of the bit index of the corresponding ippmAggrMeasureMetrics as explained above in the ippmMetricIndex definition. Example: - A measure asking for One-way-Delay(6) and One-way-Packet-Loss(12) - generated a flow of singletons which are logged in the + A network measure asking for One-way-Delay(6) and One-way-Packet- + Loss(12) generated a flow of singletons which are logged in the ippmHistoryTable. The singletons created for the One-way-Delay - measure have a value of ippmMetricIndex of 6 while the created - singletons for the One-way-Packet-Loss measure have a value of - ippmMetricIndex of 12. + measure have a value of ippmMetricIndex of 6.The aggregated + measure definition(s) might be One-Way-Delay-Percentile(8),One- + way-Delay-Median(9), or One-way-Delay-Minimum(10 . " ::= { ippmAggrMeasureEntry 4 } ippmAggrMeasureBeginTime OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the time at which the aggregated measure starts." ::= { ippmAggrMeasureEntry 5 } @@ -2285,76 +2269,78 @@ ippmAggrMeasureAggrPeriodUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the unit of the aggregated measure period." DEFVAL { second } ::= { ippmAggrMeasureEntry 6 } ippmAggrMeasureAggrPeriod OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the amount of time between 2 measurement action intervals. The action is specific to the semantic of the measure. Network metrics: The ippmNetMeasureClockPattern transforms the flow of periodical instants as a flow of unpredictable instants of measurement packet emission. As the source and the sink share the definition of the clock of - the measure, as the sending 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. + the measure, and as the sending timestamp is part of the + measurement packet, the sink has 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 metric computed corresponds to the value of the ippmHistoryTimestamp of the last - metric result of the sequence used in to compute the aggregated + metric result of the sequence used to compute the aggregated metric." DEFVAL { 60 } ::= { ippmAggrMeasureEntry 7 } ippmAggrMeasureDurationUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the unit of the measure duration." DEFVAL { second } ::= { ippmAggrMeasureEntry 8 } ippmAggrMeasureDuration OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the duration of the measure." DEFVAL { 120 } ::= { ippmAggrMeasureEntry 9 } ippmAggrMeasureHistorySize OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the maximum number of results saved for each metric of this measure. Overflow condition will be managed by the object ippmAggrMeasureResultsMgmt. " + DEFVAL { 2 } ::= { ippmAggrMeasureEntry 10 } ippmAggrMeasureStorageType OBJECT-TYPE SYNTAX StorageType MAX-ACCESS read-create STATUS current DESCRIPTION "This object defines whether this row and the measure controlled by this row are kept in volatile storage and lost upon reboot or if this row is backed up @@ -2385,29 +2371,29 @@ ippmAggrMeasureHistoryOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The owner of the measure to summarize. " ::= { ippmAggrMeasureEntry 13 } ippmAggrMeasureHistoryOwnerIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The owner index of the measure to summarize. " ::= { ippmAggrMeasureEntry 14 } ippmAggrMeasureHistoryMetric OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The metric of the measure to summarize. " ::= { ippmAggrMeasureEntry 15 } ippmAggrMeasureAdminState OBJECT-TYPE SYNTAX INTEGER { start(0), stop(1) @@ -2411,23 +2397,25 @@ SYNTAX INTEGER { start(0), stop(1) } MAX-ACCESS read-create STATUS current DESCRIPTION "This object controls the activity of the aggregated measure. 'start' The aggregated measure is started. + 'stop' - The aggregated measure is stopped. - " + The aggregated measure is stopped." + DEFVAL { start } + ::= { ippmAggrMeasureEntry 16 } ippmAggrMeasureFastReport OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "A fast report is required in order to verify quickly that a measure is running well. The feature 'fast report' is active if IppmAggrMeasureFastReport @@ -2440,78 +2428,108 @@ ippmAggrMeasureFastReport identifies the notification which defines the header of the report. The results part of the report is made of the a column of results per metrics. Results are separated using commas. To avoid disaster, an aggregated measure using a fast report must have a cycle of aggregation 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 } + DEFVAL { zeroDotZero } ::= { ippmAggrMeasureEntry 17 } ippmAggrMeasureMap OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "This object allows for classification of the measure. It is typically the name of an administrative map. " DEFVAL { "" } ::= { ippmAggrMeasureEntry 18 } +ippmAggrMeasureLastUpdate OBJECT-TYPE +SYNTAX GMTTimeStamp + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "The time when the last aggregated measure was computed." + ::= { ippmAggrMeasureEntry 19 } + +ippmAggrMeasureOperState OBJECT-TYPE + SYNTAX INTEGER { + unknown(0), + running(1), + stopped(2) + } + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Reports the operational status of the aggregated measure." + ::= { ippmAggrMeasureEntry 20 } + +ippmAggrMeasureNbPktsTreated OBJECT-TYPE + SYNTAX Counter64 + UNITS "Packets" + MAX-ACCESS read-only + STATUS current + DESCRIPTION + "Reports the current number of packets used to calculate the + aggregation since the start of the measure. + This parameters is useful to monitor the measure and it is needed + to compute statistics." + ::= { ippmAggrMeasureEntry 21 } + ippmAggrMeasureStatus OBJECT-TYPE SYNTAX RowStatus MAX-ACCESS read-create STATUS current DESCRIPTION "The status of this table entry. Once the entry status is set to active, the associate entry cannot be modified. - - The creation of an aggregated measure forced the creation of the - corresponding entry in ippmMeasureTable." - ::= { ippmAggrMeasureEntry 19 } + " + ::= { ippmAggrMeasureEntry 22 } -- -- ippmReport Group -- ippmReportPathToResults OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-only STATUS current DESCRIPTION - " It is typically an URL describing the file location where the + " It is typically a URL describing the file location where the results are logged. " ::= { ippmReport 1 } -- -- -- ippmReportSetupTable -- -- ippmReportSetupTable OBJECT-TYPE SYNTAX SEQUENCE OF IppmReportSetupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The ippmReportSetupTable is a list of definition of reports. It - defines the results of network or aggregated measures that are to - be reported. A report is saved in 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. + defines the results of network and/or aggregated measures that + are to be reported. A report is saved in the ippmReportTable, or + sent to an application using an SNMP Trap, an 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. " ::= { ippmReport 2 } ippmReportSetupEntry OBJECT-TYPE SYNTAX IppmReportSetupEntry MAX-ACCESS not-accessible STATUS current DESCRIPTION "The report applies to the results of a measure as defined in @@ -2519,198 +2537,201 @@ table. The ippmReportSetupDefinition describes the data and the events to include in the report. The definition consists of a list of tasks to perform on the results of the measure. A report is associated to a network measure or to an aggregated measure. Note 1: To associate a report to an existing measure the manager - suspends the measure by setting either the ippmNetMeasureStatus - or the ippmAggrMeasureStatus to 'notInService'. Then one sets the - report fields and activates the measure by setting the - corresponding MeasureStatus to 'active'. + suspends the measure by setting either the + ippmAggrMeasureAdminStatus or the ippmAggrMeasureStatus to + 'notInService'. Then one sets the report fields and activates the + measure by setting the corresponding MeasureStatus to 'active'. - Note 2: A report is tied to a measure. The period of the measure" + Note 2: A report is tied to a measure and its period." INDEX { ippmReportSetupOwner, ippmReportSetupIndex } ::= { ippmReportSetupTable 1 } IppmReportSetupEntry ::= SEQUENCE { ippmReportSetupOwner IppmOwnerString, - ippmReportSetupIndex Integer32, + ippmReportSetupIndex Unsigned32, ippmReportSetupMeasureOwner IppmOwnerString, - ippmReportSetupMeasureIndex Integer32, - ippmReportSetupMeasureMetric Integer32, + ippmReportSetupMeasureIndex Unsigned32, + ippmReportSetupMeasureMetric Unsigned32, ippmReportSetupDefinition IppmReportDefinition, - ippmReportSetupUpDownThreshold Integer32, - ippmReportSetupLowThreshold Integer32, - ippmReportSetupHighThreshold Integer32, + ippmReportSetupUpDownThreshold Unsigned32, + ippmReportSetupLowThreshold Unsigned32, + ippmReportSetupHighThreshold Unsigned32, ippmReportSetupDurationThresUnit TimeUnit, - ippmReportSetupDurationThreshold Integer32, - ippmReportSetupReportSize Integer32, - ippmReportSetupResultsMgmt Integer32, - ippmReportSetupNMS SnmpAdminString, + ippmReportSetupDurationThreshold Unsigned32, + ippmReportSetupReportSize Unsigned32, + ippmReportSetupResultsMgmt INTEGER, + ippmReportSetupNMS IppmOwnerString, 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." ::= { ippmReportSetupEntry 1 } ippmReportSetupIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS not-accessible STATUS current DESCRIPTION "The owner index of the report entry. The value is managed by the owner." ::= { ippmReportSetupEntry 2 } ippmReportSetupMeasureOwner OBJECT-TYPE SYNTAX IppmOwnerString MAX-ACCESS read-create STATUS current DESCRIPTION "The owner of the measure to report." ::= { ippmReportSetupEntry 3 } ippmReportSetupMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The index of the measure to report." ::= { ippmReportSetupEntry 4 } ippmReportSetupMeasureMetric OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) + SYNTAX Unsigned32 (1.. 65535) MAX-ACCESS read-create STATUS current DESCRIPTION "The metric of the measure to report." ::= { ippmReportSetupEntry 5 } ippmReportSetupDefinition OBJECT-TYPE SYNTAX IppmReportDefinition MAX-ACCESS read-create STATUS current DESCRIPTION "In order to properly define a report, one must provide information to: - + Select the events to consider for reporting; - + Configure filters to select pertinent values; - + Describe the way the report is delivered; - + Describe clean up actions to perform on report completion; + + Select the events to consider for reporting + + Configure filters to select pertinent values + + Describe the way the report is delivered + + Describe clean up actions to perform on report completion + The format of a report sent to a NMS is described in a notification defined in the ippmNotifications node. The event and the filter selected in the report definition - determines the notification to refer: + determine the notification: + Up and Down filter report format is ippmUpAndDownReport; + Inband 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 and reportExceededEventsDuration report format is ippmEventsDurationExceededReport; + Any filter and the event onMeasureCompletion report format is ippmCompletedMeasureReport; Example 1: - Consider a report definition, which reports on the fly, up and - down result events of a metric measure: + Consider a report definition, which reports up and down result + events of a metric measure: ippmReportSetupDefinition { onSingleton, reportUpAndDownMetricResults, inSNMPv2TrapPDU } - The value of the threshold is given by ippmReportSetupUpDownThreshold. It has the value '5' in this example. Being a flow of 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 2 traps: - + The first one carries the results 3.2 and 5.1 - corresponding to a down to up event; - + The second one carries the results 5.2 and 4.0 of the - up to down event - UpAndDown + + The first one carries the result 5.1 corresponding to + a down to up event; + + The second one carries the result 4.0 of the up to + down event Example 2: Consider the report definition, which reports per measure cycle in a SNMP informRequestPDU, up and down results events of a metric measure: : ippmReportSetupDefinition { onMeasureCycle, reportUpAndDownMetricResults, - inInformRequestPDU, - onReportDeliveryClearReport + inInformRequestPDU } + The value of the threshold is given by ippmReportSetupUpDownThreshold. It has the value '5' in this example. The cycle of measure of the measure setup is set to 10 results. Being a 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. - " + carries 5.1 and 4.0 corresponding to the first down to up event + and to the second up to down event, respectively. " ::= { ippmReportSetupEntry 6 } ippmReportSetupUpDownThreshold OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when the result of the measure exceeds the - value of ippmReportSetupMetricThreshold. + value of ippmReportSetupMetricThreshold, and then goes below the + threshold or vice versa. In the case of being over the threshold, + and then being below it, the measure value that is immediately + below the threshold, after previously being above it, is + reported. In the case of being below the threshold and then being + above it, the measure value that is above the threshold is + reported. + The threshold has the same unit as the metric. The metric unit is recorded in the object ippmMetricsUnit of this metric entry in the ippmMetricTable. " ::= { ippmReportSetupEntry 7 } ippmReportSetupLowThreshold OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when the result of the measure of the metric is lower that the value of ippmReportSetupLowThreshold. The threshold has the same unit as the metric. The metric unit is recorded in the object ippmMetricsUnit of this metric entry in the ippmMetricTable. " ::= { ippmReportSetupEntry 8 } ippmReportSetupHighThreshold OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when the result of the measure of the metric exceeds the value of ippmReportSetupHighThreshold. - The threshold has the same unit as the metric. The metric unit is recorded in the object ippmMetricsUnit of this metric entry in the ippmMetricTable. " ::= { ippmReportSetupEntry 9 } ippmReportSetupDurationThresUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current @@ -2709,103 +2730,103 @@ the ippmMetricTable. " ::= { ippmReportSetupEntry 9 } ippmReportSetupDurationThresUnit OBJECT-TYPE SYNTAX TimeUnit MAX-ACCESS read-create STATUS current DESCRIPTION "The unit of the duration threshold." + DEFVAL { second } ::= { ippmReportSetupEntry 10 } ippmReportSetupDurationThreshold OBJECT-TYPE -SYNTAX Integer32 +SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "An event is generated when contiguous results of the measure are over the ippmReportSetupUpDownThreshold, during ippmReportSetupDurationThreshold seconds. Performance: To improve the performance of the system, the report process may - be synchronized with the cycle of collection of network measure - or with the period of aggregation of an aggregate measure." + be synchronized with the cycle of collection of network measures, + or with the period of aggregation of an aggregated measure." DEFVAL { 15 } ::= { ippmReportSetupEntry 11 } ippmReportSetupReportSize OBJECT-TYPE - SYNTAX Integer32 + SYNTAX Unsigned32 MAX-ACCESS read-create STATUS current DESCRIPTION "Specifies the maximum number of results saved for each metric of this measure. The history of each metric is managed as a circular table. The newest result overwrites the oldest one when the history granted to this metric measure is full. The management of the results may be optimized if synchronized with the reports steps of this measure. " ::= { ippmReportSetupEntry 12 } ippmReportSetupResultsMgmt OBJECT-TYPE SYNTAX INTEGER { wrap(1), - suspend(2), - delete(3) + suspend(2) } MAX-ACCESS read-create 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 This object indicates the way the measure results are managed when the owner quota is over: 'wrap' continue the measure and erase the older entries in the history. 'suspend' - stop the measure and keep the results in the history. - 'delete' - remove the results from the history. - " + stop the measure and keep the results in the history" + DEFVAL { wrap } + ::= { ippmReportSetupEntry 13 } ippmReportSetupNMS OBJECT-TYPE - SYNTAX SnmpAdminString + SYNTAX IppmOwnerString 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. " + DEFVAL { "" } ::= { ippmReportSetupEntry 14 } ippmReportSetupNotification OBJECT-TYPE SYNTAX OBJECT IDENTIFIER MAX-ACCESS read-create STATUS current DESCRIPTION "Even though the notification to use is defined in the report definition, the object ippmReportSetupNotification provides flexibility to select another notification. " - -- DEFVAL { 0.0 } + DEFVAL { zeroDotZero } ::= { ippmReportSetupEntry 15 } ippmReportSetupMap OBJECT-TYPE SYNTAX SnmpAdminString MAX-ACCESS read-create STATUS current DESCRIPTION "An administrative name of a map to which the report belongs." DEFVAL { "" } ::= { ippmReportSetupEntry 16 } @@ -2845,313 +2866,278 @@ 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 by ippmReportMeasureOwner, ippmReportMeasureIndex, ippmReportMetricIndex and ippmReportIndex. In the index: - + ippmReportMeasureOwner identifies the owner of the measure; + + ippmReportSetupOwner identifies the owner of the measure - + ippmReportMeasureIndex identifies the measure in the owner + + ippmReportSetupIndex identifies the measure in the owner namespace; - + ippmReportMetricIndex identifies the metric measured in - ippmMetricTable; - - + ippmReportIndex is the local index of the result on the report - table." + + ippmReportSequence identifies the sequence number of the + measure result" - INDEX { ippmReportMeasureOwner, ippmReportMeasureIndex, - ippmReportMetricIndex, ippmReportIndex } + INDEX { ippmReportSetupOwner, ippmReportSetupIndex, + ippmReportSequence } ::= { ippmReportTable 1 } IppmReportEntry ::= SEQUENCE { - ippmReportMeasureOwner IppmOwnerString, - ippmReportMeasureIndex Integer32, - ippmReportMetricIndex Integer32, - ippmReportIndex Integer32, - ippmReportSequence Integer32, + ippmReportSequence Unsigned32, ippmReportTimestamp GMTTimeStamp, ippmReportValue Integer32 } -ippmReportMeasureOwner OBJECT-TYPE - SYNTAX IppmOwnerString - MAX-ACCESS not-accessible - STATUS current - DESCRIPTION - "The owner of the measure that produced this result." - ::= { ippmReportEntry 1 } - -ippmReportMeasureIndex OBJECT-TYPE - SYNTAX Integer32 (1.. 65535) - MAX-ACCESS not-accessible - STATUS current - DESCRIPTION - " The owner index of the measure that 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 + SYNTAX Unsigned32 (0..4294967295) + MAX-ACCESS not-accessible STATUS current DESCRIPTION - " ippmReportSequence is the sequence index of the measurement - results of the measure of a metric. + "ippmReportSequence is the sequence number of the measurement + results to report. Network metrics: - It's the sequence index of a measurement packet. Typically, it + It's the sequence number 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 + It is the sequence number of the aggregated metric results computed." - ::= { ippmReportEntry 5 } + ::= { ippmReportEntry 1 } ippmReportTimestamp OBJECT-TYPE SYNTAX GMTTimeStamp MAX-ACCESS read-only STATUS current DESCRIPTION - "The instant of the measure of the result." - ::= { ippmReportEntry 6 } + "The timestamp of the measurement result." + ::= { ippmReportEntry 2 } ippmReportValue OBJECT-TYPE SYNTAX Integer32 MAX-ACCESS read-only STATUS current DESCRIPTION "The value." - ::= { ippmReportEntry 7 } + ::= { ippmReportEntry 3 } -- -- IPPM Notifications -- ippmUpAndDownReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupUpDownThreshold, ippmMetricType, ippmMetricUnit, ippmMetricDescription, 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 the ippmHistoryValue - object that exceeded the threshold. + object that exceeded the threshold in the case of a down to up + change. In the case of a up to down change, the ippmHistoryValue + object that is below the threshold immediately after being over + the threshold. The notification contains the instances of the ippmHistoryTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event." + contains detailed results corresponding to this event." ::= { ippmNotifications 1 } ippmInBandReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupLowThreshold, + ippmReportSetupHighThreshold, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, - ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sent because the value of the measure is under the high threshold value and greater than the low threshold value. The notification contains the instances of the ippmHistoryValue object that exceeded the threshold. The notification contains the instances of the ippmHistoryTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event." + contains detailed results corresponding to this event." ::= { ippmNotifications 2 } ippmOutBandReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupLowThreshold, + ippmReportSetupHighThreshold, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, - ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION "A notification sent 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 the ippmHistoryValue object that exceeded the threshold. The notification contains the instances of the ippmHistoryTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event." + contains detailed results corresponding to this event." ::= { ippmNotifications 3 } ippmAboveReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupHighThreshold, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, - ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION " The notification contains the instances of the ippmHistoryValue object that exceeded the threshold. - The notification contains the instances of the ippmHistoryTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event." + contains detailed results corresponding to this event." ::= { ippmNotifications 4 } ippmBelowReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupLowThreshold, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, - ippmHistorySequence, ippmHistoryValue, ippmReportPathToResults } STATUS current DESCRIPTION " The notification contains the instances of the ippmHistoryValue - object that exceeded the threshold. + object that were below the threshold. The notification contains the instances of the ippmHistoryTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event." + contains detailed results corresponding to this event." ::= { ippmNotifications 5 } ippmEventsDurationExceededReport NOTIFICATION-TYPE OBJECTS { ippmReportSetupDefinition, + ippmReportSetupUpDownThreshold, + ippmReportSetupDurationThreshold, + ippmReportSetupDurationThresUnit, ippmMetricType, ippmMetricUnit, ippmMetricDescription, ippmHistoryTimestamp, - ippmHistorySequence, - ippmHistoryValue + ippmHistoryValue, + ippmReportPathToResults + } STATUS current DESCRIPTION "A notification sent when the duration of continuously rising metric threshold exceeds the ippmReportSetupDurationThreshold value. The notification contains the instances of the ippmReportValue object that exceeded the threshold. The notification contains the instances of the ippmReportTimestamp identifying the time the event occurred. ippmReportPathToResults is a link to the file name, which - contains detailled results corresponding to this event. + contains detailed 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, + ippmAggrMeasureHistorySize, 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 agent will then manage the reports according to the policy described in ippmAggrMeasureResultsMgmt." ::= { ippmNotifications 8 } ippmNetMeasureHistoryFull NOTIFICATION-TYPE OBJECTS { ippmNetMeasureName, + ippmNetMeasureHistorySize, 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 @@ -3149,31 +3135,30 @@ 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, + ippmReportSetupReportSize, ippmReportTimestamp, - ippmReportSequence, ippmReportValue } STATUS current DESCRIPTION "A notification sent when the size of the report of a metric of a - measure exceeded ippmReportSetupReportSize. Then the agent - manages the reports according to the policy described in + measure exceeded ippmReportSetupReportSize. The agent manages the + reports according to the policy described in ippmReportSetupResultsMgmt." ::= { ippmNotifications 10 } -- -- IPPM MIB Conformance statements -- ippmCompliances OBJECT IDENTIFIER ::={ ippmConformance 1 } ippmGroups OBJECT IDENTIFIER ::={ ippmConformance 2 } @@ -3221,22 +3206,22 @@ OBJECTS { ippmSystemSynchronizationDesc, ippmSystemTime, ippmSystemSynchronizationType, ippmSystemClockResolution, ippmSynchronizationTime, ippmSynchronizationStratum, ippmSynchronizationResolution, ippmPointOfMeasureMgmtAddrType, ippmPointOfMeasureMgmtAddress, - ippmPointOfMeasureTypePAddress, - ippmPointOfMeasureAddress, + ippmPointOfMeasureTestAddrTypeP, + ippmPointOfMeasureTestAddr, ippmSystemOperationalStatus, ippmPointOfMeasureMetrics, ippmMetricCapabilities, ippmMetricType, ippmMetricUnit, ippmMetricDescription } STATUS current DESCRIPTION "The IPPM System Group" @@ -3254,37 +3239,37 @@ ippmNetMeasureHistorySize, ippmNetMeasureFailureMgmtMode, ippmNetMeasureResultsMgmt, ippmNetMeasureSrcTypeP, ippmNetMeasureSrc, ippmNetMeasureDstTypeP, ippmNetMeasureDst, ippmNetMeasureTxMode, ippmNetMeasureTxPacketRateUnit, ippmNetMeasureTxPacketRate, - ippmNetMeasureDevtnOrBurstSize, - ippmNetMeasureMedOrIntBurstSize, + ippmNetMeasureMedOrBurstSize, + ippmNetMeasureDevOrIntBurstSize, ippmNetMeasureLossTimeout, ippmNetMeasureL3PacketSize, ippmNetMeasureDataPattern, ippmNetMeasureMap, - ippmNetMeasureSingletons, + ippmNetMeasureTotalPktsRecv, + ippmNetMeasureLastUpdate, ippmNetMeasureOperState } STATUS current DESCRIPTION "The IPPM Network Measure Group" ::= { ippmGroups 3} ippmHistoryGroup OBJECT-GROUP OBJECTS { - ippmHistorySequence, ippmHistoryTimestamp, ippmHistoryValue } STATUS current DESCRIPTION "The IPPM History Group" ::= { ippmGroups 4} ippmAggrMeasureGroup OBJECT-GROUP OBJECTS { @@ -3297,20 +3282,23 @@ ippmAggrMeasureDuration, ippmAggrMeasureHistorySize, ippmAggrMeasureStorageType, ippmAggrMeasureHistoryOwner, ippmAggrMeasureHistoryOwnerIndex, ippmAggrMeasureHistoryMetric, ippmAggrMeasureAdminState, ippmAggrMeasureFastReport, ippmAggrMeasureMap, ippmAggrMeasureResultsMgmt, + ippmAggrMeasureLastUpdate, + ippmAggrMeasureOperState, + ippmAggrMeasureNbPktsTreated, ippmAggrMeasureStatus } STATUS current DESCRIPTION "The IPPM AggregatedMeasure Group" ::= { ippmGroups 5} ippmReportGroup OBJECT-GROUP OBJECTS { ippmReportSetupMeasureOwner, @@ -3322,21 +3310,20 @@ ippmReportSetupHighThreshold, ippmReportSetupDurationThresUnit, ippmReportSetupDurationThreshold, ippmReportSetupReportSize, ippmReportSetupResultsMgmt, ippmReportSetupNMS, ippmReportSetupNotification, ippmReportSetupMap, ippmReportSetupStatus, ippmReportPathToResults, - ippmReportSequence, ippmReportTimestamp, ippmReportValue } STATUS current DESCRIPTION "The IPPM Report Group" ::= { ippmGroups 6} ippmOwnersGroup OBJECT-GROUP OBJECTS { @@ -3380,21 +3368,21 @@ 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 + + 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. @@ -3431,21 +3419,21 @@ # 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 + ippmReportSequence.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 @@ -3469,21 +3457,22 @@ # 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 + ippmReportSequence.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 @@ -3548,25 +3537,42 @@ 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. 9 Document management 9.1 Open issues - Defval 0 for an OID ? Usage of accessible-for-notify for an index ? - Subtype of InetAddress ? -9.2 Changes done since release 02 +9.2 Changes done since release 03 + + + SMI subtype: INTEGER vs Integer32...; + + SMI UNITS: Clauses added; + + cleanup of DEFVAL values; + + + Counter/index wrapping: + the index of the table wrap independently of the sequence of the + results. That makes it very difficult for application to track the + results. As the sequence id identify the instance of the result of a + measure the index is removed both from the table and from the index + clause. + ippmHistoryIndex removed from ippmHistoryEntry; + ippmHistoryIndex removed from the INDEX clause of the table + ippmHistoryTable; + ippmReportIndex removed from ippmReportEntry; + ippmReportIndex removed from the clause INDEX of ippmReportEntry + INDEX clause of the table ippmReportTable; + +9.3 Changes done since release 02 + Security/VACM: sharing table removed; ippmMeasure merged with networkMeasure and AggrMeasure to have all networkMeasure objects in read only. Indexes belong to the table; remove all reference to SNMPv1 ...inSNMPTrapPDU + System: ippmSystemOperationalStatus added @@ -3662,21 +3668,21 @@ (SNMP)", RFC 2575, April 1999. [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. 11 Acknowledgments A Kerbe. -12 Authors Addresses +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