Access egress QoS policies on 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE

This section provides information to configure Access Egress QoS policies using the command line interface.

Overview

An access egress policy defines the queuing for the traffic egressing on the access ports. Access-egress queue policies are used at the Ethernet port and define the bandwidth distribution for the various FC/queue traffic egressing on the Ethernet port.

There is one default access egress policy which is identified as policy ID 1. Each policy has 8 queues available. The Forwarding Class to queue mapping is predefined and cannot be changed. The queue parameters like CIR, PIR, and so on, can be modified. The default policy can be copied but they cannot be deleted or modified.

Basic configurations

A basic access egress QoS policy must conform to the following:

  • have a unique access egress QoS policy ID

  • have a QoS policy scope of template or exclusive

  • queue parameters can be modified, but not deleted

The following is a sample configuration output for 7210 SAS-T in access-uplink mode.

*7210SAS>config>qos>access-egress$ info detail 
----------------------------------------------
            no description
            remarking
            scope template
            queue 1
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 2
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 3
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 4
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 5
                adaptation-rule cir closest pir closest
                rate cir 0 pir max    
            exit
            queue 6
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 7
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 8
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            fc af create
                no de-mark
                no dot1p
                dot1p-in-profile 7
                dot1p-out-profile 4
            exit 
----------------------------------------------

The following is a sample configuration output for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE in network mode.

*A:01154300003>config>qos>access-egress# info detail 
----------------------------------------------
            no description
            remarking
            remark 200
            scope template
            queue 1
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 2
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 3
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 4
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 5
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 6
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 7
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 8
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
----------------------------------------------

Modifying access egress QoS queues

To modify access egress queue parameters specify the following:

The following is a sample access egress QoS policy configuration output on 7210 SAS-T access-uplink mode.

*A:SAS-T>config>qos>access-egress>queue$ info       
----------------------------------------------
                adaptation-rule cir max
                rate cir 2000 pir 30000
----------------------------------------------

Applying access egress QoS policies

Apply access egress policies to the following entities:

  • Ethernet ports

A policy can be applied to the ports that are in access mode.

Ethernet ports

Use the following syntax to apply a access-egress policy to an Ethernet port.

config>port#
        ethernet access egress
            qos access-egress-policy-id

The following is a sample port configuration output.

*A:card-1>config>port# info
----------------------------------------------
                 shutdown
                    ethernet
                        access
                            egress
                                qos 30
                            exit
                        exit
                    exit
----------------------------------------------
*A:card-1>config>port# 

Default access egress QoS policy values

The following are sample default policy parameters.

*A:card-1>config>qos>access-egress# info detail
----------------------------------------------
            description "Default Access egress QoS policy."
            no remarking
            scope template
            queue 1
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 2
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 3
                adaptation-rule cir closest pir closest
                rate 0 pir max
            exit
            queue 4
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 5
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 6
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 7
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
            queue 8
                adaptation-rule cir closest pir closest
                rate cir 0 pir max
            exit
----------------------------------------------
*A:card-1>config>qos>access-egress#

The following table lists the default forwarding class marking values when remarking is enabled on the access egress policy for 7210 SAS devices configured in network mode and access-uplink mode:

Table 1. Default FC marking values for 7210 SAS-T (access-uplink mode)
Default FC value Network mode Access-uplink mode

af

dot1p-in-profile 2

dot1p-out-profile 2

dscp-in-profile af11

dscp-out-profile af12

dot1p-in-profile 2

dot1p-out-profile 2

be

dot1p-in-profile 0

dot1p-out-profile 0

dscp-in-profile be

dscp-out-profile be

dot1p-in-profile 0

dot1p-out-profile 0

ef

dot1p-in-profile 5

dot1p-out-profile 5

dscp-in-profile ef

dscp-out-profile ef

dot1p-in-profile 5

dot1p-out-profile 5

h1

dot1p-in-profile 6

dot1p-out-profile 6

dscp-in-profile nc1

dscp-out-profile nc1

dot1p-in-profile 6

