Service ingress QoS policies

Context

config>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates or edits the ingress policy. The ingress policy defines the Service Level Agreement (SLA) enforcement that service packets receive as they ingress a SAP; the SAP can be configured on an access port or hybrid port. SLA enforcement is accomplished through the definition of meters or queues (depends on the support available on a platform) that have Forwarding Class (FC), Committed Information Rate (CIR), Peak Information Rate (PIR), Committed Burst Size (CBS), and Maximum Burst Size (MBS) characteristics. The simplest policy defines a single queue/meter that all ingress traffic flows through. Complex policies have multiple meters/queues combined with classification entries that indicate which meter/queue a packet flows through.

Policies in effect are templates that can be applied to multiple services as long as the scope of the policy is template. Meters defined in the policy are not instantiated until a policy is applied to a service SAP.

Depending on the support available on different 7210 SAS platforms, SAP ingress policies can be defined with either dot1p as the match criteria or IP DSCP as the match criteria or IP headers as the match criteria or MAC headers or both as the match criteria. On the 7210 SAS, the user has an option to use dot1p, IP DSCP, IPv4/IPv6 criteria and MAC criteria.

Only one service ingress policy can be provisioned. The SAP ingress policy with policy-id 1 is a system-defined policy applied to services when no other policy is explicitly specified. The system SAP ingress policy can be modified but not deleted. The no sap-ingress command restores the factory default settings when used on policy-id 1. See Default SAP-ingress policy for more information about the default SAP Ingress policy for different platforms.

Any changes made to the existing policy, using any of the sub-commands are applied immediately to all services where this policy is applied. For this reason, when many changes are required on a policy, it is recommended that the policy be copied to a work area policy ID. That work-in-progress policy can be modified until complete and then written over the original policy ID. Use the config qos copy command to maintain policies in this manner.

The no form of this command deletes the SAP ingress policy. A policy cannot be deleted until it is removed from all services where it is applied. The system default SAP ingress policy is a special case; the no command restores the factory defaults to policy ID 1.

Parameters

policy-id

Specifies the policy.

Values

1 to 65535

create

Keyword to create a sap ingress policy.

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command associates a dot1p classification policy, which contains entries used to map traffic received on a hybrid port or SAP to a forwarding class and profile state, based on the dot1p bits in the packet.

When it is defined in a service ingress QoS policy and associated with an access SAP ingress, a packet received on the SAP is used to match with the dot1p values defined in this policy. If a match is found, the corresponding forwarding class and profile are assigned to the packet.

The no form of this command disables use of dot1p classification policy.

Parameters

policy-id

Specifies the policy.

Values

1 to 65535

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command associates an IP DSCP classification policy, which contains entries used to map traffic received on a SAP to a forwarding class and profile state, based on the IP DSCP bits in the packet.

When it is defined in a service ingress QoS policy and associated with an access SAP ingress, a packet received on the SAP is used to match with the IP DSCP values defined in this policy. If a match is found, the corresponding forwarding class and profile are assigned to the packet.

The no form of this command disables use of DSCP classification policy.

Parameters

policy-id

Specifies the policy ID that uniquely identifies the policy.

Values

1 to 65535

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the Service Ingress QoS policy scope as exclusive or template.

The no form of this command sets the scope of the policy to the default.

Default

template

Parameters

exclusive

Specifies that the policy can only be applied to one SAP. If a policy with an exclusive scope is assigned to a second SAP an error message is generated. If the policy is removed from the exclusive SAP, it becomes available for assignment to another exclusive SAP.

template

Specifies that the policy can be applied to multiple SAPs on the router.

Default QoS policies are configured with template scopes. An error is generated when the template scope parameter to exclusive scope on default policies is modified.

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the default forwarding class for the policy. If an ingress packet does not match a higher priority (more explicit) classification command, the default forwarding class is associated with the packet. Unless overridden by an explicit forwarding class classification rule, all packets received on an ingress SAP using this ingress QoS policy are classified to the default forwarding class.

The default forwarding class is best effort (be). The default-fc settings are displayed in the show configuration and save output regardless of inclusion of the detail keyword.

Default

be

Parameters

fc

Specifies the forwarding class name for the queue/meter. The value for fc must be one of the predefined forwarding classes in the system.

profile {in | out}

Specifies that packets matching the classification entry are explicitly classified to either in-profile or out-of-profile. The remove the profile action for an classification entry, the action command must be re-executed without the profile action defined. The profile assigned by the user is used subsequently to determine the slope to use at the ingress and egress queuing points and is used for egress marking (if enabled).

in

