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
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 about 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 about 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. The following table displays the default shaper policy parameters.
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. See 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 about 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. See 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. See 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.
Because 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. The following table displays the default shaper policy parameters.
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”.
- 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
- pir-rate
the PIR for the shaper group
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
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#
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 |