[no] sap-ingress policy-id [create]
config>qos
Supported on all 7210 SAS platforms as described in this document
This command creates or edits the ingress policy. The ingress policy defines the Service Level Agreement (SLA) enforcement that service packets receive as they ingress a SAP; the SAP can be configured on an access port or hybrid port. SLA enforcement is accomplished through the definition of meters or queues (depends on the support available on a platform) that have Forwarding Class (FC), Committed Information Rate (CIR), Peak Information Rate (PIR), Committed Burst Size (CBS), and Maximum Burst Size (MBS) characteristics. The simplest policy defines a single queue/meter that all ingress traffic flows through. Complex policies have multiple meters/queues combined with classification entries that indicate which meter/queue a packet flows through.
Policies in effect are templates that can be applied to multiple services as long as the scope of the policy is template. Meters defined in the policy are not instantiated until a policy is applied to a service SAP.
Depending on the support available on different 7210 SAS platforms, SAP ingress policies can be defined with either dot1p as the match criteria or IP DSCP as the match criteria or IP headers as the match criteria or MAC headers or both as the match criteria. On the 7210 SAS, the user has an option to use dot1p, IP DSCP, IPv4/IPv6 criteria and MAC criteria.
Only one service ingress policy can be provisioned. The SAP ingress policy with policy-id 1 is a system-defined policy applied to services when no other policy is explicitly specified. The system SAP ingress policy can be modified but not deleted. The no sap-ingress command restores the factory default settings when used on policy-id 1. See Default SAP-ingress policy for more information about the default SAP Ingress policy for different platforms.
Any changes made to the existing policy, using any of the sub-commands are applied immediately to all services where this policy is applied. For this reason, when many changes are required on a policy, it is recommended that the policy be copied to a work area policy ID. That work-in-progress policy can be modified until complete and then written over the original policy ID. Use the config qos copy command to maintain policies in this manner.
A SAP ingress policy with multiple criteria can be associated with the SAP. The system defines a match-order to match against the classification rules specified in the policy. Please see the QoS overview section to know more about the match order.
Before using IPv4, IPv6 and MAC match criteria, resources must be allocated using the CLI command config>system>resource-profile>ingress-internal-tcam>qos-sap-ingress-resource. See the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Basic System Configuration Guide for information about resource allocation. See Service ingress QoS policies for more information about this CLI command.
Service ingress only queues with shapers are supported.
The no form of this command deletes the SAP ingress policy. A policy cannot be deleted until it is removed from all services where it is applied. The system default SAP ingress policy is a special case; the no command restores the factory defaults to policy ID 1.
Specifies the policy.
Keyword to create a sap ingress policy.
dot1p-classification policy-id
no dot1p-classification
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
This command associates a dot1p classification policy, which contains entries used to map traffic received on a hybrid port or SAP to a forwarding class and profile state, based on the dot1p bits in the packet.
When it is defined in a service ingress QoS policy and associated with an access SAP ingress, a packet received on the SAP is used to match with the dot1p values defined in this policy. If a match is found, the corresponding forwarding class and profile are assigned to the packet.
The no form of this command disables use of dot1p classification policy.
Specifies the policy.
dscp-classification
no dscp-classification
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
This command associates an IP DSCP classification policy, which contains entries used to map traffic received on a SAP to a forwarding class and profile state, based on the IP DSCP bits in the packet.
When it is defined in a service ingress QoS policy and associated with an access SAP ingress, a packet received on the SAP is used to match with the IP DSCP values defined in this policy. If a match is found, the corresponding forwarding class and profile are assigned to the packet.
The no form of this command disables use of DSCP classification policy.
Specifies the policy ID that uniquely identifies the policy.
scope {exclusive | template}
no scope
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
This command configures the Service Ingress QoS policy scope as exclusive or template.
The no form of this command sets the scope of the policy to the default.
template
Specifies that the policy can only be applied to one SAP. If a policy with an exclusive scope is assigned to a second SAP an error message is generated. If the policy is removed from the exclusive SAP, it becomes available for assignment to another exclusive SAP.
Specifies that the policy can be applied to multiple SAPs on the router.
Default QoS policies are configured with template scopes. An error is generated when the template scope parameter to exclusive scope on default policies is modified.
default-fc fc [profile {in | out | use-dei}]
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
This command configures the default forwarding class for the policy. If an ingress packet does not match a higher priority (more explicit) classification command, the default forwarding class is associated with the packet. Unless overridden by an explicit forwarding class classification rule, all packets received on an ingress SAP using this ingress QoS policy are classified to the default forwarding class.
The default forwarding class is best effort (be). The default-fc settings are displayed in the show configuration and save output regardless of inclusion of the detail keyword.
be
Specifies the forwarding class name for the queue/meter. The value for fc must be one of the predefined forwarding classes in the system.
Specifies that packets matching the classification entry are explicitly classified to either in-profile or out-of-profile. The remove the profile action for an classification entry, the action command must be re-executed without the profile action defined. The profile assigned by the user is used subsequently to determine the slope to use at the ingress and egress queuing points and is used for egress marking (if enabled).
Specifies that any packets matching the classification rule are treated as in-profile. Mutually exclusive to the out parameter following the profile classification action keyword.
Specifies that any packets matching the classification rule are treated as out-of-profile. Mutually exclusive to the in parameter following the profile classification action keyword.
[no] use-dei
config>qos>sap-ingress>fc
Supported on all 7210 SAS platforms as described in this document
This command enables DEI based classification. When enabled, the packet classified to this FC the DEI bit is used to determine the ingress profile for the packet. Packets received with DEI bit set to zero are treated as in-profile and packets with DEI bit set to one are treated as out-of-profile packets.
When DEI based classification is enabled, it overrules the profile values specified in the classification entry used to assign the FC.
The no form of this command disables use of DEI bit for classification of packets.
no use-dei
[no] fc fc-name [create]
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
This command creates a class instance of the forwarding class FC name. After the fc-name is created, classification actions can be applied and can be used in match classification criteria.
The no form of this command removes all the explicit queue mappings for fc-name forwarding types. The queue mappings revert to the default meters for fc-name.
Specifies the forwarding class name for the queue. The value of the fc-name must be one of the predefined forwarding classes for the system.
Keyword to create a forwarding class.
multicast-queue queue-id
no multicast-queue
config>qos>sap-ingress>fc
config>qos>network>fc
Supported on all 7210 SAS platforms as described in this document
This command overrides the default multicast forwarding type queue mapping for fc fc-name. The specified queue ID must exist within the policy as a multipoint queue before the mapping can be made. After the forwarding class mapping is executed, all broadcast, unknown unicast, and multicast (BUM) traffic on a SAP or a access-uplink port using this policy is forwarded using the queue ID.
The no form of this command removes the association of the FC and the queue. When the no form is executed, the BUM traffic uses the default multicast forwarding type queue.
1
Specifies the queue ID.
[no] ip-criteria
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
Commands in this context create or edit policy entries that specify IP criteria used to match supported fields from the IP packet header, including IP DSCP.
IP criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.
The 7210 SAS implementation exits on the first match found and executes the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.
Before associating a SAP ingress policy configured to use IPv4 criteria with a SAP, resources must be allocated to it. See the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Basic System Configuration Guide for more information about this CLI command and resource allocation.
The no form of this command deletes all the entries specified under this node. When IP criteria entries are removed from a SAP ingress policy, the IP criteria is removed from all services where that policy is applied.
[no] ipv6-criteria
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
Commands in this context create or edit policy entries that specify IPv6 criteria such as IP quintuple lookup or DiffServ code point.
IPv6 criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.
The 7210 SAS implementation exits on the first match found and execute the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.
Before associating a SAP ingress policy configured to use IPv6 criteria with a SAP, resources must be allocated to it. See the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Basic System Configuration Guide for more information about this CLI command and resource allocation.
The no form of this command deletes all the entries specified under this node. When ipv6-criteria entries are removed from a SAP ingress policy, the ipv6-criteria is removed from all services where that policy is applied.
[no] mac-criteria
config>qos>sap-ingress
Supported on all 7210 SAS platforms as described in this document
Commands in this context create or edit policy entries that specify MAC criteria.
The MAC criteria-based SAP ingress policies are used to select the forwarding class for matched traffic.
The 7210 SAS implementation exits on the first match found and execute the actions in accordance with the accompanying action command. For this reason entries must be sequenced correctly from most to least explicit.
Before associating a SAP ingress policy configured to use MAC criteria with a SAP, resources must be allocated to it. See the 7210 SAS-D, Dxp, K 2F1C2T, K 2F6C4T, K 3SFP+ 8C Basic System Configuration Guide for more information about this CLI command and resource allocation.
The no form of this command deletes all the entries specified under this node. When mac-criteria entries are removed from a SAP ingress policy, the mac-criteria is removed from all services where that policy is applied.
[no] queue queue-id
config>qos>sap-ingress>fc
Supported on all 7210 SAS platforms as described in this document
This command overrides the default unicast forwarding type queue mapping for fc fc-name. The specified queue ID must exist within the policy as a non-multipoint queue before the mapping can be made. When the forwarding class mapping is executed, all unicast traffic (this includes all traffic, even broadcast and multicast for services) on a SAP or an access-uplink port using this policy is forwarded using the queue ID.
The no form of this command sets the unicast (point-to-point) queue ID back to the default queue for the forwarding class (queue 1).
Specifies the queue ID for the queue.
multicast-meter meter-id
no multicast-meter
config>qos>sap-ingress>fc
Supported on all 7210 SAS platforms as described in this document
This command overrides the default multicast forwarding type queue mapping for fc fc-name. The specified meter-id must exist within the policy before the mapping can be made. When the forwarding class mapping is executed, all broadcast, unknown unicast, and multicast (BUM) traffic on an access SAP using this policy is forwarded using the meter ID.
The default multicast forwarding type queue is the default unicast queue (queue 1). In other words, if no multicast meter is assigned to a FC, it uses default queue 1.
The no form of this command removes the association of the FC and the meter. When the no form is executed, the BUM traffic uses the default multicast forwarding type queue (queue 1).
1
Specifies the meter ID for the meter.
[no] meter meter-id
config>qos>sap-ingress>fc
Supported on all 7210 SAS platforms as described in this document
This command overrides the default unicast forwarding type queue mapping for fc fc-name. The specified meter-id must exist within the policy before the mapping can be made. When the forwarding class mapping is executed, all unicast traffic (this includes all traffic, even broadcast and multicast for services) on an access SAP using this policy is forwarded using the meter ID.
The no form of this command sets the unicast (point-to-point) traffic type back to the default queue for the forwarding class (queue 1).
Specifies the meter ID for the meter.