QoS Shapers and Shaper QoS Policies

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

Topics in this chapter include:

Overview of QoS Shapers and Shaper QoS Policies

Shapers are used to control access or network traffic flows through the 7705 SAR.

QoS shapers refer to per-SAP and per-VLAN dual-rate aggregate shapers that operate at the QoS tier 2 level.

Shaper QoS policies refer to policies that contain shaper groups, such as per-customer (MSS) dual-rate aggregate shapers that operate at the QoS tier 3 level.

Configuring a dual-rate aggregate shaper means setting PIR and CIR values. For per-customer (MSS) aggregate shapers, this is done through a shaper group.

Dual-rate aggregate shapers are applied to shaped and unshaped SAP traffic for access ingress and access egress flows, and to shaped and unshaped VLAN traffic for network egress flows.

On a hybrid port, where access and network traffic can share the same physical port, a shaper policy can be applied independently to access egress or network egress traffic.

For more information on QoS shapers and shaper QoS policies, see the following sections:

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:

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

Creating a Shaper QoS Policy and Shaper Groups

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:

a shaper policy name — the system does not dynamically assign a name
a description (optional) — a brief description of the policy
a shaper group (optional) and its PIR and CIR values — a shaper group is a dual-rate aggregate shaper that is used mainly as a per-customer (MSS) aggregate shaper
an unshaped SAP shaper group (optional) — the shaper group used by the group of all unshaped SAPs for the purpose of traffic arbitration with the shaped SAPs on a port

Use the following CLI syntax to configure a shaper policy and shaper groups within the 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] 
        unshaped-sap-shaper-group shaper-group-name

Example:

config>qos 
config>qos$ shaper-policy "shaper_policy_2" create
config>qos>shaper-policy$ shaper-group ‟sg1” 
config>qos>shaper-policy>shaper-group$ rate 1000 cir 200
config>qos>shaper-policy>shaper-group$ exit
config>qos>shaper-policy$ shaper-group ‟unshaped_sg1” 
config>qos>shaper-policy>shaper-group$ rate 500 cir 100
config>qos>shaper-policy>shaper-group$ exit
config>qos>shaper-policy>unshaped-sap-shaper-group$ ‟unshaped_sg1”
config>qos>shaper-policy$ exit
config>qos$

The following 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 max cir 0
            exit
            shaper-group sg1 create
                description "Shaper Group_1"
                rate 1000 cir 200
            exit
            shaper-group unshaped_sg1 create
                no description
                rate 500 cir 100
            exit
            unshaped-sap-shaper-group unshaped_sg1 
        exit
.....
#--------------------------------------------------
*A:7705custDoc:Sar18>config>qos#

Applying a Shaper QoS Policy and Shaper Groups

A shaper QoS policy must be assigned to an Ethernet MDA for access ingress per-customer aggregate shaping, or to a port for access egress per-customer aggregate shaping. Once a shaper policy is assigned, a shaper group can be applied.

Shaper groups are created within the shaper policy and provide the per-customer (MSS) aggregate shapers. The unshaped SAP shaper group within the policy provides the shaper rate for all the unshaped SAPs (4-priority scheduled SAPs). For each shaped SAP, an ingress or egress shaper group can be specified.

For ingress, the shaper group assigned to a SAP or unshaped shaper group must be a shaper group from the shaper policy assigned to the Ethernet MDA.

For egress, the shaper group assigned to a SAP or unshaped shaper group must be a shaper group from the shaper policy assigned to the port.

All ingress shaped or unshaped SAPs configured with the same ingress shaper group on an Ethernet MDA have their aggregate traffic shaped at the shaper group rate. Similarly, all the egress shaped or unshaped SAPs configured with the same egress shaper group on a port have their aggregate traffic shaped at the shaper group rate.

On all 7705 SAR fixed platforms (with the exception of the 7705 SAR-X), when a shaper policy is assigned to an Ethernet MDA for access ingress aggregate shaping, it is automatically assigned to all the Ethernet MDAs in that chassis. The shaper group members contained in the shaper policy span all the Ethernet MDAs. SAPs on different Ethernet MDAs configured with the same ingress shaper group will share the shaper group rate.

