12.7. Slope QoS Policy Command Reference

12.7.1. Command Hierarchies

12.7.1.1. Configuration Commands

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

12.7.1.2. Operational Commands

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

12.7.1.3. Show Commands

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

12.7.2. Command Descriptions

12.7.2.1. Configuration Commands

12.7.2.1.1. Generic Commands

description

Syntax 
description description-string
no description
Context 
config>qos>slope-policy
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

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

The description command associates a text string with a configuration context to help identify the context in the configuration file.

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

Parameters 
description-string—
Specifies a text string describing the entity. Allowed values are any string up to 80 characters composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, and so on), the entire string must be enclosed within double quotes.

12.7.2.1.2. Slope Policy QoS Commands

slope-policy

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

Supported on all 7210 SAS platforms as described in this document

Description 

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

Default 

slope-policy default

Parameters 
name—
Specifies the name of the slope policy. 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, and so on), the entire string must be enclosed within double quotes.

12.7.2.1.3. Slope Policy QoS Policy Commands

queue

Syntax 
queue queue-id
Context 
config>qos>slope-policy
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to configure the high-priority, low-priority, and non-tcp slope parameters per queue.

Parameters 
queue-id —
Specifies the ID of the queue for which the drop-rate is to be configured.
Values—
1 to 8

 

high-slope

Syntax 
[no] high-slope
Context 
config>qos>slope-policy>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to define the high priority Random Early Detection (RED) slope graph. A high priority RED slope is used managing access to the shared portion of the buffer pool for high priority or in-profile packets that ingress of non-ring ports and egress out of non-ring ports.

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

The no form of this command reverts 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>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to define the low priority RED slope graph. A low priority ring RED slope is used managing access to the shared portion of the buffer pool for low priority or out-of-profile packets that are received on non-ring ports and egress out of non-ring ports.

The low-slope parameters can be changed at any time and the affected buffer pool high priority RED slopes will be adjusted appropriately.

The no form of this command reverts the low slope configuration commands to the default values. If the 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.

high-slope-ring

Syntax 
[no] high-slope-ring
Context 
config>qos>slope-policy
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to define the high priority RED slope graph. A high priority ring RED slope is used managing access to the shared portion of the buffer pool for high priority or in-profile packets that ingress of ring ports and egress out of ring ports.

The high-slope-ring parameters can be changed at any time and the affected buffer pool high priority RED slopes will be adjusted appropriately.

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

low-slope-ring

Syntax 
[no] low-slope-ring
Context 
config>qos>slope-policy
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables the context to define the low priority Random Early Detection (RED) slope graph. A low priority ring RED slope is used managing access to the shared portion of the buffer pool for low priority or out-of-profile packets that are received on ring ports and egress out of ring ports.

The low-slope-ring parameters can be changed at any time and the affected buffer pool high priority RED slopes will be adjusted appropriately.

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

12.7.2.1.4. RED Slope Commands

max-avg

Syntax 
max-avg percent
no max-avg
Context 
config>qos>slope-policy>queue>high-slope
config>qos>slope-policy>queue>low-slope
config>qos>slope-policy>queue>high-slope-ring
config>qos>slope-policy>queue>low-slope-ring
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command sets the low priority or high priority Weighted Random Early Detection (WRED) slope position for the reserved and shared buffer average utilization value where the packet discard probability rises directly to one. The percent parameter is expressed as a percentage of the shared buffer size.

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

Default 

max-avg 90 - High slope default is 90% buffer utilization before discard probability is 1

max-avg 75 - Low slope default is 75% buffer utilization before discard probability is 1

max-avg 75 - Non-tcp slope default is 75% buffer utilization before discard probability is 1

Parameters 
percent—
Specifies the percentage of the reserved and shared buffer space for the buffer pool at which point the drop probability becomes 1. The value entered must be greater 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>queue>high-slope
config>qos>slope-policy>queue>low-slope
config>qos>slope-policy>queue>high-slope-ring
config>qos>slope-policy>queue>low-slope-ring
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command sets the low priority or high priority Random Early Detection (RED) slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one. 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 75 represents 75% of 1, or a packet discard probability of 0.75.

The no form of this command reverts the value to the default.

Default 

max-prob 75

Parameters 
percent—
Specifies the maximum drop probability percentage corresponding to the max-avg, expressed as a decimal integer.
Values—
0 to 10, 25, 50, 75, 100

 

shutdown

Syntax 
[no] shutdown
Context 
config>qos>slope-policy>high-slope
config>qos>slope-policy>low-slope
config>qos>slope-policy>queue>high-slope-ring
config>qos>slope-policy>queue>low-slope-ring
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command enables or disables the administrative status of the Random Early Detection slope.

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

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

