10.2. Access Egress QoS Policy Command Reference

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.

This command enables the context to create or edit 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.

On 7210 SAS-Mxp, the access egress policy provides an option to configure remarking parameters and access port egress queue parameters on access port. The remarking parameters are used when SAP-based queuing is configured and port-based marking is in use. See Access Egress QoS Policies on 7210 SAS-M, 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE for more information.

The remarking parameters and queue parameters are used when port-based queuing is configured. See Access Egress QoS Policies on 7210 SAS-M, 7210 SAS-T, 7210 SAS-Sx/S 1/10GE, and 7210 SAS-Sx 10/100GE for more information.

Any changes made to an existing policy are applied to all access ports on which the policy is specified.

The no form of the policy associated the default policy with the access port.

This command enables the context to modify Queue parameters associated with a particular queue. The queue is identifiable by the queue-id and FCs are mapped into the queues/ See Forwarding Class to Queue-ID Map for 7210 SAS-M, 7210 SAS-T, and 7210 SAS-Mxp for more information.

This command specifies the remarking policy ID to use for marking packets on access egress (also known as, access port egress).

7210 SAS-Mxp supports two different access egress queuing modes. Marking functionality available in these two modes are different as described in the overview below. See Summary of Remark Policy and Attachment Points for 7210 SAS-Mxp for more information.

SAP-based queuing mode

The 7210 SAS-Mxp supports SAP-based marking for access SAPs and port-based egress marking on access ports. SAP-based marking is only supported for L2 SAPs, that is, SAPs configured in Epipe and VPLS service. If user enables remarking in the SAP egress policy attached to the SAP, then the remark policy configured is used to mark the packets sent out of the SAP. If remarking is disabled in the SAP egress policy attached to the SAP, then remark policy configured under the access-egress policy associated with the egress access port is used to mark all packets sent out of the L2 SAP configured on the access port. This is known as port-based marking. For more details refer to the details in the chapter above on Access Egress policies. section Access Egress QoS Policy for SAP-based Queuing Mode on 7210 SAS-Mxp.

Port-based Queuing Mode

When port-based queues are used, only per port egress marking is supported. In other words, per SAP marking cannot be used when Port-based queuing mode is used. For more details refer to the details in the chapter above on Access Egress policies, section Access Egress QoS Policy for Port-based Queuing Mode on 7210 SAS-Mxp

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.

See Summary of Remark Policy and Attachment Points for 7210 SAS-Mxp for more information.

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, then packets are not remarked at all.

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 and Summary of Remark Policy and Attachment Points for 7210 SAS-Mxp for the remark policy that can be used to configure FC to priority bit markings in different QoS policies associated with different service entities.

Note: See Access Egress QoS Policies on 7210 SAS-Mxp for more information.

The no form of this command disables remarking.

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.

This command enables support for a queue’s PIR and CIR to be configured as a percentage of the egress port’s line rate (that is, the port limit). When the rates are expressed as a port limit, the actual rates used per instance of the queue will vary based on the port speed or the configured port egress rate. For example, when the same QoS policy is used on a 1-Gigabit and a 10-Gigabit Ethernet port, the queue’s rates will be 10 times greater on the 10 Gigabit port due to the difference in port speeds. This enables the same QoS policy to be used on SAPs on different ports instead of using different policies to modify a queue’s rate to get the same relative performance from the queue.

If the port’s speed changes after the queue is created, the queue’s PIR and CIR are recalculated based on the defined percentage value.

The rate and percent-rate commands override one another. If the current rate for a queue is defined using the percent-rate command and the rate command is executed, the percent-rate values are deleted. Similarly, the percent-rate command causes any rate command values to be deleted. A queue’s rate may dynamically be changed back and forth from a percentage to an explicit rate at anytime.

The no form of this command reverts the queue to its default shaping rate and CIR values. When no percent-rate is defined within an egress queue-override, the queue reverts to the PIR and CIR defined within the access egress QoS policy associated with the queue.

This command associates the specified queue management policy with this 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.

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.

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 over-subscription factors or available egress bandwidth. The CIR defines the rate at which the system prioritizes the queue over other queues competing for the same bandwidth.

The rate command can be executed at anytime, altering the PIR and CIR rates for all queues created on the access ports.

The no form of this command reverts all queues created with the queue ID by association with the QoS policy to the default PIR (max) and CIR (0) parameters.

This command enables the context to specify the weight of the queue when the queue mode is set to weighted.

For queues configured in weighted mode, the CIR of the queues are met if bandwidth is available and the configured weights are considered in the PIR loop. The configured weight determines the proportion of available bandwidth that is given to this queue in comparison to other queues configured in weighted mode.

The no form of this command reverts the weight to the default.

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.

This command displays access egress QoS policy information.