Queue group redirect list

A queue group redirection list allows packets that match a configured type value to be redirected to a specific queue group instance at SAP ingress or egress.

The queue group instance must be an instance of the default queue group, which is the queue group configured under the SAP with the QoS policy.

The only type matching supported is vxlan-vni, which enables an ingress and egress match based on the VNI in IPv4 and IPv6 VXLAN and VXLAN GPE packets. Each entry in the redirect list matches a specific VNI and maps it to a specific queue group instance. A maximum of 16 match statements can be configured in a queue group redirect list.

A redirect list is configured as follows:

configure
    qos
        queue-group-redirect-list redirect-list-name
 [create]
            type redirect-list-type
            match field-value instance instance-id
        exit

where:

redirect-list-name specifies the name of the queue group redirect list
redirect-list-type specifies the type of queue group redirect list; the default and only possible value is vxlan-vni
field-value specifies the value of the field in the ingress or egress packet which, when matched, causes the packet to be redirected to the specified queue group instance. The field-value is dependent on the setting of the type and must be a valid VXLAN VNI. The VNI can be specified in any of the available formats but is always shown in decimal.
instance-id specifies the instance of the queue group template to which the VXLAN and VXLAN GPE packets are redirected. The packets can be redirected to the default instance, that is, the instance specified with the QoS policy.

A queue group redirection list is applied under the SAP ingress or egress as shown in the following example. The prior configuration of a default queue group instance (the queue group instance specified with the QoS policy under the SAP ingress or egress) is mandatory. Only a single list can be applied per-SAP ingress or egress.

configure
    service
        {ies | vprn} service-id
            interface ip-int-name
                sap sap-id
                    ingress
                        qos policy-id fp-redirect-group
queue-group-name instance instance-id
                                        queue-group-redirect-list 
redirect-list-name
                                    egress
                                        qos policy-id port-redirect-
group queue-group-name instance instance-id
                                        queue-group-redirect-list 
redirect-list-name

In order for packets to be redirected to the policer or queue in the queue group instance specified in a queue group redirect list, the following criteria must be met:

The FC in the SAP ingress or egress QoS policy must be redirected to an FP or port redirect queue group.
The VNI to be matched must be configured in a match statement in the queue group redirect list.
The instance corresponding to the related match statement must exist on the FP ingress or port egress through which the traffic ingresses or egresses.

If any of these conditions are not met, the traffic is not redirected to the queue group instance specified in the redirect list and falls back to either using the SAP policers and queues or the default instance (the one configured with the QoS policy under the SAP), depending on which condition is not met; this applies to VXLAN and VXLAN GPE packets with VNIs not listed in the redirect list, and non-VXLAN and non-VXLAN GPE packets.

Modifying a queue group redirect list causes the VNI-to-instance matching to change on all SAPs (ingress and egress) where the queue group redirect list is applied.

There is a limit on the number of SAP/VNI combinations at ingress and the number of SAP-instance/VNI combinations at egress per FP, which can be seen using the tools dump resource-usage card slot-num fp fp-number command. The egress limit is a subset of the Dynamic Service Entries and instance mismatches are considered to be allocated on the related ingress and egress FP. The output shows the total, allocated, and free resources, as shown in the following example:

*A:PE# tools dump resource-usage card 1 fp 1
===============================================================================
Resource Usage Information for Card Slot #1 FP #1
===============================================================================
                                                    Total  Allocated       Free
-------------------------------------------------------------------------------
...
                Sap IngQGrp RedirLst Entries |      31999          2      31997
                     Dynamic Service Entries +     131071          2     131069
            SapInst EgrQGrp RedirLst Entries -      31999          2      31997
...
===============================================================================
*A:PE#

If a queue group instance specified in an applied queue group redirect list does not exist on the SAP's FP ingress or port egress, a flag is displayed in the show output for the SAP, for example:

*A:PE# show service id 1 sap 1/1/1
===============================================================================
Service Access Points(SAP)
===============================================================================
Service Id         : 1
SAP                : 1/1/1                    Encap             : null
Description        : (Not Specified)
Admin State        : Up                       Oper State        : Up
Flags              : SapIngQGrpRedirMismatch
                     SapEgrQGrpRedirMismatch
Multi Svc Site     : None
Last Status Change : 01/31/2017 17:50:56
Last Mgmt Change   : 02/02/2017 12:02:56
===============================================================================
*A:PE#

The following show command can be used to identify which instances from the redirection list exist on the SAP's FP ingress and port egress and which do not exist and are causing the mismatch:

*A:PE# show service id 1 sap 1/1/1 queue-group-redirection
===============================================================================
Queue Group Redirect List Mismatch Information (Ingress SAP)
===============================================================================
-------------------------------------------------------------------------------
Queue Group      Instance          FP
-------------------------------------------------------------------------------
qg2                     1          1/1
                        2          1/1 : mismatch
-------------------------------------------------------------------------------
===============================================================================
 
===============================================================================
Queue Group Redirect List Mismatch Information (Egress SAP)
===============================================================================
-------------------------------------------------------------------------------
Queue Group      Instance          Port
-------------------------------------------------------------------------------
qg2                     1          1/1/1
                        2          1/1/1 : mismatch
-------------------------------------------------------------------------------
===============================================================================
*A:PE#