dot1p-out-profile 6

h2

dot1p-in-profile 4

dot1p-out-profile 4

dscp-in-profile af41

dscp-out-profile af41

dot1p-in-profile 4

dot1p-out-profile 4

l1

dot1p-in-profile 3

dot1p-out-profile 3

dscp-in-profile af21

dscp-out-profile af22

dot1p-in-profile 3

dot1p-out-profile 3

l2

dot1p-in-profile 1

dot1p-out-profile 1

dscp-in-profile cs1

dscp-out-profile cs1

dot1p-in-profile 1

dot1p-out-profile 1

nc

dot1p-in-profile 7

dot1p-out-profile 7

dscp-in-profile nc2

dscp-out-profile nc2

dot1p-in-profile 7

dot1p-out-profile 7

Deleting QoS policies

Every access Ethernet port is associated, by default, with the default access egress policy (policy-id 1). You can replace the default policy with a customer-configured policy, but you cannot entirely remove the policy from the port configuration. When you remove a non-default access egress policy, the association reverts to the default policy-id 1.

A QoS policy cannot be deleted until it is removed from all access ports where they are applied.

*A:card-1>config>qos# no access-egress 30
MINOR: CLI Could not remove Access egress policy "30" because it is in use.

Removing a policy from the QoS configuration

config>qos# no access-egress policy-id
config>qos# no access-egress 100
    config>qos# no access-egress 1010

Access egress QoS policy command reference

Command hierarchies

Configuration commands for 7210 SAS-T (access-uplink mode)

config
    - qos
        - access-egress policy-id [create]
        - no access-egress policy-id
            - description description-string
            - no description
            - fc fc-name [create]
            - no fc fc-name
                - [no] de-mark [force de-value]
                - dot1p dot1p-priority
                - no dot1p
                - dot1p-in-profile dot1p-value 
                - no dot1p-in-profile
                - dot1p-out-profile dot1p-value 
                - no dot1p-out-profile
                - dscp-in-profile dscp-name
                - no dscp-in-profile
                - dscp-out-profile dscp-name
                - no dscp-out-profile
            - queue queue-id 
                - adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
                - no adaptation-rule
                - rate cir cir-rate [pir pir-rate]
                - no rate
            - remarking {use-dot1p | use-dscp | all}
            - no remarking
            - scope {exclusive | template}
            - no scope

Operational commands

    - config
        - qos
            - copy sap-ingress src-pol dst-pol overwrite

Show commands

show
    - qos
        - access-egress [policy-id] [association| detail]

Configuration commands

Generic commands

description
Syntax

description description-string

no description

Context

config>qos>access-egress

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description

This command creates a text description stored in the configuration file for a configuration context.

The description command associates a text string with a configuration context to help identify the context in the configuration file.

The no form of this command removes any description string from the context.

Parameters
description-string

Specifies a text string describing the entity. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

access-egress
Syntax

access-egress policy-id [create]

no access-egress policy-id

Context

config>qos

Platforms

7210 SAS-T (in access-uplink and network modes),7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE

Description

This command creates or edits an access egress QoS policy. The policy can be applied to multiple access ports. The access egress policy is common to services (SAPs) that are all egressing on a particular port.

Any changes made to an existing policy are applied to all access ports on which the policy is specified.

The remarking parameters and queue parameters are used when port-based queuing is configured

This command is used to create or edit a access egress QoS policy. The egress policy defines the queue parameters (CIR/PIR) for each of the forwarding class traffic as they egress on the access port. Policies in effect are templates that can be applied to multiple access ports as long as the scope of the policy is template. There are 8 queues always available per port for which parameters are configurable.

Parameters
policy-id

Specifies the value that uniquely identifies the access-egress policy.

Values

1 to 65535

create

Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.

fc
Syntax

fc fc-name [create]

no fc fc-name

Context

config>qos>access-egress

Platforms

7210 SAS-T (access-uplink mode)

Description

This command defines the fc node within the access egress QoS policy is used to contain the explicitly defined dot1p marking commands for the fc-name.

