3. FP QoS Configuration

3.1. FP4 Ingress and Egress Queue Reallocation

FP4 forwarding planes support the reallocation of queues between ingress and egress. Queues can be reallocated either from ingress to egress, or from egress to ingress. The reallocation is performed in sets of 8k (8192) queues, with the requirement that a minimum of 8k queues must be allocated at both ingress and egress. The ingress and egress buffer pool sizes are not affected by the queue reallocation.

The queue allocation is configured using a named FP resource policy that is created using the fp-resource-policy command within the QoS configuration branch and is applied under the card>fp context. The system supports up to 15 policies, including the system-created default policy that cannot be modified or deleted and is applied by default to all FP4 forwarding planes. The default policy allocates 128k queues to ingress and 128k queues to egress.

The queue allocation within the FP resource policy is configured as follows:

configure
    qos
        fp-resources-policy policy-name
            queues
                ingress-percent-of-total percent-of-total-queues

The ingress-percent-of-total command specifies the percentage of the total number of queues allocated to ingress queues, with the remainder being allocated to egress queues. The percentage is configured as an integer to two decimal places with a range from 4.00 to 97.00 (values outside of this range are not applicable due to the requirement of a minimum of 8k queues are ingress and egress).

Queues can be allocated in sets of 8k queues. If the percentage configured results in the queue allocation not being a multiple of 8k, the number of queues at ingress is rounded down to the next 8k boundary, and consequently the number of queues at egress is rounded up to the next 8192 boundary, both while respecting the minimum at ingress and egress. For example, if the ingress-percent-of-total is configured to 27%, that calculates to 70778.88 queues, the number of ingress queues would be rounded down to 65536 queues and the number of egress queues rounded up to 196608.

FP resource policies are applied to a forwarding plane as follows:

configure
    card slot-number
        fp fp-number
            fp-resources-policy name

An FP resource policy that is applied to an FP cannot be deleted.

The queue allocation can be modified by either applying a differently named FP resource policy to an FP, and this includes removing an applied user-created FP resource policy to return to the default policy, or modifying the ingress-percent-of-total command that also includes removing this parameter to return to its default configuration in the policy applied to an FP. The system then checks whether requested queue allocation is achievable based on the current ingress and egress queue consumption on the related FP. If the requested queue allocation is not achievable, the command fails.

When the queue allocation is modified, the system immediately resets the associated cards, XIOMs, and MDAs in order to reallocate the queues, with the following exceptions:

  1. When the system boots and reads the configuration file, the queue allocation within the file is used without requiring an additional reset or reboot.
  2. When the queue allocation is modified on a 7750 SR-1, the system does not automatically reset the card or MDA; it is the user's responsibility to save the configuration and immediately reboot the system.
  3. If the card, XIOM or MDA is provisioned but not equipped, the modification is accepted and is immediately active.

When redundancy mechanisms are used that spans FPs, for example LAGs, it is recommended that the same queue allocation is applied to all related FPs.

FP resource policies can be displayed using a show command, with the details of the configured ingress-percent-of-total command and the associations on which FPs it is applied. The name of the FP resource policy applied to an FP can be displayed using the show card slot-number detail command. For example, the FP resource policy below allocates the minimum number of queues to ingress and the maximum number of queues to egress, and is applied to card 1 FP 1:

*A:PE# show qos fp-resource-policy "ingress-8k-egress-248k" detail
===============================================================================
FP Resource Policy
===============================================================================
Policy Name        : ingress-8k-egress-248k
Description        : (Not Specified)
-------------------------------------------------------------------------------
Queues
-------------------------------------------------------------------------------
Ingress Percent of total : 4.00
-------------------------------------------------------------------------------
FP Resource Policy Associations
-------------------------------------------------------------------------------
Card-FP
-------------------------------------------------------------------------------
1-1
-------------------------------------------------------------------------------
No. of Associations : 1
-------------------------------------------------------------------------------
===============================================================================
*A:PE# show card 1 detail | match expression "FP|FP Resource Policy"
FP 1 Specific Data
    FP Resource Policy            : ingress-8k-egress-248k
    Generation                    : FP4
FP 2 Specific Data
    FP Resource Policy            : default
    Generation                    : FP4
FP 3 Specific Data
    FP Resource Policy            : default
    Generation                    : FP4
FP 4 Specific Data
    FP Resource Policy            : default
    Generation                    : FP4
*A:PE# 

When an FP resources policy is applied to change the queue allocation, the resulting queue allocation can be displayed using the tools dump resource-usage card slot-num fp fp-number command:

*A:PE# tools dump resource-usage card 1 fp 1 | match expression "Ingress Queues|Egress Queues"
                              Ingress Queues |       8192        535       7657
                               Egress Queues |     253952        108     253844