Default 

shutdown

start-avg

Syntax 
start-avg percent
no start-avg
Context 
config>qos>slope-policy>queue>high-slope
config>qos>slope-policy>queue>low-slope
config>qos>slope-policy>queue>high-slope-ring
config>qos>slope-policy>queue>low-slope-ring
 
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command sets the low priority or high priority Random Early Detection (RED) slope position for the shared buffer average utilization value where the packet discard probability starts to increase above zero. The percent parameter is expressed as a percentage of the shared buffer size.

The no form of this command reverts the value to the default. 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.

Default 

max-avg 70 - High slope default is 70% buffer utilization

max-avg 50 - Low slope default is 50% buffer utilization

max-avg 50 - Non-tcp slope default is 50% buffer utilization

Parameters 
percent—
Specifies the percentage of the reserved and shared buffer space for the buffer pool at which the drop starts. The value entered must be lesser or equal to the current setting of max-avg. If the entered value is greater than the current value of max-avg, an error will occur and no change will take place.
Values—
0 to 100

 

12.7.2.1.5. Operational Commands

copy

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

Supported on all 7210 SAS platforms as described in this document

Description 

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

The copy 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—
Specifies 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. This parameter indicates that the source policy ID and the destination policy ID are slope policy IDs.
overwrite—
Keyword to replace the existing destination policy. 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.

12.7.2.1.6. Show Commands

slope-policy

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

Supported on all 7210 SAS platforms as described in this document

Description 

This command displays slope policy information.

Parameters 
slope-policy-name—
Specifies the name of the slope policy.
detail—
Displays detailed information about the slope policy.
Output 

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

Sample Output
*A:SAH01-051>show>qos# slope-policy "default"
 
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : default
Description    : Default slope policy.
 
-------------------------------------------------------------------------------
High Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 70                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 80
 
-------------------------------------------------------------------------------
Low Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 50                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 80
 
-------------------------------------------------------------------------------
High Slope Ring Parameters
-------------------------------------------------------------------------------
Start Avg      : 70                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 80
 
-------------------------------------------------------------------------------
Low Slope Ring Parameters
-------------------------------------------------------------------------------
Start Avg      : 50                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 80
 
===============================================================================
*A:SAH01-051>show>qos#
 
*A:SAH01-051>show>qos# slope-policy detail
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : default
Description    : Default slope policy.
-------------------------------------------------------------------------------
High Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 70                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 80
-------------------------------------------------------------------------------
Low Slope Parameters
-------------------------------------------------------------------------------
Start Avg      : 50                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 80
-------------------------------------------------------------------------------
High Slope Ring Parameters
-------------------------------------------------------------------------------
Start Avg      : 70                           Admin State  : Disabled
Max Avg        : 90                           Max Prob.    : 80
-------------------------------------------------------------------------------
Low Slope Ring Parameters
-------------------------------------------------------------------------------
Start Avg      : 50                           Admin State  : Disabled
Max Avg        : 75                           Max Prob.    : 80
-------------------------------------------------------------------------------
SAP Ingress
-------------------------------------------------------------------------------
SAP Ingress Policy Id         : 1
Queue Ids                     : 1
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
SAP Egress
-------------------------------------------------------------------------------
SAP Egress Policy Id          : 1
Queue Ids                     : 1
------------------------------------------------------------------------------
------------------------------------------------------------------------------
Network Ingress
------------------------------------------------------------------------------
Network Ingress Policy Id     : 1
Queue Ids                     : 1, 2, 3, 4, 5, 6, 7, 8
------------------------------------------------------------------------------
Network Queues
------------------------------------------------------------------------------
Network Queue Policy Name     : default
Queue Ids                     : 1, 2, 3, 4, 5, 6, 7, 8
------------------------------------------------------------------------------
==============================================================================
*A:SAH01-051>show>qos#
Table 47:  Output Fields: QoS Slope Policy 

Label

Description

Policy

The ID that uniquely identifies the policy

Description

A string that identifies the policy’s context in the configuration file

Time Avg

The weighting between the previous shared buffer average utilization result and the new shared buffer utilization

Slope Parameters

Start Avg

Specifies the low priority or high priority RED slope position for the shared buffer average utilization value where the packet discard probability starts to increase above zero

Max Avg

Specifies the percentage of the shared buffer space for the buffer pool at which point the drop probability becomes 1, expressed as a decimal integer

Admin State

Up — The administrative status of the RED slope is enabled

Down — The administrative status of the RED slope is disabled

Specifies the low priority or high priority RED slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one

Max Prob.

Specifies the high priority RED slope position for the maximum non-one packet discard probability value before the packet discard probability rises directly to one