Access egress QoS policies on 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE
This section provides information to configure Access Egress QoS policies using the command line interface.
Overview
An access egress policy defines the queuing for the traffic egressing on the access ports. Access-egress queue policies are used at the Ethernet port and define the bandwidth distribution for the various FC/queue traffic egressing on the Ethernet port.
There is one default access egress policy which is identified as policy ID 1. Each policy has 8 queues available. The Forwarding Class to queue mapping is predefined and cannot be changed. The queue parameters like CIR, PIR, and so on, can be modified. The default policy can be copied but they cannot be deleted or modified.
Basic configurations
A basic access egress QoS policy must conform to the following:
have a unique access egress QoS policy ID
have a QoS policy scope of template or exclusive
queue parameters can be modified, but not deleted
The following is a sample configuration output for 7210 SAS-T in access-uplink mode.
*7210SAS>config>qos>access-egress$ info detail
----------------------------------------------
no description
remarking
scope template
queue 1
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 2
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 3
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 4
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 5
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 6
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 7
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 8
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
fc af create
no de-mark
no dot1p
dot1p-in-profile 7
dot1p-out-profile 4
exit
----------------------------------------------
The following is a sample configuration output for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE in network mode.
*A:01154300003>config>qos>access-egress# info detail
----------------------------------------------
no description
remarking
remark 200
scope template
queue 1
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 2
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 3
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 4
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 5
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 6
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 7
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 8
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
----------------------------------------------
Modifying access egress QoS queues
To modify access egress queue parameters specify the following:
queue ID value
On 7210 SAS-T, 8 Queues are identified and are mapped as defined in Forwarding class to queue-ID map .
On 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE, a queue ID in the policy identifies a FC as per the table 32.Forwarding class-to-queue ID map for 7210 SAS-Sx/S 1/10GE and 7210 SAS-Sx 10/100GE. In other words, the rate parameters configured for the FC/queue ID applies to the aggregate rate across both unicast and multicast queue for the FC.
queue parameters
Egress queues support configuration of CIR and PIR rates.
The following is a sample access egress QoS policy configuration output on 7210 SAS-T access-uplink mode.
*A:SAS-T>config>qos>access-egress>queue$ info
----------------------------------------------
adaptation-rule cir max
rate cir 2000 pir 30000
----------------------------------------------
Applying access egress QoS policies
Apply access egress policies to the following entities:
Ethernet ports
A policy can be applied to the ports that are in access mode.
Ethernet ports
Use the following syntax to apply a access-egress policy to an Ethernet port.
config>port#
ethernet access egress
qos access-egress-policy-id
The following is a sample port configuration output.
*A:card-1>config>port# info
----------------------------------------------
shutdown
ethernet
access
egress
qos 30
exit
exit
exit
----------------------------------------------
*A:card-1>config>port#
Default access egress QoS policy values
The following are sample default policy parameters.
*A:card-1>config>qos>access-egress# info detail
----------------------------------------------
description "Default Access egress QoS policy."
no remarking
scope template
queue 1
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 2
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 3
adaptation-rule cir closest pir closest
rate 0 pir max
exit
queue 4
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 5
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 6
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 7
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
queue 8
adaptation-rule cir closest pir closest
rate cir 0 pir max
exit
----------------------------------------------
*A:card-1>config>qos>access-egress#
The following table lists the default forwarding class marking values when remarking is enabled on the access egress policy for 7210 SAS devices configured in network mode and access-uplink mode:
| Default FC value | Network mode | Access-uplink mode |
|---|---|---|
|
af |
dot1p-in-profile 2 dot1p-out-profile 2 dscp-in-profile af11 dscp-out-profile af12 |
dot1p-in-profile 2 dot1p-out-profile 2 |
|
be |
dot1p-in-profile 0 dot1p-out-profile 0 dscp-in-profile be dscp-out-profile be |
dot1p-in-profile 0 dot1p-out-profile 0 |
|
ef |
dot1p-in-profile 5 dot1p-out-profile 5 dscp-in-profile ef dscp-out-profile ef |
dot1p-in-profile 5 dot1p-out-profile 5 |
|
h1 |
dot1p-in-profile 6 dot1p-out-profile 6 dscp-in-profile nc1 dscp-out-profile nc1 |
dot1p-in-profile 6 dot1p-out-profile 6 |
|
h2 |
dot1p-in-profile 4 dot1p-out-profile 4 dscp-in-profile af41 dscp-out-profile af41 |
dot1p-in-profile 4 dot1p-out-profile 4 |
|
l1 |
dot1p-in-profile 3 dot1p-out-profile 3 dscp-in-profile af21 dscp-out-profile af22 |
dot1p-in-profile 3 dot1p-out-profile 3 |
|
l2 |
dot1p-in-profile 1 dot1p-out-profile 1 dscp-in-profile cs1 dscp-out-profile cs1 |
dot1p-in-profile 1 dot1p-out-profile 1 |
|
nc |
dot1p-in-profile 7 dot1p-out-profile 7 dscp-in-profile nc2 dscp-out-profile nc2 |
dot1p-in-profile 7 dot1p-out-profile 7 |
Deleting QoS policies
Every access Ethernet port is associated, by default, with the default access egress policy (policy-id 1). You can replace the default policy with a customer-configured policy, but you cannot entirely remove the policy from the port configuration. When you remove a non-default access egress policy, the association reverts to the default policy-id 1.
A QoS policy cannot be deleted until it is removed from all access ports where they are applied.
*A:card-1>config>qos# no access-egress 30
MINOR: CLI Could not remove Access egress policy "30" because it is in use.
Removing a policy from the QoS configuration
config>qos# no access-egress policy-id
config>qos# no access-egress 100
config>qos# no access-egress 1010
Access egress QoS policy command reference
Command hierarchies
Configuration commands for 7210 SAS-T (access-uplink mode)
config
- qos
- access-egress policy-id [create]
- no access-egress policy-id
- description description-string
- no description
- fc fc-name [create]
- no fc fc-name
- [no] de-mark [force de-value]
- dot1p dot1p-priority
- no dot1p
- dot1p-in-profile dot1p-value
- no dot1p-in-profile
- dot1p-out-profile dot1p-value
- no dot1p-out-profile
- dscp-in-profile dscp-name
- no dscp-in-profile
- dscp-out-profile dscp-name
- no dscp-out-profile
- queue queue-id
- adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
- no adaptation-rule
- rate cir cir-rate [pir pir-rate]
- no rate
- remarking {use-dot1p | use-dscp | all}
- no remarking
- scope {exclusive | template}
- no scope
Configuration commands for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode)
config
- qos
- access-egress policy-id [create]
- no access-egress policy-id
- description description-string
- no description
- queue queue-id
- adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
- no adaptation-rule
- rate cir cir-rate [pir pir-rate]
- no rate
- remark policy-id
- no remark
- remarking
- no remarking
- scope {exclusive | template}
- no scope
Operational commands
- config
- qos
- copy sap-ingress src-pol dst-pol overwrite
Show commands
show
- qos
- access-egress [policy-id] [association| detail]
Configuration commands
Generic commands
description
Syntax
description description-string
no description
Context
config>qos>access-egress
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE
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.
access-egress
Syntax
access-egress policy-id [create]
no access-egress policy-id
Context
config>qos
Platforms
7210 SAS-T (in access-uplink and network modes),7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE
Description
This command creates or edits an access egress QoS policy. The policy can be applied to multiple access ports. The access egress policy is common to services (SAPs) that are all egressing on a particular port.
Any changes made to an existing policy are applied to all access ports on which the policy is specified.
The remarking parameters and queue parameters are used when port-based queuing is configured
This command is used to create or edit a access egress QoS policy. The egress policy defines the queue parameters (CIR/PIR) for each of the forwarding class traffic as they egress on the access port. Policies in effect are templates that can be applied to multiple access ports as long as the scope of the policy is template. There are 8 queues always available per port for which parameters are configurable.
Parameters
- policy-id
Specifies the value that uniquely identifies the access-egress policy.
- create
Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.
fc
Syntax
fc fc-name [create]
no fc fc-name
Context
config>qos>access-egress
Platforms
7210 SAS-T (access-uplink mode)
Description
This command defines the fc node within the access egress QoS policy is used to contain the explicitly defined dot1p marking commands for the fc-name.
When the mapping for the fc-name and marking value is not defined, the node for fc-name is not displayed in the show configuration or save configuration output.
The no form of this command removes the explicit dot1p marking commands for the fc-name.
Parameters
- fc-name
Specifies the forwarding class for which dot1p marking is to be edited. The value given for fc-name must be one of the predefined forwarding classes in the system.
- create
Keyword to create an access-egress policy. The create keyword requirement can be enabled or disabled in the environment>create context.
de-mark
Syntax
[no] de-mark [force de-value]
Context
config>qos>access-egress>fc
Platforms
7210 SAS-T (access-uplink mode)
Description
This command explicitly defines the marking of the DEI bit for fc fc-name according to the in and out of profile status of the packet (fc-name may be used to identify the dot1p-value).
If no de-value is present, the default values are used for the marking of the DEI bit: for example, 0 for in-profile packets, 1 for out-of-profile ones – see IEEE 802.1ad-2005 standard.
If the de-value is specifically mentioned in the command line it means this value is to be used for all the packets of this forwarding class regardless of their in/out of profile status.
Parameters
- de-value
Specifies the DEI value to use for this forwarding class.
dot1p
Syntax
[no] dot1p dot1p-value
Context
config>qos>access-egress>fc
Platforms
7210 SAS-T (access-uplink mode)
Description
This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.
DEI marking can be enabled using the de-mark command along with this command for the command to take effect. When the de-mark command is configured along with this command, the DEI bit is marked in the packet to indicate the profile of the packet. The DEI bit is marked to 0 to indicate in-profile/green packet and 1 to indicate out-of-profile/yellow packet. If the force de-value parameter is specified then the DEI bit is set to specified value for all packets.
If the no form of this command is executed then software will use the dot1p-in-profile and dot1p-out-profile if configured, else it will use default values.
The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:
If de-mark is not configured, then dot1p [in | out]-profile values are considered. Even if dot1p value is configured, it is configured it is ignored and if ‛dot1p [in | out]-profile’ value is not configured then default values are considered for that FC.
If de-mark is configured and if dot1p value is configured then it is considered. Else if ‛dot1p [in | out]-profile’ value is configured it is considered. In this case, dot1p value, has the precedence over ‛dot1p [in | out]-profile’.
Default
no dot1p
Parameters
- dot1p-value
Specifies the 802.1p value to set for in-profile frames in this forwarding class.
dot1p-in-profile
Syntax
dot1p-in-profile dot1p-priority
no dot1p-in-profile
Context
config>qos>>access-egress>fc
Platforms
7210 SAS-T (access-uplink mode)
Description
The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.
This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with in-profile status (or green color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.
If DEI marking is enabled using the de-mark command and the command ‛dot1p dot1p-value’ is used to configure the dot1p value, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.
When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.
The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.
The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:
If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.
If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>' has the precedence over `dot1p [in|out]-profile'.
If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.
Default
0
Parameters
- dot1p-priority
Specifies the 802.1p value to set for in-profile frames in this forwarding class.
dot1p-out-profile
Syntax
dot1p-out-profile dot1p-priority
no dot1p-out-profile
Context
config>qos>access-egress>fc
Platforms
7210 SAS-T (access-uplink mode)
Description
The command will add the capability to mark on an egress the in and out of profile status via a certain dot1p combination, similarly with the DEI options. It may be used when the internal in and out of profile status needs to be communicated to an adjacent network/customer device that does not support the DEI bit.
This command explicitly defines the egress IEEE 802.1P (dot1p) bits marking for fc-name. When the marking is set, all packets with out-of-profile status (or yellow color) of fc-name that have either an IEEE 802.1Q or IEEE 802.1P encapsulation use the explicitly defined dot1p-value. If the egress packets for fc-name are not IEEE 802.1Q or IEEE 802.1P encapsulated, the dot1p command has no effect.
If DEI marking is enabled using the de-mark command and the dot1p-value is configured, then this command has no effect. In other words, enabling DEI marking has precedence over this command and the system ignores this command.
When this command is used the DEI Bit is left unchanged by the egress processing if a tag exists. If a new tag is added, the related DEI bit is set to 0.
The no form of this command sets the IEEE 802.1P or IEEE 802.1Q priority bits to 0.
The following rules are applied by software to determine the Dot1p values to when both dot1p command and dot1p-in-profile and dot1p-out-profile command is specified:
If de-mark is not configured, then dot1p [in|out]-profile values are considered. Even if `dot1p <val>' command is configured it is ignored and if `dot1p [in|out]-profile' value is not configured then default values are considered for that FC.
If de-mark is configured and if `dot1p <value>' command is configured then it is considered. Else if `dot1p [in|out]-profile' value is configured it is considered. In this case `dot1p <val>', has the precedence over `dot1p [in|out]-profile'.
If marking is enabled and both dot1p <val> and dot1-[in|out]-profile commands are not specified, then the default values for default.
Default
0
Parameters
- dot1p-priority
Specifies the 802.1p value to set for in-profile frames in this forwarding class.
dscp-out-profile
Syntax
dscp-out-profile dscp-name
no dscp-out-profile
Context
config>qos>access-egress>fc
Platforms
7210 SAS-T (in access-uplink mode and network).
Description
This command specifies the out-of-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.
When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.
The no form of this command reverts to the factory default out-of-profile dscp-name.
Parameters
- dscp-name
Specifies the DSCP name.
dscp-in-profile
Syntax
dscp-in-profile dscp-name
no dscp-in-profile
Context
config>qos>access-egress>fc
Platforms
7210 SAS-T (access-uplink mode)
Description
This command specifies the in-profile DSCP name for the forwarding class. When marking is set, the corresponding DSCP value is used to mark all IP packets with out-of-profile status, on the egress of this forwarding class queue.
When multiple DSCP names are associated with the forwarding class at network egress, the last name entered will overwrite the previous value.
The no form of this command reverts to the factory default in-profile dscp-name.
Parameters
- dscp-name
Specifies the DSCP name.
queue
Syntax
queue queue-id
Context
config>qos>access-egress
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx/S 1/10GE (standalone and standalone-VC), and 7210 SAS-Sx 10/100GE
Description
This command creates the context to modify queue parameters associated with a particular queue. The queue is identifiable by queue ID and FCs are mapped into the queues. See 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 for more information.
Parameters
- queue-id
Specifies the access egress queue-id associated with an FC. See 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 for more information.
remarking
Syntax
remarking {use-dot1p|use-dscp|all}
no remarking
Context
config>qos>network>egress
Platforms
7210 SAS-T (access-uplink mode)
Description
This command enables the system to remark egress packets sent out of access ports. The user can specify if dot1p or dscp or both dot1p and dscp to be used for marking the packets sent out of the port.
When 7210 is operated in access-uplink mode, marking support is available as given below:
On access port egress, the behavior is as follows:
If the use-dot1p keyword is configured in the access-egress policy, then the dot1p bits are marked in the packet header for all traffic sent out of all SAPs configured on that access port.
If the use-dscp keyword is configured in the access-egress policy, then the IP DSCP bits are marked in the packet header for IPv4 traffic sent out of all SAPs configured on that access port.
Note:DSCP marking also marks the IPv4 packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.
If the all keyword is configured is configured in the access-egress policy, then the Dot1p bits are marked in the packet header for all traffic (Layer 2 and IPv4) sent out of all SAPs and the IP DSCP bits are marked in the packet header for all IPv4 traffic sent out of all SAPs configured on that access port.
Note:DSCP marking also marks the packets associated with SAPs configured in an Layer 2 VPN service. If this is not required, to avoid this it is recommended to use only dot1p marking on access ports.
If remarking is enabled in access-egress policy, by default use-dot1p is used. If no marking values are specified, then the default FC to Dot1p marking values are used.
The no form of this command disables remarking.
Default
no remarking
remark
Syntax
remark policy-id
no remark
Context
config>qos>access-egress
Platforms
7210 SAS-T (network mode), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE network mode
Description
This command specifies the remarking policy ID to use for marking packets on access egress (also known as, access port egress).
The remarking policy ID must be associated with the appropriate access egress policy and remarking must be enabled in the access egress policy to enable marking of packets sent out of all SAPs configured on the access port.
Only remarking policy of type dot1p, dscp, or dot1p-dscp is allowed to be used when the remark policy is associated with access-egress. See Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12, for different remark policies supported on the node and its use.
The no form of this command removes the explicit association of the remark policy and associates the default remark policy. In other words, if remarking is enabled and no remark policy is executed, then the default remark policy is used to mark packets sent out. If no remark policy is executed and remarking is disabled, packets are not remarked.
Parameters
- policy-id
Specifies the remark policy.
remarking
Syntax
no remarking
remarking
Context
config>qos>access-egress
Platforms
7210 SAS-T (network mode), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE network mode
Description
This command enables the system to remark egress packets sent out of access ports.
When remarking is enabled, the remark policy configured in the QoS policy context is used to determine the FC to QoS bit mapping. For example, when remarking is enabled in the access-egress QoS policy, the remark policy associated with access-egress QoS policy is used to determine the FC to dot1p mapping to use for marking packets sent out of access ports.
See Remark policies for the remark policy that can be used to configure FC to priority bit markings in different QoS policies associated with different service entities. For more information, see Summary of remark policy and attachment points for 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE (network mode) and Summary of remark policy and attachment points for 7210 SAS-Mxp, 7210 SAS-R6, and 7210 SAS-R12
The no form of this command disables remarking.
Default
no remarking
Access egress queue QoS policy commands
adaptation-rule
Syntax
adaptation-rule [cir adaptation-rule] [pir adaptation-rule]
no adaptation-rule
Context
config>qos>access-egress>queue
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE
Description
This command defines the method used by the system to derive the operational CIR and PIR rates when the queue is provisioned in hardware. For the cir and pir parameters, the system attempts to find the best operational rate depending on the defined constraint.
The no form of this command removes any explicitly defined constraints used to derive the operational CIR and PIR created by the application of the policy. When a specific adaptation-rule is removed, the default constraints for cir and pir apply.
Default
adaptation-rule pir closest cir closest
Parameters
- cir adaptation-rule
Specifies the adaptation rule and defines the constraints enforced when adapting the CIR rate defined using the queue queue-id rate command. The cir parameter requires a qualifier that defines the constraint used to derive the operational CIR rate for the queue. When the cir parameter is not specified, the default constraint applies. The max (maximum), min (minimum), and closest qualifiers are mutually exclusive. 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 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 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.
rate
Syntax
rate cir cir-rate [pir pir-rate]
no rate
Context
config>qos>access-egress>queue
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE
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 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 (max) and CIR (0) parameters.
Parameters
- cir cir-rate
Specifies the administrative CIR rate, in kilobits, for the queue. The cir parameter overrides the default administrative CIR used by the queue. When the rate command is executed, a valid CIR setting must be explicitly defined. When the rate command has not been executed or the cir parameter is not explicitly specified, the default CIR (0) is assumed.
Fractional values are not allowed and must be given as a positive integer.
- pir pir-rate
Specifies the administrative PIR rate, in kilobits, for the queue. When the rate command is executed, a PIR setting is optional. When the rate command has not been executed, the default PIR of max is assumed.
Fractional values are not allowed and must be given as a positive integer.
The actual PIR rate is dependent on the queue’s adaptation-rule parameters and the actual hardware where the queue is provisioned.
scope
Syntax
scope {exclusive | template}
no scope
Context
config>qos>access-egress
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE
Description
This command configures the scope as exclusive or template. The policy’s scope cannot be changed if the policy is applied to multiple ports.
The no form of this command reverts the scope of the policy to the default.
Default
template
Parameters
- exclusive
Specifies that the policy can only be applied to one interface port. If a policy with an exclusive scope is assigned to a second interface an error message is generated. If the policy is removed from the exclusive interface, it will become available for assignment to another exclusive interface. The system default policies cannot be put into the exclusive scope. An error will be generated if scope exclusive is executed in any policies with a policy ID equal to 1.
- template
Specifies that the policy can be applied to multiple ports on the router.
Operational commands
copy
Syntax
copy sap-ingress src-pol dst-pol [overwrite]
Context
config>qos
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, 7210 SAS-Sx 10/100GE
Description
This command copies existing QoS policy entries for a QoS policy ID to another QoS 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
- sap-ingress src-pol dst-pol
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. Indicates that the source policy ID and the destination policy ID are SAP ingress 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, an error will occur if the destination policy ID exists.
Show commands
access-egress
Syntax
access-egress [policy-id] [association | detail]
Context
show>qos
Platforms
7210 SAS-T (in access-uplink and network modes), 7210 SAS-Sx 1/10GE: standalone and standalone-VC, and 7210 SAS-Sx 10/100GE
Description
This command displays access egress QoS policy information.
Parameters
- policy-id
Displays the policy ID of the access-egress policy.
- association
Displays associations related to the specified access-egress policy.
- detail
Displays detailed policy information including the policy associations.
Output
The following output is an example of access egress QoS policy information, and Output fields: QoS access egress describes the output fields.
Sample outputA:Dut-A>show>qos# access-egress
===============================================================================
Access Egress Policies
===============================================================================
Policy-Id Scope Description
-------------------------------------------------------------------------------
1 Template Default Access egress QoS policy.
===============================================================================
A:Dut-A>show>qos#
A:Dut-A>show>qos# access-egress 1 detail
===============================================================================
QoS Access Egress
===============================================================================
-------------------------------------------------------------------------------
Policy-id : 1 Scope : Template
Remark : False Remark Pol Id: 2
Description : Default Access egress QoS policy.
-------------------------------------------------------------------------------
Queue Rates and Rules
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId CIR CIR Adpt Rule PIR PIR Adpt Rule
-------------------------------------------------------------------------------
Queue1 0 closest max closest
Queue2 0 closest max closest
Queue3 0 closest max closest
Queue4 0 closest max closest
Queue5 0 closest max closest
Queue6 0 closest max closest
Queue7 0 closest max closest
Queue8 0 closest max 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
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Port-id : 1/1/21
Port-id : 1/1/23
Port-id : 1/1/25
Port-id : 1/1/26
===============================================================================
A:Dut-A>show>qos#
A:Dut-A>show>qos#
| Label | Description |
|---|---|
Policy-Id |
The ID that uniquely identifies the policy |
Remark |
True — Remarking is enabled for all the dot1q-tagged packets that egress the ports on which the sap-egress QoS policy is applied and remarking is enabled False — Remarking is disabled for the policy |
Remark Pol Id |
Displays the policy id of the remarking policy |
Scope |
Exclusive — Implies that this policy can be applied only to a single access egress port Template — Implies that this policy can be applied to multiple access ports on the router |
Description |
A text string that helps identify the policy’s context in the configuration file |
Queue Rates and Rules |
|
QueueId |
Displays the Queue identifier associated with the sap-egress QoS policy |
CIR |
Specifies the administrative Committed Information Rate (CIR) parameters for the queue The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth. |
CIR Adpt Rule |
min — The operational CIR for the queue will be equal to or greater than the administrative rate specified using the rate command max — The operational CIR for the queue will be equal to or less than the administrative rate specified using the rate command closest — The operational CIR for the queue will be the rate closest to the rate specified using the rate command without exceeding the operational PIR |
PIR |
Specifies the administrative Peak Information Rate (PIR) parameters for the queue The PIR defines the maximum rate that the queue can transmit packets through the access port. |
PIR Adpt Rule |
min — The operational PIR for the queue will be equal to or greater than the administrative rate specified using the rate command max — The operational PIR for the queue will be equal to or less than the administrative rate specified using the rate command closest — The operational PIR for the queue will be the rate closest to the rate specified using the rate command |
High Slope/Low slope |
|
QueueId |
Displays the Queue identifier associated with the sap-egress QoS policy |
State |
Displays the state of the queue. The state of the queue can be either ‟Up” or ‟Down” |
Start Avg |
Specifies the low priority or high priority RED slope position for the shared buffer average utilization value where the packet discard probability starts to increase above zero |
Max Avg |
Specifies the percentage of the shared buffer space for the buffer pool at which point the drop probability becomes ‟1” This parameter is expressed as a decimal integer. |
Max Prob |
Specifies the high priority RED slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one |
Burst Sizes and Time Average Factor |
|
QueueId |
Displays the Queue identifier associated with the sap-egress QoS policy |
CBS |
Displays the configured CBS value |
MBS |
Displays the configured MBS value |
Time Average Factor |
Displays the value of the time average factor in use |