For hybrid ports, one shaper policy can be applied to the network egress traffic as well as to the access egress traffic. For network egress, all the shaped interfaces (VLANs) and unshaped interfaces are bound to the default shaper group contained in the shaper policy assigned to the network egress port. The access egress traffic is bound to the shaper group assigned to each shaped SAP or to the default shaper group if none is assigned, and all the unshaped SAPs are assigned to the unshaped shaper group or to the default shaper group if none is assigned. Traffic is then scheduled between the network and access shaper groups by ensuring that the CIR rate for each shaper group is scheduled before any of the excess information rate (EIR) traffic from any of the shaper groups.

Applying a Shaper Policy

The following examples illustrate the CLI syntax to apply a shaper policy to an MDA and a hybrid port (access and network egress).

CLI Syntax:

config>card>mda#
    access 
        ingress
            shaper-policy policy-name

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 outputs show an ingress shaper policy applied to an MDA and different shaper policies applied to access egress and network egress traffic on a hybrid port:

*A:ALU>config>card>mda>access# info detail
----------------------------------------------
                ingress
                    fabric-policy 1
                    security-queue-policy 1
                    shaper-policy "test_shaper_policy"
                exit
----------------------------------------------
*A:ALU>config>card>mda>access#

*A:ALU>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
----------------------------------------------

Applying a Shaper Group

Shaper groups are applied to SAPs on Epipe, Ipipe, and VPLS services, and to interface SAPs on IES and VPRN services. The shaper group must exist within the shaper policy assigned to an MDA.

When an unshaped-sap-shaper-group is configured within a shaper policy, it is automatically applied to the unshaped SAPs on the MDA. Operators do not need to specifically apply the unshaped SAP shaper group.

Use the following CLI syntax to apply a shaper group to a VPLS SAP. The syntax is similar for Epipe and Ipipe SAPs. The syntax is also similar for IES and VPRN services, except that the SAP is configured on a service interface.

CLI Syntax:

config>service>vpls>sap#
    egress
        [no] shaper-group name
    ingress
        [no] shaper-group name

The following output shows shaper group ‟sg1” applied to access ingress traffic on a VPLS SAP:

*A:ALU>config>service>vpls>sap>ingress# info detail
----------------------------------------------
                    qos 1
                    no match-qinq-dot1p
                    scheduler-mode 16-priority
                    no agg-rate-limit
                    shaper-group sg1
----------------------------------------------
*A:ALU>config>service>vpls>sap>ingress#

Viewing Shaper Policy Information

Use the show>qos>shaper-policy command to view information on a shaper policy, its shaper groups (including the unshaped SAP shaper group), the PIR and CIR values, and where the policy is used.

*A:ALU>show qos shaper-policy ‟test_shaper_policy”  detail
===============================================================================
QoS Shaper Policy
===============================================================================
-------------------------------------------------------------------------------
Shaper Policy (test_shaper_policy)
-------------------------------------------------------------------------------
Policy                     : test_shaper_policy
Description                : (Not Specified)
Unshaped Sap Shaper Group  : unshaperd_sg1
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Shaper Group Name                   PIR (Kbps)      CIR (Kbps)
-------------------------------------------------------------------------------
default                             max             0
test_sg1                            999000          555000
unshaperd_sg1                       888000          444000
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Policy Associations
-------------------------------------------------------------------------------
Object Type    Object Id      Direction
-------------------------------------------------------------------------------
MDA            1/1            access  ingress
MDA            1/2            access  ingress
MDA            1/5            access  ingress
Port           1/2/1          access  egress
Port           1/5/8          network egress
-------------------------------------------------------------------------------
===============================================================================
*A:ALU>show qos shaper-policy ‟test_shaper_policy”  detail#

Default Shaper QoS Policy Values

