11.3. 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.

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

The access-egress policy provides an option to configure remarking parameters and access port egress queue parameters on an access port. The remarking parameters are used when SAP-based queuing is configured and port-based marking is in use. The remarking parameters and queue parameters are used when port-based queuing is configured. See Access Egress QoS Policies on 7210 SAS-R6 and 7210 SAS-R12 for more information.

The no form of this command deletes the access-egress policy. A policy cannot be deleted until it is removed from all access ports where it is applied. When an access-egress policy is removed from an access port, the access port revert to the default access-egress policy ID 1.

This command specifies the remarking policy ID to use for marking packets on access egress (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 a remarking policy of the 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-R6 and 7210 SAS-R12 for more information about the different remark policies supported on the node and their use.

Note: On the 7210 SAS-R6 and 7210 SAS-R12, two different access-egress queuing modes are supported; the marking functionality available in each of these modes is different. See Access Egress QoS Policies on 7210 SAS-R6 and 7210 SAS-R12 for more information about egress QoS policies on these platforms.

The no form of the command removes the explicit association of the remark policy and associates the default remark policy. If remarking is enabled and no remark policy is executed, 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.

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 the access-egress QoS policy is used to determine the FC-to-dot1p mapping 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.

See Summary of Remark Policy and Attachment Points for 7210 SAS-R6 and 7210 SAS-R12 and Access Egress QoS Policies on 7210 SAS-R6 and 7210 SAS-R12 for more information.

The no form of the command disables remarking.

This command configures the scope as exclusive or template. The policy 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 enables the context to configure the access-egress queue parameters.

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, within the access egress Qos policy, enables support for a queue PIR and CIR to be configured as a percentage of the egress port 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-Gb and a 10-Gb Ethernet port, the queue rates are 10 times greater on the 10 Gb port as a result of 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 speed changes after the queue is created, the queue 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 the command associates the default SAP egress queue management policy with this queue.

This command specifies whether the queue operates in strict or weighted mode.

The no form of the command reverts the queue mode to the default.

This command configures 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 the command reverts the weight to the default.

This command defines the administrative PIR and the administrative 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 max default specifies the amount of bandwidth in kilobits per second (thousand bits per second). The max value is mutually exclusive to the pir-rate value.

Note: Queues with a cir-level cir-level parameter value of 8 are treated differently by the software than queues configured with different cir-level values. The PIR rate values configured for the cir-level 8 queues are ignored. Only the CIR rate value is used and PIR is set to the CIR value. In addition, when executing the no form of the rate command for a queue configured at cir-level 8, the default CIR (and PIR) value is set to 1. See the cir-level parameter description under the port-parent command for more information about the scheduler behavior for queues configured with a cir-level value of 8.

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 parameters (0).