4. Port level egress rate-limiting

This chapter provides information to configure the port level egress-rate command using the CLI.

4.1. Overview

Egress port rate limiting allows the device to limit the traffic that egresses through a port to a value less than the available link bandwidth.

4.1.1. Applications

This feature is useful when connecting the 7210 SAS to an Ethernet-over-SDH (EoSDH) (or microwave) network, where the network allocates predetermined bandwidth to the nodes connecting into it, based on the transport bandwidth requirement. When connecting to such a network, it is important that the traffic sent into the SDH node does not exceed the configured values, because the SDH network does not have the QoS capabilities and buffers required to prioritize the ingress traffic.

Egress rate attributes include the following:

  1. Allows for per port configuration of the maximum egress port rate, using the egress-rate CLI command.
  2. Ethernet ports configured as access and access uplink support this feature.
  3. The port scheduler distributes the available maximum egress bandwidth based on the CIR/PIR configuration parameters provisioned for the queues.
  4. The 7210 SAS-D and 7210 SAS-Dxp provide support for a burst parameter to control the amount of burst the egress port can generate.
  5. When ports are members of a LAG, all the ports use the same value for the egress-rate and the max-burst parameters.
  6. If frame overhead accounting (also known as Frame-based accounting) is enabled, the queue scheduler accounts for the Ethernet frame overhead.

4.1.2. Effect of port-level rate-limiting on queue functionality

When an egress-rate sub-rate value is provided, the access-uplink port egress queue rates that are specified using percentages use the egress-rate value instead of the port bandwidth (if egress rate is less than port bandwidth) to configure the queue rates. Configuring the egress port rate to different values results in a corresponding dynamic adjustment of rates for the egress queues configured on the access-uplink ports.

When the egress-rate sub-rate value is set, the CBS and MBS of the associated network queues do not change.

4.2. Basic configurations

For port-level rate limiting, the following considerations apply:

  1. The egress-rate command is in the config>port>ethernet context.
  2. The egress-rate command configures the maximum rate (in kb/s).
  3. For 7210 SAS-D devices, the max-burst command configures a maximum burst (in kilobits) associated with the egress-rate. This parameter is optional and if it is not defined, by default it is set to 32 kb for a 1G port. Users cannot configure max-burst without configuring egress-rate. The value should be between 32 and 16384 or default.
  4. For 7210 SAS-Dxp devices, the max-burst command configures a maximum-burst (in kilobits) associated with the egress-rate. This parameter is optional and if it is not defined, by default it is set to 65 kb for a 1G port and 98 kb for a 10G port. Users cannot configure max-burst without configuring egress-rate. The value should be between 32 and 16384 or default.
  5. By default the egress-rate command is not set on the port. The default egress-rate value for a port is the maximum (which is equal to the line rate).

The following sample configuration output shows the egress-rate configuration for a port.

*A:Dut-1>config>port# info 
----------------------------------------------
        ethernet
            egress-rate 120000 max-burst 234
        exit
        no shutdown
----------------------------------------------
*A:Dut-1>config>port#

4.2.1. Modifying port level egress-rate command

To modify egress-rate parameters, apply an egress-rate command with new egress-rate and max-burst values.

The following sample configuration shows a modified egress-rate configuration for a port.

*A:Dut-1>config>port# ethernet egress-rate 10000 max-burst default 
*A:Dut-1>config>port# info 
----------------------------------------------
        ethernet
            egress-rate 10000
        exit
        no shutdown
----------------------------------------------
*A:Dut-1>config>port#

4.2.2. Removing port level egress-rate command

To remove the egress-rate command from a port, use the no option with the egress-rate command. Do not include the rate for the egress-rate and max-burst options.

Use the following syntax to remove the egress-rate command from a port.

CLI Syntax:
config>port>ethernet# no egress-rate

The following sample configuration output shows the removal of the egress-rate configuration from a port.

*A:Dut-1>config>port# no ethernet egress-rate
*A:Dut-1>config>port# info 
----------------------------------------------
        ethernet
        exit
        no shutdown
----------------------------------------------
*A:Dut-1>config>port#

4.2.2.1. Default egress-rate values

By default no egress-rate is configured for a port. For more information on the CLI and description, see Port level egress-rate command reference.