Specifies that any packets matching the classification rule are treated as in-profile. Mutually exclusive to the out parameter following the profile classification action keyword.

out

Specifies that any packets matching the classification rule are treated as out-of-profile. Mutually exclusive to the in parameter following the profile classification action keyword.

Context

config>qos>sap-ingress>fc

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command enables DEI based classification. When enabled, the packet classified to this FC the DEI bit is used to determine the ingress profile for the packet. Packets received with DEI bit set to zero are treated as in-profile and packets with DEI bit set to one are treated as out-of-profile packets.

When DEI based classification is enabled, it overrules the profile values specified in the classification entry used to assign the FC.

The no form of this command disables use of DEI bit for classification of packets.

Default

no use-dei

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates a class instance of the forwarding class FC name. After the fc-name is created, classification actions can be applied and can be used in match classification criteria.

The no form of this command removes all the explicit queue mappings for fc-name forwarding types. The queue mappings revert to the default meters for fc-name.

Parameters

fc-name

Specifies the forwarding class name for the queue. The value of the fc-name must be one of the predefined forwarding classes for the system.

Values

be, l2, af, l1, h2, ef, h1, nc

create

Keyword to create a forwarding class.

Context

config>qos>sap-ingress>fc

config>qos>network>fc

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command overrides the default multicast forwarding type queue mapping for fc fc-name. The specified queue ID must exist within the policy as a multipoint queue before the mapping can be made. After the forwarding class mapping is executed, all broadcast, unknown unicast, and multicast (BUM) traffic on a SAP or a access-uplink port using this policy is forwarded using the queue ID.

The no form of this command removes the association of the FC and the queue. When the no form is executed, the BUM traffic uses the default multicast forwarding type queue.

Default

1

Parameters

queue-id

Specifies the queue ID.

Values

1 to 8

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create or edit policy entries that specify IP criteria used to match supported fields from the IP packet header, including IP DSCP.

IP criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.

The 7210 SAS implementation exits on the first match found and executes the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.

The no form of this command deletes all the entries specified under this node. When IP criteria entries are removed from a SAP ingress policy, the IP criteria is removed from all services where that policy is applied.

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create or edit policy entries that specify IPv6 criteria such as IP quintuple lookup or DiffServ code point.

IPv6 criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.

The 7210 SAS implementation exits on the first match found and execute the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.

The no form of this command deletes all the entries specified under this node. When ipv6-criteria entries are removed from a SAP ingress policy, the ipv6-criteria is removed from all services where that policy is applied.

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create or edit policy entries that specify MAC criteria.

The MAC criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.

The 7210 SAS implementation exits on the first match found and execute the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.

The no form of this command deletes all the entries specified under this node. When mac-criteria entries are removed from a SAP ingress policy, the mac-criteria is removed from all services where that policy is applied.

Context

config>qos>sap-ingress>fc

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command overrides the default unicast forwarding type queue mapping for fc fc-name. The specified queue ID must exist within the policy as a non-multipoint queue before the mapping can be made. When the forwarding class mapping is executed, all unicast traffic (this includes all traffic, even broadcast and multicast for services) on a SAP or an access-uplink port using this policy is forwarded using the queue ID.

The no form of this command sets the unicast (point-to-point) queue ID back to the default queue for the forwarding class (queue 1).

Parameters

queue-id

Specifies the queue ID for the queue.

Context

config>qos>sap-ingress>fc

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command overrides the default multicast forwarding type queue mapping for fc fc-name. The specified meter-id must exist within the policy before the mapping can be made. When the forwarding class mapping is executed, all broadcast, unknown unicast, and multicast (BUM) traffic on an access SAP using this policy is forwarded using the meter ID.

The default multicast forwarding type queue is the default unicast queue (queue 1). In other words, if no multicast meter is assigned to a FC, it uses default queue 1.

The no form of this command removes the association of the FC and the meter. When the no form is executed, the BUM traffic uses the default multicast forwarding type queue (queue 1).

Default

1

Parameters

meter-id

Specifies the meter ID for the meter.

Values

1 to 16

Context

config>qos>sap-ingress>fc

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command overrides the default unicast forwarding type queue mapping for fc fc-name. The specified meter-id must exist within the policy before the mapping can be made. When the forwarding class mapping is executed, all unicast traffic (this includes all traffic, even broadcast and multicast for services) on an access SAP using this policy is forwarded using the meter ID.

The no form of this command sets the unicast (point-to-point) traffic type back to the default queue for the forwarding class (queue 1).

Parameters

meter-id

Specifies the meter ID for the meter.

Values

