7.4. Slope QoS Policy Command Reference

7.4.1. Command Hierarchies

7.4.1.1. Configuration Commands

config
— qos
[no] slope-policy name [create]
description description-string
— no description
[no] high-slope
max-avg percent
— no max-avg
max-prob percent
— no max-prob
start-avg percent
— no start-avg
[no] shutdown
[no] low-slope
max-avg percent
— no max-avg
max-prob percent
— no max-prob
start-avg percent
— no start-avg
[no] shutdown

7.4.1.2. Operational Commands

config
— qos
copy slope-policy src-name dst-name [overwrite]

7.4.1.3. Show Commands

show
— qos
slope-policy [slope-policy-name] [detail]

7.4.2. Command Descriptions

7.4.2.1. Configuration Commands

7.4.2.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>slope-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 (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

7.4.2.1.2. Slope Policy QoS Commands

slope-policy

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

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

Default 

slope-policy “default”

Parameters 
name—
the name of the slope policy
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 (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

 

create—
keyword used to create a slope policy

high-slope

Syntax 
[no] high-slope
Context 
config>qos>slope-policy
Description 

The high-slope context contains the commands and parameters for defining the high-priority Weighted Random Early Detection (WRED) or Random Early Detection (RED) slope graph. Each queue supports a high-priority WRED/RED slope for managing access to the queue for low-priority or out-of-profile packets.

The high-slope parameters can be changed at any time and the affected queue high-priority WRED/RED slopes will be adjusted appropriately.

The no form of this command restores the high slope configuration commands to the default values. If the commands within high-slope are set to the default parameters, the high-slope mode will not appear in save config and show config output unless the detail parameter is present.

low-slope

Syntax 
[no] low-slope
Context 
config>qos>slope-policy
Description 

The low-slope context contains the commands and parameters for defining the low-priority or high-priority WRED/RED slope graph. Each queue supports a low-priority WRED/RED slope for managing access to the queue for low-priority or out-of-profile packets.

The low-slope parameters can be changed at any time and the queue low-priority WRED/RED slopes will be adjusted appropriately.

The no form of this command restores the low slope configuration commands to the default values. If the leaf commands within low-slope are set to the default parameters, the low-slope mode will not appear in save config and show config output unless the detail parameter is present.

7.4.2.1.3. WRED/RED Slope Commands

max-avg

Syntax 
max-avg percent
no max-avg
Context 
config>qos>slope-policy>high-slope
config>qos>slope-policy>low-slope
Description 

This command sets the low-priority or high-priority WRED or RED slope position for the queue average usage value where the packet discard probability rises directly to one (maxThreshold or maxT). The percent parameter is expressed as a percentage of the maximum queue depth (buffer-based WRED) or a percentage of maximum payload of the queue (payload-based WRED).

The no form of this command restores the max-avg value to the default setting. If the current start-avg setting is larger than the default, an error will occur and the max-avg setting will not be changed to the default.

Default 

max-avg 90 (the high slope default is 90% queue usage before discard probability is 1)

max-avg 75 (the low slope default is 75% queue usage before discard probability is 1)

Parameters 
percent—
the percentage of the maximum queue depth at which point the drop probability becomes 1. The value entered must be greater than or equal to the current setting of start-avg. If the entered value is smaller than the current value of start-avg, an error will occur and no change will take place.
Values—
0 to 100

 

max-prob

Syntax 
max-prob percent
no max-prob
Context 
config>qos>slope-policy>high-slope
config>qos>slope-policy>low-slope
Description 

This command sets the high-priority or low-priority WRED/RED maximum discard probability (maxDP) at slope position max-avg. The percent parameter is expressed as a percentage of packet discard probability where always discard is a probability of 1. A max-prob value of 80 represents 80% of 1, or a packet discard probability of 0.8.

For bridging domain queues on the 2-port 10GigE (Ethernet) Adapter card and 2-port 10GigE (Ethernet) module, the queues support the following DP (discard probability) values: 0%, 1%, 2%, 3%, 4%, 5%, 6%, 7%, 8%, 9%, 10%, 25%, 50%, 75%, and 100%. User-configured values are rounded down to match these DP values.

For example, configuring a DP to be 74% means that the actual value used is 50%.

The no form of this command restores the max-prob value to the default setting.

Default 

max-prob 80 (80% maximum drop probability corresponding to the max-avg)

Parameters 
percent—
the maximum drop probability percentage corresponding to the max-avg, expressed as a decimal integer
Values—
0 to 100

 

shutdown

Syntax 
[no] shutdown
Context 
config>qos>slope-policy>high-slope
config>qos>slope-policy>low-slope
Description 

This command enables or disables the administrative status of the WRED/RED slope.

By default, all slopes are shut down and have to be explicitly enabled (no shutdown).

The no form of this command administratively enables the WRED/RED slope.

Default 

shutdown (the WRED/RED slope disabled, implying a zero (0) drop probability)

start-avg

Syntax 
start-avg percent
no start-avg
Context 
config>qos>slope-policy>high-slope
config>qos>slope-policy>low-slope
Description 

This command sets the high-priority or low-priority WRED/RED slope position for the queue average usage value where the packet discard probability starts to increase above zero (minThreshold or minT). The percent parameter is expressed as a percentage of the maximum queue depth (buffer-based WRED) or a percentage of maximum payload of the queue (payload-based WRED).

The no form of this command restores the start-avg value to the default setting. If the max-avg setting is smaller than the default, an error will occur and the start-avg setting will not be changed to the default.

Parameters 
percent—
the percentage of the maximum queue depth where the packet discard probability starts to increase above zero
Values—
0 to 100

 

Default—
50

7.4.2.2. Operational Commands

copy

Syntax 
copy slope-policy src-name dst-name [overwrite]
Context 
config>qos
Description 

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

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 
slope-policy src-name dst-name
indicates that the source policy ID and the destination policy ID are slope 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 if the destination policy ID exists.

7.4.2.3. Show Commands

Note:

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

slope-policy

Syntax 
slope-policy [slope-policy-name] [detail]
Context 
show>qos
Description 

This command displays slope policy information.

Parameters 
slope-policy-name—
the name of the slope policy
detail—
displays detailed information about the slope policy
Output 

The following output is an example of slope policy information, and Table 51 describes the fields.

Output Example
*A:ALU-1# show qos slope-policy SlopePolicy1 detail
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : SlopePolicy1
Description    : Test1
Time Avg       : 3
-------------------------------------------------------------------------------
High Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 90                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 60
-------------------------------------------------------------------------------
Low Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 75                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 40
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Object Type    Object Id     Queue
-------------------------------------------------------------------------------
sap-ingress    1             1
sap-ingress    8             1
sap-ingress    8             2
sap-egress     1             1
network-queue  default       1
network-queue  default       2
network-queue  default       3
network-queue  default       4
network-queue  default       5
network-queue  default       6
network-queue  default       7
network-queue  default       8
network-queue  default       9
network-queue  default       10
network-queue  default       11
network-queue  default       12
network-queue  default       13
network-queue  default       14
network-queue  default       15
network-queue  default       16
===============================================================================
*A:ALU-1#
Table 51:  Slope Policy Command Output Fields 

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

Time Avg

The time average factor, which is the exponential weight factor used in calculating the average queue size. The time_average_factor parameter is non-user-configurable, and is set to a system-wide default value of 3.

High Slope Parameters

Start Avg

The high-priority WRED/RED slope position for the queue average usage value where the packet discard probability starts to increase above zero

Max Avg

The high-priority WRED or RED slope position for the queue average usage value where the packet discard probability rises directly to one

Admin State

enabled - the administrative status of the WRED/RED slope is enabled

disabled - the administrative status of the WRED/RED slope is disabled

Max Prob.

The high-priority WRED/RED maximum discard probability (at slope position max-avg)

Low Slope Parameters

Start Avg

The low-priority WRED/RED slope position for the queue average usage value where the packet discard probability starts to increase above zero

Max Avg

The low-priority WRED or RED slope position for the queue average usage value where the packet discard probability rises directly to one

Admin State

enabled - the administrative status of the WRED/RED slope is enabled

disabled - the administrative status of the WRED/RED slope is disabled

Max Prob.

The low-priority WRED/RED maximum discard probability (at slope position max-avg)

Associations

Object Type

The type of object using the specified slope policy

Object Id

The identifier of the object using the specified slope policy

Queue

The number of the queue using the specified slope policy