Network queue QoS policies
This section provides information to configure network queue QoS policies using the command line interface.
Overview
Network queue policies define the network egress queue parameters. Network queue policies are associated with the following:
network ports on 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, and 7210 SAS-Mxp in network mode
hybrid ports on 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, and 7210 SAS-Mxp in network mode
access uplink ports on 7210 SAS-T in access uplink mode
Network queue policies define the bandwidth distribution for the network egress queues.
There is one default network queue policy. The default policies can be copied but they cannot be deleted or modified. The default policy is identified as network-queue default. Default network queue policies are applied to all network ports and hybrid port. The user must explicitly create and then associate other network queue QoS policies if the default values need to be modified.
The default network queue policy is defined as follows:
On 7210 SAS-T (both access-uplink and network mode), it defines 8 forwarding classes and assigns 8 queues, one to each FC.
On 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12, it defines 8 forwarding classes and assigns 8 queues, one to each FC.
On 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE, it defines 8 forwarding classes and assigns 16 queues, one each to unicast traffic mapped to the FC and to multicast traffic mapped to the FC, for a total of 2 egress queues per FC.
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.
Create 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 network ports (for 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, and 7210 SAS-Mxp in network mode) and access uplink ports (for 7210 SAS-T in access uplink mode).
To create a network queue policy, define the following:
network queue policy name
The system will not dynamically assign a name.
description
The description provides a brief overview of policy features.
FCs are mapped to the queues according to Forwarding class to queue-ID map and Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE
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]
The following is a sample configuration output to create a network queue QoS policy on the 7210 SAS-Sx/S 1/10GE, 7210 SAS-Sx 10/100GE, and 7210 SAS-T.
*A:Dut-B>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
----------------------------------------------
*A:Dut-B>config>qos>network-queue#
The following is a sample configuration output to create a network queue QoS policy on the 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12.
*A:7210SAS>config>qos# info detail
----------------------------------------------
#--------------------------------------------------
echo "QoS Policy Configuration"
#--------------------------------------------------
network-queue "t" create
no description
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 2
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 3
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 4
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 5
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 6
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 7
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 8
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
----------------------------------------------
*A:7210SAS>config>qos
Applying network queue policies
Apply network queue policies to the following entities:
Ethernet Ports
Applying network queue configuration in network mode
Use the following syntax to apply a network queue policy to an Ethernet port in network mode of operation.
The network-queue policy can only be applied on a network port.
config>port#
ethernet
#--------------------------------------------------
echo "Port Configuration"
#--------------------------------------------------
port 1/1/1
ethernet
mode network
network
queue-policy "nq1-cbs"
exit
exit
exit
no shutdown
exit
Applying network queue configuration in access-uplink mode
Use the following syntax to apply a network queue policy to an Ethernet port in access-uplink mode of operation.
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 for 7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE devices.
A:qos1# 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 CIR PIR CBS
CIR Rule PIR Rule
-------------------------------------------------------------------------------
1 0 100 12.50
closest closest
2 25 100 12.50
closest closest
3 25 100 12.50
closest closest
4 25 100 12.50
closest closest
5 100 100 12.50
closest closest
6 100 100 12.50
closest closest
7 10 100 12.50
closest closest
8 10 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/4
Port-id : 1/1/8
Port-id : 1/1/9
Port-id : 1/1/10
Port-id : 1/1/12
Port-id : 1/1/13
Port-id : 1/1/14
Port-id : 1/1/15
Port-id : 1/1/16
Port-id : 1/1/17
Port-id : 1/1/18
Port-id : 1/1/19
Port-id : 1/1/20
Port-id : 1/1/21
Port-id : 1/1/22
Port-id : 1/1/23
Port-id : 1/1/24
Port-id : lag-1
===============================================================================
A:qos1#
The following displays default policy parameters for 7210 SAS-T (access-uplink and network modes), 7210 SAS-S 1/10GE, and 7210 SAS-Sx 10/100GE.
*A:Dut-C>config>qos>network-queue# info detail
----------------------------------------------
description "Default network queue QoS policy."
queue 1
rate 0 pir 100
adaptation-rule cir closest pir closest
exit
queue 2
rate 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 3
rate 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 4
rate 25 pir 100
adaptation-rule cir closest pir closest
exit
queue 5
rate 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 6
rate 100 pir 100
adaptation-rule cir closest pir closest
exit
queue 7
rate 10 pir 100
adaptation-rule cir closest pir closest
exit
queue 8
rate 10 pir 100
adaptation-rule cir closest pir closest
exit
----------------------------------------------
*A:Dut-C>config>qos>network-queue#
The following displays default policy parameters for the default network queue policy for 7210 SAS-Mxp.
*A:sim_dutc>config>qos>network-queue$ info detail
----------------------------------------------
no description
queue 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 2
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 3
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 4
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
queue 5
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
queue-mode weighted
weight 1
exit
The following are sample default policy parameters for 7210 SAS-R6 and 7210 SAS-R12.
*A:7210SAS>show>qos# network-queue ‟default” detail
===============================================================================
QoS Network Queue Policy
===============================================================================
-------------------------------------------------------------------------------
Network Queue Policy (t)
-------------------------------------------------------------------------------
Policy : t
Accounting : packet-based
Description : (Not Specified)
Wrr Policy :
Pkt.Byte Offset: 0
-------------------------------------------------------------------------------
Queue Rates and Rules
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId CIR(%) CIR Adpt Rule PIR(%) PIR Adpt Rule
-------------------------------------------------------------------------------
Queue1 0 closest 100 closest
Queue2 0 closest 100 closest
Queue3 0 closest 100 closest
Queue4 0 closest 100 closest
Queue5 0 closest 100 closest
Queue6 0 closest 100 closest
Queue7 0 closest 100 closest
Queue8 0 closest 100 closest
-------------------------------------------------------------------------------
Queue Mode and Weight Details
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId Mode Weight
-------------------------------------------------------------------------------
Queue1 weighted 1
Queue2 weighted 1
Queue3 weighted 1
Queue4 weighted 1
Queue5 weighted 1
Queue6 weighted 1
Queue7 weighted 1
Queue8 weighted 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 Queue-Mgmt
-------------------------------------------------------------------------------
Queue1 def def 7 default
Queue2 def def 7 default
Queue3 def def 7 default
Queue4 def def 7 default
Queue5 def def 7 default
Queue6 def def 7 default
Queue7 def def 7 default
Queue8 def def 7 default
-------------------------------------------------------------------------------
FC UCastQ MCastQ EHsmdaQ
-------------------------------------------------------------------------------
be 1 9 1
l2 2 10 2
af 3 11 3
l1 4 12 4
h2 5 13 5
ef 6 14 6
h1 7 15 7
nc 8 16 8
Network-Port Associations
-------------------------------------------------------------------------------
No Matching Entries
===============================================================================
*A:7210SAS>show>qos#
*7210SAS>config>qos>network-queue# info detail
----------------------------------------------
description "Default hybrid queue QoS policy."
queue 1
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 2
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 3
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 4
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 5
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 6
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 7
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
queue 8
port-parent cir-level 1 pir-weight 1
rate cir 0 pir 100
adaptation-rule cir closest pir closest
queue-mgmt "default"
exit
----------------------------------------------
*7210SAS>config>qos>network-queue#
Default network queue policy values for hybrid ports on 7210 SAS-R6 and 7210 SAS-R12
The default network queue policies are identified as policy-id default and _tmnx_hybrid_default.The MPLS and IP traffic on hybrid ports arrives at the _tmnx_hybrid_default policy if there is no policy applied.
The following is a sample configuration output for default policy parameters for 7210 SAS-R6 and 7210 SAS-R12.
*A:7210SAS>show>qos# network-queue
===============================================================================
Network Queue Policies
===============================================================================
Policy-Id Description
-------------------------------------------------------------------------------
default Default network queue QoS policy.
_tmnx_hybrid_default Default hybrid queue QoS policy.
===============================================================================
*A:7210SAS>show>qos#
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 network ports (for devices operating in network mode) and access uplink ports (for 7210 SAS-T in access-uplink mode). The user 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.
A network-queue policy cannot be deleted until it is removed from all network ports where it is applied.
Use the following syntax to delete a user-created network queue policy.
config>qos# no network-queue policy-name
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]
config>qos# copy network-queue nq1-cbs nq2-cbs
The following is a sample of the copied policies output.
*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 for 7210 SAS-T (in network mode and access-uplink mode)
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 cir-rate-in-kbps [pir pir-rate-in-kbps]
- no rate
Configuration commands for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
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
- 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
Configuration commands for 7210 SAS-Sx 1/10GE and 7210 SAS-Sx 10/100GE
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 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, 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.
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.
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 Forwarding class to queue-ID map . 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 Forwarding class to queue-ID map 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 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 Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE. 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.
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 Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.
- pir adaptation-rule
Specifies the adaptation rule and defines the constraints enforced when adapting the PIR rate defined using the queuequeue-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 Supported hardware rates and burst step sizes for CIR and PIR values on the 7210 SAS-Mxp, 7210 SAS-R6, 7210 SAS-R12, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-T for information about supported hardware step-size rates.
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.
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.
- 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.
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.
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
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:
*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
| 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 |
*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
| 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 |