1 to 16

Context

config>qos>sap-ingress>ip-criteria>entry

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This mandatory command associates the forwarding class with specific IP or MAC criteria entry ID. The action command supports setting the forwarding class parameter. Packets that meet all match criteria within the entry have their forwarding class overridden based on the parameters included in the action parameters.

The action command must be executed for the match criteria to be added to the active list of entries.

Each time action is executed on a specific entry ID, the previous entered values for fc fc-name is overridden with the newly defined parameters.

The no form of this command removes the entry from the active entry list. Removing an entry on a policy immediately removes the entry from all SAPs using the policy. All previous parameters for the action is lost.

Default

action specified by the default-fc command

Parameters

fc fc-name

Specifies the name of the forwarding class. The value of fc fc-name must be one of the predefined forwarding classes in the system. Specifying the fc fc-name is required. When a packet matches the rule, the forwarding class is only overridden when the fc fc-name parameter is defined on the rule. If the packet matches and the forwarding class is not explicitly defined in the rule, the forwarding class is inherited based on previous rule matches.

Values

be, l2, af, l1, h2,ef, h1, nc

profile {in | out}

Specifies the profile assignment. When specified, packets matching the classification entry are explicitly classified to either in-profile or out-of-profile. The remove the profile action for an classification entry, the action command must be re-executed without the profile action defined. The profile assigned by the user is used subsequently to determine the slope to use at the ingress and egress queuing points and is used for egress marking (if enabled).

in

Specifies that any packets matching the classification rule are treated as in-profile. The in parameter is mutually exclusive to the out parameter following the profile classification action keyword. Either in or out must be specified when the profile keyword is present.

out

Specifies that any packets matching the classification rule are treated as out-of-profile. The out parameter is mutually exclusive to the in parameter following the profile classification action keyword. Either in or out must be specified when the profile keyword is present.

use-dei

Specifies whether DEI must be used to determine the initial profile of the packet.

Context

config>qos>sap-ingress>ip-criteria

config>qos>sap-ingress>mac-criteria

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create or edit an IP or MAC criteria entry for the policy. Multiple entries can be created using unique entry-id numbers.

The list of flow criteria is evaluated in a top down fashion with the lowest entry ID at the top and the highest entry ID at the bottom. If the defined match criteria for an entry within the list matches the information in the egress packet, the system stops matching the packet against the list and performs the matching entries reclassification actions. If none of the entries match the packet, the IP flow reclassification list has no effect on the packet.

An entry is not populated in the list unless the action command is executed for the entry. An entry that is not populated in the list has no effect on egress packets. If the action command is executed without any explicit reclassification actions specified, the entry is populated in the list allowing packets matching the entry to exit the list, preventing them from matching entries lower in the list. Because this is the only flow reclassification entry that the packet matched and this entry explicitly states that no reclassification action is to be performed, the matching packet is not reclassified.

The no form of this command removes the specified entry from the policy. Entries removed from the policy are immediately removed from all services where that policy is applied.

Parameters

entry-id

Specifies a match criterion and the corresponding action. It is recommended that multiple entries be given entry IDs in staggered increments. This allows users to insert a new entry in an existing policy without requiring renumbering of all the existing entries.

An entry cannot have any match criteria defined (in which case, everything matches) but must have at least the keyword action fc fc-name for it to be considered complete. Entries without the action keyword are considered incomplete and therefore are rendered inactive.

Values

1 to 64

create

Keyword to create a flow entry when the system is configured to require the explicit use of the keyword to prevent accidental object creation. Objects may be accidentally created when this protection is disabled and an object name is mistyped when attempting to edit the object. This keyword is not required when the protection is disabled. The keyword is ignored when the flow entry already exists.

Context

config>qos>sap-ingress>ip-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command creates a context to configure match criteria for SAP ingress QoS policy match criteria. When the match criteria have been satisfied, the action associated with the match criteria is executed.

If more than one match criteria (within one match statement) are configured, all criteria must be satisfied (AND function) before the action associated with the match is executed.

A match context can consist of multiple match criteria, but multiple match statements cannot be entered per entry.

The no form of this command removes the match criteria for the entry-id.

Parameters

protocol protocol-id

Specifies an IP protocol to be used as a SAP QoS policy match criterion.

The protocol type such as TCP / UDP / OSPF is identified by its respective protocol number.

Well-known protocol numbers include ICMP(1), TCP(6), UDP(17).

Values 0 to 255; check the node for values.

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create and edit match MAC criteria for ingress SAP QoS policy match criteria. When the match criteria have been satisfied the action associated with the match criteria is executed.

