Network queue QoS policies
This chapter provides information to configure network queue QoS policies using the CLI.
Overview
Network queue policies define the egress network queuing for the traffic egressing on the access uplink ports. Network queue policies are used at the Ethernet port and define the bandwidth distribution for the FC traffic egressing on the Ethernet port.
On 7210 SAS-D and 7210 SAS-Dxp, all network-queue policies contain eight queues. The user cannot allocate fewer queues or change the mapping of FC to queue. Each of these queues is shared by unicast and multicast traffic.
Basic configurations
A basic network queue QoS policy must conform to the following:
Each network queue QoS policy must have a unique policy name.
Queue parameters can be modified but cannot be deleted.
Creating a network queue QoS policy
Configuring and applying QoS policies other than the default policy is optional. A default network queue policy is applied to all access uplink ports:
To create a network queue policy, define the following:
network queue policy name
The system does not dynamically assign a name.
description
The description provides a brief overview of policy features.
On 7210 SAS-D and 7210 SAS-Dxp, FCs are mapped to eight queues available at the port according to FC-to-queue ID map.
Use the following syntax to create a network queue QoS policy.
config>qos
network-queue policy-name
description description-string
queue queue-id
rate cir cir-percent [pir pir-percent]
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
*A:7210SASD>config>qos>network-queue# info detail
----------------------------------------------
description "Default network queue QoS policy."
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
exit
queue 2
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 3
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 4
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 5
rate cir 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 6
rate cir 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 7
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 8
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
----------------------------------------------
*7210SASD>config>qos>network-queue#
*7210SASDxp>config>qos>network-queue# info detail
----------------------------------------------
description "Default network queue QoS policy."
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
exit
queue 2
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 3
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 4
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 5
rate cir 15 pir 100
adaptation-rule cir closest pir closest
exit
queue 6
rate cir 15 pir 100
adaptation-rule cir closest pir closest
exit
queue 7
rate cir 5 pir 100
adaptation-rule cir closest pir closest
exit
queue 8
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
Applying network queue configuration in access-uplink mode
Use the following syntax to apply a network queue policy to an Ethernet port.
config>port#
ethernet
access
uplink
queue-policy policy-name
#--------------------------------------------------
echo "Port Configuration"
#--------------------------------------------------
port 1/1/1
ethernet
mode access uplink
access
uplink
queue-policy "nq1-cbs"
exit
exit
exit
no shutdown
exit
Default network queue policy values
The default network queue policies are identified as policy-id default. The default policies cannot be modified or deleted. The following table lists the network queue policy defaults for 7210 SAS-D.
Field |
Default |
|---|---|
description |
Default network queue QoS policy. |
queue 1 |
|
rate |
|
cir |
0 |
pir |
100 |
queue 2 |
|
rate |
|
cir |
25 |
pir |
100 |
queue 3 |
|
rate |
|
cir |
25 |
pir |
100 |
queue 4 |
|
rate |
|
cir |
25 |
pir |
100 |
queue 5 |
|
rate |
|
cir |
100 |
pir |
100 |
queue 6 |
|
rate |
|
cir |
100 |
pir |
100 |
queue 7 |
|
rate |
|
cir |
10 |
pir |
100 |
queue 8 |
|
rate |
|
cir |
10 |
pir |
100 |
The following table lists the network queue policy defaults for 7210 SAS-Dxp.
Field |
Default |
|---|---|
description |
Default network queue QoS policy. |
queue 1 |
|
rate |
|
cir |
0 |
pir |
100 |
queue 2 |
|
rate |
|
cir |
10 |
pir |
100 |
queue 3 |
|
rate |
|
cir |
10 |
pir |
100 |
queue 4 |
|
rate |
|
cir |
10 |
pir |
100 |
queue 5 |
|
rate |
|
cir |
15 |
pir |
100 |
queue 6 |
|
rate |
|
cir |
15 |
pir |
100 |
queue 7 |
|
rate |
|
cir |
5 |
pir |
100 |
queue 8 |
|
rate |
|
cir |
10 |
pir |
100 |
The following displays network queue default policy parameters for 7210 SAS-D.
*A:dut-a>config>qos>network-queue# info detail
----------------------------------------------
description "Default network queue QoS policy."
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
exit
queue 2
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 3
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 4
rate cir 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 5
rate cir 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 6
rate cir 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 7
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 8
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
The following displays network queue default policy parameters for 7210 SAS-Dxp.
*A:dut-a>config>qos>network-queue# info detail
----------------------------------------------
description "Default network queue QoS policy."
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
exit
queue 2
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 3
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 4
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 5
rate cir 15 pir 100
adaptation-rule cir closest pir closest
exit
queue 6
rate cir 15 pir 100
adaptation-rule cir closest pir closest
exit
queue 7
rate cir 5 pir 100
adaptation-rule cir closest pir closest
exit
queue 8
rate cir 10 pir 100
adaptation-rule cir closest pir closest
exit
Service management tasks
This section describes the service management tasks.
Deleting network queue QoS policies
A network queue policy is associated by default with all access uplink ports. You can replace the default policy with a customer-configured policy, but you cannot entirely remove a QoS policy. When you remove a QoS policy, the policy association reverts to the default network-queue policy default.
Use the following syntax to delete a user-created network queue policy.
config>qos# no network-queue policy-name
The following example shows the command usage to delete a user-created network queue policy.
config>qos# no network-queue nq1
Copying and overwriting network queue QoS policies
You can copy an existing network queue policy, rename it with a new policy ID name, or overwrite an existing network queue policy. The overwrite option must be specified or an error occurs if the destination policy ID exists.
Use the following syntax to copy and overwrite a QoS policy.
config>qos# copy network-queue source-policy-id dest-policy-id [overwrite]
The following example shows the command usage to copy and overwrite a QoS policy.
config>qos# copy network-queue nq1-cbs nq2-cbs
The following is a sample configuration output showing copied policies.
*A:card-1>config>qos# info
#--------------------------------------------------
echo "QoS Slope and Queue Policies Configuration"
#--------------------------------------------------
.......
network-queue "nq1-cbs" create
queue 1
rate cir 0 pir 32
adaptation-rule cir max
exit
queue 2
exit
queue 3
exit
queue 4
exit
queue 5
exit
queue 6
rate cir 0 pir 4
exit
queue 7
rate cir 3 pir 93
exit
queue 8
rate cir 0 pir 3
exit
exit
network-queue "nq2-cbs" create
queue 1
rate cir 0 pir 32
adaptation-rule cir max
exit
queue 2
exit
queue 3
exit
queue 4
exit
queue 5
exit
queue 6
rate cir 0 pir 4
exit
queue 7
rate cir 3 pir 93
exit
queue 8
rate cir 0 pir 3
exit
exit
----------------------------------------------
*A:card-1>config>qos# info
Editing network queue QoS policies
You can change existing policies, except the default policies, and entries in the CLI. The changes are applied immediately to all ports where the policy is applied. To prevent configuration errors, use the copy command to make a duplicate of the original policy to a work area, make the edits, and then overwrite the original policy.
Network queue QoS policy command reference
Command hierarchies
Configuration commands
- config
- qos
- network-queue policy-name [create]
- description description-string
- no description
- queue queue-id
- adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
- no adaptation-rule
- rate cir-rate-in-kbps [pir pir-rate-in-kbps]
- no rate
Operational commands
- config
- qos
- copy network-queue src-name dst-name [overwrite]
Show commands
- show
- qos
- network-queue [network-queue-policy-name] [detail]
Command descriptions
Configuration commands
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
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.
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
Description
This command copies or overwrites existing network queue QoS policies to another network queue policy ID. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.
Parameters
- network-queue src-name dst-name
Specifies that the source policy ID and the destination policy ID are network-queue policy IDs. Specifies the source policy ID that the copy command attempts to copy from, and the destination policy ID to which the command copies a duplicate of the policy.
- overwrite
Specifies that everything in the existing destination policy is overwritten with the contents of the source policy. If overwrite is not specified, a message is generated saying that the destination policy ID exists.
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
Description
This command creates a context to configure a network queue policy. Network queue policies on the Ethernet port define network egress queuing.
Network queue policies define the egress queuing for access-uplink ports.
The no form of this command removes the network-queue policy from use. However, the network queue with policy-name default cannot be modified or deleted.
Default
default
Parameters
- policy-name
Specifies the name of the network queue policy. Allowed values are 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
Specifies that a network queue policy is created.
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
Description
This command configures a QoS network-queue policy queue.
The FCs are mapped to queues, as listed in FC-to-queue ID map. Only one FC can be mapped to one queue. A queue-id value of 8 is the highest priority and a queue-id value of 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 guarantee high priority treatment, because the scheduler policy can influence the relative priority among the queues.
Parameters
- queue-id
Specifies the queue within the policy. This is a required parameter each time the queue command is executed.
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 settings when the queue is provisioned in hardware. For the CIR and PIR parameters individually, 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 pir 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.
- 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.
slope-policy
Syntax
[no] slope-policy name
Context
config>qos>network-queue>queue
Platforms
Supported on all 7210 SAS platforms as described in this document
Description
This command is used to override 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 High and Low slope definitions that will be used by the queue.
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 the command restores the default slope policy to the queue.
Parameters
- name
The name parameter is required and must specify an existing slope policy name. If slope-policy-name does not exist, the slope-policy command will fail.
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 PIR and the CIR parameters for the queue. The PIR defines the maximum rate at which 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 any time, changing 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 and CIR 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 of 0 is assumed. Fractional values are not allowed and must be specified 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.
- 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 the value must be a positive integer.
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
Description
This command displays network queue policy information.
Parameters
- network-queue-policy-name
Specifies the name of the network queue policy. Allowed values are 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.
- detail
Specifies 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 policy information, and Output fields: network queue policy describes the output fields.
Sample output*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>config>qos# show qos network-queue nq1-cbs detail
===============================================================================
QoS Network Queue Policy
-------------------------------------------------------------------------------
Network Queue Policy (nq1-cbs)
-------------------------------------------------------------------------------
Policy : nq1-cbs
Accounting : packet-based
-------------------------------------------------------------------------------
Queue CIR PIR CBS
CIR Rule PIR Rule
-------------------------------------------------------------------------------
1 0 32 8.29
max closest
2 0 100 6.00
closest closest
3 0 100 10.00
closest closest
4 0 100 6.00
closest closest
5 0 100 10.00
closest closest
6 0 4 10.00
closest closest
7 3 93 1.00
closest closest
8 0 3 7.00
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/1
===============================================================================
*A:card-1>config>qos#
|
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 |