Network queue QoS policy queue commands

queue

Syntax

queue queue-id

Context

config>qos>network-queue

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

Description

This command configures a QoS network-queue policy queue.

On 7210 SAS-Mxp and 7210 SAS-T (both network and access-uplink mode), the behavior is as follows.

The queues are created by default (the user has no option to delete them) and the FCs are mapped to these queues as per Table: Forwarding class to queue-ID map . Only one FC is mapped to one queue. Network queue carry both the unicast and multicast traffic and no segregation is done. The queues are scheduled are per the port scheduler policy associated with this port.

On the 7210 SAS-R6 and 7210 SAS-R12, the behavior is as follows.

The queues are created by default (the user has no option to delete them) and the FCs are mapped to queues, see Table: Forwarding class to queue-ID map for more information. Only one FC can be mapped to one queue. Queue ID 8 is the highest priority and queue ID 1 is the lowest priority. Network queues carry both the unicast and multicast traffic and no segregation is performed.

The hardware port scheduler prioritizes the queue according to the priority for each queue. High priority traffic should be mapped to high priority FCs. Mapping traffic to high priority FCs does not necessarily guarantee high priority treatment, because the scheduler policy can influence the relative priority among the queues. See Schedulers on 7210 SAS-R6 and 7210 SAS-R12 for more information about scheduling behavior and the queue parameters considered by the scheduler.

On 7210 SAS-Sx 1/10GE: standalone and standalone-VC, the behavior is as follows.

The queues are created by default (the user has no option to delete them) and the FCs are mapped to these queues as per Table: Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE. Network queue carry both the unicast and multicast traffic and a separate queue is used for them per FC. In other words, a total of 2 queues are allocated per FC, one queue each for unicast traffic and for multicast traffic. The queues are scheduled are per the port scheduler policy associated with this port.

Parameters

queue-id

Specifies the queue ID, expressed as an integer. The queue-id uniquely identifies the queue within the policy. This is a required parameter each time the queue command is executed.

Values

1 to 8

adaptation-rule

Syntax

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

no adaptation-rule

Context

config>qos>network-queue>queue

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

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 cir closest pir 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 Table: 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 queuequeue-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 Table: 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.

queue-mgmt

Syntax

queue-mgmt name

no queue-mgmt

Context

config>qos>network-queue>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command configures a WRED policy for the specified queue.

The queue management policy is used to specify the queue buffer parameters and queue slope policy parameters.

The no form of this command associates the default SAP egress queue management policy with this queue.

Parameters

name

Specifies the name of the queue management policy, up to 32 characters.

queue-mode

Syntax

[no] queue-mode queue-mode

Context

config>qos>network-queue>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command determines whether the queue operates in strict or weighted mode.The no form of this command reverts the queue mode to the default value.

Default

weighted

Parameters

queue-mode

Specifies the mode of operation for the queue.

Values

strict — If a queue is configured in strict mode, the scheduler schedules the queue in order of their priority in the 2 passes, the CIR loop and the PIR loop.

weighted — If a queue is configured in weighted mode, the scheduler examines these queues in two passes - CIR loop and a PIR loop. In the CIR loop, it distributes the available bandwidth to all the strict and then weighted queues in round-robin up to the configured CIR rate. It examines the weighted queues in the PIR loop, after examining all the strict queues and distributes the available bandwidth, if any, in the proportion of the configured weights.

rate

Syntax

rate [cir cir-percent] [pir pir-percent]

no rate

Context

config>qos>network-queue>queue

Platforms

Supported on all 7210 SAS platforms as described in this document, including those operating in access-uplink mode

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 any time, and alters 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 (100) and CIR parameters (0).

Parameters

cir cir percent

Specifies the percentage of the guaranteed rate allowed for the queue. When the rate command is executed, a valid CIR setting must be explicitly defined. When the rate command has not been executed, the default CIR of 0 is assumed. Fractional values are not allowed and must be given as a positive integer.

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

Values

0 to 100

Default

0

pir pir percent

Specifies the percentage of the maximum rate allowed for the queue. When the rate command is executed, the PIR setting is optional. When the rate command has not been executed, or the PIR parameter is not explicitly specified, the default PIR of 100 is assumed. Fractional values are not allowed and must be given as a positive integer.

Values

1 to 100 percent

Default

100

weight

Syntax

weight weight

no rate

Context

config>qos>network-queue>queue

Platforms

7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

Description

This command configures the weight for the specified policy.

The configured weight determines the proportion of available bandwidth that is given to this queue in comparison to other queues contending for bandwidth at the same priority level.

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

Default

weight 1

Parameters

weight

Specifies the weight of the queue.

Values

1 to 15