If more than one match criteria (within one match statement) are configured then all criteria must be satisfied (and function) before the action associated with the match is executed.

A match context can consist of multiple match criteria, but multiple match statements cannot be entered per entry.

The no form of this command removes the match criteria for the entry-id.

Context

config>qos>sap-ingress>ipv6-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures match criteria for ingress SAP QoS policy match IPv6 criteria. When the match criteria have been satisfied the action associated with the match criteria is executed.

If more than one match criteria (within one match statement) are configured, then all criteria must be satisfied (and function) before the action associated with the match is executed.

A match context can consist of multiple match criteria, but multiple match statements cannot be entered per entry.

The no form of this command removes the match criteria for the entry-id.

Parameters

next-header next-header

Specifies the next meader to match.

The protocol type such as TCP / UDP / OSPF is identified by its respective protocol number. Well-known protocol numbers include ICMP(1), TCP(6), UDP(17).

Values

protocol numbers accepted in DHB: 0 to 42, 45 to 49, 52 to 59, 61 to 255 keywords: none, crtp, crudp, egp, eigrp, encap, ether-ip, gre, icmp, idrp, igmp, igp, ip, ipv6, ipv6-icmp, ipv6-no-nxt, isis, iso-ip, l2tp, ospf-igp, pim, pnni, ptp, rdp, rsvp, stp, tcp, udp, vrrp * — udp/tcp wildcard

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a destination MAC address or range to be used as a Service Ingress QoS policy match criterion.

The no form of this command removes the destination MAC address as the match criterion.

Parameters

ieee-address

Specifies the MAC address to be used as a match criterion.

Values

HH:HH:HH:HH:HH:HH or HH-HH-HH-HH-HH-HH where H is a hexadecimal digit

ieee-address-mask

Specifies a 48-bit mask to match a range of MAC address values.

This 48-bit mask can be configured using the following formats:

Format style	Format syntax	Example
Decimal	DDDDDDDDDDDDDD	281474959933440
Hexadecimal	0xHHHHHHHHHHHH	0xFFFFFF000000
Binary	0bBBBBBBB...B	0b11110000...B

All packets with a source MAC OUI value of 00-03-FA subject to a match condition should be specified as: 0003FA000000 0x0FFFFF000000

Default

0xFFFFFFFFFFFF (hex) (exact match)

Values

0x00000000000000 to 0xFFFFFFFFFFFF (hex)

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures an Ethernet type II value for use as a service ingress QoS policy match criterion.

The Ethernet type field is a two-byte field used to identify the protocol carried by the Ethernet frame. For example, 0800 is used to identify IPv4 packets.

The Ethernet type field is used by the Ethernet version-II frames. IEEE 802.3 Ethernet frames use the dsap, ssap or snap-pid fields as match criteria; the Ethernet type field is not used.

The snap-pid, etype, ssap, and dsap fields are mutually exclusive and cannot be part of the same match criteria.

The dataplane processes a maximum of two VLAN tags in a received packet. The Ethertype used in the MAC matching criteria for ACLs is the Ethertype that is found in the packet after processing single-tagged frames, double-tagged frames, and no-tag frames

The packet is considered to have no tags if at least one of the following criteria is true:

• the packet is a null-tagged frame

• the packet is a priority-tagged frame

• the outermost Ethertype does not match the default Ethertype (0x8100)

• the outermost Ethertype does not match the configured dot1q-etype on Dot1q encapsulated ports

• the outermost Ethertype does not match the configured qinq-etype on QinQ encapsulated ports

The packet is considered to have a single tag if at least one of the following criteria is true:

• the outermost Ethertype matches the default Ethertype (0x8100)

• the outermost Ethertype matches the configured dot1q-etype on Dot1q encapsulated ports

• the outermost Ethertype matches the configured qinq-etype on QinQ encapsulated ports

The packet is considered to have double tags if at least one of the following criteria is true:

• the outermost Ethertype matches the default Ethernet type (0x8100)

• the configured dot1q-etype on Dot1q encapsulated ports and the immediately following Ethertype match the default Ethertype (0x8100)

• the configured qinq-etype on QinQ encapsulated ports and the immediately following Ethertype match the default Ethertype (0x8100)

The no form of this command removes the previously entered etype field as the match criteria.

Parameters

etype-value

Specifies the Ethernet type II frame Ether type value to be used as a match criterion, expressed in hexadecimal or decimal notation.

Values

0x0600 to 0xFFFF (hexadecimal)