The default shaper policies are identified by the policy name ‟default”. The default policies cannot be deleted. Shaper Policy Defaults displays the default shaper policy parameters.

Table 1. 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 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 and an Unshaped SAP Aggregate Shaper (H-QoS)

Configuring tier 2 per-SAP aggregate shapers applies to Gen-2 SAPs configured with 16-priority scheduling mode and Gen-3 SAPs. Access ingress and access egress shapers are configured under the same CLI context.

Configuring a single tier 2 aggregate shaper for all unshaped SAPs applies to Gen-2 SAPs configured with 4-priority scheduling mode. Access ingress and access egress shapers are configured under different CLI contexts.

Creating 16-Priority Shaped SAPs and Configuring per-SAP Aggregate Shapers

Create shaped Gen-2 SAPs by configuring the scheduler mode to 16-priority. On Gen-3 hardware, the scheduler mode is always 4-priority and SAPs are shaped.

Configure a shaped SAPs’ aggregate rates by setting the CIR and PIR, as required. The SAP must be shut down before the scheduler mode and the agg-rate and cir-rate can be changed.

Use the first CLI syntax (below) to create shaped SAPs for access egress and access ingress for VLL and VPLS services (including routed VPLS), and the second syntax for IES and VPRN services. Examples are given for Epipe and IES services on Gen-2 and Gen-3 hardware:

CLI Syntax:

config>service>epipe service-id customer customer-id 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]

CLI Syntax:

config>service>ies service-id customer customer-id create
    interface ip-interface-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]

In the examples below, MDA 1/12 is a Gen-2 adapter card and MDA 1/3 is a Gen-3 adapter card.

Example:

config>service>epipe# sap 1/12/8 create
config>service>epipe>sap# shutdown
config>service>epipe>sap# egress
    ...egress# scheduler-mode 16-priority
    ...egress# agg-rate-limit 250000 cir 150000
config>service>epipe# sap 1/12/7 create
config>service>epipe>sap# ingress
    ...ingress# scheduler-mode 16-priority
    ...ingress# agg-rate-limit 250000 cir 150000
config>service>epipe# sap 1/3/2 create
config>service>epipe>sap# ingress
    ...ingress# agg-rate-limit 250000 cir 150000

Example:

config>service>ies# interface ‟ies_6000_interface”
config>service>ies>if# sap 1/12/5 create
config>service>ies>if>sap# shutdown
config>service>ies>if>sap# egress
    ...egress# scheduler-mode 16-priority
    ...egress# agg-rate-limit 250000 cir 150000
config>service>ies# interface ‟ies_6001_interface”
config>service>ies>if# sap 1/12/6 create
config>service>ies>if>sap# # ingress
    ...ingress# scheduler-mode 16-priority
    ...ingress# agg-rate-limit 250000 cir 150000
config>service>ies>if# sap 1/3/3 create
config>service>ies>if>sap# # ingress
    ...ingress# agg-rate-limit 250000 cir 150000

The following outputs display the shaped SAP configuration for Epipe and IES services:

*A:7705custDoc:Sar18>config>service>epipe# info
----------------------------------------------
....
            sap 1/12/7 create
                shutdown
                ingress
                    scheduler-mode 16-priority
                    agg-rate-limit 250000 cir 150000
                exit
            exit
            sap 1/12/8 create
                shutdown
                egress
                    scheduler-mode 16-priority
                    agg-rate-limit 250000 cir 150000
                exit
            exit
            sap 1/3/2 create
                shutdown
                egress
                    agg-rate-limit 250000 cir 150000
                exit
            exit
----------------------------------------------
*A:7705custDoc:Sar18>config>service>epipe#