*A:PE#

3.1.1. FP QoS Configuration Command Reference

3.1.1.1. Command Hierarchies

3.1.1.1.1. FP QoS Commands

config
— qos
fp-resource-policy policy-name [create]
— no fp-resource-policy policy-name
description description-string
queues
ingress-percent-of-total percent-of-total-queues

3.1.1.2. Command Descriptions

3.1.1.2.1. FP QoS Commands

fp-resource-policy

Syntax 
fp-resource-policy policy-name [create]
no fp-resource-policy policy-name
Context 
config>qos
Description 

This command configures an FP resource policy that is used to manage resources on an FP4 forwarding plane.

A default policy is created by the system and applied to all FP4 FPs by default. If an FP resource policy is removed from an FP, the system automatically applies the default policy to that FP. The system prevents the modification or deletion of the default policy, and the deletion of any user created policy that is applied to an FP. The system supports a maximum of 15 FP resource policies.

The no form of this command deletes the FP resources policy from the system.

Parameters 
policy-name—
Specifies the FP resource policy, up to 64 characters.
create—
Creates the FP resource policy entry.

queues

Syntax 
queues
Context 
config>qos>fp-resource-policy
Description 

This command enters the context to modify the FP resource policy information for the queues.

ingress-percent-of-total

Syntax 
ingress-percent-of-total percent-of-total-queues
no ingress-percent-of-total
Context 
config>qos>fp-resource-policy>queues
Description 

This command configures the percentage of the total number of queues on the FP on which the policy is applied that are allocated to ingress, with the remainder allocated to egress. The ingress and egress buffer pool sizes are not affected by the queue allocation.

The allocation is performed in sets of 8192 queues, with a minimum of 8192 queues at ingress and 8192 queues at egress. If the percentage configured results in the queue allocation not being a multiple of 8192, the number of queues at ingress is rounded down to the next 8192 boundary, and consequently the number of queues at egress is rounded up to the next 8192 boundary, both while respecting the minimum at ingress and egress.

If the FP resources policy being applied to any FP and the updated allocation is not achievable with the current ingress or egress queue consumption on any of the related FPs, then the command fails.

The configuration of ingress-percent-of-total command, including removing this parameter to return to its default configuration, causes the router to immediately reset the associated cards, XIOMs, and MDAs, except on the 7750 SR-1 where the configuration must be saved, and the router rebooted, immediately after committing the configuration transaction.

The no form of this command reverts the percentage of ingress queues, and consequently egress queues, to their default allocation.

Default 

ingress-percent-of-total 50.00

Parameters 
percent-of-total-queues—
Specifies the percentage of total ingress queues as two fraction digits.
Values—
4.00 to 97.00

 

3.1.2. Show Command Reference

3.1.2.1. Command Hierarchies

3.1.2.1.1. Show Commands

show
— qos
fp-resource-policy [fp-resource-policy-name] [association]
fp-resource-policy [fp-resource-policy-name] [detail]

3.1.2.2. Command Descriptions

3.1.2.2.1. Show Commands

fp-resource-policy

Syntax 
fp-resource-policy [fp-resource-policy-name] [association]
fp-resource-policy [fp-resource-policy-name] [detail]
Context 
show>qos
Description 

This command displays the FP resource policies configured on the system.

Parameters 
fp-resource-policy-name—
Displays the FP resource policy name, up to 32 characters.
association—
Displays the entities associated to the specified FP resource policy.
detail—
Displays detailed FP resource policies information, including FP resource policy associations.
Output 

The following output is an example of FP resource policy information.

Sample Output
A:PE# show qos fp-resources-policy
===============================================================================
FP Resource Policy Summary
===============================================================================
Policy Name                      Description
-------------------------------------------------------------------------------
default                          Default FP resource policy.
fp-res-policy-1
===============================================================================
A:PE#
A:PE# show qos fp-resources-policy fp-res-policy-1 associations
===============================================================================
FP Resource Policy
===============================================================================
Policy Name         : fp-res-policy-1
Description         : (Not Specified)
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
FP      : 1-1
FP      : 1-2
FP      : 1-3
FP      : 1-4
===============================================================================
A:PE#
A:PE# show qos fp-resources-policy fp-res-policy-1 detail
===============================================================================
FP Resource Policy
===============================================================================
Policy Name         : fp-res-policy-1
Description         : (Not Specified)
-------------------------------------------------------------------------------
Queues
-------------------------------------------------------------------------------
Ingress Percent of Total : 50.00 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
FP      : 1-1
FP      : 1-2
FP      : 1-3
FP      : 1-4
===============================================================================
A:PE#