Configures an ACL meter to provide ingress traffic rate shaping on BlackDiamond X8 series switches, BlackDiamond 8800 series switches, E4G-200 and E4G-400 switches, SummitStack, and Summit family switches. On BlackDiamond c-, xl-, and xm-series modules, you can use this command to configure meters for ingress and egress rate limiting.
|
By default, a newly committed meter has no maximum burst size, no committed rate, and a default action of drop.
The meter configured with this command is associated with an ACL rule by specifying the meter name using the meter action modifier within the rule.
The committed-rate keyword specifies the traffic rate allowed for this meter, and the configured rate operates as described in Rate Configuration Notes. The rate you specify is rounded up to the next granularity increment value. For example, if you configure a 1 Mbps committed rate for a platform with a 64Kbps granularity increment, this value falls between the increment values of 960 Kbps and 1024 Kbps, so the effective committed rate is set to 1024 Kbps. Also, note that some platforms listed below require an adjustment to the expected rate to calculate the configured rate.
Platform | Granularity | Notes |
---|---|---|
BlackDiamond X8 series switches, BlackDiamond 8000 c-, e-, xl-, and xm-series modules, E4G-200 and E4G-400 switches, and Summit family switches | 64Kbps |
Specify the traffic rate in Kbps, Mbps, or Gbps. The range is 64Kbps to 1 Gbps for GE ports and 1Mbps to 10 Gbps for 10GE ports. Add 20 bytes per frame to the expected rate to determine the configured rate. |
The max-burst-size keyword specifies the maximum number of consecutive bits that are allowed to be in-profile at wire-speed. The max-burst-size parameter can be specified in Kb, Mb, or Gb. The specified max-burst-size is rounded down to the nearest supported size. The max-burst-size range on BlackDiamond X8 series switches, BlackDiamond 8000 series switches, E4G-200 and E4G-400 switches, and Summit switches is 32Kb to 128Mb.
The keyword out-actions specifies the action that is taken when a packet is out-of-profile. The supported actions include dropping the packet, marking the drop precedence for the packet, or setting the DSCP value in the packet. The keyword drop indicates that any out-of-profile packet is immediately dropped. The keyword set-drop-precedence marks out-of-profile packets with high drop precedence. If the optional keyword set-dscp is specified, the DSCP value, as specified by the parameter dscp-value, is written into the out-of-profile packet. Setting the DSCP value to none leaves the DSCP value in the packet unchanged.
The following example configures the ACL meter maximum_bandwidth, assigns it a rate of 10 Mbps, and sets the out of profile action to drop:
configure meter maximum_bandwidth committed-rate 10 Mbps out-action drop
The following example uses the port_groups variable:
configure meter ingmeter0 committed-rate 50 Mbps out-actions drop log disable-port ports GroupA configure meter ingmeter1 committed-rate 75 Mbps out-actions drop log disable-port ports GroupA configure meter ingmeter0 committed-rate 100 Pps out-actions drop log disable-port ports GroupB configure meter ingmeter1 committed-rate 150 Pps out-actions drop log disable-port ports GroupB
This command was available in ExtremeXOS 11.1.
The log, trap and ports keywords and port-group and port_list variables were added in ExtremeXOS 16.1
This command is available on all platforms.