1536 to 65535 (decimal)

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the dot1p value to be used as a service ingress QoS policy match criterion to match against the dot1p value in the inner tag (the one that follows the outermost tag in the packet) of the received packet.

The no form of this command removes the previously entered dot1p value as the match criteria.

Default

no inner-dot1p

Parameters

dot1p-value

Specifies the dot1p value to match.

Values

0 to 7

dot1p-mask

Specifies the mask value to match a range of dot1p values, expressed in hexadecimal or decimal notation.

Values

0 to 7

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the VLAN value to be used as a service ingress QoS policy match criterion to match against the VLAN value in the inner tag (the one that follows the outermost tag in the packet) of the received packet.

The no form of this command removes the previously entered VLAN tag value as the match criteria.

Default

no inner-tag

Parameters

value

Specifies the VLAN value to use for the match.

Values

0 to 4095 (decimal)

0x0 to 0xFFF (hexadecimal)

vid-mask

Specifies the mask value to match a range of VLAN values.

Values

1 to 4095 (decimal)

1x0 to 0xFFF (hexadecimal)

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the dot1p value to be used as a service ingress QoS policy match criterion to match against the dot1p value in the outermost tag of the received packet.

The no form of this command removes the previously entered dot1p value as the match criteria.

Default

no outer-dot1p

Parameters

dot1p-value

Specifies the dot1p value to match.

Values

0 to 7

dot1p-mask

Specifies the mask value to match a range of dot1p values, expressed in hexadecimal or decimal notation.

Values

0 to 7

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures the VLAN value to be used as a service ingress QoS policy match criterion to match against the VLAN value in the outermost tag in the packet of the received packet.

The no form of this command removes the previously entered VLAN tag value as the match criteria.

Default

no outer-tag

Parameters

value

Specifies the VLAN value to use for the match.

Values

0 to 4095 (decimal)

0x0 to 0xFFF (hexadecimal)

vid-mask

Specifies the mask value to match a range of VLAN values.

Values

0 to 4095 (decimal)

0x0 to 0xFFF (hexadecimal)

Context

config>qos>sap-ingress>mac-criteria>entry

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a source MAC address or range to be used as a service ingress QoS policy match criterion.

The no form of this command removes the source MAC address as the match criteria.

Parameters

ieee-address

Specifies the 48-bit IEEE mac address to be used as a match criterion.

Values

HH:HH:HH:HH:HH:HH or HH-HH-HH-HH-HH-HH where H is a hexadecimal digit

ieee-address-mask

Specifies a 48-bit mask.

This 48 bit mask can be configured using the following formats

Format style	Format syntax	Example
Decimal	DDDDDDDDDDDDDD	281474959933440
Hexadecimal	0xHHHHHHHHHHHH	0x0FFFFF000000
Binary	0bBBBBBBB...B	0b11110000...B

To configure all packets with a source MAC OUI value of 00-03-FA are subject to a match condition, then the entry should be specified as: 003FA000000 0xFFFFFF000000

Default

0xFFFFFFFFFFFF (hexadecimal) (exact match)

Values

0x00000000000000 to 0xFFFFFFFFFFFF (hexadecimal)

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

Commands in this context create a queue and modify queue parameters associated with a particular queue. The queue-ID to FC map is user-defined.

The 7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T support two, four, six, or eight queues per SAP. The 7210 SAS-K 3SFP+ 8C supports four or eight queues per SAP

The no form of this command removes the queue.

Parameters

queue-id

Specifies the ID of the queue.

Values

1 to 8

create

Keyword to create a network queue policy.

Context

config>qos>sap-ingress

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command modifies meter parameters associated with a particular meter. The queue-ID to FC map is user-defined.

The no form of this command remove the meter definition.

Default

no meter

Parameters

meter-id

Specifies the ID of the meter.

Values

1 to 16

Context

config>qos>sap-ingress>meter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the method used by the system to derive the operational CIR and PIR rates when the meter is provisioned in hardware. For the cir and pir parameters, the system attempts to find the best operational rate depending on the defined constraint.

The no form of this command removes any explicitly defined constraints used to derive the operational CIR and PIR created by the application of the policy. When a specific adaptation-rule is removed, the default constraints for cir and pir apply.

Default

adaptation-rule pir closest cir closest

Parameters

cir adaptation-rule

Specifies the adaptation rule and defines the constraints enforced to adapt the CIR rate defined using the meter meter-id rate command. The cir parameter requires a qualifier that defines the constraint used to derive the operational CIR rate for the meter. When the cir command is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.

Default

closest

Values

max — Specifies that the operational CIR value is equal to or less than the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

min — Specifies that the operational CIR value is equal to or greater than the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

