SAP ingress queue and meter QoS policy commands

queue

Syntax

queue queue-id [create]

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.

meter

Syntax

meter meter-id

no meter

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

adaptation-rule

Syntax

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

no adaptation-rule

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.

adaptation-rule

Syntax

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

no adaptation-rule

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.

cbs

Syntax

[no] cbs size-in-kbytes

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)

cbs

Syntax

[no] cbs size [kbits | bytes | kbytes]

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

mbs

Syntax

[no] mbs size-in-kbytes

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)

mbs

Syntax

[no] mbs size [kbits | bytes | kbytes]

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

priority

Syntax

[no] priority level

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

mode

Syntax

mode mode

no mode

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.

rate

Syntax

rate cir cir-rate-in-kbps [pir pir-rate-in-kbps]

no rate

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)

rate

Syntax

rate cir cir-rate-in-kbps [pir pir-rate-in-kbps]

no rate

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)