Technical Documentation

shaping-rate (Applying to an Interface)

Syntax

shaping-rate rate;

Hierarchy Level

[edit class-of-service interfaces interface-name],[edit class-of-service interfaces interface-name unit logical-unit-number]

Release Information

Statement introduced before JUNOS Release 7.4.

[edit class-of-service interfaces interface interface-name] hierarchy level added in JUNOS Release 7.5.

Description

For logical interfaces on which you configure packet scheduling, configure traffic shaping by specifying the amount of bandwidth to be allocated to the logical interface.

For physical interfaces on IQ PICs, configure traffic shaping based on the rate-limited bandwidth of the total interface bandwidth.

Note: The shaping-rate statement cannot be applied to a physical interface on J Series routers.

Logical and physical interface traffic shaping is mutually exclusive. This means you can include the shaping-rate statement at the [edit class-of-service interfaces interface interface-name] hierarchy level or the [edit class-of-service interfaces interface interface-name unit logical-unit-number] hierarchy level, but not both.

Note: For MX Series routers, the shaping rate value for the physical interface at the [edit class-of-service interfaces interface-name] hierarchy level must be a minimum of 160 Kbps. If the value is less than the sum of the logical interface guaranteed rates, the user is not allowed to apply the shaping rate to a physical interface.

Alternatively, you can configure a shaping rate for a logical interface and oversubscribe the physical interface by including the shaping-rate statement at the [edit class-of-service traffic-control-profiles] hierarchy level. With this configuration approach, you can independently control the delay-buffer rate, as described in Oversubscribing Interface Bandwidth.

For FRF.16 bundles on link services interfaces, only shaping rates based on percentage are supported.

Default

If you do not include this statement at the [edit class-of-service interfaces interface interface-name unit logical-unit-number] hierarchy level, the default logical interface bandwidth is the average of unused bandwidth for the number of logical interfaces that require default bandwidth treatment. If you do not include this statement at the [edit class-of-service interfaces interface interface-name] hierarchy level, the default physical interface bandwidth is the average of unused bandwidth for the number of physical interfaces that require default bandwidth treatment.

Options

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).

Range: For logical interfaces, 1000 through 32,000,000,000 bps.

For physical interfaces, 1000 through 160,000,000,000 bps.

Usage Guidelines

See Applying Scheduler Maps Overview.

Required Privilege Level

interface—To view this statement in the configuration.

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


Published: 2010-04-14