closest — Specifies that the operational CIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

pir adaptation-rule

Specifies the adaptation rule and defines the constraints enforced to adapt the PIR rate defined using the meter meter-id rate command. The pir parameter requires a qualifier that defines the constraint used to derive the operational PIR rate for the meter. When the rate command is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.

Default

closest

Values

max — Specifies that the operational PIR value is less than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

min — Specifies that the operational PIR value is equal to or greater than the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

closest — Specifies that the operational CIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

Context

config>qos>sap-ingress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the method used by the system to derive the operational CIR and PIR rates when the queue is provisioned in hardware. For the cir and pir parameters, the system attempts to find the best operational rate depending on the defined constraint.

The no form of this command removes any explicitly defined constraints used to derive the operational CIR and PIR created by the application of the policy. When a specific adaptation-rule is removed, the default constraints for cir and pir apply.

Default

adaptation-rule pir closest cir closest

Parameters

cir adaptation-rule

Specifies the adaptation rule and defines the constraints enforced when adapting the CIR rate defined using the queue queue-id rate command. The cir parameter requires a qualifier that defines the constraint used to derive the operational CIR rate for the queue. When the cir parameter is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.

Default

closest

Values

max — Specifies that the operational CIR value is less than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

min — Specifies that the operational CIR value is greater than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

closest — Specifies that the operational CIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

pir adaptation-rule

Specifies the adaptation rule and defines the constraints enforced when adapting the PIR rate defined using the queue queue-id rate command. The pir parameter requires a qualifier that defines the constraint used when deriving the operational PIR rate for the queue. When the pir command is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive.

Default

closest

Values

max — Specifies that the operational PIR value is less than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

min — Specifies that the operational PIR value is greater than or equal to the specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

closest — Specifies that the operational PIR value is equal to the closest specified rate, taking into account the hardware step size. The hardware step size varies based on the rate and the platform.

Context

config>qos>sap-ingress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the CBS value (minimum depth of the queue).

The no form of this command reverts to the default value.

Default

10

Parameters

size-in-kbytes

Specifies the CBS in kilobytes.

Values

0 to 10240 (7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T)

0 to 102400 (7210 SAS-K 3SFP+ 8C)

Context

config>qos>sap-ingress>meter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the CBS value of the meter. The committed burst size parameter specifies the maximum burst size that can be transmitted by the source while still complying with the CIR. If the transmitted burst is lower than the CBS value, the packets are marked as out-profile by the meter to indicate that the traffic is complying with the meter-configured CIR rate.

The no form of this command reverts to the default value.

Default

kbits

Parameters

[kbits | bytes | kbytes]

Specifies the maximum burst size.

Values

size-in-kbits — 1 to 16384, default

size-in-bytes — 64 to 2097152, default

size-in-kbytes — 1 to 2048, default

Context

config>qos>sap-ingress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the MBS value (maximum depth of the queue).

The no form of this command reverts to the default value.

Default

60

Parameters

size-in-kbytes

Specifies the MBS value in kilobytes.

Values

0 to 12800 (7210 SAS-K 2F1C2T and 7210 SAS-K 2F6C4T)

0 to 63488 (7210 SAS-K 3SFP+ 8C)

Context

config>qos>sap-ingress>meter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the MBS value of the meter. The maximum burst size parameter specifies the maximum burst size that can be transmitted by the source while still complying with the PIR. If the transmitted burst is lower than the MBS value, the packets are marked as out-profile by the meter to indicate that the traffic is complying with the meter-configured PIR rate.

The no form of this command reverts to the default value.

Default

kbits

Parameters

[kbits | bytes | kbytes]

Specifies the maximum burst size.

Values

size-in-kbits — 1 to 16384, default

size-in-bytes — 64 to 2097152, default

size-in-kbytes — 1 to 2048, default

Context

config>qos>sap-ingress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the queue priority. The queue priority is used by the scheduler to determine the order of service in both the within-cir loop and within-pir loop. Higher priority queues are serviced before lower priority queues.

The no form of this command reverts to the default value.

Default

1

Parameters

level

Specifies the priority of the queue.

Values

1 to 4

Context

config>qos>sap-ingress>meter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the mode of the meter. The mode can be configured as Two Rate Three Color Marker (trTCM) or Single Rate Three Color Marker (srTCM). The mode command can be executed at any time. The no form of this command sets it to default mode.

Default

trtcm2

Parameters

mode

Specifies the mode of the meter.

Values

