8.6. Network queue QoS policy command reference

8.6.1. Command hierarchies

8.6.1.1. Configuration commands for 7210 SAS-T (in network mode and access-uplink mode)

config
— qos
network-queue policy-name [create]
description description-string
queue queue-id
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
rate cir cir-rate-in-kbps [pir pir-rate-in-kbps]
— no rate

8.6.1.2. Configuration commands for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12

config
— qos
network-queue policy-name [create]
description description-string
queue queue-id
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
queue-mgmt name
— no queue-mgmt
queue-mode queue-mode
— no queue-mode
rate [cir cir-percent] [pir pir-percent]
— no rate
weight weight
— no weight

8.6.1.3. Configuration commands for 7210 SAS-Sx 1/10GE and 7210 SAS-Sx 10/100GE

config
— qos
network-queue policy-name [create]
description description-string
queue queue-id
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
rate cir cir-rate-in-kbps [pir pir-rate-in-kbps]
— no rate

8.6.1.4. Operational commands

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

8.6.1.5. Show commands

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

8.6.2. Command descriptions

8.6.2.1. Configuration commands

8.6.2.1.1. Generic commands

description

Syntax 
description description-string
no description
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 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.6.2.2. Network queue QoS policy commands

network-queue

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

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

Description 

Commands in this context configure a network queue policy.

Network queue policies define the egress network queuing for the traffic egressing on the network ports and hybrid ports, and access-uplink ports (in access-uplink mode). Network queue policies define the bandwidth distribution for the various FC traffic egressing on the port. By default, network queue policy defines eight queues and a mapping of FC-to-queue.

Default 

default

Parameters 
policy-name—
Specifies the name of 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.6.2.3. 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 30. 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 30 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/S 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 31. 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 32 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 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. See Table 32 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

 

8.6.2.4. Operational commands

copy

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

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

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 specifies the destination policy ID to which the command will copy a duplicate of the policy. Indicates that the source policy ID and the destination policy ID are network-queue policy IDs.
overwrite—
Keyword to replace the existing destination policy. Everything in the existing destination policy will be overwritten with the contents of the source policy. If overwrite is not specified, the following message is generated to indicate that the destination policy ID exists:

SR>config>qos# copy network-queue nq1 nq2

MINOR: CLI Destination "nq2" exists - use {overwrite}

SR>config>qos# copy network-queue nq1 nq2 overwrite

8.6.2.5. Show commands

network-queue

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

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

Description 

This command displays network queue policy information.

Parameters 
network-queue-policy-name—
Specifies the name of the 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 for each queue its rates, adaptation rule, and cbs details. It also shows FC to queue mapping details.
Output 

The following outputs are examples of network queue policy information, and the associated tables describe the output fields:

Sample output 1
*A:card-1# show qos network-queue nq1    
===============================================================================
QoS Network Queue Policy
-------------------------------------------------------------------------------
Network Queue Policy (nq1)
-------------------------------------------------------------------------------
Policy         : nq1                                                          
Accounting     : packet-based 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/20 
===============================================================================
*A:card-1# 
*A:card-1# show qos network-queue nq1 detail 
===============================================================================
QoS Network Queue Policy
===============================================================================
Network Queue Policy (nq1)
-------------------------------------------------------------------------------
Policy         : nq1                                                           
Accounting     : packet-based                                                  
Description    : this is a network-queue policy
-------------------------------------------------------------------------------
Queue CIR        PIR       CBS 
      CIR Rule   PIR Rule                
-------------------------------------------------------------------------------
1      0         100       12.50                                               
       closest   closest                                                       
2      0         100       12.50                                               
       closest   closest                                                       
3      0         100       12.50                                               
       closest   closest                                                       
4      0         100       12.50                                               
       closest   closest                                                       
5      0         100       12.50                                               
       closest   closest                                                       
6      0         100       12.50                                               
       closest   closest                                                       
7      0         100       12.50                                               
       closest   closest                                                       
8      0         100       12.50                                               
       closest   closest                                                       
-------------------------------------------------------------------------------
FC    UCastQ
-------------------------------------------------------------------------------
be     1                                                                       
l2     2                                                                       
af     3                                                                       
l1     4                                                                       
h2     5                                                                       
ef     6                                                                       
h1     7                                                                       
nc     8                                                                       
-------------------------------------------------------------------------------
Associations                          
-------------------------------------------------------------------------------
Port-id : 1/1/20                                                               
===============================================================================
*A:card-1# 
*A:card-1# show qos network-queue default detail 
===============================================================================
QoS Network Queue Policy
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy         : default                                                       
Table 58:  Output fields: network queue labels 

Label

Description

Policy

The policy name that uniquely identifies the policy

Description

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

Associations

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

Sample output 2
*A:SAS>config>qos>network-queue#  show qos network-queue default 
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy         : default                      
Accounting     : packet-based                 
Description    : Default network queue QoS policy.
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/10                                                               
Port-id : 1/1/19                                                               
Port-id : 1/1/20                                                               
Port-id : 1/1/24                                                               
===============================================================================
 
*A:SAS>config>qos>network-queue#  show qos network-queue default detail 
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (default)
-------------------------------------------------------------------------------
Policy         : default                      
Accounting     : packet-based                 
Description    : Default network queue QoS policy.
-------------------------------------------------------------------------------
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            10             closest  
-------------------------------------------------------------------------------
Parent Details
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId          Port       CIR Level      PIR Weight
-------------------------------------------------------------------------------
Queue1          True             1             1  
Queue2          True             2             1  
Queue3          True             3             1  
Queue4          True             4             1  
Queue5          True             5             1  
Queue6          True             6             1  
Queue7          True             7             1  
Queue8          True             8             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
-------------------------------------------------------------------------------
Queue1          def            def           7
Queue2          def            def           7
Queue3          def            def           7
Queue4          def            def           7
Queue5          def            def           7
Queue6          def            def           7
Queue7          def            def           7
Queue8          def            def 
 
Table 59:  Output fields: network queue policy 

Label

Description

Policy

The policy name that uniquely identifies the policy

Description

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

Associations

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

Queue

Displays the queue ID

CIR(%)

Displays the committed information rate

CIR Adapt Rule

Displays the adaptation rule in use

PIR(%)

Displays the peak information rate

PIR Adapt Rule

Displays the adaptation rule in use

Port

Indicates if the parent scheduler is a port scheduler

CIR Level

Displays the priority of the queue in the CIR loop

PIR Weight

Displays the weight of the queue used in the PIR loop

High Slope

Displays the WRED high-slope parameters

Low Slope

Displays the WRED low-slope parameters

Burst Sizes (CBS/MBS)

Displays the configured CBS and MBS value

Time Avg Factor

Displays the WRED Time Average Factor value in use

FC and UcastQ

Displays the FC-to-queue association