*A:7705custDoc:Sar18>config>service>ies# info
----------------------------------------------
....
            interface "ies_6000_interface" create
                sap 1/12/5 create
                    shutdown
                    egress
                        scheduler-mode 16-priority
                        agg-rate-limit 250000 cir 150000
                    exit
                exit
            exit
            interface "ies_6001_interface" create
                sap 1/12/6 create
                    shutdown
                    ingress
                        scheduler-mode 16-priority
                        agg-rate-limit 250000 cir 150000
                    exit
                exit
            exit
            interface "ies_6002_interface" create
            sap 1/3/3 create
                shutdown
                egress
                    agg-rate-limit 250000 cir 150000
                exit
            exit
----------------------------------------------

Configuring an Unshaped Aggregate CIR for All 4-Priority Unshaped SAPs (Access Ingress)

Use the first CLI syntax to set the unshaped-sap-cir for all unshaped 4-priority SAPs on a 7705 SAR-8 Shelf V2 or 7705 SAR-18. The fabric profile must be in aggregate mode before an unshaped SAP aggregate CIR can be assigned. Use the second CLI syntax for a 7705 SAR-M, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-A, 7705 SAR-Ax, or 7705 SAR-Wx; it does not apply to the 7705 SAR-X.

CLI Syntax:

config>qos
    fabric-profile policy-id aggregate-mode create
        aggregate-rate aggregate-rate [unshaped-sap-cir cir-rate]

CLI Syntax:

config>system>qos
    access-ingress-aggregate-rate access-ingress-aggregate-rate [unshaped-sap-cir cir-rate]

Example:

config>qos# 
config>qos# fabric-profile 2 aggregate-mode create
config>qos>fabric-profile# aggregate-rate 250000 unshaped-sap-cir 150000

Example:

config>system>qos# 
config>system>qos# access-ingress-aggregate-rate 250000 unshaped-sap-cir 150000

The following output displays the fabric profile configuration for an H-QoS configuration:

*A:ALU-1:Sar18>config>qos# info detail
#--------------------------------------------------
echo "QoS Policy Configuration"
#--------------------------------------------------
....
 fabric-profile 2 aggregate-mode create
            no description
            aggregate-rate 250000 unshaped-sap-cir 150000
        exit
#--------------------------------------------------

*A:ALU-1>config>qos#

For the 7705 SAR-M, 7705 SAR-H, 7705 SAR-Hc, 7705 SAR-A, 7705 SAR-Ax, and 7705 SAR-Wx:

*A:7705custDoc:sarM>config>system>qos# info detail
----------------------------------------------
            access-ingress-aggregate-rate 250000 unshaped-sap-cir 150000
            network-ingress-aggregate-rate 2
----------------------------------------------
*A:7705custDoc:sarM>config>system>qos#

Configuring an Unshaped Aggregate CIR for All 4-Priority Unshaped SAPs (Access Egress)

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 Interface Configuration Guide for command descriptions.

Use the following CLI syntax to configure a per-port CIR rate limit for the aggregate of all 4-priority unshaped SAPs on the egress port:

CLI Syntax:

config>port port-id>ethernet
    access
        egress
            [no] unshaped-sap-cir cir-rate

Example:

config# port 1/12/7 
config>port# ethernet
config>port>ethernet# access
config>port>ethernet>access# egress
config>port>ethernet>access>egress# unshaped-sap-cir 5000000

The following output displays the port configuration for the unshaped SAPs in an H-QoS configuration:

*A:7705custDoc:Sar18>config>port# info
----------------------------------------------
.....
        ethernet
            access
                egress
                    unshaped-sap-cir 500000
                exit
            exit
        exit
----------------------------------------------
*A:7705custDoc:Sar18>config>port#

Configuring per-VLAN Shapers and an Unshaped VLAN Shaper

This section contains information on the following topics:

Configuring Per-VLAN Network Egress Shapers

Per-VLAN network egress shapers can be configured for network interfaces.

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. 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. Refer to the 7705 SAR Router Configuration Guide for command descriptions.

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.

Use the following CLI syntax to configure a CIR for the bulk of network egress unshaped VLANs. Refer to the 7705 SAR Interface Configuration Guide for command descriptions.

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 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.

Shaper QoS Policy Command Reference

Command Hierarchies

Configuration Commands