srtcm — meters a packet stream and marks its packets either green, yellow, or red. Marking is based on a CIR and two associated burst sizes, a CBS and an Maximum Burst Size (MBS). A packet is marked green if it does not exceed the CBS and yellow if it does exceed the CBS, but not the MBS; otherwise, it is marked red and is dropped. The srTCM mode is useful, for example, for ingress policing of a service, where only the length, not the peak rate, of the burst determines service eligibility.

trtcm2 — implements the policing algorithm defined in RFC 4115. The trTCM2 mode meters the packet stream and marks the packets either green, yellow, or red. A packet is marked red and is dropped if it exceeds the PIR. Otherwise, it is marked either yellow or green depending on whether it exceeds or does not exceed the CIR. The trTCM2 mode is useful, for example, for ingress policing of a service, where a peak rate needs to be enforced separately from a committed rate.

Note:

If the meter mode is configured as trtcm2, the system configures the policer EIR rate based on the value of the PIR rate configured by the user.

Context

config>qos>sap-ingress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the administrative Peak Information Rate (PIR) and the administrative Committed Information Rate (CIR) parameters for the queue. The PIR defines the maximum rate that the queue can transmit packets through the port. Defining a PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained by the queue can be limited by oversubscription factors or available egress bandwidth. The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

The max default specifies the amount of bandwidth in kilobits per second (thousand bits per second). The max value is mutually exclusive to the pir-rate value.

The no form of this command returns all queues created with the queue ID by association with the QoS policy to the default PIR and CIR parameters (max, 0).

Default

rate 0 pir max

Parameters

cir-rate-in-kbps

Specifies the administrative CIR rate, in kilobits, for the queue. If the rate command is not executed or the cir parameter is not explicitly specified, the default CIR value is used.

Default

0

Values

0 to 3000000, max (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T)

0 to 20000000, max (7210 SAS-K 3SFP+ 8C)

pir-rate-in-kbps

Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. If the rate command is not executed, the default PIR of maximum value is used.

Default

max

Values

1 to 3000000, max (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T)

1 to 20000000, max (7210 SAS-K 3SFP+ 8C)

Context

config>qos>sap-ingress>meter

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the administrative Peak Information Rate (PIR) and the administrative Committed Information Rate (CIR) parameters for the meter. The PIR defines the maximum rate at which the meter can admit the packet into the system for forwarding. Defining a PIR does not necessarily guarantee that the queue can transmit at the intended rate. The actual rate sustained by the flow can be limited by oversubscription factors or available egress bandwidth.

The max default specifies the amount of bandwidth in kilobits per second (thousand bits per second). The max value is mutually exclusive to the pir-rate value.

The no form of this command returns all meters created with the meter-id by association with the QoS policy to the default PIR and CIR parameters (max, 0).

Default

rate 0 pir max

Parameters

cir-rate-in-kbps

Specifies the administrative CIR rate, in kilobits, for the queue. If the rate command is not executed or the cir parameter is not explicitly specified, the default CIR value is used.

Default

0

Values

0 to 3000000, max (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T)

0 to 20000000, max (7210 SAS-K 3SFP+ 8C)

pir-rate-in-kbps

Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. If the rate command is not executed, the default PIR of maximum value is used.

Note:

If the meter mode is configured as trtcm2, the system configures the policer EIR rate based on the value of the PIR rate configured by the user.

Default

max

Values

1 to 3000000, max (7210 SAS-K 2F1C2T, 7210 SAS-K 2F6C4T)

1 to 20000000, max (7210 SAS-K 3SFP+ 8C)

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays SAP ingress QoS policy information.

Parameters

policy-id

Displays information about the specific policy ID.

Default

all SAP ingress policies

Values

1 to 65535

detail

Displays detailed policy information including policy associations.

associations

Displays the policy associations of the sap-ingress policy.

match-criterion

Displays the match-criterion of the sap-ingress policy.

Output

The following output is an example of SAP ingress QoS policy information, and Output fields: SAP ingress describes the output fields.

