draft-ietf-rtfm-meter-mib-03.txt   draft-ietf-rtfm-meter-mib-04.txt 
Internet Engineering Task Force Nevil Brownlee Internet Engineering Task Force Nevil Brownlee
INTERNET-DRAFT The University of Auckland INTERNET-DRAFT The University of Auckland
November 1997 December 1997
Traffic Flow Measurement: Meter MIB Traffic Flow Measurement: Meter MIB
<draft-ietf-rtfm-meter-mib-03.txt> <draft-ietf-rtfm-meter-mib-04.txt>
Status of this Memo Status of this Memo
This document is an Internet-Draft. Internet-Drafts are working This document is an Internet-Draft. Internet-Drafts are working
documents of the Internet Engineering Task Force (IETF), its Areas, and documents of the Internet Engineering Task Force (IETF), its Areas, and
its Working Groups. Note that other groups may also distribute working its Working Groups. Note that other groups may also distribute working
documents as Internet-Drafts. This Internet Draft is a product of the documents as Internet-Drafts. This Internet Draft is a product of the
Realtime Traffic Flow Measurement Working Group of the IETF. Realtime Traffic Flow Measurement Working Group of the IETF.
Internet Drafts are draft documents valid for a maximum of six months. Internet Drafts are draft documents valid for a maximum of six months.
skipping to change at page 2, line ? skipping to change at page 2, line ?
3.1 Format of Definitions . . . . . . . . . . . . . . . . . . . . 4 3.1 Format of Definitions . . . . . . . . . . . . . . . . . . . . 4
4 Overview 4 4 Overview 4
4.1 Scope of Definitions, Textual Conventions . . . . . . . . . . 4 4.1 Scope of Definitions, Textual Conventions . . . . . . . . . . 4
4.2 Usage of the MIB variables . . . . . . . . . . . . . . . . . . 5 4.2 Usage of the MIB variables . . . . . . . . . . . . . . . . . . 5
5 Changes Introduced Since RFC 2064 6 5 Changes Introduced Since RFC 2064 6
6 Definitions 7 6 Definitions 7
7 Security Considerations 43 7 Security Considerations 44
8 Acknowledgements 44 8 Acknowledgements 46
9 References 44 9 References 46
10Author's Address 46 10 Author's Address 47
1 Introduction 1 Introduction
This memo defines a portion of the Management Information Base (MIB) for This memo defines a portion of the Management Information Base (MIB) for
use with network management protocols in the Internet community. In use with network management protocols in the Internet community. In
particular, it describes objects for managing and collecting data from particular, it describes objects for managing and collecting data from
network Realtime Traffic Flow Meters, as described in [9]. network Realtime Traffic Flow Meters, as described in [9].
The MIB is 'basic' in the sense that it provides more than enough The MIB is 'basic' in the sense that it provides more than enough
information for everyday traffic measurment. Furthermore, it can be information for everyday traffic measurment. Furthermore, it can be
skipping to change at page 8, line 8 skipping to change at page 8, line 8
OBJECT-GROUP, MODULE-COMPLIANCE OBJECT-GROUP, MODULE-COMPLIANCE
FROM SNMPv2-CONF FROM SNMPv2-CONF
mib-2, ifIndex mib-2, ifIndex
FROM RFC1213-MIB FROM RFC1213-MIB
OwnerString OwnerString
FROM RMON-MIB FROM RMON-MIB
TimeFilter TimeFilter
FROM RMON2-MIB; FROM RMON2-MIB;
flowMIB MODULE-IDENTITY flowMIB MODULE-IDENTITY
LAST-UPDATED "9707071715Z" LAST-UPDATED "9712230937Z"
ORGANIZATION "IETF Realtime Traffic Flow Measurement Working Group" ORGANIZATION "IETF Realtime Traffic Flow Measurement Working Group"
CONTACT-INFO CONTACT-INFO
"Nevil Brownlee, The University of Auckland "Nevil Brownlee, The University of Auckland
Postal: Information Technology Sytems & Services Postal: Information Technology Sytems & Services
The University of Auckland The University of Auckland
Private Bag 92-019 Private Bag 92-019
Auckland, New Zealand Auckland, New Zealand
Phone: +64 9 373 7599 x8941 Phone: +64 9 373 7599 x8941
E-mail: n.brownlee@auckland.ac.nz" E-mail: n.brownlee@auckland.ac.nz"
DESCRIPTION DESCRIPTION
"MIB for the RTFM Traffic Flow Meter." "MIB for the RTFM Traffic Flow Meter."
REVISION "9712230937Z"
DESCRIPTION
"Two further variables deprecated:
- flowRuleInfoRulesReady (use flowRuleInfoStatus intead)
- flowDataStatus (contains no useful information)"
REVISION "9707071715Z" REVISION "9707071715Z"
DESCRIPTION DESCRIPTION
"Significant changes since RFC 2064 include: "Significant changes since RFC 2064 include:
- flowDataPackageTable added - flowDataPackageTable added
- flowColumnActivityTable deprecated - flowColumnActivityTable deprecated
- flowManagerCounterWrap deprecated" - flowManagerCounterWrap deprecated"
REVISION "9603080208Z" REVISION "9603080208Z"
DESCRIPTION DESCRIPTION
"Initial version of this MIB (RFC 2064)" "Initial version of this MIB (RFC 2064)"
skipping to change at page 16, line 24 skipping to change at page 16, line 29
the meter. the meter.
Note that references to rule sets in the flowManagerInfoTable Note that references to rule sets in the flowManagerInfoTable
use indexes for their flowRuleSetInfoTable entries. These may use indexes for their flowRuleSetInfoTable entries. These may
be different each time the rule set is loaded into a meter." be different each time the rule set is loaded into a meter."
::= { flowRuleSetInfoEntry 6 } ::= { flowRuleSetInfoEntry 6 }
flowRuleInfoRulesReady OBJECT-TYPE flowRuleInfoRulesReady OBJECT-TYPE
SYNTAX TruthValue SYNTAX TruthValue
MAX-ACCESS read-create MAX-ACCESS read-create
STATUS current STATUS deprecated
DESCRIPTION DESCRIPTION
"Indicates whether the rules for this row's associated rule set "Indicates whether the rules for this row's associated rule set
are ready for use. The meter will refuse to 'run' the rule set are ready for use. The meter will refuse to 'run' the rule set
unless this variable has been set to true(1). unless this variable has been set to true(1).
While RulesReady is false(2), the manager may modify the rule While RulesReady is false(2), the manager may modify the rule
set, for example by downloading rules into it." set, for example by downloading rules into it."
::= { flowRuleSetInfoEntry 7 } ::= { flowRuleSetInfoEntry 7 }
flowRuleInfoFlowRecords OBJECT-TYPE flowRuleInfoFlowRecords OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
skipping to change at page 26, line 45 skipping to change at page 26, line 52
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A TimeFilter for this entry. Allows GetNext and GetBulk "A TimeFilter for this entry. Allows GetNext and GetBulk
to find flow table rows which have changed since a specified to find flow table rows which have changed since a specified
value of sysUptime." value of sysUptime."
::= { flowDataEntry 2 } ::= { flowDataEntry 2 }
flowDataStatus OBJECT-TYPE flowDataStatus OBJECT-TYPE
SYNTAX INTEGER { inactive(1), current(2) } SYNTAX INTEGER { inactive(1), current(2) }
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS deprecated
DESCRIPTION DESCRIPTION
"Status of this flow data record." "Status of this flow data record."
::= { flowDataEntry 3 } ::= { flowDataEntry 3 }
flowDataSourceInterface OBJECT-TYPE flowDataSourceInterface OBJECT-TYPE
SYNTAX Integer32 SYNTAX Integer32
MAX-ACCESS read-only MAX-ACCESS read-only
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"Index of the interface associated with the source address "Index of the interface associated with the source address
skipping to change at page 37, line 29 skipping to change at page 37, line 35
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"A collection of attribute values for a single flow, as "A collection of attribute values for a single flow, as
specified by this row's indexes. The attribute values are specified by this row's indexes. The attribute values are
contained within a BER-encoded sequence [7], in the order contained within a BER-encoded sequence [7], in the order
they appear in their flowPackageSelector. they appear in their flowPackageSelector.
For example, to retrieve a flowPackage containing values for For example, to retrieve a flowPackage containing values for
attributes 11, 18 and 29, for a flow in rule set 7, with flow attributes 11, 18 and 29, for a flow in rule set 7, with flow
index 3447, one would GET the package whose Object Identifier index 3447, one would GET the package whose Object Identifier
(OID) was (OID) is
flowPackageData . 3.11.18.29 . 7. 0 . 3447 flowPackageData . 3.11.18.29 . 7. 0 . 3447
To retrieve a flowPackage for the next such flow, which had To get a package for the next such flow which had been
been active since time 12345, one would GETNEXT the package active since time 12345 one would GETNEXT the package whose
whose Object Identifier (OID) was Object Identifier (OID) is
flowPackageData . 3.11.18.29 . 7. 12345 . 3447" flowPackageData . 3.11.18.29 . 7. 12345 . 3447"
::= { flowDataPackageEntry 5 } ::= { flowDataPackageEntry 5 }
-- --
-- The Rule Table -- The Rule Table
-- --
-- This is an array of rule sets; the 'running' ones are indicated -- This is an array of rule sets; the 'running' ones are indicated
-- by the entries in the meter's flowManagerInfoTable. Several rule -- by the entries in the meter's flowManagerInfoTable. Several rule
-- sets can be held in a meter so that the manager can change the -- sets can be held in a meter so that the manager can change the
skipping to change at page 40, line 28 skipping to change at page 40, line 32
flowMIBCompliances flowMIBCompliances
OBJECT IDENTIFIER ::= { flowMIBConformance 1 } OBJECT IDENTIFIER ::= { flowMIBConformance 1 }
flowMIBGroups flowMIBGroups
OBJECT IDENTIFIER ::= { flowMIBConformance 2 } OBJECT IDENTIFIER ::= { flowMIBConformance 2 }
flowControlGroup OBJECT-GROUP flowControlGroup OBJECT-GROUP
OBJECTS { OBJECTS {
flowRuleInfoSize, flowRuleInfoOwner, flowRuleInfoSize, flowRuleInfoOwner,
flowRuleInfoTimeStamp, flowRuleInfoStatus, flowRuleInfoTimeStamp, flowRuleInfoStatus,
flowRuleInfoName, flowRuleInfoRulesReady, flowRuleInfoName,
flowRuleInfoRulesReady,
flowRuleInfoFlowRecords, flowRuleInfoFlowRecords,
flowInterfaceSampleRate, flowInterfaceSampleRate,
flowInterfaceLostPackets, flowInterfaceLostPackets,
flowReaderTimeout, flowReaderOwner, flowReaderTimeout, flowReaderOwner,
flowReaderLastTime, flowReaderPreviousTime, flowReaderLastTime, flowReaderPreviousTime,
flowReaderStatus, flowReaderRuleSet, flowReaderStatus, flowReaderRuleSet,
flowManagerCurrentRuleSet, flowManagerStandbyRuleSet, flowManagerCurrentRuleSet, flowManagerStandbyRuleSet,
flowManagerHighWaterMark, flowManagerHighWaterMark,
-- flowManagerCounterWrap, <- In DataScaleGroup
flowManagerOwner, flowManagerTimeStamp, flowManagerOwner, flowManagerTimeStamp,
flowManagerStatus, flowManagerRunningStandby, flowManagerStatus, flowManagerRunningStandby,
flowFloodMark, flowFloodMark,
flowInactivityTimeout, flowActiveFlows, flowInactivityTimeout, flowActiveFlows,
flowMaxFlows, flowFloodMode } flowMaxFlows, flowFloodMode }
STATUS current STATUS deprecated
DESCRIPTION DESCRIPTION
"The control group defines objects which are used to control "The control group defines objects which are used to control
an accounting meter." an accounting meter."
::= {flowMIBGroups 1 } ::= {flowMIBGroups 1 }
flowDataTableGroup OBJECT-GROUP flowDataTableGroup OBJECT-GROUP
OBJECTS { OBJECTS {
-- flowDataIndex, <- Index
-- flowDataTimeMark, <- Index
flowDataStatus, flowDataStatus,
flowDataSourceInterface, flowDataSourceInterface,
flowDataSourceAdjacentType, flowDataSourceAdjacentType,
flowDataSourceAdjacentAddress, flowDataSourceAdjacentMask, flowDataSourceAdjacentAddress, flowDataSourceAdjacentMask,
flowDataSourcePeerType, flowDataSourcePeerType,
flowDataSourcePeerAddress, flowDataSourcePeerMask, flowDataSourcePeerAddress, flowDataSourcePeerMask,
flowDataSourceTransType, flowDataSourceTransType,
flowDataSourceTransAddress, flowDataSourceTransMask, flowDataSourceTransAddress, flowDataSourceTransMask,
flowDataDestInterface, flowDataDestInterface,
flowDataDestAdjacentType, flowDataDestAdjacentType,
flowDataDestAdjacentAddress, flowDataDestAdjacentMask, flowDataDestAdjacentAddress, flowDataDestAdjacentMask,
flowDataDestPeerType, flowDataDestPeerType,
flowDataDestPeerAddress, flowDataDestPeerMask, flowDataDestPeerAddress, flowDataDestPeerMask,
flowDataDestTransType, flowDataDestTransType,
flowDataDestTransAddress, flowDataDestTransMask, flowDataDestTransAddress, flowDataDestTransMask,
-- flowDataRuleSet, <- Index
flowDataToOctets, flowDataToPDUs, flowDataToOctets, flowDataToPDUs,
flowDataFromOctets, flowDataFromPDUs, flowDataFromOctets, flowDataFromPDUs,
flowDataFirstTime, flowDataLastActiveTime, flowDataFirstTime, flowDataLastActiveTime,
flowDataSourceClass, flowDataDestClass, flowDataClass, flowDataSourceClass, flowDataDestClass, flowDataClass,
flowDataSourceKind, flowDataDestKind, flowDataKind flowDataSourceKind, flowDataDestKind, flowDataKind
} }
STATUS current STATUS deprecated
DESCRIPTION DESCRIPTION
"The flow table group defines objects which provide the "The flow table group defines objects which provide the
structure for the rule table, including the creation time structure for the flow table, including the creation time
and activity time indexes into it. In addition it defines and activity time indexes into it. In addition it defines
objects which provide a base set of flow attributes for the objects which provide a base set of flow attributes for the
adjacent, peer and transport layers, together with a flow's adjacent, peer and transport layers, together with a flow's
counters and times. Finally it defines a flow's class and counters and times. Finally it defines a flow's class and
kind attributes, which are set by rule actions." kind attributes, which are set by rule actions."
::= {flowMIBGroups 2 } ::= {flowMIBGroups 2 }
flowDataScaleGroup OBJECT-GROUP flowDataScaleGroup OBJECT-GROUP
OBJECTS { OBJECTS {
flowManagerCounterWrap, flowManagerCounterWrap,
skipping to change at page 42, line 21 skipping to change at page 42, line 28
} }
STATUS deprecated STATUS deprecated
DESCRIPTION DESCRIPTION
"The flow column table group defines objects which can be used "The flow column table group defines objects which can be used
to collect part of a column of attribute values from the flow to collect part of a column of attribute values from the flow
table." table."
::= {flowMIBGroups 5 } ::= {flowMIBGroups 5 }
flowDataPackageGroup OBJECT-GROUP flowDataPackageGroup OBJECT-GROUP
OBJECTS { OBJECTS {
-- flowPackageSelector, <- Index
-- flowPackageRuleSet, <- Index
-- flowPackageIndex, <- Index
flowPackageData flowPackageData
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The data package group defines objects which can be used "The data package group defines objects which can be used
to collect a specified set of attribute values from a row of to collect a specified set of attribute values from a row of
the flow table." the flow table."
::= {flowMIBGroups 6 } ::= {flowMIBGroups 6 }
flowRuleTableGroup OBJECT-GROUP flowRuleTableGroup OBJECT-GROUP
skipping to change at page 42, line 46 skipping to change at page 43, line 4
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The rule table group defines objects which hold the set(s) "The rule table group defines objects which hold the set(s)
of rules specifying which traffic flows are to be accounted of rules specifying which traffic flows are to be accounted
for." for."
::= {flowMIBGroups 7 } ::= {flowMIBGroups 7 }
flowDataScaleGroup2 OBJECT-GROUP flowDataScaleGroup2 OBJECT-GROUP
OBJECTS { OBJECTS {
-- flowManagerCounterWrap, <- Deprecated
flowDataPDUScale, flowDataOctetScale flowDataPDUScale, flowDataOctetScale
} }
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The flow scale group defines objects which specify scale "The flow scale group defines objects which specify scale
factors for counters. This group replaces the earlier factors for counters. This group replaces the earlier
version of flowDataScaleGroup above (now deprecated)." version of flowDataScaleGroup above (now deprecated)."
::= {flowMIBGroups 8} ::= {flowMIBGroups 8}
flowControlGroup2 OBJECT-GROUP
OBJECTS {
flowRuleInfoSize, flowRuleInfoOwner,
flowRuleInfoTimeStamp, flowRuleInfoStatus,
flowRuleInfoName,
-- flowRuleInfoRulesReady, <- Deprecated
flowRuleInfoFlowRecords,
flowInterfaceSampleRate,
flowInterfaceLostPackets,
flowReaderTimeout, flowReaderOwner,
flowReaderLastTime, flowReaderPreviousTime,
flowReaderStatus, flowReaderRuleSet,
flowManagerCurrentRuleSet, flowManagerStandbyRuleSet,
flowManagerHighWaterMark,
-- flowManagerCounterWrap, <- In DataScaleGroup
flowManagerOwner, flowManagerTimeStamp,
flowManagerStatus, flowManagerRunningStandby,
flowFloodMark,
flowInactivityTimeout, flowActiveFlows,
flowMaxFlows, flowFloodMode }
STATUS current
DESCRIPTION
"The control group defines objects which are used to control
an accounting meter. It replaces the earlier version of
flowControlGroup above (now deprecated)."
::= {flowMIBGroups 9 }
flowDataTableGroup2 OBJECT-GROUP
OBJECTS {
-- flowDataIndex, <- Index
-- flowDataTimeMark, <- Index
-- flowDataStatus, <- Deprecated
flowDataSourceInterface,
flowDataSourceAdjacentType,
flowDataSourceAdjacentAddress, flowDataSourceAdjacentMask,
flowDataSourcePeerType,
flowDataSourcePeerAddress, flowDataSourcePeerMask,
flowDataSourceTransType,
flowDataSourceTransAddress, flowDataSourceTransMask,
flowDataDestInterface,
flowDataDestAdjacentType,
flowDataDestAdjacentAddress, flowDataDestAdjacentMask,
flowDataDestPeerType,
flowDataDestPeerAddress, flowDataDestPeerMask,
flowDataDestTransType,
flowDataDestTransAddress, flowDataDestTransMask,
-- flowDataRuleSet, <- Index
flowDataToOctets, flowDataToPDUs,
flowDataFromOctets, flowDataFromPDUs,
flowDataFirstTime, flowDataLastActiveTime,
flowDataSourceClass, flowDataDestClass, flowDataClass,
flowDataSourceKind, flowDataDestKind, flowDataKind
}
STATUS current
DESCRIPTION
"This flow table group defines objects which provide the
structure for the flow table. It replaces the earlier
version of flowDataTableGroup above (now deprecated)."
::= {flowMIBGroups 10 }
flowMIBCompliance MODULE-COMPLIANCE flowMIBCompliance MODULE-COMPLIANCE
STATUS current STATUS current
DESCRIPTION DESCRIPTION
"The compliance statement for a Traffic Flow Meter." "The compliance statement for a Traffic Flow Meter."
MODULE MODULE
MANDATORY-GROUPS { MANDATORY-GROUPS {
flowControlGroup, flowControlGroup2,
flowDataTableGroup, flowDataTableGroup2,
flowDataPackageGroup, flowDataPackageGroup,
flowRuleTableGroup flowRuleTableGroup
} }
::= { flowMIBCompliances 1 } ::= { flowMIBCompliances 1 }
END END
7 Security Considerations 7 Security Considerations
This MIB describes how an RTFM traffic meter is controlled, and provides This MIB describes how an RTFM traffic meter is controlled, and provides
 End of changes. 23 change blocks. 
19 lines changed or deleted 95 lines changed or added

This html diff was produced by rfcdiff 1.34. The latest version is available from http://tools.ietf.org/tools/rfcdiff/