Note:

When the mapping for the fc-name and marking value is not defined, the node for fc-name is not displayed in the show configuration or save configuration output.

The no form of this command removes the explicit dot1p marking commands for the fc-name.

Parameters
fc-name

Specifies the forwarding class for which dot1p marking is to be edited. The value given for fc-name must be one of the predefined forwarding classes in the system.

Values

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

create

Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.

de-mark
Syntax

[no] de-mark [force de-value]

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command explicitly defines the marking of the DEI bit for fc fc-name according to the in and out of profile status of the packet (fc-name may be used to identify the dot1p-value).

If no de-value is present, the default values are used for the marking of the DEI bit: for example, 0 for in-profile packets, 1 for out-of-profile ones – see IEEE 802.1ad-2005 standard.

If the de-value is specifically mentioned in the command line it means this value is to be used for all the packets of this forwarding class regardless of their in/out of profile status.

Parameters
de-value

Specifies the DEI value to use for this forwarding class.

Values

0 or 1

dot1p
Syntax

[no] dot1p dot1p-value

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

DEI marking can be enabled using the de-mark command along with this command for the command to take effect. When the de-mark command is configured along with this command, the DEI bit is marked in the packet to indicate the profile of the packet. The DEI bit is marked to 0 to indicate in-profile/green packet and 1 to indicate out-of-profile/yellow packet. If the force de-value parameter is specified then the DEI bit is set to specified value for all packets.

If the no form of this command is executed then software will use the dot1p-in-profile and dot1p-out-profile if configured, else it will use default values.

Note:

The following rules are applied by software to determine the Dot1p values when the dot1p, dot1p-in-profile, and dot1p-out-profile commands are specified:

  1. If de-mark is not configured, then dot1p [in | out]-profile values are considered. Even if dot1p value is configured, it is configured it is ignored and if ‛dot1p [in | out]-profile’ value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if dot1p value is configured then it is considered. Else if ‛dot1p [in | out]-profile’ value is configured it is considered. In this case, dot1p value, has the precedence over ‛dot1p [in | out]-profile’.

Default

no dot1p

Parameters
dot1p-value

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dot1p-in-profile
Syntax

dot1p-in-profile dot1p-priority

no dot1p-in-profile

Context

