shaping-rate (Limiting Excess Bandwidth Usage)

Syntax

Hierarchy Level

Release Information

Statement introduced before Junos OS Release 7.4.

The burst-size option added for Trio MPC/MIC modules in Junos OS Release 11.4.

Description

Define a limit on excess bandwidth usage for J Series routers and Trio MPC/MIC interfaces on MX Series routers.

The transmit-rate statement at the [edit class-of-service schedulers scheduler-name] hierarchy level configures the minimum bandwidth allocated to a queue. The transmission bandwidth can be configured as an exact value or allowed to exceed the configured rate if additional bandwidth is available from other queues. For J Series routers only, you limit the excess bandwidth usage with this statement.

You should configure the shaping rate as an absolute maximum usage and not the additional usage beyond the configured transmit rate.

Default

If you do not include this statement, the default shaping rate is 100 percent, which is the same as no shaping at all.

Options

percent percentage—Shaping rate as a percentage of the available interface bandwidth.

rate—Peak rate, in bits per second (bps). You can specify a value in bits per second either as a complete decimal number or as a decimal number followed by the abbreviation k (1000), m (1,000,000), or g (1,000,000,000).

burst-size bytes—Maximum burst size, in bytes. The burst value determines the number of rate credits that can accrue when the queue or scheduler node is held in the inactive round robin.

Required Privilege Level

interface—To view this statement in the configuration.

interface-control—To add this statement to the configuration.