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

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 settings when the queue is provisioned in hardware. For the CIR and PIR parameters individually, 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.

rate

Syntax

rate cir cir-rate [pir pir-rate]

no rate

Context

config>qos>access-egress>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command defines the administrative PIR and 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 over subscription 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 any time, altering the PIR and CIR rates for all queues created on the access ports.

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

Parameters

cir-rate

Specifies that the default administrative CIR used by the queue is overridden. 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 specified as a positive integer.

Values

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

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

Default

0

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 specified 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

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

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

Default

max

scope

Syntax

scope {exclusive | template}

no scope

Context

config>qos>access-egress

Platforms

Supported on all 7210 SAS platforms as described in this document

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 sets the scope of the policy to the default of template.

Default

template

Parameters

exclusive

Specifies that the policy can only be applied to one 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 becomes available for assignment to another exclusive interface. The system default policies cannot be put into the exclusive scope. An error occurs if scope exclusive is executed in the default access-egress policy (policy-id 1).

template

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

access-egress

Syntax

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

Context

show>qos

Platforms

Supported on all 7210 SAS platforms as described in this document

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 Table: Access-egress labels and descriptions 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
-------------------------------------------------------------------------------
===============================================================================
A:Dut-A>show>qos#
A:Dut-A>show>qos#
Table: Access-egress labels and descriptions

Label

Description

Scope

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

Template — Specifies that this policy can be applied to multiple access ports on the router

Description

A text string that helps identify the policy 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 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 is equal to or greater than the administrative rate specified using the rate command

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

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

PIR

Specifies the administrative 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 is equal to or greater than the administrative rate specified using the rate command

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

closest — The operational PIR for the queue is 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