Network Working Group M. Fine Internet Draft K. McCloghrie Expires December 2000 Cisco Systems J. Seligson K. Chan Nortel Networks S. Hahn Intel A. Smith No Affiliation Francis Reichmeyer IPHighway July 14, 2000 Differentiated Services Quality of Service Policy Information Base draft-ietf-diffserv-pib-01.txt Status of this Memo This document is an Internet-Draft and is in full conformance with all provisions of Section 10 of RFC2026. Internet-Drafts are working documents of the Internet Engineering Task Force (IETF), its areas, and its working groups. Note that other groups may also distribute working documents as Internet-Drafts. Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as ``work in progress.'' To view the current status of any Internet-Draft, please check the ``1id-abstracts.txt'' listing contained in an Internet-Drafts Shadow Directory, see http://www.ietf.org/shadow.html. [Page 1] DiffServ QoS Policy Information Base July 2000 1. Glossary PRC Policy Rule Class. A type of policy data. PRI Policy Rule Instance. An instance of a PRC. PIB Policy Information Base. The database of policy information. PDP Policy Decision Point. See [RAP-FRAMEWORK]. PEP Policy Enforcement Point. See [RAP-FRAMEWORK]. PRID Policy Rule Instance Identifier. Uniquely identifies an instance of a a PRC. 2. Introduction [SPPI] describes a structure for specifying policy information that can then be transmitted to a network device for the purpose of configuring policy at that device. The model underlying this structure is one of well defined policy rule classes and instances of these classes residing in a virtual information store called the Policy Information Base (PIB). This document specifies a set of policy rule classes specifically for configuring QoS Policy for Differentiated Services [DSARCH]. One way to provision policy is by means of the COPS protocol [COPS] with the extensions for provisioning [COPS-PR]. This protocol supports multiple clients, each of which may provision policy for a specific policy domain such as QoS. The PRCs defined in this DiffServ QoS PIB are intended for use by the COPS-PR QoS client type. Furthemore, these PRCs are in addition to any other PIBs that may be defined for the QoS client type in the future, as well as the PRCs defined in the Framework PIB [FR-PIB] 3. DiffServ PIB Concepts 3.1. Filters, Filter Groups and Classifiers The basis of differential QoS treatment of packets is a filter. This is simply a general specification for matching a pattern to appear in packets belonging to flows, e.g. microflows or behavior aggregates. Associated with each filter is a permit/deny flag which effectively gives a negation operation. Sets of these filters are used to create classifiers. Classifiers are applied to interfaces with a direction flag to indicate an ingress or egress classifier. Filters are combined, in order, into filter groups; [Page 2] DiffServ QoS Policy Information Base July 2000 filter groups are then combined, in order, to build a classifier. This allows a rudimentary classification grammar to be defined. On input, each packet is checked against the ingress classifier on the interface. Similarly, on output each packet is checked against the egress classifier on the interface. The result of the classifier then feeds into appropriate meters and actions to be applied to packets. For each classifier, the packet is checked against the set of filter groups in the appropriate order. The detailed operation of the PIB syntax is as follows. If a packet matches a filter in the first filter group of a classifier and the sense is "permit" then the subsequent meters and actions associated with that classifier are applied to that packet and no further filters are compared. If the sense is "deny" then the rest of the filters in the current filter group are skipped and operation proceeds with the first filter of the next filter group. If the packet does not match any of the filters in the filter group then the next filter group is tried. This process is continued until a definitive match is obtained. Each classifier must cover all possible matches i.e., it must be complete. 3.2. Applying QoS Policy Using Targets The task of applying QoS policy within a network requires the specification of several components. The flows to which QoS policy should be applied must be identified. The interfaces of the device on which the policy should be enforced must be known. A certain set of parameters to support flow metering is also required. The combination of these components provides the target against which QoS policy is to be applied. Within the context of the QoS PIB, the association between these components is defined efficiently using the Target class. The Target class serves to logically link several other QoS policy classes. Flow classification rules, specifying behavior aggregate (BA) or multi-field (MF) classification parameters, are indirectly identified using the PRC for the appropriate classification class coupled with an identifier for a specific -- classifier. Interface information is specified using the role combination tag, defined in the Interface Type class, to identify the group of interfaces on which classification is to be performed. The direction of packet flow on the identified interfaces is provided as well. A link to the metering component is provided using the PRC for the appropriate metering class instance. Once a target has been defined, actions based on the classification and metering phases must be specified. Action class instances are linked with the Target entry through the associated Meter class instance. A [Page 3] DiffServ QoS Policy Information Base July 2000 precedence component is also provided so that a definitive order of evaluation may be defined for Target class instances being applied to the same interface role and flow direction targets. The Target class thus functions as the integration point for the range of components used for the application of QoS policy. 3.3. Interface Modeling with Queue Sets The traffic processing capabilities of an interface are determined by the queuing resources that are associated with the interface. These capabilities are represented abstractly using queue sets. A queue set is comprised of one or more individual queues. The PDP creates the queue sets, configures the parameters of the individual queues, configures the scheduling discipline to be used to schedule the queues and then assigns a queue set to each tuple. In this way, the PDP sets the scheduling policy for each interface based on the role combination of the interface and the type of the interface. In order for the PDP to configure a queue set that can be properly realized by an interface, the PEP reports to the PDP the types of interfaces it has together with various capabilities and configuration limits (such as the maximum number of queues an interface could support) of the interface types. It should be emphasized that the PDP does not configure individual interfaces directly. Rather, it configures them indirectly by specifying the configuration for each interface type and role combination pair. It is the responsibility of the PEP to apply the queue set characteristics, and hence the interface scheduling configuration, to the individual interfaces on the basis of the type and role combination information. 3.3.1. Queue Scheduling There are two basic scheduling disciplines supported by queue sets: priority queueing and weighted fair queueing. To support these, each queue is assigned a priority which is then used to determine a strict processing order between queues. However, several queues may be assigned the same priority. In this case, these queues form a group, called a priority group, and are scheduled using WFQ. In other words, service is given to the priority group with the highest priority that has any non-empty queue. Within a priority group queues are serviced using WFQ. [Page 4] DiffServ QoS Policy Information Base July 2000 3.3.2. Assigning Packets To Queues and Thresholds In keeping with the DiffServ model of classifying packets into behaviour classes and then providing service suitable for that behaviour, packets are assigned to queues on the basis of their final DSCP values. Furthermore, each queue is configured with a set of thresholds to support multiple discard priorities for the PHBs in a PHB group. Packets are assigned to thresholds within a queue on the basis of their DSCPs. The PDP is responsible for this assignment of DSCP values to queues and the associated thresholds. 3.3.3. Hierarchies of Queues Sometimes policy may require hierachies of queues. For example, a department might has some set of traffic classes with a defined scheduling policy between these classes. Multiple departments might then share a link with there being a defined scheduling policy between traffic from the various depertments. The PIB does not support hierarchical queueing at this time. However, we expect to add this support in the future by allowing the traffic from one queue set to feed into the queues of another queue set. 4. Summary of the DiffServ PIB The DiffServ PIB consists of one module containing the base PRCs for setting DiffServ policy, queues, classifiers, meters, etc., and also contains filters for matching IP packets. This module comprises several groups which are summarized in this section. QoS Interface Group This group consists of PRCs to indicate to the PDP the types of interface supported on the PEP in terms of their QoS capabilities and PRCs that the PDP can install in order to configure these interfaces (queues, scheduling parameters, buffer sizes, etc.) to affect the desired policy. This group describes capabilities in terms of the types of interfaces and takes configuration in terms of interface types and role combinations [FR-PIB]; it does not deal with individual interfaces on the device. [Page 5] DiffServ QoS Policy Information Base July 2000 QoS Metering Group This group contains configuration of meters. These meters can then be used to by target classes to specify metering policy. QoS Action Group This group contains the policies that define the action to be taken after the result of the classification and metering. This group also contains the policies that associate the classifiers, meters and actions. 5. PIB Operational Overview This section provides an operation overview of configuring DiffServ QoS policy. After initial PEP to PDP communication setup, using [COPS-PR] for example, the PEP will provide to the PDP the PIB Policy Rule Classes (PRCs), interface types, and interface type capabilities it supports. The PRCs supported by the PEP are reported to the PDP in the PRC Support Table, frwkPrcSupportTable defined in the framework PIB [FR-PIB]. Each instance of the frwkPrcSupportTable indicates a PRC that the PEP understands and for which the PDP can send class instances as part of the policy information. The interface types the PEP supports are described by rows in the interface type table, frwkIfCapsSetTable. Each row, or instance of this class describes the characteristics of an interface type. The PEP informs the PDP of these interface types and then the PDP configures the interfaces, per role combination, by means of installing queue sets. The PDP, with knowledge of the PEP's capabilities, then provides the PEP with administration domain and interface-specific policy information. Instances of the qosTargetTable define how the Traffic Conditioning Elements are combined into Traffic Conditioning Blocks, as described in [MODEL]. Each instance of the qosTargetTable applies to an interface type defined by its roles and direction (ingress or egress). This is pictured in the following diagram where the InterfaceRoles X, and Y would be used by the network device to associate the traffic conditioning block with the interfaces needing each of thess policies. +----------------------------+ +----------------------------+ | qosTargetEntry | [Page 6] DiffServ QoS Policy Information Base July 2000 | | | | | PolicyFilterEntry | <------- Ptr to Policy Filter | | | | InterfaceRoles = X | +----------------------------+ | Meter -----+ | +-------------------|--------+ | v +----------------+ | qosMeterEntry | +----------------+ | v +----------------+ | qosActionEntry | +----------------+ Figure 7.1 DiffServ PIB Table Relationships Notice that the qosTargetTable allows the use of heterogeneous classifiers with same instance of qosMeterTable. For example, if classifiers operating on layer 2 addresses were to be defined, those classifiers could be used together with the IP ones. After receiving the PIB, the PEP will associate the Classifier, Meter and Action with the corresponding interfaces supporting the specific interface type and roles. [Page 7] DiffServ QoS Policy Information Base July 2000 6. PIB Definitions 6.1. The DiffServ Base PIB DIFFSERV-PIB PIB-DEFINITIONS ::= BEGIN IMPORTS Unsigned32, Integer32, MODULE-IDENTITY, OBJECT-TYPE FROM COPS-PR-SPPI TruthValue, TEXTUAL-CONVENTION FROM SNMPv2-TC PolicyInstanceId, PolicyReferenceId, PolicyTagId, PolicyTagReference FROM COPS-PR-SPPI; RoleCombination FROM FRAMEWORK-PIB; qosPolicyIpPib MODULE-IDENTITY CLIENT-TYPE { tbd -- QoS Client Type } LAST-UPDATED "200007141800Z" ORGANIZATION "IETF DIFFSERV WG" CONTACT-INFO " Michael Fine Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA Phone: +1 408 527 8218 Email: mfine@cisco.com Keith McCloghrie Cisco Systems, Inc. 170 West Tasman Drive, San Jose, CA 95134-1706 USA Phone: +1 408 526 5260 Email: kzm@cisco.com John Seligson Nortel Networks, Inc. 4401 Great America Parkway Santa Clara, CA 95054 USA Phone: +1 408 495 2992 Email: jseligso@nortelnetworks.com" [Page 8] DiffServ QoS Policy Information Base July 2000 DESCRIPTION "The PIB module containing a set of policy rule classes that describe quality of service (QoS) policies for DiffServ. It includes general classes that may be extended by other PIB specifications as well as a set of PIB classes related to IP processing." ::= { tbd } qosPolicyGenPibClasses OBJECT IDENTIFIER ::= { qosPolicyIpPib 1 } qosPolicyIpPibClasses OBJECT IDENTIFIER ::= { qosPolicyIpPib 2 } -- -- Textual Conventions -- -- -- DiffServ Codepoint -- Dscp ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An integer that is in the range of the DiffServ codepoint values." SYNTAX INTEGER (0..63) -- -- Interface types -- QosInterfaceQueueCount ::= TEXTUAL-CONVENTION STATUS current DESCRIPTION "An integer that describes the number of queues an interface supports. It is limited to the number of DSCP values." SYNTAX INTEGER (1..64) -- -- QoS Interface Group -- [Page 9] DiffServ QoS Policy Information Base July 2000 -- -- This group specifies the configuration of the various interface -- types including the configuration of queue sets, setting of -- queueing parameters and the mapping of DSCPs to thresholds in -- queues. qosIfParameters OBJECT IDENTIFIER ::= { qosPolicyGenPibClasses 1 } -- -- Interface Type Capability Tables -- -- The Interface type capability tables define capabilities that may -- be associated with an interface of a specific type. This PIB -- defines three such tables: a classification capabilities table, a -- metering capabilities table and a scheduling capabilities table. -- Other PIBs may define other capability tables to augment the -- capability definitions of these tables or to introduce completely -- new capabilities. -- -- Classification Capabilities -- qosIfClassificationCapsTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfClassificationCapsEntry PIB-ACCESS notify, 3 STATUS current DESCRIPTION "This table specifies the classification capabilities of an interface type" ::= { qosIfParameters 1 } qosIfClassificationCapsEntry OBJECT-TYPE SYNTAX QosIfClassificationEntry STATUS current DESCRIPTION "An instance of this class describes the classification capabilities of an interface." INDEX { qosIfClassificationCapsPrid } UNIQUENESS { qosIfClassificationCaps } [Page 10] DiffServ QoS Policy Information Base July 2000 ::= { qosIfClassificationCapsTable 1 } QosIfClassificationCapsEntry ::= SEQUENCE { qosIfClassificationCapsPrid PolicyInstanceId, qosIfClassificationCaps BITS } qosIfClassificationCapsPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies a instance of the class." ::= { qosIfClassificationCapsEntry 1 } qosIfClassificationCaps OBJECT-TYPE SYNTAX BITS { inputIpClassification(1), outputIpClassification(2), -- Indicates the ability to classify IP -- packets on ingress and on egress, -- respectively. ipAddrClassification(3), -- indicates the ability to classify based on -- IP addresses ipProtoClassification(4), -- indicates the ability to classify based on -- IP protocol numbers ipDscpClassification(5) -- indicates the ability to classify based on -- IP DSCP ipL4Classification(6) -- indicates the ability to classify based on -- IP layer 4 port numbers for UDP and TCP } STATUS current DESCRIPTION "Bit set of supported classification capabilities. In addition to these capabilities, other PIBs may define other capabilities that can then be specified in addition to the ones specified here (or instead of the ones specified here if none of these are specified)." [Page 11] DiffServ QoS Policy Information Base July 2000 ::= { qosIfClassificationCapsEntry 2 } -- -- Metering Capabilities -- qosIfMeteringCapsTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfMeteringCapsEntry PIB-ACCESS notify, 3 STATUS current DESCRIPTION "This table specifies the metering capabilities of an interface type" ::= { qosIfParameters 2 } qosIfMeteringCapsEntry OBJECT-TYPE SYNTAX QosIfMeteringCapsEntry STATUS current DESCRIPTION "An instance of this class describes the classification capabilities of an interface." INDEX { qosIfMeteringCapsPrid } UNIQUENESS { qosIfMeteringCaps } ::= { qosIfMeteringCapsTable 1 } QosIfMeteringCapsEntry ::= SEQUENCE { qosIfMeteringCapsPrid PolicyInstanceId, qosIfMeteringCaps BITS } qosIfMeteringCapsPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies a instance of the class." ::= { qosIfMeteringCapsEntry 1 } qosIfMeteringCaps OBJECT-TYPE SYNTAX BITS { [Page 12] DiffServ QoS Policy Information Base July 2000 meterByRemarking (1), meterByDropping (2), -- These capabilities indicate if the interface -- can remark out of profile packets or drop them, -- respectively inputShaping (3), outputShaping (4) -- indicate if the interface can shape on ingress -- or on egress, respectively. } STATUS current DESCRIPTION "Bit set of supported classification capabilities. As with classification capabilities, these metering capabilities may be augmented by capabilities specified in other PRCs (in other PIBs)." ::= { qosIfMeteringCapsEntry 2 } -- -- Scheduling Capabilities -- qosIfSchedulingCapsTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfSchedulingCapsEntry PIB-ACCESS notify, 10 STATUS current DESCRIPTION "This table specifies the scheduling capabilities of an interface type" ::= { qosIfParameters 3 } qosIfSchedulingCapsEntry OBJECT-TYPE SYNTAX QosIfSchedulingCapsEntry STATUS current DESCRIPTION "An instance of this class describes the classification capabilities of an interface." INDEX { qosIfSchedulingCapsPrid } UNIQUENESS { qosIfSchedulingCapsMaxQueues, [Page 13] DiffServ QoS Policy Information Base July 2000 qosIfSchedulingCapsMaxThresholds, qosIfSchedulingCapsMaxPriorities, qosIfSchedulingCapsServiceDisc, qosIfSchedulingCapsMinQueueSize, qosIfSchedulingCapsMaxQueueSize, qosIfSchedulingCapsTotalQueueSize, qosIfSchedulingCapsWredCapable } ::= { qosIfSchedulingCapsTable 1 } QosIfSchedulingCapsEntry ::= SEQUENCE { qosIfSchedulingCapsPrid PolicyInstanceId, qosIfSchedulingCapsMaxQueues INTEGER qosIfSchedulingCapsMaxThresholds INTEGER qosIfSchedulingCapsMaxPriorities INTEGER qosIfSchedulingCapsServiceDisc BITS qosIfSchedulingCapsMinQueueSize INTEGER qosIfSchedulingCapsMaxQueueSize INTEGER qosIfSchedulingCapsTotalQueueSize INTEGER qosIfSchedulingCapsWredCapable TruthValue } qosIfSchedulingCapsPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies a instance of the class." ::= { qosIfSchedulingCapsEntry 1 } qosIfSchedulingCapsMaxQueues OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "The maximum number of queues that this interface type can support. The queues set assigned to this interface type may not have more queues than this maximum. A value of zero means that there is no maximum." ::= { qosIfSchedulingCapsEntry 2 } qosIfSchedulingCapsMaxThresholds OBJECT-TYPE SYNTAX INTEGER STATUS current [Page 14] DiffServ QoS Policy Information Base July 2000 DESCRIPTION "The maximum number of drop thresholds that each queue supports. If the interface has a different number of thresholds for each of its queues, it must report the maximum number of thresholds any of the queues supports. The value of this attribute must be one or more." ::= { qosIfSchedulingCapsEntry 3 } qosIfSchedulingCapsMaxPriorities OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "The maximum number of priority groups that the the queues of the interface may be grouped into. A value of zero means there is no maximum." ::= { qosIfSchedulingCapsEntry 4 } qosIfSchedulingCapsServiceDisc OBJECT-TYPE SYNTAX BITS { fq(1), -- fair queueing (a.k.a. round robin) wfq(2) -- weighted fq (a.k.a. wrr) STATUS current DESCRIPTION "The scheduling disciplines supported for servicing queues in the same priority group that the interface supports. Several general purpose and well-known queuing disciplines are supported by this attribute. Other queueing disciplines may be specified instead of, or in addition to, these disciplines by setting and providing another capabilities PRC specifying the other scheduling discipline. A value of fq indicates that the interface supports fair queuing, i.e., each queue is treated equally and is serviced in a round-robin fashion. A value of wfq indicates that the queue is serviced using a weighted fair queuing discipline. Queues are serviced in a round robin fashion but each queue is given bandwidth in proportion to its weight. If none is specified then the service discipline is either unspecified or specified by another capabilities PRC." [Page 15] DiffServ QoS Policy Information Base July 2000 ::= { qosIfSchedulingCapsEntry 5 } qosIfSchedulingCapsMinQueueSize OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Some interfaces may allow the size of a queue to be configured. This attribute specifies the minimum size the queue can be configured to specified in bytes. Some interfaces set queue size in terms of packets. These devices must report the minimum queue size in bytes by assuming an average packet size suitable for the particular interface." ::= { qosIfSchedulingCapsEntry 6 } qosIfSchedulingCapsMaxQueueSize OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Some interfaces may allow the size of a queue to be configured. This attribute specifies the maximum size the queue can be configured to specified in bytes. As with qosIfSchedulingCapsMinQueueSize, devices that set queue size in terms of packets must report the maximum queue size in bytes by assuming an average packet size suitable for the particular interface." ::= { qosIfSchedulingCapsEntry 7 } qosIfSchedulingCapsTotalQueueSize OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "Some interfaces may have a limited buffer space to be share amoung all queues of that interface while also allowing the size of each queue to be configurable. To prevent the situation where the PDP configures the sizes of the queues in excess of the total buffer available to the interface, the PEP can report the total buffer space available with this capability. The value is the total number of bytes." ::= { qosIfSchedulingCapsEntry 8 } [Page 16] DiffServ QoS Policy Information Base July 2000 qosIfSchedulingCapsWredCapable OBJECT-TYPE SYNTAX TruthValue STATUS current DESCRIPTION "If true, then this interface supports WRED on (at least one of) its queues. Otherwise it supports only taildrop." ::= { qosIfSchedulingCapsEntry 9 } -- -- Queue Set Assignment Table -- qosIfQueueSetAssignTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfQueueSetAssignEntry PIB-ACCESS install, 6 STATUS current DESCRIPTION "Contains the assignment of queue sets to interface types per role combination. Contains the assignment of DSCPs to queues and thresholds for each interface type. So, after classification and metering, when the packet has a final DSCP mark, the packet is enqueued on the apprpriate queue at the appropriated threshold based on the mapping of the DSCP to threshollds in queues." ::= { qosIfParameters 4 } qosIfQueueSetAssignEntry OBJECT-TYPE SYNTAX QosIfQueueSetAssignEntry STATUS current DESCRIPTION "A conceptual row in the qosIfQueueSetAssignTable. INDEX { qosIfQueueSetAssignPrid } UNIQUENESS { qosIfQueueSetAssignIfName, qosIfQueueSetAssignRoles } ::= { qosIfQueueSetAssignTable 1 } QosIfQueueSetAssignEntry ::= SEQUENCE { [Page 17] DiffServ QoS Policy Information Base July 2000 qosIfQueueSetAssignPrid PolicyInstanceId, qosIfQueueSetAssignName SnmpAdminString, qosIfQueueSetAssignRoles RoleCombination, qosIfQueueSetAssignQueueSetId PolicyTagReference, qosIfQueueSetAssignDscpMap PolicyTagReference } qosIfQueueSetAssignPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "The index that uniquely identifies this row in the table, i.e., this PRI." ::= { qosIfQueueSetAssignEntry 1 } qosIfQueueSetAssignName OBJECT-TYPE SYNTAX SnmpAdminString STATUS current DESCRIPTION "The name of an interface type. This name must exist in frwkIfCapSetTable." ::= { qosIfQueueSetAssignEntry 2 } qosIfQueueSetAssignRoles OBJECT-TYPE SYNTAX RoleCombination STATUS current DESCRIPTION "The role combination associated with the interface type. ::= { qosIfQueueSetAssignEntry 3 } qosIfQueueSetAssignQueueSet OBJECT-TYPE SYNTAX PolicyTagReference PIB-TAG qosIfQueueSetId STATUS current DESCRIPTION "The integer ID of the queue set to be assigned to all interfaces of type specified by qosIfQueueSetAssignName and with role combination specified by qosIfQueueSetAssignRoles. This queue set must exist in qosIfQueueTable." ::= { qosIfQueueSetAssignEntry 4 } [Page 18] DiffServ QoS Policy Information Base July 2000 qosIfQueueSetAssignDscpMap OBJECT-TYPE SYNTAX PolicyTagReference PIB-TAG qosIfDscpMapMapId STATUS current DESCRIPTION "The DSCP map to apply to interfaces of type qosIfQueueSetAssignName and role combo qosIfQueueSetAssignRoles." ::= { qosIfQueueSetAssignEntry 5 } -- -- Interface Queue Table -- -- The Interface Queue Table enumerates the individual queues and -- groups them into queue sets. Configuration of each queue, and -- hence an entire queue set is specified by this table. -- qosIfQueueTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfQueueEntry PIB-ACCESS install, 10 STATUS current DESCRIPTION "Contains configuration information for the individual queues of the queue sets." ::= { qosIfParameters 5 } qosIfQueueEntry OBJECT-TYPE SYNTAX QosIfQueueEntry STATUS current DESCRIPTION "A conceptual row in the qosIfQueueTable. Each row identifies a specific queue within a given queue set and contains detailed information about the queue. Queues are associated with a given set through this table and a queue set is associated with an interface set through the qosIfQsetAssignTable." INDEX { qosIfQueuePrid } UNIQUENESS {} [Page 19] DiffServ QoS Policy Information Base July 2000 ::= { qosIfQueueTable 1 } QosIfQueueEntry ::= SEQUENCE { qosIfQueuePrid PolicyInstanceId, qosIfQueueSetId PolicyTagId, qosIfQueueQueueSize Unsigned32, qosIfQueueSetThreshSet PolicyTagReference, qosIfQueuePriorityGroup INTEGER, qosIfQueueServiceDisc INTEGER, qosIfQueueDrainSize Unsigned32, qosIfQueueMinAbsBandwidth Unsigned64, qosIfQueueBandwidthAllocation INTEGER } qosIfQueuePrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "The index that uniquely identifies this row in the table, i.e., this PRI." ::= { qosIfQueueEntry 1 } qosIfQueueSetId OBJECT-TYPE SYNTAX PolicyTagId STATUS current DESCRIPTION "An index that uniquely identifies a specific queue set. The queue set identified by this value is associated with an interface set through the qosIfQueueSetAssignQueueSetId object in the qosIfQueueSetAssignTable. The individual queues that are members of this set all have the same value for this attribute (i.e., they have the same set ID)." ::= { qosIfQueueEntry 2 } qosIfQueueQueueSize OBJECT-TYPE SYNTAX Unsigned32 STATUS current DESCRIPTION "The size of the queue in bytes. Some devices set queue size in terms of packets. These devices must calculate the queue size in packets by assuming an average packet size suitable for the particular interface. [Page 20] DiffServ QoS Policy Information Base July 2000 Some devices have a fixed size buffer to be shared among all queues. These devices must allocate a fraction of the total buffer space to this queue calculated as the the ratio of the queue size to the sum of the queue sizes for the interface." ::= { qosIfQueueEntry 3 } qosIfQueueThreshSet OBJECT-TYPE SYNTAX PolicyTagReference PIB-TAG qosIfThresholdSetId STATUS current DESCRIPTION "The threshold set in the threshold set table that is to be used to configure the thresholds of this queue. The threshold set specifies how to configure the taildrop or RED thresholds for this queue. "The threshold set may contain less thresholds than the queue actually supports. In this case the queue is free to configure the extra thresholds any way it likes since no packets will ever be assigned to those thresholds. A value of zero indicates no threshold set is associated with the queue. In this case the queue is configured with a single threshold at 100% qosIfThresholdDropMethod of tailDrop." ::= { qosIfQueueEntry 4 } qosIfQueuePriorityGroup OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "This attribute specifies the priority group that the queue belongs to. Queues with a larger priority group number are given a higher priority than those with a smaller group number. For example, a queue in priority group 2 will be serviced (i.e., drained) before some other queue with a group number of 1. Queues with the same priority group number have the same priority. For these another scheduling discipline (other than priority scheduling) must be specified. This is done with the qosIfQueueServiceDisc attribute." [Page 21] DiffServ QoS Policy Information Base July 2000 ::= { qosIfQueueEntry 5 } qosIfQueueServiceDisc OBJECT-TYPE SYNTAX INTEGER { na(1), -- only one queue in group other(2), -- specified by augmented attributes fq(3), -- Fair Queuing wfq(4) -- Weighted Fair Queuing } STATUS current DESCRIPTION "This attribute identifies the service discipline used to service the queues in the same priority group. It must have the same value for all queues in the priority group. Several general purpose and well-known queuing disciplines are supported by this attribute. Queuing disciplines that differ from those that are supported by this attribute are specified by setting this attribute to other(1) and augmenting this PRC with additional attributes to specify the desired service discipline. As an example, an interface that is associated with a queue set supporting two priority queues and three queues that are serviced using WFQ would be modeled as follows: Id Q Discipline Q Drain Size Priority Group 22 na(1) - 3 23 na(1) - 2 24 wfq(3) 500 1 25 wfq(3) 350 1 26 wfq(3) 150 1 The queue set presented in this example would service all queued traffic in queue 22 first, followed by all of the queued traffic in queue 23. Next the queued traffic in queues 24 through 26 would be serviced in a round robin fashion with queue 24 receiving 50% of the available bandwidth, queue 25 receiving 35% of the available bandwidth and queue 26 receiving 15% of the available bandwidth. This example is presented for expository purposes and has been simplified accordingly. Note that, in this example, queues 24, 25 and 26 form a priority group. The qosIfQueueDrainSize attribute is used to determine the additional processing characteristics of the [Page 22] DiffServ QoS Policy Information Base July 2000 individual queues in a this priority group." ::= { qosIfQueueEntry 6 } qosIfQueueDrainSize OBJECT-TYPE SYNTAX Unsigned32 STATUS current DESCRIPTION "The maximum number of bytes that may be drained from the queue in one cycle. The percentage of the interface bandwidth allocated to this queue can be calculated from this attribute and the sum of the drain sizes of all the queues in a specific priority group in a queue set. This attribute when compared with the drain size of other queues, represents the minimum bandwidth available to this queue. The minimum bandwidth specified in absolute terms is specified by the attribute qosIfQueueMinAbsBandwidth. Which of these two applies is specified by the attribute qosIfQueueBandwidthAllocation." ::= { qosIfQueueEntry 7 } qosIfQueueMinAbsBandwidth OBJECT-TYPE SYNTAX Unsigned64 STATUS current DESCRIPTION "The maximum interface bandwidth that is available for consumption when servicing this queue. This bandwidth is specified in terms of bits per second. This attribute represents the absolute bandwidth that is available to a given queue. The relative bandwidth that is available to a given queue, with respect to other queues with which it is associated, is specified by the attribute qosIfQueueDrainSize. Which of these two applies is specified by the attribute qosIfQueueBandwidthAllocation. ::= { qosIfQueueEntry 8 } qosIfQueueBandwidthAllocation OBJECT-TYPE SYNTAX INTEGER { absolute(1), --use qosIfQueueMinAbsBandwidth relative(2) --use qosIfQueueDrainSize } [Page 23] DiffServ QoS Policy Information Base July 2000 STATUS current DESCRIPTION "This attribute specifies whether to configure the queue for an absolute bandwidth limit or one that is relative to other queues of the priority group. i.e., whether to configure the queue using qosIfQueueMinAbsBandwidth or qosIfQueueDrainSize." If some queues have their bandwidth requirement specified in absolute terms and others in relative terms then the requirements of the absolute specification is met first. That is, the drain sizes of the absolute queues must be calculated based on the interface speed so as to ensure the absolute bandwidth requirement. ::= { qosIfQueueEntry 9 } -- -- Interface Threshold Table -- -- The Interface Threshold Table enumerates the individual thresholds -- and groups them into sets that can be applied to queues. -- Configuration of individual thresholds and hence the threshold sets -- of individual queues, id done through this table. -- qosIfThresholdTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfThresholdEntry PIB-ACCESS install, 6 STATUS current DESCRIPTION "Contains configuration information for the individual thresholds of the threshold sets." ::= { qosIfParameters 6 } qosIfThresholdEntry OBJECT-TYPE SYNTAX QosIfThresholdEntry STATUS current DESCRIPTION "A conceptual row in the qosIfThresholdTable. Each row identifies a specific threshold within a given set and contains detailed information about the [Page 24] DiffServ QoS Policy Information Base July 2000 threshold. Threshold sets are associated with a queue set through the qosIfQueueThreshSet attribute of the qosIfQueueTable." INDEX { qosIfThresholdPrid } UNIQUENESS { qosIfThresholdSetId, qosIfThresholdDropMethod, qosIfThresholdMinThresh, qosIfThresholdMaxThresh } ::= { qosIfThresholdSetTable 1 } QosIfThresholdSetEntry ::= SEQUENCE { qosIfThresholdPrid PolicyInstanceId, qosIfThresholdSetId PolicyTagId, qosIfThresholdDropMethod INTEGER, qosIfThresholdMinThresh INTEGER, qosIfThresholdMaxThresh INTEGER } qosIfThresholdPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "The index that uniquely identifies this row in the table, i.e., this PRI." ::= { qosIfThresholdEntry 1 } qosIfThresholdSetId OBJECT-TYPE SYNTAX PolicyTagId STATUS current DESCRIPTION "An index that uniquely identifies a specific threshold set. The individual thresholds that are members of this set all have the same value for this attribute (i.e., they have the same set ID)." ::= { qosIfThresholdEntry 2 } qosIfThresholdDropMethod OBJECT-TYPE SYNTAX INTEGER { other(1), tailDrop(2), randomDrop(3) } [Page 25] DiffServ QoS Policy Information Base July 2000 STATUS current DESCRIPTION "The drop method to apply to packets exceeding the threshold. If the mechanism is other then another policy may be specified by an additional attribute augmenting this table." ::= { qosIfThresholdEntry 3 } qosIfThresholdMinThresh OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "The queue depth, in bytes, below which no packets are dropped. If the queue depth is above this value and below the value of qosIfThresholdMaxThresh then packets assigned to this threshold are dropped randomly by the random drop process if random drop is in effect. If tail drop is in effect, this attribute has no relevance." ::= { qosIfThresholdEntry 4 } qosIfThresholdMaxThresh OBJECT-TYPE SYNTAX INTEGER STATUS current DESCRIPTION "The queue depth, in bytes, above which all packets assigned to this threshold are dropped." ::= { qosIfThresholdEntry 5 } -- -- DSCP to Queue and Threshold Mapping Table -- -- Supports the assignment of DSCPs to queues and thresholds for each -- interface type -- qosIfDscpMapTable OBJECT-TYPE SYNTAX SEQUENCE OF QosIfDscpMapEntry PIB-ACCESS install, 6 STATUS current DESCRIPTION "Assigns DSCP values to queues and thresholds for an arbitrary [Page 26] DiffServ QoS Policy Information Base July 2000 DSCP map. This map can then be assigned to various interface and role combination pairs." ::= { qosIfParameters 7 } qosIfDscpMapEntry OBJECT-TYPE SYNTAX QosIfDscpMapEntry STATUS current DESCRIPTION "An instance of the qosIfDscpMap class." INDEX { qosIfDscpMapPrid } UNIQUENESS { qosIfDscpMapMapId, qosIfDscpMapDscp } ::= { qosIfDscpMapTable 1 } QosIfDscpMapEntry ::= SEQUENCE { qosIfDscpMapPrid PolicyInstanceId, qosIfDscpMapMapId PolicyTagId, qosIfDscpMapDscp Dscp, qosIfDscpMapQueue PolicyReferenceId, qosIfDscpMapThresh PolicyReferenceId } qosIfDscpMapPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An index that is used to uniquely identify the instance of the qosIfDscpMap class." ::= { qosIfDscpMapEntry 1 } qosIfDscpMapMapId OBJECT-TYPE SYNTAX PolicyTagId STATUS current DESCRIPTION "An integer that identifies the DSCP map to which this PRI belongs." ::= { qosIfDscpMapEntry 2 } qosIfDscpMapDscp OBJECT-TYPE SYNTAX Dscp [Page 27] DiffServ QoS Policy Information Base July 2000 STATUS current DESCRIPTION "The DSCP that is being assigned to a queue and threshold by this PRI." ::= { qosIfDscpMapEntry 3 } qosIfDscpMapQueue OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosIfQueueTable STATUS current DESCRIPTION "This attribute maps the DSCP specified by qosIfDscpMapDscp to the queue identified by qosIfQueuePrid in qosIfQueueTable. For a given DSCP map, all the queues must belong to a single queue set." ::= { qosIfDscpMapEntry 4 } qosIfDscpMapThresh OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosIfThresholdTable STATUS current DESCRIPTION "This attribute maps the DSCP specified by qosIfDscpMapDscp to the threshold identified by qosIfThresholdId in qosIfThresholdTable." The threshold set to which this threshold belongs must be assigned to the queue specified by qosIfDscpMapQueue." ::= { qosIfDscpMapEntry 5 } -- -- QoS Meter Table -- -- The QoS Meter Table contains metering specifications that -- can be used to provide an acceptable flow bandwidth -- dimension to the Target table. -- qosMeter OBJECT IDENTIFIER ::= { qosPolicyGenPibClasses 2 } [Page 28] DiffServ QoS Policy Information Base July 2000 qosMeterTable OBJECT-TYPE SYNTAX SEQUENCE OF QosMeterEntry PIB-ACCESS install, 10 STATUS current DESCRIPTION "Contains the current set of configured meters. The meters are associated with a classifier during operation through the QoS Target Table." INSTALL-ERRORS { invalidCommittedData(1), invalidPeakData(2) } ::= { qosMeter 1 } qosMeterEntry OBJECT-TYPE SYNTAX QosMeterEntry STATUS current DESCRIPTION "General metering definitions. Each entry specifies an instance of the qosMeter class which specifies metering information in terms of traffic stream bandwidth parameters. An entry can thus be used to support traffic metering based on the specified service level specification." INDEX { qosMeterPrid } UNIQUENESS { qosMeterDataSpecification, qosMeterCommittedRate, qosMeterCommittedBurst, qosMeterPeakRate, qosMeterPeakBurst, qosMeterHighConfAction, qosMeterMedConfAction, qosMeterLowConfAction } ::= { qosMeterTable 1 } QosMeterEntry ::= SEQUENCE { qosMeterPrid PolicyInstanceId, qosMeterDataSpecification INTEGER, qosMeterCommittedRate Unsigned32, qosMeterCommittedBurst Unsigned32, qosMeterPeakRate Unsigned32, qosMeterPeakBurst Unsigned32, [Page 29] DiffServ QoS Policy Information Base July 2000 qosMeterHighConfAction PolicyReferenceId, qosMeterMedConfAction PolicyReferenceId, qosMeterLowConfAction PolicyReferenceId } qosMeterPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies the instance of the qosMeter class. Meters are associated with specific flows using this attribute through the qosTargetMeter attribute in the QoS Target class." ::= { qosMeterEntry 1 } qosMeterDataSpecification OBJECT-TYPE SYNTAX INTEGER { noMeterData(1), -- no metering reqd committedData(2), -- committed rate only peakData(3) -- committed and peak } STATUS current DESCRIPTION "Specifies the metering data, and thus the actions, that are defined in a given entry. A value of noMeterData(1) indicates that no flow metering is necessary. All flows associated with this meter entry are considered to be at a high level of conformance. A value of committedData(2) indicates that committed rate and committed burst information has been specified and will be applied to associated flows. No peak rate and burst information has been specified meaning that two levels of conformance (high, medium) are supported. A value of peakData(3) indicates that peak rate and peak burst information has been provided in addition to the committed rate and committed burst information. All provided information will be applied to associated flows meaning that three levels of conformance (high, medium, low) are supported." [Page 30] DiffServ QoS Policy Information Base July 2000 ::= { qosMeterEntry 2 } qosMeterCommittedRate OBJECT-TYPE SYNTAX Unsigned32 (0..'ffffffff'h) STATUS current DESCRIPTION "This object represents the committed information rate (CIR) against which associated traffic streams will be metered. The CIR specifies the rate at which incoming traffic can arrive to be considered to be at a high level of conformance. Typically, this value specifies the rate at which tokens are added to a token bucket used to meter received flows. This object specifies a rate in bytes per second units such that, for example, a value of 100 equates to a committed information rate of 100 bytes per second. Committed rate (and burst) information must be present if the qosMeterDataSpecification object has the value committedData(2) or peakRate(3). This, in turn, requires that at least both high and medium conformance actions be specified." ::= { qosMeterEntry 3 } qosMeterCommittedBurst OBJECT-TYPE SYNTAX Unsigned32 (0..'ffffffff'h) STATUS current DESCRIPTION "This object represents the committed burst size (CBS) against which associated traffic streams will be metered. The CBS specifies the maximum burst size that is supported for flows to be considered to be at a high level of conformance. Typically, this value represents the maximum number of tokens in a token bucket. This object specifies flow data in bytes per second units such that, for example, a value of 100 equates to a committed information rate of 100 bytes per second. Committed burst (and rate) information must be present if the qosMeterDataSpecification object has the value [Page 31] DiffServ QoS Policy Information Base July 2000 committedData(2) or peakRate(3). This, in turn, requires that at least both high and medium conformance actions be specified." ::= { qosMeterEntry 4 } qosMeterPeakRate OBJECT-TYPE SYNTAX Unsigned32 (0..'ffffffff'h) STATUS current DESCRIPTION "This object represents the peak information rate (PIR) against which associated traffic streams will be metered. The PIR specifies the rate at which incoming traffic can arrive to be considered to be at a medium level of conformance. Typically, this value specifies the rate at which tokens are added to a token bucket used to meter received flows. This object specifies a rate in bytes per second units such that, for example, a value of 100 equates to a committed information rate of 100 bytes per second. Peak rate (and burst) information must be present if the qosMeterDataSpecification object has the value peakData(3). This, in turn, requires that high, medium and low conformance actions be specified." ::= { qosMeterEntry 5 } qosMeterPeakBurst OBJECT-TYPE SYNTAX Unsigned32 (0..'ffffffff'h) STATUS current DESCRIPTION "This object represents the peak burst size (PBS) against which associated traffic streams will be metered. The CBS specifies the maximum burst size that is supported for flows to be considered to be at a medium level of conformance. Typically, this value represents the maximum number of tokens in a token bucket. This object specifies flow data in bytes per second units such that, for example, a value of 100 equates to a committed information rate of 100 bytes per second. [Page 32] DiffServ QoS Policy Information Base July 2000 Peak burst (and rate) information must be present if the qosMeterDataSpecification object has the value peakData(3). This, in turn, requires that high, medium and low conformance actions be specified." ::= { qosMeterEntry 6 } qosMeterHighConfAction OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosActionTable STATUS current DESCRIPTION "This attribute identifies the action that is to be initiated for flows that are determined to have a high level of conformance with regard to metering criteria being applied to the flow. Actions must be defined in the qosActionTable prior to being referenced by this attribute. A valid value for this attribute must always be provided." ::= { qosMeterEntry 7 } qosMeterMedConfAction OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosActionTable STATUS current DESCRIPTION "This attribute identifies the action that is to be initiated for flows that are determined to have a medium level of conformance with regard to metering criteria being applied to the flow. Actions must be defined in the qosActionTable prior to being referenced by this attribute. A valid value for this attribute must be provided if the value of the associated qosMeterDataSpecification object is committedRate(2) or peakRate(3)." ::= { qosMeterEntry 8 } qosMeterLowConfAction OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosActionTable STATUS current [Page 33] DiffServ QoS Policy Information Base July 2000 DESCRIPTION "This attribute identifies the action that is to be initiated for flows that are determined to have a low level of conformance with regard to metering criteria being applied to the flow. Actions must be defined in the qosActionTable prior to being referenced by this attribute. A valid value for this attribute must be provided if the value of the associated qosMeterDataSpecification object is peakRate(3)." ::= { qosMeterEntry 9 } -- -- The Generic QoS Action Group -- qosAction OBJECT IDENTIFIER ::= { qosPolicyGenPibClasses 3 } -- -- The QoS Action Table -- -- The QoS Action Table describes actions that are associated with -- specific meters through the QoS Target Table. An action specifies -- whether to mark, drop, or leave the packet unchaged. qosActionTable OBJECT-TYPE SYNTAX SEQUENCE OF QosActionEntry PIB-ACCESS install, 4 STATUS current DESCRIPTION "Contains the current set of configured actions. The actions are associated with meters and interfaces during operation." ::= { qosAction 1 } qosActionEntry OBJECT-TYPE SYNTAX QosActionEntry STATUS current DESCRIPTION "General action definitions. Each entry specifies an instance [Page 34] DiffServ QoS Policy Information Base July 2000 of the qosAction class which describes (potentially) several distinct action attributes. An instance of this class can not be deleted while it is being referenced in a target instance in another class. This class may be extended with actions that apply to specific QoS policies using augmentation." INDEX { qosActionPrid } UNIQUENESS { qosActionDrop, qosActionUpdateDSCP } ::= { qosActionTable 1 } QosActionEntry ::= SEQUENCE { qosActionPrid PolicyInstanceId, qosActionAction INTEGER, qosActionUpdateDSCP Dscp, } qosActionPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies the instance of the QoS Action class. Class instances may not be contiguous. Actions are associated with Target instances in other classes (e.g., the QoS Meter class) using this attribute." ::= { qosActionEntry 1 } qosActionAction OBJECT-TYPE SYNTAX INTEGER { drop(1), mark(2), unchange(3) -- don't alter the DSCP } STATUS current DESCRIPTION "This action attribute specifies the action to be taken on the packet. Prior to discarding a packet, other actions that have been specified should be performed if they make protocol [Page 35] DiffServ QoS Policy Information Base July 2000 sense. For example, requests for traffic mirroring (if such an action is supported by a device) should be honored. However, updating protocol header values will typically not be necessary." ::= { qosActionEntry 2 } qosActionUpdateDSCP OBJECT-TYPE SYNTAX Dscp STATUS current DESCRIPTION "This attribute specifies the value to write into the DSCP field of the packet if the action to be taken is to mark the packet. ::= { qosActionEntry 3 } -- -- The QoS Target Table -- -- The QoS Target Table supports the association of filters, -- interfaces, meters and actions. It allows filter instances, as -- defined in various filter classes, to be associated with specific -- interfaces/flow direction (based on interface role combination and -- traffic direction) and actions to be performed based on traffic -- classification and metering. Furthermore, it allows heterogeneous -- filter definition class instances to be applied to the same -- interface group in a prescribed order of precedence. -- qosTargetTable OBJECT-TYPE SYNTAX SEQUENCE OF QosTargetEntry PIB-ACCESS install, 7 STATUS current DESCRIPTION "A class that applies a set of filters to interfaces specifying, for each interface, the precedence order of the filters with respect to other filters applied to the same interface and, for each filter, the meter to apply to packets accepted by the filter. Interfaces are specified abstractly in terms of interface roles. This class may contain filters that specify different types of traffic classification." [Page 36] DiffServ QoS Policy Information Base July 2000 INSTALL-ERRORS { priPrecedenceConflict(1) -- precedence conflict detected } ::= { qosAction 2 } qosTargetEntry OBJECT-TYPE SYNTAX QosTargetEntry STATUS current DESCRIPTION "An instance of the qosTarget class. Instance creation may be prohibited based on the status of certain class attributes which must exist prior to class instantiation." INDEX { qosTargetPrid } UNIQUENESS { qosTargetFilterId, qosTargetInterfaceRoles, qosTargetInterfaceDirection, qosTargetOrder } ::= { qosTargetTable 1 } QosTargetEntry ::= SEQUENCE { qosTargetPrid PolicyInstanceId, qosTargetFilterId PolicyTagReference, qosTargetInterfaceRoles RoleCombination, qosTargetInterfaceDirection INTEGER, qosTargetOrder Unsigned32, qosTargetMeter PolicyReferenceId } qosTargetPrid OBJECT-TYPE SYNTAX PolicyInstanceId STATUS current DESCRIPTION "An arbitrary integer index that uniquely identifies the instance of the QoS Target class." ::= { qosTargetEntry 1 } qosTargetFilterId OBJECT-TYPE SYNTAX PolicyTagReference PIB-TAG frwkFilterGroupDefinitionId STATUS current DESCRIPTION [Page 37] DiffServ QoS Policy Information Base July 2000 "This attribute identifies the filter group that is associated with this target. This filter group must be specified in frwkFilterGroupDefinitionTable and the specific group is identified by the value of this attribute." ::= { qosTargetEntry 2 } qosTargetInterfaceRoles OBJECT-TYPE SYNTAX RoleCombination STATUS current DESCRIPTION "The interfaces to which this target applies specified in terms of a set of roles. The role combination specified by this attribute must exist in the frwkIfCapSetRoleComboTable prior to being association with an instance of this class." ::= { qosTargetEntry 3 } qosTargetInterfaceDirection OBJECT-TYPE SYNTAX INTEGER { in(1), out(2) } STATUS current DESCRIPTION "The direction of packet flow at the interface in question to which this filter applies." ::= { qosTargetEntry 4 } qosTargetOrder OBJECT-TYPE SYNTAX Unsigned32 STATUS current DESCRIPTION "An integer that determines the precedence order of this filter in the list of filters applied to interfaces of the specified role combination. A filter with a given precedence order is positioned in the list before one with a higher-valued precedence order. As an example, consider the following Target association: Index IfRoleCombo IfDirection FilterId Order 14 'eth1000+L2+L3' 'in' 8 1 [Page 38] DiffServ QoS Policy Information Base July 2000 15 'eth1000+L2+L3' 'in' 3 2 16 'eth1000+L2+L3' 'in' 12 3 17 'eth1000+L2+L3' 'in' 6 4 18 'eth1000+L2+L3' 'in' 21 5 Five distinct filter specifications form a Target association (e.g., based on the specified interface role combination and direction attributes) with a prescribed order of evaluation. The FilterId attributes identify the filter definition instances. Precedence values within an association must be unique otherwise instance installation will be prohibited and an error value will be returned." ::= { qosTargetEntry 5 } qosTargetMeter OBJECT-TYPE SYNTAX PolicyReferenceId PIB-REFERENCE qosMeterTable STATUS current DESCRIPTION "This attribute identifies the meter that is associated with this QoS Target instance. Meters are defined in the qosMeterTable. The corresponding instance in the qosMeter class (i.e., the class instance where the qosMeterPrid is equal to the value of this object) must exist prior to being associated with a Target entry." ::= { qosTargetEntry 6 } -- -- Conformance Section -- qosPolicyIpPibConformance OBJECT IDENTIFIER ::= { qosPolicyIpPib 3 } qosPolicyIpPibCompliances OBJECT IDENTIFIER ::= { qosPolicyIpPibConformance 1 } qosPolicyIpPibGroups OBJECT IDENTIFIER ::= { qosPolicyIpPibConformance 2 } [Page 39] DiffServ QoS Policy Information Base July 2000 qosPolicyIpPibCompliance MODULE-COMPLIANCE STATUS current DESCRIPTION "Describes the requirements for conformance to the QoS Policy IP PIB." MODULE -- this module MANDATORY-GROUPS { qosIfSchedulingCapsGroup, qosIfQueueSetAssignGroup, qosIfQueueGroup, qosMeterGroup, qosActionGroup, qosTargetGroup } OBJECT qosIfQueueSetAssignName MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueSetAssignRoles MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueSetAssignQueueSetId MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueSetId MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueQueueSize MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueSetThreshSet MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueuePriorityGroup MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueServiceDisc MIN-ACCESS notify DESCRIPTION "Install support is not required." [Page 40] DiffServ QoS Policy Information Base July 2000 OBJECT qosIfQueueDrainSize MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueMinAbsBandwidth MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfQueueBandwidthAllocation MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterDataSpecification MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterCommittedRate MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterCommittedBurst MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterPeakRate MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterPeakBurst MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterHighConfAction MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterMedConfAction MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosMeterLowConfAction MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosActionDrop [Page 41] DiffServ QoS Policy Information Base July 2000 MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosActionUpdateDSCP MIN-ACCESS notify DESCRIPTION "Install support is not required." GROUP qosIfClassificationCapsGroup DESCRIPTION "The qosIfClassificationCapsGroup is mandatory if IP datagram classification is supported." GROUP qosIfMeteringCapsGroup DESCRIPTION "The qosIfMeteringCapsGroup is mandatory if metering and shaping capabilities are supported." GROUP qosIfThresholdGroup DESCRIPTION "The qosIfThresholdGroup is mandatory if queue-based thresholds are supported and if the qosIfDscpMapGroup is supported." OBJECT qosIfThresholdSetId MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfThresholdDropMethod MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfThresholdMinThresh MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfThresholdMaxThresh MIN-ACCESS notify DESCRIPTION "Install support is not required." GROUP qosIfDscpAssignGroup DESCRIPTION "The qosIfDscpAssignGroup is mandatory if traffic queue assignment based on DSCP is supported." OBJECT qosIfDscpAssignName [Page 42] DiffServ QoS Policy Information Base July 2000 MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfDscpAssignRoles MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfDscpAssignDscpMap MIN-ACCESS notify DESCRIPTION "Install support is not required." GROUP qosIfDscpMapGroup DESCRIPTION "The qosIfDscpMapGroup is mandatory if the qosIfDscpAssignGroup is supported." OBJECT qosIfDscpMapMapId MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfDscpMapDscp MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfDscpMapQueue MIN-ACCESS notify DESCRIPTION "Install support is not required." OBJECT qosIfDscpMapThresh MIN-ACCESS notify DESCRIPTION "Install support is not required." ::= { qosPolicyIpPibCompliances 1 } qosIfClassificationCapsGroup OBJECT-GROUP OBJECTS { qosIfClassificationCaps } STATUS current DESCRIPTION "Objects from the qosIfClassificationCapsTable." ::= { qosPolicyIpPibGroups 3 } qosIfMeteringCapsGroup OBJECT-GROUP [Page 43] DiffServ QoS Policy Information Base July 2000 OBJECTS { qosIfMeteringCaps } STATUS current DESCRIPTION "Objects from the qosIfMeteringCapsTable." ::= { qosPolicyIpPibGroups 4 } qosIfSchedulingCapsGroup OBJECT-GROUP OBJECTS { qosIfSchedulingCapsMaxQueues, qosIfSchedulingCapsMaxThresholds, qosIfSchedulingCapsMaxPriorities, qosIfSchedulingCapsServiceDisc, qosIfSchedulingCapsMinQueueSize, qosIfSchedulingCapsMaxQueueSize, qosIfSchedulingCapsTotalQueueSize, qosIfSchedulingCapsWredCapable } STATUS current DESCRIPTION "Objects from the qosIfSchedulingCapsTable." ::= { qosPolicyIpPibGroups 5 } qosIfQueueSetAssignGroup OBJECT-GROUP OBJECTS { qosIfQueueSetAssignName, qosIfQueueSetAssignRoles, qosIfQueueSetAssignQueueSetId, } STATUS current DESCRIPTION "Objects from the qosIfQueueSetAssignTable." ::= { qosPolicyIpPibGroups 6 } qosIfQueueGroup OBJECT-GROUP OBJECTS { qosIfQueueSetId, qosIfQueueQueueSize, qosIfQueueSetThreshSet, qosIfQueuePriorityGroup, qosIfQueueServiceDisc, [Page 44] DiffServ QoS Policy Information Base July 2000 qosIfQueueDrainSize, qosIfQueueMinAbsBandwidth, qosIfQueueBandwidthAllocation } STATUS current DESCRIPTION "Objects from the qosIfQueueTable." ::= { qosPolicyIpPibGroups 7 } qosIfThresholdGroup OBJECT-GROUP OBJECTS { qosIfThresholdSetId, qosIfThresholdDropMethod, qosIfThresholdMinThresh, qosIfThresholdMaxThresh } STATUS current DESCRIPTION "Objects from the qosIfThresholdTable." ::= { qosPolicyIpPibGroups 8 } qosIfDscpAssignGroup OBJECT-GROUP OBJECTS { qosIfDscpAssignName, qosIfDscpAssignRoles, qosIfDscpAssignDscpMap } STATUS current DESCRIPTION "Objects from the qosIfDscpAssignTable." ::= { qosPolicyIpPibGroups 9 } qosIfDscpMapGroup OBJECT-GROUP OBJECTS { qosIfDscpMapMapId, qosIfDscpMapDscp, qosIfDscpMapQueue, qosIfDscpMapThresh } STATUS current DESCRIPTION "Objects from the qosIfDscpMapTable." [Page 45] DiffServ QoS Policy Information Base July 2000 ::= { qosPolicyIpPibGroups 10 } qosMeterGroup OBJECT-GROUP OBJECTS { qosMeterDataSpecification, qosMeterCommittedRate, qosMeterCommittedBurst, qosMeterPeakRate, qosMeterPeakBurst, qosMeterHighConfAction, qosMeterMedConfAction, qosMeterLowConfAction } STATUS current DESCRIPTION "Objects from the qosMeterTable." ::= { qosPolicyIpPibGroups 11 } qosActionGroup OBJECT-GROUP OBJECTS { qosActionDrop, qosActionUpdateDSCP } STATUS current DESCRIPTION "Objects from the qosActionTable." ::= { qosPolicyIpPibGroups 12 } qosTargetGroup OBJECT-GROUP OBJECTS { qosTargetFilterId, qosTargetFilterType, qosTargetInterfaceRoles, qosTargetInterfaceDirection, qosTargetOrder, qosTargetMeter } STATUS current DESCRIPTION "Objects from the qosTargetTable." ::= { qosPolicyIpPibGroups 13 } [Page 46] DiffServ QoS Policy Information Base July 2000 END [Page 47] DiffServ QoS Policy Information Base July 2000 7. Security Considerations The information contained in a PIB when transported by the COPS protocol [COPS-PR] may be sensitive, and its function of provisioning a PEP requires that only authorized communication take place. The use of IPSEC between PDP and PEP, as described in [COPS], provides the necessary protection against these threats. 8. Intellectual Property Considerations The IETF is being notified of intellectual property rights claimed in regard to some or all of the specification contained in this document. For more information consult the online list of claimed rights. 9. Authors' Addresses Michael Fine Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA Phone: +1 408 527 8218 Email: mfine@cisco.com Keith McCloghrie Cisco Systems, Inc. 170 West Tasman Drive San Jose, CA 95134-1706 USA Phone: +1 408 526 5260 Email: kzm@cisco.com John Seligson Nortel Networks, Inc. 4401 Great America Parkway Santa Clara, CA 95054 USA Phone: +1 408 495 2992 Email: jseligso@nortelnetworks.com Kwok Ho Chan Nortel Networks, Inc. 600 Technology Park Drive Billerica, MA 01821 USA Phone: +1 978 288 8175 Email: khchan@nortelnetworks.com [Page 48] DiffServ QoS Policy Information Base July 2000 Scott Hahn Intel 2111 NE 25th Avenue Hillsboro, OR 97124 USA Phone: +1 503 264 8231 Email: scott.hahn@intel.com Andrew Smith Fax: +1 415 345 1827 Email: ah_smith@pacbell.net Francis Reichmeyer IPHighway Inc. Parker Plaza, 16th Floor 400 Kelby St. Fort-Lee, NJ 07024 Phone: (201) 585-0800 Email: FranR@iphighway.com 10. References [COPS] Boyle, J., Cohen, R., Durham, D., Herzog, S., Rajan, R., and A. Sastry, "The COPS (Common Open Policy Service) Protocol" RFC 2748, January 2000. [COPS-PR] K. Chan, D. Durham, S. Gai, S. Herzog, K. McCloghrie, F. Reichmeyer, J. Seligson, A. Smith, R. Yavatkar, "COPS Usage for Policy Provisioning," draft-ietf-rap-cops-pr-03.txt, July 2000. [SPPI] K. McCloghrie, et.al., "Structure of Policy Provisioning Information," draft-ietf-rap-sppi-01.txt, July 2000. [DSARCH] M. Carlson, W. Weiss, S. Blake, Z. Wang, D. Black, and E. Davies, "An Architecture for Differentiated Services", RFC 2475, December 1998 [FR-PIB] M. Fine, K. McCloghrie, J. Seligson, K. Chan, S. Hahn, A. Smith, F. Reichmeyer "Framework Policy Information Base", Internet Draft , July 2000 [POLICY] M. Stevens, W. Weiss H. Mahon, B. Moore, J. Strassner, G. Waters, A. Westerinen, J. Wheeler, "Policy Framework", [Page 49] DiffServ QoS Policy Information Base July 2000 draft-ietf-policy-framework-00.txt, September 1999. [RAP-FRAMEWORK] R. Yavatkar, D. Pendarakis, "A Framework for Policy-based Admission Control", draft-ietf-rap-framework-03.txt, April 1999. [SNMP-SMI] K. McCloghrie, D. Perkins, J. Schoenwaelder, J. Case, M. Rose and S. Waldbusser, "Structure of Management Information Version 2 (SMIv2)", STD 58, RFC 2578, April 1999. [MODEL] Y. Bernet, A. Smith, S. Blake, D. Grossman "A Conceptual Model for DiffServ Routers", draft-ietf-diffserv-model-03.txt, May 2000. [Page 50] DiffServ QoS Policy Information Base July 2000 Table of Contents 1 Glossary ........................................................ 2 2 Introduction .................................................... 2 3 DiffServ PIB Concepts ........................................... 2 3.1 Filters, Filter Groups and Classifiers ........................ 2 3.2 Applying QoS Policy Using Targets ............................. 3 3.3 Interface Modeling with Queue Sets ............................ 4 3.3.1 Queue Scheduling ............................................ 4 3.3.2 Assigning Packets To Queues and Thresholds .................. 5 3.3.3 Hierarchies of Queues ....................................... 5 4 Summary of the DiffServ PIB ..................................... 5 5 PIB Operational Overview ........................................ 6 6 PIB Definitions ................................................. 8 6.1 The DiffServ Base PIB ......................................... 8 7 Security Considerations ......................................... 48 8 Intellectual Property Considerations ............................ 48 9 Authors' Addresses .............................................. 48 10 References ..................................................... 49 [Page 51]