Shaper QoS Policies

In This Chapter

This chapter provides information to configure shaper QoS policies using the command line interface.

Topics in this chapter include:

Overview

Shaper policies are used to configure dual-rate shapers that control access or network traffic flows through the 7705 SAR. The dual-rate shapers provide a third tier of aggregate shaping to shaped and unshaped SAP traffic for access egress flows and to shaped and unshaped VLAN traffic for network egress flows. See QoS for Hybrid Ports for more information.

Configuring a dual-rate aggregate shaper means setting PIR and CIR values, which is done through an entity called a shaper group.

On a hybrid port, both access and network traffic share the same physical port. The shaper policy is applied independently to the access egress or network egress traffic.

Note:

In Release 6.2, the only shaper group supported is the default shaper group.

Basic Configuration

This section contains the following topics related to creating and applying shaper QoS policies:

A basic shaper QoS policy must conform to the following rules.

  1. Each shaper policy must have a unique policy identifier (name).
  2. Default values can be modified but parameters cannot be deleted.

Creating a Shaper QoS Policy

Configuring and applying shaper QoS policies is optional. If no shaper QoS policy is explicitly defined, the default shaper QoS policy (“default”) is applied.

To create a new shaper policy, define the following:

  1. a shaper policy name — the system does not dynamically assign a name
  2. a description (optional) — a brief description of the policy
  3. a shaper group (optional) and its PIR and CIR values — a shaper group is an access or a network aggregate dual-rate shaper (see QoS for Hybrid Ports)

Use the following CLI syntax to configure a shaper policy:

CLI Syntax:
config>qos#
shaper-policy policy-name [create]
description description-string
shaper-group shaper-group-name [create]
description description-string
rate pir-rate [cir cir-rate]
Example:
configure qos$
config>qos$ shaper-policy "shaper_policy_2" create
config>qos>shaper-policy$ shaper-group “default”
config>qos>shaper-policy>shaper-group$ rate 1000 cir 200
config>qos>shaper-policy>shaper-group$ exit
config>qos>shaper-policy$ exit
config>qos$

The following sample output shows the configuration for “shaper_policy_2”:

*A:7705custDoc:Sar18>config>qos# info detail
#--------------------------------------------------
....
        shaper-policy "shaper_policy_2" create
            no description
            shaper-group default create
                description "Default Shaper Group."
                rate 1000 cir 200
            exit
        exit
.....
#--------------------------------------------------
*A:7705custDoc:Sar18>config>qos#

Applying a Shaper Policy

A shaper policy can be applied to Ethernet access egress and network egress traffic for a hybrid port. Refer to the 7705 SAR OS Interface Configuration Guide for command descriptions for these commands.

There can be one shaper policy for access egress and one for network egress. All the unshaped SAP and unshaped network traffic is bound to an access and a network shaper group, respectively. That is, shaped SAPs and the bulk (aggregate) of unshaped SAPs are shaped together as per the shaper policy assigned to access egress. Similarly, for network traffic, the shaped interfaces (VLANs) and the bulk (aggregate) of unshaped interfaces are shaped together as per the shaper policy assigned to network egress.

The shaper rate defined for the shaper policy that is assigned to the access egress traffic of a hybrid port applies to all shaped SAPs and the bulk of unshaped SAPs. The shaper rate for the port’s network egress traffic applies similarly to VLANs (that is, all shaped VLANs and the bulk of unshaped VLANs). Once the configured egress shaper rate is reached, both the access and network traffic scheduling is paused.

Note:

  1. On the 8-port Ethernet Adapter card, version 2, and the 7705 SAR-F, shaped and unshaped VLANs are arbitrated towards the port but egress-rate cannot be enabled.
  2. When a shaper policy is assigned to a hybrid port on a 6-port Ethernet 10Gbps Adapter card, the cir-rate does not take effect.

Use the following CLI syntax to apply a shaper policy to a hybrid port (access and network egress).

CLI Syntax:
config>port>ethernet#
egress-rate sub-rate
mode hybrid
access
egress
shaper-policy policy-name
unshaped-sap-cir cir-rate
network
egress
shaper-policy policy-name
unshaped-if-cir cir-rate

The following sample output shows different shaper policies applied to access egress and network egress traffic on a hybrid port:

*A:7705custDoc:Sar18>config>port>ethernet# info
----------------------------------------------
            mode hybrid
            encap-type dot1q
            network
                egress
                    shaper-policy 2
                    unshaped-if-cir 250000
                exit
            exit
            access
                egress
                    unshaped-sap-cir 200000
                    shaper-policy 5
                exit
            exit
----------------------------------------------
*A:7705custDoc:Sar18>config>port>ethernet#

Default Shaper Policy Values

The default shaper policies are identified by the policy name “default”. The default policies cannot be deleted. Table 61 displays the default shaper policy parameters.

Table 61:  Shaper Policy Defaults   

Field

Default

description

“Default Shaper QoS policy.”

shaper-group

“default”

    description

“Default Shaper Group.”

    pir-rate

max

    cir-rate

0

The following sample output displays the default configuration:

