11.8. Command Descriptions

11.8.1. Configuration Commands

11.8.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, etc.), the entire string must be enclosed within double quotes.

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. It also allows bulk modifications to an existing policy with the use of the overwrite keyword.

Parameters 
slope-policy—
Specifies 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 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.

11.8.2. Operational Commands

11.8.2.1. Slope Policy QoS Commands

slope-policy

Syntax 
[no] slope-policy name [create]
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 composed of printable, 7-bit ASCII characters. If the string contains special characters (#, $, spaces, etc.), the entire string must be enclosed within double quotes.

11.8.2.2. 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 RED slope graph. Each buffer pool supports a high priority RED slope for managing access to the shared portion of the buffer pool for high priority or in-profile packets.

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

Note:

See Table 46 for information about the mapping of traffic types to use high-slope parameters on 7210 SAS-D. See Table 47 for information about the mapping of traffic types to use high-slope parameters on 7210 SAS-Dxp.

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 node 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. Each buffer pool supports a low priority RED slope for managing access to the shared portion of the buffer pool for low priority or out-of-profile packets.

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

Note:

See Table 46 for information about the mapping of traffic types to use low-slope parameters on 7210 SAS-D. See Table 47 for information about the mapping of traffic types to use low-slope parameters on 7210 SAS-Dxp.

The no form of this command reverts 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 node will not appear in save config and show config output unless the detail parameter is present.

non-tcp-slope

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

7210 SAS-D

Description 

This command configures non-tcp profile RED slope parameters.

Note:

See Table 46 for information about the mapping of traffic types to use non-TCP-slope parameters on 7210 SAS-D.

The no form of this command reverts to the default.

time-average-factor

Syntax 
time-average-factor value
no time-average-factor
Context 
config>qos>slope-policy>queue
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command configures a weighting factor to calculate the new shared buffer average utilization after assigning buffers for a packet entering a queue. To derive the new shared buffer average utilization, the buffer pool takes a portion of the previous shared buffer average and adds it to the inverse portion of the instantaneous shared buffer utilization. The time-average-factor command sets the weighting factor between the old shared buffer average utilization and the current shared buffer instantaneous utilization when calculating the new shared buffer average utilization.

The TAF value applies to all high priority, low priority and non-tcp packets WRED slopes for egress access and network buffer pools controlled by the slope policy.

The no form of this command reverts the default setting.

Default 

7

Parameters 
value —
Specifies the TAF, expressed as a decimal integer. The value specified for TAF affects the speed at which the shared buffer average utilization tracks the instantaneous shared buffer utilization. A low value weights the new shared buffer average utilization calculation more to the shared buffer instantaneous utilization, zero using it exclusively. A high value weights the new shared buffer average utilization calculation more to the previous shared buffer average utilization value.
Values—
0 to 15

 

11.8.2.3. 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>non-tcp-slope (supported only on 7210 SAS-D devices)
Supported Platforms 

7210 SAS-D, 7210 SAS-Dxp

Description 

This command configures the low priority or high priority or non-tcp 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 value 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 startavg. 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>non-tcp-slope (supported only on 7210 SAS-D devices)
Supported Platforms 

7210 SAS-D, 7210 SAS-Dxp

Description 

This command sets 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. 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 setting.

Default 

max-prob 75

Parameters 
percent—
Specifies the maximum drop probability percentage corresponding to the max-avg, expressed as a decimal integer.
Values—
0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 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
Supported Platforms 

7210 SAS-D, 7210 SAS-Dxp

Description 

This command enables or disables the administrative status of the RED 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>non-tcp-slope (supported only on 7210 SAS-D)
Supported Platforms 

Supported on all 7210 SAS platforms as described in this document

Description 

This command sets 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. 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.

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

 

11.8.2.4. WRED command for 7210 SAS-D

use-wred-slopes

Syntax 
use-wred-slopes slope-type
no use-wred-slopes
Context 
config>system>qos
Supported Platforms 

7210 SAS-D

Description 

This command provides the user with the option to use 2 WRED slopes per queue or use 3 WRED slopes per queue. It is a global option which affects all the queues in the system. In other words, user can choose to use either 2 WRED slopes for all queues in the system or 3 WRED slopes for all queues in the system.

Using 3 WRED slopes per queue allows differentiating tcp in-profile traffic, tcp out-of-profile traffic, and non-tcp traffic. For non-tcp traffic both in and out profile use the same slope.

Using 2 WRED slopes per queue allows differentiating in-profile and out-of-profile traffic, without further differentiation of tcp and non-tcp traffic. All traffic, irrespective of tcp or non-tcp traffic, uses either in-profile slope or out-of-profile slope, depending on the profile assigned to the traffic by the ingress meters.

Note:

See Table 46 for information about the mapping of traffic types to use high-slope, low-slope, and non-TCP-slope parameters on 7210 SAS-D.

The no form of this command enables the use of 3 WRED slopes per queue.

Default 

use-wred-slopes tcp-non-tcp to maintain backward compatibility.

Parameters 
slope-type—
Specifies the slope policy type.
Values—
High and Low slope type: When high-low is set, two slopes are used per queue. High priority/In-profile slope for all packets that are classified as in-profile by the ingress meter and Low priority/out-of-profile slope for all packets that are classified as out-of-profile by the ingress meter. The high-priority/in-profile WRED slope uses the values configured under config>qos>slope-policy>high-slope. The low-priority/out-of-profile WRED slope uses the values configured under config>qos>slope-policy>low-slope. The values configured under non-TCP WRED slope is ignored by the system.
TCP and Non-TXP slope type: The non-TCP WRED slope is used for all packets classified as non-TCP packets on ingress, irrespective of the packet's profile or priority. Packets classified as TCP and determined to be high-priority/in-profile by the ingress meter, uses the high priority TCP WRED slope. This slope uses the values configured under config>qos>slope-policy>high-slope. Packets classified as TCP and determined to be low-priority/out-of-profile by the ingress meter, uses the low-priority TCP WRED slope. The low-priority/out-of-profile TCP WRED slope uses the values configured under config>qos>slope-policy>low-slope. The non-TCP WRED slope uses the values configured under config>qos>slope-policy>non-tcp-slope.

 

11.8.3. Show Commands

11.8.3.1. 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 outputs are examples of QoS slope policy information, and the associated tables describe the output fields.

Sample Output
*A:>config# show qos slope-policy 1   
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : 1                                                             
-------------------------------------------------------------------------------
Utilization                   State       Start-Threshold
-------------------------------------------------------------------------------
High-Slope                    Down              75%
Low-Slope                     Down              50% 
-------------------------------------------------------------------------------
Queue                   High Slope Drop Rate(%)       Low Slope Drop Rate(%)
-------------------------------------------------------------------------------
Queue 1                        6.250000               100.000000
Queue 2                        6.250000               100.000000
Queue 3                        6.250000               100.000000
Queue 4                        6.250000               100.000000
Queue 5                        6.250000               100.000000
Queue 6                        6.250000               100.000000
Queue 7                        6.250000               100.000000
Queue 8                        6.250000               100.000000
===============================================================================
*A:>config#                           
*A:>config# show qos slope-policy 1 detail 
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : 1                                                             
-------------------------------------------------------------------------------
Utilization                   State       Start-Threshold
-------------------------------------------------------------------------------
High-Slope                    Down              75%
Low-Slope                     Down              50%
-------------------------------------------------------------------------------
Queue                   High Slope Drop Rate(%)       Low Slope Drop Rate(%)
-------------------------------------------------------------------------------
Queue 1                        6.250000               100.000000
Queue 2                        6.250000               100.000000
Queue 3                        6.250000               100.000000
Queue 4                        6.250000               100.000000
Queue 5                        6.250000               100.000000
Queue 6                        6.250000               100.000000
Queue 7                        6.250000               100.000000
Queue 8                        6.250000               100.000000
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Object Type Object Id     Application          Pool
-------------------------------------------------------------------------------
Port        1/1/1         Acc-Egr              default                         
===============================================================================
*A:>config# 
Table 50:  Output Fields: 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.

Sample Output: Detailed (7210 SAS-D)
*A:SAS-D>show>qos# slope-policy abc detail
===============================================================================
QoS Slope Policy
===============================================================================
Policy         : abc
Description    : (Not Specified)
-------------------------------------------------------------------------------
High Slope
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            70           90            75
Queue2          Down            70           90            75
Queue3          Down            70           90            75
Queue4          Down            70           90            75
Queue5          Down            70           90            75
Queue6          Down            70           90            75
Queue7          Down            70           90            75
Queue8          Down            70           90            75
-------------------------------------------------------------------------------
Low Slope
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            75
Queue2          Down            50           75            75
Queue3          Down            50           75            75
Queue4          Down            50           75            75
Queue5          Down            50           75            75
Queue6          Down            50           75            75
Queue7          Down            50           75            75
Queue8          Down            50           75            75
-------------------------------------------------------------------------------
Non Tcp Slope
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
QueueId        State      Start-Avg(%)   Max-Avg(%)   Max-Prob(%)
-------------------------------------------------------------------------------
Queue1          Down            50           75            75
Queue2          Down            50           75            75
Queue3          Down            50           75            75
Queue4          Down            50           75            75
Queue5          Down            50           75            75
Queue6          Down            50           75            75
Queue7          Down            50           75            75
Queue8          Down            50           75            75
-------------------------------------------------------------------------------
Time Avg Factor
-------------------------------------------------------------------------------
-------------------------------------------------------------------------------
Queue Id   Time Avg Factor
-------------------------------------------------------------------------------
Queue1            7
Queue2            7
Queue3            7
Queue4            7
Queue5            7
Queue6            7
Queue7            7
Queue8            7
 
-------------------------------------------------------------------------------
Associations
-------------------------------------------------------------------------------
Object Type Object Id     Application          Pool
-------------------------------------------------------------------------------
No Matching Entries
 
*A:SAS-D>show>qos#
 
*A:SAH01-051>show>qos# slope-policy 32 detail
 
===============================================================================
QoS Slope Policy
===============================================================================
===============================================================================
*A:SAH01-051>show>qos#
*A:SAH01-051>show>qos# slope-policy 32 detail
 
===============================================================================
QoS Slope Policy
===============================================================================
===============================================================================
Table 51:  Output Fields: Slope Policy Detail 

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.