Alcatel-Lucent 7950 Quality Of Service Manual page 176

Service Ingress QoS Policy Commands
Service Ingress QoS Policy Commands
sap-ingress
Syntax [no] sap-ingress policy-id | policy-name
Context config>qos
Description
This command is used to create or edit the ingress policy. The ingress policy defines the Service Level
Agreement (SLA) enforcement service packets receive as they ingress a SAP. SLA enforcement is
accomplished through the definition of queues 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 that all ingress traffic flows through. Complex
policies have multiple queues combined with specific IP or MAC match criteria that indicate which queue a
packet will flow though.
Policies in effect are templates that can be applied to multiple services as long as the scope of the policy is
template. Queues defined in the policy are not instantiated until a policy is applied to a service SAP.
A SAP ingress policy is considered incomplete if it does not include definition of at least one queue and
does not specify the default action. The OS does not allow incomplete SAP ingress policies to be applied to
services.
SAP ingress policies can be defined with either IP headers as the match criteria or MAC headers as the
match criteria. The IP and MAC criteria are mutually exclusive and cannot be part of the same SAP ingress
policy.
It is possible that a SAP ingress policy will include the dscp map command, the dot1p map command and
an IP or MAC match criteria. When multiple matches occur for the traffic, the order of precedence will be
used to arrive at the final action. The order of precedence is as follows:
1. 802.1p bits
2. DSCP
3. IP Quintuple or MAC headers
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. The default SAP ingress policy
defines one queue associated with the best effort (be) forwarding class, with CIR of zero and PIR of line
rate.
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.
The no sap-ingress policy-id 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.
Page 176 7950 XRS Quality of Service Guide