config>qos>>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with in-profile status (or green color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the command ‛dot1p dot1p-value’ is used to configure the dot1p value, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note:

The following rules are applied by software to determine the Dot1p values when the dot1p, dot1p-in-profile, and dot1p-out-profile commands are specified:

  1. If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>' has the precedence over `dot1p [in|out]-profile'.

  3. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

Default

0

Parameters
dot1p-priority

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dot1p-out-profile
Syntax

dot1p-out-profile dot1p-priority

no dot1p-out-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.

This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with out-of-profile status (or yellow color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.

If DEI marking is enabled using the de-mark command and the dot1p-value is configured, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.

When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.

The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.

Note:

The following rules are applied by software to determine the Dot1p values when the dot1p, dot1p-in-profile, and dot1p-out-profile commands are specified:

  1. If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.

  2. If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>', has the precedence over `dot1p [in|out]-profile'.

  3. If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.

Default

0

Parameters
dot1p-priority

Specifies the 802.1p value to set for in-profile frames in this forwarding class.

Values

0 to 7

dscp-out-profile
Syntax

dscp-out-profile dscp-name

no dscp-out-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (in access-uplink mode and network).

Description

This command specifies the out-of-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default out-of-profile dscp-name.

Parameters
dscp-name

Specifies the DSCP name.

Values

be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63

dscp-in-profile
Syntax

dscp-in-profile dscp-name

no dscp-in-profile

Context

config>qos>access-egress>fc

Platforms

7210 SAS-T (access-uplink mode)

Description

This command specifies the in-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.

When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.

The no form of this command reverts to the factory default in-profile dscp-name.

Parameters
dscp-name

Specifies the DSCP name.

Values

be, cp1, cp2, cp3, cp4, cp5, cp6, cp7, cs1, cp9, af11, cp11, af12, cp13, af13, cp15, cs2, cp17, af21, cp19, af22, cp21, af23, cp23, cs3, cp25, af31, cp27, af32, cp29, af33, cp31, cs4, cp33, af41, cp35, af42, cp37, af43, cp39, cs5, cp41, cp42, cp43, cp44, cp45, ef, cp47, nc1, cp49, cp50, cp51, cp52, cp53, cp54, cp55, nc2, cp57, cp58, cp59, cp60, cp61, cp62, cp63

queue
Syntax

queue queue-id

Context

config>qos>access-egress

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE

Description

This command creates the context to modify queue parameters associated with a particular queue. The queue is identifiable by queue ID and FCs are mapped into the queues. See Forwarding class to queue-ID map and Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE for more information.

Parameters
queue-id

Specifies the access egress queue-id associated with an FC. See Forwarding class to queue-ID map and Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE for more information.

Values

1 to 8

remarking
Syntax

remarking {use-dot1p|use-dscp|all}

no remarking

Context

config>qos>network>egress

Platforms

7210 SAS-T (access-uplink mode)

Description

This command enables the system to remark egress packets sent out of access ports. The user can specify if dot1p or dscp or both dot1p and dscp to be used for marking the packets sent out of the port.

When 7210 is operated in access-uplink mode, marking support is available as given below:

  • On access port egress, the behavior is as follows:

    • If the use-dot1p keyword is configured in the access-egress policy, then the dot1p bits are marked in the packet header for all traffic sent out of all SAPs configured on that access port.

    • If the use-dscp keyword is configured in the access-egress policy, then the IP DSCP bits are marked in the packet header for IPv4 traffic sent out of all SAPs configured on that access port.

      Note:

      DSCP marking also marks the IPv4 packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.

    • If the all keyword is configured is configured in the access-egress policy, then the Dot1p bits are marked in the packet header for all traffic (Layer 2 and IPv4) sent out of all SAPs and the IP DSCP bits are marked in the packet header for all IPv4 traffic sent out of all SAPs configured on that access port.

      Note:
      • DSCP marking also marks the packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.

      • If remarking is enabled in access-egress policy, by default use-dot1p is used. If no marking values are specified, then the default FC to Dot1p marking values are used.

The no form of this command disables remarking.

Default

no remarking

remark
Syntax

remark policy-id

no remark

Context

config>qos>access-egress

Platforms

7210 SAS-T (network mode), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE network mode

Description

This command specifies the remarking policy ID to use for marking packets on access egress (also known as, access port egress).

The remarking policy ID must be associated with the appropriate access egress policy and remarking must be enabled in the access egress policy to enable marking of packets sent out of all SAPs configured on the access port.

Only remarking policy of type dot1p, dscp, or dot1p-dscp is allowed to be used when the remark policy is associated with access-egress. See Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12, for different remark policies supported on the node and its use.

The no form of this command removes the explicit association of the remark policy and associates the default remark policy. In other words, if remarking is enabled and no remark policy is executed, then the default remark policy is used to mark packets sent out. If no remark policy is executed and remarking is disabled, packets are not remarked.

Parameters
policy-id

Specifies the remark policy.

Values

1 to 65535

remarking
Syntax

no remarking

remarking

Context

config>qos>access-egress

Platforms

7210 SAS-T (network mode), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE network mode

Description

This command enables the system to remark egress packets sent out of access ports.

When remarking is enabled, the remark policy configured in the QoS policy context is used to determine the FC to QoS bit mapping. For example, when remarking is enabled in the access-egress QoS policy, the remark policy associated with access-egress QoS policy is used to determine the FC to dot1p mapping to use for marking packets sent out of access ports.

See Remark policies for the remark policy that can be used to configure FC to priority bit markings in different QoS policies associated with different service entities. For more information, see Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

The no form of this command disables remarking.

Default

no remarking

Access egress queue QoS policy commands

adaptation-rule
Syntax

adaptation-rule [cir adaptation-rule] [pir adaptation-rule]

no adaptation-rule

Context

config>qos>access-egress>queue

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

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. See Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.

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. See Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.

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.

rate
Syntax

rate cir cir-rate [pir pir-rate]

no rate

Context

config>qos>access-egress>queue

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

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 rate command can be executed at anytime, altering the PIR and CIR rates for all queues created on the access ports.

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

Parameters
cir cir-rate

Specifies the administrative CIR rate, in kilobits, for the queue. The cir parameter overrides the default administrative CIR used by the queue. When the rate command is executed, a valid CIR setting must be explicitly defined. When the rate command has not been executed or the cir parameter is not explicitly specified, the default CIR (0) is assumed.

Fractional values are not allowed and must be given as a positive integer.

Values

0 to 1000000, max (For devices with only 1G ports)

0 to 10000000, max (For devices with both 1G and 10G ports)

Default

0

pir pir-rate

Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. When the rate command has not been executed, the default PIR of max is assumed.

Fractional values are not allowed and must be given as a positive integer.

The actual PIR rate is dependent on the queue’s adaptation-rule parameters and the actual hardware where the queue is provisioned.

Values

0 to 1000000, max (For devices with only 1G ports)

0 to 10000000, max (For devices with both 1G and 10G ports)

Default

max

scope
Syntax

scope {exclusive | template}

no scope

Context

config>qos>access-egress

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description

This command configures the scope as exclusive or template. The policy’s scope cannot be changed if the policy is applied to multiple ports.

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

Default

template

Parameters
exclusive

Specifies that the policy can only be applied to one interface port. If a policy with an exclusive scope is assigned to a second interface an error message is generated. If the policy is removed from the exclusive interface, it will become available for assignment to another exclusive interface. The system default policies cannot be put into the exclusive scope. An error will be generated if scope exclusive is executed in any policies with a policy ID equal to 1.

template

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

Operational commands

copy
Syntax

copy sap-ingress src-pol dst-pol [overwrite]

Context

config>qos

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, 7210 SAS-Sx 10/100GE

Description

This command copies existing QoS policy entries for a QoS policy ID to another QoS policy ID.

The copy command is a configuration level maintenance tool used to create new policies using existing policies. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

Parameters
sap-ingress src-pol dst-pol

Specifies the source policy ID that the copy command will attempt to copy from and specify the destination policy ID to which the command will copy a duplicate of the policy. Indicates that the source policy ID and the destination policy ID are SAP ingress policy IDs.

Values

1 to 65535

overwrite

Keyword to replace the existing destination policy. Everything in the existing destination policy will be overwritten with the contents of the source policy. If overwrite is not specified, an error will occur if the destination policy ID exists.

Show commands

access-egress
Syntax

access-egress [policy-id] [association | detail]

Context

show>qos

Platforms

7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE

Description

This command displays access egress QoS policy information.

Parameters
policy-id

Displays the policy ID of the access-egress policy.

association

Displays associations related to the specified access-egress policy.

detail

Displays detailed policy information including the policy associations.

Output

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

Sample output
A:Dut-A>show>qos# access-egress

===============================================================================
Access Egress Policies
===============================================================================
Policy-Id            Scope     Description
-------------------------------------------------------------------------------
1                    Template  Default Access egress QoS policy.
===============================================================================
A:Dut-A>show>qos#
A:Dut-A>show>qos# access-egress 1 detail

===============================================================================
QoS Access Egress
===============================================================================
-------------------------------------------------------------------------------
Policy-id      : 1                            Scope        : Template
Remark         : False                        Remark Pol Id: 2
Description    : Default Access egress QoS policy.
-------------------------------------------------------------------------------
Queue Rates and Rules
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        CIR          CIR Adpt Rule        PIR          PIR Adpt Rule
-------------------------------------------------------------------------------
Queue1          0              closest            max            closest
Queue2          0              closest            max            closest
Queue3          0              closest            max            closest
Queue4          0              closest            max            closest
Queue5          0              closest            max            closest
Queue6          0              closest            max            closest
Queue7          0              closest            max            closest
Queue8          0              closest            max            closest
-------------------------------------------------------------------------------
Queue Mode and Weight Details
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId           Mode                      Weight
-------------------------------------------------------------------------------
Queue1            weighted                   1
Queue2            weighted                   1
Queue3            weighted                   1
Queue4            weighted                   1
Queue5            weighted                   1
Queue6            weighted                   1
Queue7            weighted                   1
Queue8            weighted                   1
-------------------------------------------------------------------------------
High Slope
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            75
Queue2          Down            70           90            75
Queue3          Down            70           90            75
Queue4          Down            70           90            75
Queue5          Down            70           90            75
Queue6          Down            70           90            75
Queue7          Down            70           90            75
Queue8          Down            70           90            75
-------------------------------------------------------------------------------
Low Slope
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            75
Queue2          Down            50           75            75
Queue3          Down            50           75            75
Queue4          Down            50           75            75
Queue5          Down            50           75            75
Queue6          Down            50           75            75
Queue7          Down            50           75            75
Queue8          Down            50           75            75
-------------------------------------------------------------------------------
Burst Sizes and Time Average Factor
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId         CBS            MBS       Time Average Factor        Queue-Mgmt
-------------------------------------------------------------------------------
Queue1          def               def              7           default
Queue2          def               def              7           default
Queue3          def               def              7           default
Queue4          def               def              7           default
Queue5          def               def              7           default
Queue6          def               def              7           default
Queue7          def               def              7           default
Queue8          def               def              7           default

-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/21
Port-id : 1/1/23
Port-id : 1/1/25
Port-id : 1/1/26
===============================================================================
A:Dut-A>show>qos#
A:Dut-A>show>qos#

Table 2. Output fields: QoS access egress
Label Description

Policy-Id

The ID that uniquely identifies the policy

Remark

True — Remarking is enabled for all the dot1q-tagged packets that egress the ports on which the sap-egress QoS policy is applied and remarking is enabled

False — Remarking is disabled for the policy

Remark Pol Id

Displays the policy id of the remarking policy

Scope

Exclusive — Implies that this policy can be applied only to a single access egress port

Template — Implies that this policy can be applied to

multiple access ports on the router

Description

A text string that helps identify the policy’s context in the configuration file

Queue Rates and Rules

QueueId

Displays the Queue identifier associated with the sap-egress QoS policy

CIR

Specifies the administrative Committed Information Rate (CIR) parameters for the queue

The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

CIR Adpt Rule

min — The operational CIR for the queue will be equal to or greater than the administrative rate specified using the rate command

max — The operational CIR for the queue will be equal to or less than the administrative rate specified using the rate command

closest — The operational CIR for the queue will be the rate closest to the rate specified using the rate command without exceeding the operational PIR

PIR

Specifies the administrative Peak Information Rate (PIR) parameters for the queue

The PIR defines the maximum rate that the queue can transmit packets through the access port.

PIR Adpt Rule

min — The operational PIR for the queue will be equal to or greater than the administrative rate specified using the rate command

max — The operational PIR for the queue will be equal to or less than the administrative rate specified using the rate command

closest — The operational PIR for the queue will be the rate closest to the rate specified using the rate command

High Slope/Low slope

QueueId

Displays the Queue identifier associated with the sap-egress QoS policy

State

Displays the state of the queue. The state of the queue can be either ‟Up” or ‟Down”

Start Avg

Specifies the low priority or high priority RED slope position for the shared buffer average utilization value where the packet discard probability starts to increase above zero

Max Avg

Specifies the percentage of the shared buffer space for the buffer pool at which point the drop probability becomes ‟1”

This parameter is expressed as a decimal integer.

Max Prob

Specifies the high priority RED slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one

Burst Sizes and Time Average Factor

QueueId

Displays the Queue identifier associated with the sap-egress QoS policy

CBS

Displays the configured CBS value

MBS

Displays the configured MBS value

Time Average Factor

Displays the value of the time average factor in use