N-Series v7.x does not support the classic Ratelimit command set

  • 0
  • 1
  • Article
  • Updated 5 years ago
  • (Edited)
Article ID: 13816 

Products
Matrix N-Series DFE, firmware 7.11.01.0025 and higher 

Changes
While running firmware 6.12.08.0003 or lower, configured rate-limiting using the 'set port ratelimit...' command set (7345).
Then, upgraded to firmware 7.11.01.0025 or higher. 

Symptoms
Even when using the recommended 6.x-to-7.x transition procedure as explained in 13533, the 7.x configuration load process drops any 'set port ratelimit...' commands after displaying an "unsupported command" error message for each. 

Cause
The legacy 'set|clear|show port ratelimit...' command set has been intentionally removed from 7.x firmware versions, so no longer exists. 

Solution/Workaround
Functions as Designed (FAD). 

Workaround:
Use the Class of Service command set, instead. 

For example, assume the presence (in 6.x firmware) of this ratelimit configuration , which limits both ingress and egress traffic of all priorities on port ge.1.5 to a maximum of 1250 Kilobytes per second (10000 Kilobits per second, 10 Megabits per second):
set port ratelimit enable
set port ratelimit ge.1.5 0-7 1250 enable inbound
set port ratelimit ge.1.5 0-7 1250 enable outbound
Starting with no policy or cos configuration, what follows is the generally equivalent (in 6.x and 7.x firmware) cos configuration to replace the inbound/outbound ratelimit command. The intent of these configurations is for all ports to behave as they previously did - except for the ports cited in the 'cos port-config' section. Traffic ingressed by those ports will also be Inbound Rate Limited and Outbound Rate Shaped. Rate Shaping is used instead of Rate Limiting so that any TCP traffic will not be subject to the issue outlined in 11667

The background for these very granular but somewhat complicated configurations will become clearer (especially when trying to apply them to variations of hardware and firmware which support fewer or greater features than are included here) if you first start with no cos configurations, then collect and review the output of a 'show config all cos' command.
For every native txq group/type 0.0, we are adding a group/type 1.0 which also does Outbound Rate Shaping.
For every native txq group/type 0.1, we are adding a group/type 1.1 which also does Outbound Rate Shaping.
For every native txq group/type 0.2, we are adding a group/type 1.2 which also does Outbound Rate Shaping.
For every native irl group/type 0.0, we are adding a group/type 1.0 which also does Inbound Rate Limiting.
For every native irl group/type 0.1, we are adding a group/type 1.1 which also does Inbound Rate Limiting. 

If your firmware does not include one or more of the above types, then you should not configure for it.
If your hardware does not include one or more of the above types, then you should not configure for it.
If your configured rate-limited port(s) does not include one or more of the above types, then you need not configure for it.
If the ingressing rate-limited traffic does not use all possible priorities 0-7, then you need not configure for it.
# cos state 
set cos state enable

# cos settings [map priorities to txq references and to a single irl reference]
# Only if including Inbound limiting, otherwise defaults will work fine.
set cos settings 0 txq-reference 0 irl-reference 0
set cos settings 1 txq-reference 2 irl-reference 0
set cos settings 2 txq-reference 4 irl-reference 0
set cos settings 3 txq-reference 6 irl-reference 0
set cos settings 4 txq-reference 8 irl-reference 0
set cos settings 5 txq-reference 10 irl-reference 0
set cos settings 6 txq-reference 12 irl-reference 0
set cos settings 7 txq-reference 14 irl-reference 0

# cos port-config [create new port groups to emulate default port groups plus provide value-added features]
# Only if including Outbound shaping, otherwise defaults will work fine.
# For any given port, two of these will error out on any given system.
set cos port-config txq 1.0 name "N-Series 16Q Ratelimit" ports ge.1.5 arb-slice 0,0,0,0,0,0,0,0,0,0,0,0,0,0,0,64
set cos port-config txq 1.1 name "N-Series 4Q Ratelimit" ports ge.1.5 arb-slice 0,0,0,32
set cos port-config txq 1.2 name "N-Series 11Q Ratelimit" ports ge.1.5 arb-slice ge.1.5 0,0,0,0,0,0,0,0,100,0,0
# Only if including Inbound limiting, otherwise defaults will work fine.
# For any given port, one of these will error out on any given system
set cos port-config irl 1.0 name "N-Series 32 IRL Ratelimit" ports ge.1.5
set cos port-config irl 1.1 name "N-Series 8 IRL Ratelimit" ports ge.1.5

# cos reference [map txq references to txq hardware, and map irl references to irl hardware]
# Only if including Outbound shaping, otherwise defaults will work fine.
set cos reference txq 1.0 0 queue 0
set cos reference txq 1.0 2 queue 2
set cos reference txq 1.0 4 queue 4
set cos reference txq 1.0 6 queue 6
set cos reference txq 1.0 8 queue 8
set cos reference txq 1.0 10 queue 8
set cos reference txq 1.0 12 queue 8
set cos reference txq 1.0 14 queue 9
set cos reference txq 1.1 0 queue 0
set cos reference txq 1.1 2 queue 2
set cos reference txq 1.1 4 queue 4
set cos reference txq 1.1 6 queue 6
set cos reference txq 1.1 8 queue 8
set cos reference txq 1.1 10 queue 10
set cos reference txq 1.1 12 queue 12
set cos reference txq 1.1 14 queue 13
set cos reference txq 1.2 0 queue 0
set cos reference txq 1.2 2 queue 2
set cos reference txq 1.2 4 queue 4
set cos reference txq 1.2 6 queue 6
set cos reference txq 1.2 8 queue 8
set cos reference txq 1.2 10 queue 8
set cos reference txq 1.2 12 queue 8
set cos reference txq 1.2 14 queue 9
# Only if including Inbound limiting, otherwise defaults will work fine.
set cos reference irl 1.0 0 rate-limit 0
set cos reference irl 1.1 0 rate-limit 0

# cos port-resource [provide txq hardware function, and provide irl hardware function]
# Only if including Outbound shaping, otherwise defaults will work fine.
set cos port-resource txq 1.0 0 rate 10 unit mbps
set cos port-resource txq 1.0 2 rate 10 unit mbps
set cos port-resource txq 1.0 4 rate 10 unit mbps
set cos port-resource txq 1.0 6 rate 10 unit mbps
set cos port-resource txq 1.0 8 rate 10 unit mbps
set cos port-resource txq 1.0 9 rate 10 unit mbps
set cos port-resource txq 1.1 0 rate 10 unit mbps
set cos port-resource txq 1.1 2 rate 10 unit mbps
set cos port-resource txq 1.1 4 rate 10 unit mbps
set cos port-resource txq 1.1 6 rate 10 unit mbps
set cos port-resource txq 1.1 8 rate 10 unit mbps
set cos port-resource txq 1.1 10 rate 10 unit mbps
set cos port-resource txq 1.1 12 rate 10 unit mbps
set cos port-resource txq 1.1 13 rate 10 unit mbps
# Only if including Inbound limiting, otherwise defaults will work fine.
set cos port-resource irl 1.0 0 rate 10 unit mbps type drop
set cos port-resource irl 1.1 0 rate 10 unit mbps type drop
If you need further assistance in developing an equivalent rate-limiting configuration in the absence of NetSight Policy Manager (the recommended method of configuring Policy and Class of Service), please contact the GTAC.
Photo of FAQ User

FAQ User, Official Rep

  • 13,610 Points 10k badge 2x thumb

Posted 5 years ago

  • 0
  • 1

There are no replies.

This conversation is no longer open for comments or replies.