A*A:ALU-1>config>qos# info detail
#--------------------------------------------------
echo "QoS Policy Configuration"
#--------------------------------------------------
 ...    
       shaper-policy "default" create
            description "Default Shaper QoS policy."
            shaper-group default create
                description "Default Shaper Group."
                rate max cir 0
            exit
        exit
 ...
#--------------------------------------------------

Configuring Per-SAP Aggregate Shapers

Per-SAP aggregate shapers can be configured for the following services: Epipe, Ipipe, IES, VPLS, and VPRN. Refer to the 7705 SAR OS Services Guide for command descriptions.

Use the following CLI syntax to configure an Epipe per-SAP aggregate shaper (Ipipe and VPLS syntax is similar):

CLI Syntax:
config>service>epipe#
sap sap-id create
egress
scheduler-mode {4-priority | 16-priority}
agg-rate-limit agg-rate [cir cir-rate]
ingress
scheduler-mode {4-priority | 16-priority}
agg-rate-limit agg-rate [cir cir-rate]

Use the following CLI syntax to configure an IES per-SAP aggregate shaper (VPRN syntax is similar):

CLI Syntax:
config>service>ies#
interface ip-int-name create
sap sap-id create
egress
scheduler-mode {4-priority | 16-priority}
agg-rate-limit agg-rate [cir cir-rate]
ingress
scheduler-mode {4-priority | 16-priority}
agg-rate-limit agg-rate [cir cir-rate]

Configuring a CIR for Access Egress Unshaped SAPs

To provide arbitration between the bulk (aggregate) of unshaped SAPs and the shaped SAPs, assign a rate to the unshaped SAPs. Refer to the 7705 SAR OS Interface Configuration Guide for command descriptions.

Use the following CLI syntax to configure a CIR for the bulk of access egress unshaped SAPs:

CLI Syntax:
config>port>ethernet#
access
egress
unshaped-sap-cir cir-rate

Configuring Per-VLAN Network Egress Shapers

Per-VLAN network egress shapers can be configured for network interfaces. Refer to the 7705 SAR OS Router Configuration Guide for command descriptions.

The queue-policy command is used to enable and disable the network egress per-VLAN shapers on a per-interface basis. If the no queue-policy command is used, the VLAN (that is, the interface) defaults to unshaped mode. Note that the agg-rate-limit command cannot be accessed unless a network queue policy is assigned to the interface.

Use the following CLI syntax to configure a per-VLAN network egress shaper on a network interface:

CLI Syntax:
config>router>interface#
egress
queue-policy name
agg-rate-limit agg-rate [cir cir-rate]

Configuring a CIR for Network Egress Unshaped VLANs

To provide arbitration between the bulk (aggregate) of unshaped VLANs and the shaped VLANs, assign a rate to the unshaped VLANs. Refer to the 7705 SAR OS Interface Configuration Guide for command descriptions.

Use the following CLI syntax to configure a CIR for the bulk of network egress unshaped VLANs:

CLI Syntax:
config>port>ethernet#
network
egress
unshaped-if-cir cir-rate

Service Management Tasks

This section describes the following service management tasks:

Removing and Deleting QoS Policies

A QoS policy cannot be deleted until its associations with all the ports are removed.

Since one shaper policy can be assigned to multiple ports, you must remove all the associations to the ports before deleting the shaper policy.

Use the following CLI syntax to remove a shaper policy from a port and then delete the shaper policy from the QoS configuration:

CLI Syntax:
config>port>ethernet>access>egress# no shaper-policy
config>qos# no shaper-policy policy-name
Example:
config>port>ethernet>access>egress# no shaper-policy
config>qos# no shaper-policy shaper_policy_2

Copying and Overwriting QoS Policies

You can copy an existing shaper policy to a new shaper policy or overwrite an existing shaper policy. If the destination policy ID exists, the overwrite option must be specified or an error occurs.

Use the following syntax to overwrite an existing shaper QoS policy.

CLI Syntax:
config>qos> copy shaper-policy src-name dst-name overwrite
Example:
config>qos# copy shaper-policy ShaperPolicy1 ShaperPolicy2 overwrite
config>qos# exit

The following sample output displays the copied policies:

*A:ALU-2>config>qos# info detail
#--------------------------------------------------
echo "QoS Policy Configuration"
#--------------------------------------------------
...
        shaper-policy "default" create
            description "Default shaper policy"
            shaper-group “default” create
                rate max cir 0
            exit
        exit
        shaper-policy "ShaperPolicy2" create
            description "Test2"
            shaper-group “default” create
                rate 2000 cir 250
            exit
        exit
        shaper-policy "ShaperPolicy1" create
            description "Test1"
            shaper-group “default” create
                rate 1000 cir 150
            exit
        exit
        shaper-policy "ShaperPolicy2" create
            description "Test1"
            shaper-group “default” create
                rate 1000 cir 150
            exit
        exit
 ...
#--------------------------------------------------

Editing QoS Policies

You can change existing policies and entries in the CLI. The changes are applied immediately to all queues where this policy is applied. To prevent configuration errors, copy the policy to a work area, make the edits, and then write over the original policy.