config
    - qos
        - shaper-policy policy-name [create] 
        - no shaper-policy policy-name
            - description description-string
            - no description 
            - shaper-group shaper-group-name [create]
            - no shaper-group shaper-group-name
                - rate pir-rate [cir cir-rate] 
                - no rate 
            - [no] unshaped-sap-shaper-group shaper-group-name

Operational Commands

config
    - qos
        - copy shaper-policy src-name dst-name [overwrite]

Show Commands

show
    - qos
        - shaper-policy [shaper-policy-name] [detail]

Command Descriptions

Configuration Commands

Generic Commands

description

Syntax

description description-string

no description

Context

config>qos>shaper-policy

Description

This command creates a text description stored in the configuration file for a configuration context.

The no form of this command removes any description string from the context.

Default

n/a

Parameters

description-string: a text string describing the entity. Allowed values are any string up to 80 characters long composed of printable, 7-bit ASCII characters. If the string contains special characters (such as #, $, or spaces), the entire string must be enclosed within double quotes.

Shaper QoS Policy Commands

shaper-policy

Syntax

shaper-policy policy-name [create]

no shaper-policy policy-name

Context

config>qos

Description

This command enables the context to configure a shaper QoS policy.

For hybrid ports, the shaper policy is independently assigned to access or network egress traffic. When the Ethernet port mode is changed to hybrid mode, the default policy is assigned to access and network traffic. To change an access or network policy, use the commands config>port>ethernet>access>egress>shaper-policy and config>port>ethernet> network>egress>shaper-policy.

For access ingress per-customer aggregate shaping, the shaper policy is assigned to an Ethernet MDA, and SAPs on that Ethernet MDA must be bound to a shaper group within the shaper policy bound to that Ethernet MDA. To assign a shaper policy to an adapter card, use the command config>card>mda>access>ingress>shaper-policy.

For access egress per-customer aggregate shaping, the shaper policy is assigned to a port, and SAPs on that port must be bound to a shaper group within the shaper policy bound to that port. To assign a shaper policy on egress, use the command config>port>ethernet> access>egress>shaper-policy.

The default shaper policy cannot be deleted. Shaper Policy Defaults displays the default shaper policy parameters.

Table 2. Shaper Policy Defaults
Field	Default
description	‟Default Shaper QoS policy.”
shaper-group	‟default”
description	‟Default Shaper Group.”
pir-rate	max
cir-rate	0

The no form of this command removes the configured shaper-policy.

Default

shaper-policy ‟default”

Parameters

policy-name

the name of the shaper policy. To access the default shaper policy, enter ‟default”.

Values

Valid names consist of any string up to 32 characters long composed of printable, 7-bit ASCII characters.

If the string contains special characters (such as #, $, or spaces), the entire string must be enclosed within double quotes.

create: keyword used to create a shaper policy

shaper-group

Syntax

shaper-group shaper-group-name [create]

no shaper-group shaper-group-name

Context

config>qos>shaper-policy

Description

This command creates and configures a shaper group. A shaper group is a dual-rate aggregate shaper used to arbitrate shaped and unshaped traffic for SAPs (access) and for VLANs (network).

The default shaper group cannot be deleted.

The no form of this command removes the configured shaper-group.

Default

shaper-group ‟default”

Parameters

shaper-group-name: the name of the shaper group. To access the default shaper group, enter ‟default”.

create: keyword used to create a shaper group

rate

Syntax

rate pir-rate [cir cir-rate]

no rate

Context

config>qos>shaper-policy>shaper-group

Description

This command sets the PIR and CIR for the shaper group. When the PIR or CIR is set to max, the corresponding aggregate shaper rate is capped at the egress-rate configured on the port (config>port>ethernet>egress-rate).

The no form of this command restores the pir-rate and cir-rate to the default values.

Default

pir-rate: max cir-rate: 0

Parameters

cir-rate

the CIR for the shaper group

Values: 0 to 100000000, or max (kbps)

pir-rate

the PIR for the shaper group

Values: 1 to 100000000, or max (kbps)

unshaped-sap-shaper-group

Syntax

[no] unshaped-sap-shaper-group shaper-group-name

Context

config>qos>shaper-policy

Description

This command assigns a shaper group to the unshaped SAPs assigned to the shaper policy. An unshaped shaper group is a dual-rate aggregate shaper used to arbitrate unshaped traffic for SAPs (access).

There can be only one unshaped SAP shaper group per shaper policy. The unshaped SAP shaper group must already exist within the shaper policy before it can be chosen for the unshaped-sap-shaper-group.

The no form of this command removes the configured unshaped-sap-shaper-group.

Default

shaper-group ‟default”

Parameters

shaper-group-name: the name of the unshaped SAP shaper group. To access the default shaper group, enter ‟default”.

Operational Commands

copy

Syntax

copy shaper-policy src-name dst-name [overwrite]

Context

config>qos

Description

This command copies existing QoS policy entries for a QoS policy to another QoS policy.

This command is a configuration-level maintenance tool used to create new policies using existing policies. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

Parameters

shaper-policy src-name dst-name: indicates that the source policy ID and the destination policy ID are shaper policy IDs. Specify the source policy ID that the copy command will attempt to copy from and specify the destination policy ID to which the command will copy a duplicate of the policy.

overwrite: specifies that the existing destination policy is to be replaced. Everything in the existing destination policy will be overwritten with the contents of the source policy. If overwrite is not specified, an error will occur.

Show Commands

Note: The following command outputs are examples only; actual displays may differ depending on supported functionality and user configuration.

shaper-policy

Syntax

shaper-policy [shaper-policy-name] [detail]

Context

show>qos

Description

This command displays shaper policy information.

Parameters

shaper-policy-name: the name of the shaper policy

detail: displays detailed information about the shaper policy

Output

The following output is an example of shaper policy information, and Shaper Policy Field Descriptions describes the fields.

Output Example

*A:7705custDoc:Sar18>show>qos# shaper-policy
===============================================================================
Shaper Policies
===============================================================================
Policy-Id                        Description
-------------------------------------------------------------------------------
2
5
default                          Default Shaper QoS policy.
shaper_policy_1
shaper_policy_2
===============================================================================
*A:7705custDoc:Sar18>show>qos#

*A:7705:Dut-C# show qos shaper-policy 5
===============================================================================
QoS Shaper Policy
===============================================================================
-------------------------------------------------------------------------------
Shaper Policy (5)
-------------------------------------------------------------------------------
Policy                     : 5
Description                : Description for Shaper Policy id # 5
-------------------------------------------------------------------------------
Shaper Group Name                   PIR             CIR
-------------------------------------------------------------------------------
default                             max             0
===============================================================================

*A:7705:Dut-C# show qos shaper-policy 5 detail
===============================================================================
QoS Shaper Policy
===============================================================================
-------------------------------------------------------------------------------
Shaper Policy (5)
-------------------------------------------------------------------------------
Policy                     : 5
Description                : Description for Shaper Policy id # 5
-------------------------------------------------------------------------------
Shaper Group Name                   PIR             CIR
-------------------------------------------------------------------------------
default                             max             0
-------------------------------------------------------------------------------
Policy Associations
-------------------------------------------------------------------------------
Object Type    Object Id     Direction
-------------------------------------------------------------------------------
Port           1/10/7        access egress
Port           1/10/8        network egress
===============================================================================
*A:7705custDoc:Sar18>show>qos#

Table 3. Shaper Policy Field Descriptions
Label	Description
Policy	The ID that uniquely identifies the policy
Description	A text string that helps identify the policy’s context in the configuration file
Shaper Group Name	The name of the shaper group
PIR	The peak information rate for the shaper
CIR	The committed information rate for the shaper
Policy Associations
Object Type	The type of object using the specified shaper policy
Object Id	The identifier of the object using the specified shaper policy
Direction	The direction of traffic to which the shaper policy applies