Network queue QoS policy queue commands

queue

Syntax

[no] queue queue-id

Context

config>qos>network-queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command configures a QoS network-queue policy queue.

The user has an option to define the FC to queue map. Either one or multiple FCs can be mapped to the same queue.

The no form of this command deletes the queue.

Parameters

queue-id

Specifies the queue-id for the queue, expressed as an integer. The queue-id uniquely identifies the queue within the policy.

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

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 rate and cir 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.

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.

cbs

Syntax

[no] cbs size-in-kbytes

Context

config>qos>network-queue>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

32

Parameters

size-in-kbytes

Specifies the CBS value in kilobytes.

Values

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

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

mbs

Syntax

mbs size-in-kbytes

no mbs

Context

config>qos>network-queue>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

512

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)

priority

Syntax

priority level

no priority

Context

config>qos>network-queue>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

slope-policy

Syntax

slope-policy name

no slope-policy

Context

config>qos>network-queue>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command overrides the default slope-policy configuration for the queue. The specified slope- policy name must exist as a current slope policy name. If the slope policy does not exist, the slope-policy command fails. If a slope policy is currently associated with a queue, the slope policy cannot be removed from the system.

The slope policy contains the ring and non-ring high and low WRED slope definitions that are used by the queue. See Buffer pools for more information about ring and non-ring buffer pools and slope usage.

If the slope-policy command is not executed or the no slope-policy command is executed, the default slope policy will be associated with the queue.

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

Parameters

name

Specifies an existing slope policy name, up to 32 characters.

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

Description

This command defines the administrative PIR and the administrative 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 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(100), and CIR(0) parameters.

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 is assumed. The parameter must be given as positive integer.

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

Default

0

Values

0 to 100

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 is assumed. The parameter must be given as positive integer.

Default

100

Values

1 to 100

weight

Syntax

weight weight

no weight

Context

config>qos>network-queue>queue

Platforms

Supported on all 7210 SAS platforms as described in this document

Description

This command specifies the weight of the queue.

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 default.

Parameters

weight

Specifies the weight of the queue.

Values

1 to 100