8.5. Network Queue QoS Policy Command Reference

8.5.1. Command Hierarchies

8.5.1.1. Configuration Commands

— config
— qos
network-queue policy-name [create]
description description-string
[no] queue queue-id
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
cbs size-in-kbyte
— no cbs
mbs size in kbytes
— no mbs
priority level
— no priority
slope-policy name
rate cir cir-percent [pir pir-percent]
— no rate
weight weight
— no weight

8.5.1.2. Operational Commands

— config
— qos
copy network-queue src-name dst-name [overwrite]

8.5.1.3. Show Commands

— show
— qos
network-queue [network-queue-policy-name] [detail]

8.5.2. Command Descriptions

8.5.2.1. Configuration Commands

8.5.2.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>network-queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

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.

8.5.2.1.2. Operational Commands

copy

Syntax 
copy network-queue src-name dst-name [overwrite]
Context 
config>qos
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command copies or overwrites existing network queue QoS policies to another network queue 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 
network-queue src-name dst-name
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. This parameter indicated that the source policy ID and the destination policy ID are network-queue policy IDs.
overwrite—
Specifies to replace the existing destination policy. Everything in the existing destination policy will be overwritten with the contents of the source policy. If the overwrite keyword is not specified, a message is generated saying that the destination policy ID exists.

8.5.2.1.3. Network Queue QoS Policy Commands

network-queue

Syntax 
[no] network-queue policy-name [create]
Context 
config>qos
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure a network queue policy. Network queue policies on the Ethernet port define network egress queuing.

On the 7210 SAS-K 2F1C2T, the network queue policy can be associated with access-uplink ports to define queues to be used on egress.

On the 7210 SAS-K 2F6C4T and 7210 SAS-K 3SFP+ 8C, the network queue policy can be associated with access-uplink ports and network ports to define queues to be used on egress.

Default 

default

Parameters 
policy-name—
Specifies the network queue policy. Valid names consist of any string up to 32 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.
create—
Keyword to create a network queue policy.

8.5.2.1.4. Network Queue QoS Policy Queue Commands

queue

Syntax 
[no] queue queue-id
Context 
config>qos>network-queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure 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
Supported 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
Supported 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
Supported 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
Supported 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
Supported 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 will fail. 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 will be 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
Supported 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
Supported 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

 

8.5.2.2. Show Commands

network-queue

Syntax 
network-queue [network-queue-policy-name] [detail]
Context 
show>qos
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays network queue policy information.

Parameters 
network-queue-policy-name—
Displays network queue information for the specified network queue policy. Valid names consist of any string up to 32 characters long 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
detail—
Displays each queue’s rates and adaptation-rule and cbs details. It also shows FC to queue mapping details.
Output 

The following output is an example of network queue information, and Table 40 describes the output fields.

Sample Output
*A:SAH01-051>show>qos# network-queue "default" detail
 
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy         : default
Description    : Default network queue QoS policy.
Wrr Policy     :
Pkt.Byte Offset: 0
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
FC To Queue Mappings
 
-------------------------------------------------------------------------------
FC        Queue
-------------------------------------------------------------------------------
be        1
l2        2
af        3
l1        4
h2        5
ef        6
h1        7
nc        8
-------------------------------------------------------------------------------
Queue Rates and Rules
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        CIR(%)       CIR Adpt Rule        PIR(%)       PIR Adpt Rule
-------------------------------------------------------------------------------
Queue1          0              closest            100            closest
Queue2          25             closest            100            closest
Queue3          25             closest            100            closest
Queue4          25             closest            100            closest
Queue5          100            closest            100            closest
Queue6          100            closest            100            closest
Queue7          10             closest            100            closest
Queue8          10             closest            100            closest
-------------------------------------------------------------------------------
Queue Priority and Weight Details
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId         Priority      Weight
-------------------------------------------------------------------------------
Queue1          1             1
Queue2          1             1
Queue3          1             1
Queue4          1             1
Queue5          1             1
Queue6          1             1
Queue7          1             1
Queue8          1             1
-------------------------------------------------------------------------------
High Slope Non Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            80
Queue2          Down            70           90            80
Queue3          Down            70           90            80
Queue4          Down            70           90            80
Queue5          Down            70           90            80
Queue6          Down            70           90            80
Queue7          Down            70           90            80
Queue8          Down            70           90            80
-------------------------------------------------------------------------------
Low Slope Non Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            80
Queue2          Down            50           75            80
Queue3          Down            50           75            80
Queue4          Down            50           75            80
Queue5          Down            50           75            80
Queue6          Down            50           75            80
Queue7          Down            50           75            80
Queue8          Down            50           75            80
-------------------------------------------------------------------------------
High Slope Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            80
Queue2          Down            70           90            80
Queue3          Down            70           90            80
Queue4          Down            70           90            80
Queue5          Down            70           90            80
Queue6          Down            70           90            80
Queue7          Down            70           90            80
Queue8          Down            70           90            80
-------------------------------------------------------------------------------
Low Slope Ring
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            80
Queue2          Down            50           75            80
Queue3          Down            50           75            80
Queue4          Down            50           75            80
Queue5          Down            50           75            80
Queue6          Down            50           75            80
Queue7          Down            50           75            80
Queue8          Down            50           75            80
-------------------------------------------------------------------------------
Slope Policies
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        CBS(KBytes)  MBS(KBytes)    Slope-Policy
-------------------------------------------------------------------------------
Queue1           50          200           default
Queue2           50          200           default
Queue3           50          200           default
Queue4           50          200           default
Queue5           50          200           default
Queue6           50          200           default
Queue7           50          200           default
Queue8           50          200           default
 
Network-Port Associations
-------------------------------------------------------------------------------
No Matching Entries
 
===============================================================================
*A:SAH01-051>show>qos#
Table 40:  Output Fields: Network Queue 

Label

Description

Policy

The policy name that uniquely identifies the policy

Accounting

Displays whether the accounting mode is packet-based or frame-based

Description

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

Port-Id

Displays the physical port identifier where the network queue policy is applied

Queue

Displays the queue ID

CIR

Displays the committed information rate

PIR

Displays the peak information rate

CBS

Displays the committed burst size

FC

Displays FC to queue mapping