*A:Dut-B>show>qos# sap-ingress 1 detail
===============================================================================
QoS Sap Ingress
===============================================================================
-------------------------------------------------------------------------------
Sap Ingress Policy (1)
-------------------------------------------------------------------------------
Policy-id                 : 1                 Scope                : Template
Default FC                : be
Criteria-type             : None
Mac Sub-Criteria          : None              IP Sub-Criteria      : None
IPv6 Enabled              : False
DOT1P Class Policy Id     : 0                 DSCP Class Policy Id : 0
MPLS Lsp Exp Class Policy*: 0
Name                      : default
Description               : Default SAP ingress QoS policy.
-------------------------------------------------------------------------------
FC        Queue       MCast Queue Use Dei
-------------------------------------------------------------------------------
be        1           1           false
l2        1           1           false
af        1           1           false
l1        1           1           false
h2        1           1           false
ef        1           1           false
h1        1           1           false
nc        1           1           false
-------------------------------------------------------------------------------
FC        Meter       MCast Meter Use Dei
-------------------------------------------------------------------------------
be        -           -           false
l2        -           -           false
af        -           -           false
l1        -           -           false
h2        -           -           false
ef        -           -           false
h1        -           -           false
nc        -           -           false
-------------------------------------------------------------------------------
Queue Rates and Rules
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        CIR          CIR Adpt Rule        PIR          PIR Adpt Rule
-------------------------------------------------------------------------------
Queue1          0              closest            max            closest
-------------------------------------------------------------------------------
Queue Priority and Weight Details
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId         Priority      Weight
-------------------------------------------------------------------------------
Queue1          1             1
-------------------------------------------------------------------------------
High Slope Non Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            80
-------------------------------------------------------------------------------
Low Slope Non Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            80
-------------------------------------------------------------------------------
High Slope Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            80
-------------------------------------------------------------------------------
Low Slope Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            80
-------------------------------------------------------------------------------
Slope Policies
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        CBS(KBytes)  MBS(KBytes)    Slope-Policy
-------------------------------------------------------------------------------
Queue1           10          60            default
-------------------------------------------------------------------------------
Match Criteria
-------------------------------------------------------------------------------
No Matching Criteria.
SAP Associations
-------------------------------------------------------------------------------
No Associations Found.
-------------------------------------------------------------------------------
Meter Mode        CIR Admin CIR Rule PIR Admin PIR Rule CBS Admin MBS Admin
                  CIR Oper           PIR Oper           CBS Oper  MBS Oper
-------------------------------------------------------------------------------
No Matching Entries
===============================================================================
* indicates that the corresponding row element may have been truncated.
*A:Dut-B>show>qos#

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays dot1p-classification QoS policy information.

Parameters

policy-id

Displays information about the specific policy ID.

detail

Displays detailed policy information.

Output

The following output is an example of dot1p classification policy information, and Output fields: dot1p classification describes the output fields.

A:SAH01-050>config>qos>sap-ingress# show  qos dot1p-classification 10
===============================================================================
DOT1P Classification Maps
===============================================================================
-------------------------------------------------------------------------------
Dot1P Class Id     : 10
Description        : (Not Specified)
-------------------------------------------------------------------------------
A:SAH01-050>config>qos>sap-ingress#


A:SAH01-050>config>qos>sap-ingress# show  qos dot1p-classification 10  detail

===============================================================================
DOT1P Classification Maps
===============================================================================
-------------------------------------------------------------------------------
Dot1P Class Id     : 10
Description        : (Not Specified)

-------------------------------------------------------------------------------
Dot1P Bit Map                         Forwarding Class                Profile
-------------------------------------------------------------------------------
6                                       h1                              None
7                                       nc                              None

-------------------------------------------------------------------------------
Network Policy Associations
-------------------------------------------------------------------------------
No Network Policy Associations found.
-------------------------------------------------------------------------------

-------------------------------------------------------------------------------
SAP Ingress Associations
-------------------------------------------------------------------------------
SAP Ingress Id             : 10
-------------------------------------------------------------------------------
===============================================================================

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command displays DSCP classification QoS policy information.

Parameters

policy-id

Displays information about the specific policy ID.

detail

Displays detailed policy information.

Output

The following is an example of DSCP classification information, and Output fields: DSCP classification describes the output fields.

*A:SAH01-071>config>qos# show qos dscp-classification 6335 detail 

===============================================================================
DSCP Classification Maps
===============================================================================
-------------------------------------------------------------------------------
Dscp Class Id      : 6335
Description        : (Not Specified)
 
-------------------------------------------------------------------------------
Dscp Bit Map                         Forwarding Class                Profile
-------------------------------------------------------------------------------
cp7                                     nc                              In
cp15                                    h1                              In
cp23                                    ef                              In
cp31                                    h2                              In
cp39                                    l1                              In
cp47                                    af                              In
cp55                                    l2                              In
 
-------------------------------------------------------------------------------
Network Policy Associations
-------------------------------------------------------------------------------
No Network Policy Associations found. 
-------------------------------------------------------------------------------
 
-------------------------------------------------------------------------------
SAP Ingress Associations
-------------------------------------------------------------------------------
SAP Ingress Id             : 17
-------------------------------------------------------------------------------
===============================================================================