Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

Navigation
Guide That Contains This Content
[+] Expand All
[-] Collapse All
     

    Related Documentation

     

    Example: Configuring a Physical Interface Policer for Aggregate Traffic at a Physical Interface

    This example shows how to configure a single-rate two-color policer as a physical interface policer.

    Requirements

    No special configuration beyond device initialization is required before configuring this example.

    Overview

    A physical interface policer specifies rate-limiting for aggregate traffic, which encompasses all protocol families and logical interfaces configured on a physical interface, even if the interfaces belong to different routing instances.

    You can apply a physical interface policer to Layer 3 input or output traffic only by referencing the policer from a stateless firewall filter that is configured for specific a specific protocol family (not for family any) and configured as a physical interface filter. You configure the filter terms with match conditions that select the types of packets you want to rate-limit, and you specify the physical interface policer as the action to apply to matched packets.

    Topology

    The physical interface policer in this example, shared-policer-A, rate-limits to 10,000,000 bps and permits a maximum burst of traffic of 500,000 bytes. You configure the policer to discard packets in nonconforming flows, but you could instead configure the policer to re-mark nonconforming traffic with a forwarding class, a packet loss priority (PLP) level, or both.

    To be able to use the policer to rate-limit IPv4 traffic, you reference the policer from an IPv4 physical interface filter. For this example, you configure the filter to pass the policer IPv4 packets that meet either of the following match terms:

    • Packets received through TCP and with the IP precedence fields critical-ecp (0xa0), immediate (0x40), or priority (0x20)
    • Packets received through TCP and with the IP precedence fields internet-control (0xc0) or routine (0x00)

    You could also reference the policer from physical interface filters for other protocol families.

    Configuration

    The following example requires you to navigate various levels in the configuration hierarchy. For information about navigating the CLI, see Using the CLI Editor in Configuration Mode.

    To configure this example, perform the following tasks:

    CLI Quick Configuration

    To quickly configure this example, copy the following configuration commands into a text file, remove any line breaks, and then paste the commands into the CLI at the [edit] hierarchy level.

    set interfaces so-1/0/0 unit 0 family inet address 192.168.1.1/24set interfaces so-1/0/0 unit 0 family vplsset interfaces so-1/0/0 unit 1 family mplsset firewall policer shared-policer-A physical-interface-policerset firewall policer shared-policer-A if-exceeding bandwidth-limit 100m burst-size-limit 500kset firewall policer shared-policer-A then discardset firewall family inet filter ipv4-filter physical-interface-filterset firewall family inet filter ipv4-filter term tcp-police-1 from precedence [ critical-ecp immediate priority ]set firewall family inet filter ipv4-filter term tcp-police-1 from protocol tcpset firewall family inet filter ipv4-filter term tcp-police-1 then policer shared-policer-Aset firewall family inet filter ipv4-filter term tcp-police-2 from precedence [ internet-control routine ]set firewall family inet filter ipv4-filter term tcp-police-2 from protocol tcpset firewall family inet filter ipv4-filter term tcp-police-2 then policer shared-policer-Aset interfaces so-1/0/0 unit 0 family inet filter input ipv4-filter

    Configuring the Logical Interfaces on the Physical Interface

    Step-by-Step Procedure

    To configure the logical interfaces on the physical interface:

    1. Enable configuration of logical interfaces.

      [edit]user@host# edit interfaces so-1/0/0
    2. Configure protocol families on logical unit 0.

      [edit interfaces so-1/0/0]user@host# set unit 0 family inet address 192.168.1.1/24user@host# set unit 0 family vpls
    3. Configure protocol families on logical unit 1.

      [edit interfaces so-1/0/0]user@host# set unit 1 family mpls

    Results

    Confirm the configuration of the firewall filter by entering the show interfaces configuration mode command. If the command output does not display the intended configuration, repeat the instructions in this procedure to correct the configuration.

    [edit]user@host# show interfacesso-1/0/0 {unit 0 {family inet {address 192.168.1.1/24;}family vpls;}unit 1 {family mpls;}}

    Configuring a Physical Interface Policer

    Step-by-Step Procedure

    To configure a physical interface policer:

    1. Enable configuration of the two-color policer.

      [edit]user@host# edit firewall policer shared-policer-A
    2. Configure the type of two-color policer.

      [edit firewall policer shared-policer-A]user@host# set physical-interface-policer
    3. Configure the traffic limits and the action for packets in a nonconforming traffic flow.

      [edit firewall policer shared-policer-A]user@host# set if-exceeding bandwidth-limit 100m burst-size-limit 500kuser@host# set then discard
      For a physical interface filter, the actions you can configure for packets in a nonconforming traffic flow are to discard the packets, assign a forwarding class, assign a PLP value, or assign both a forwarding class and a PLP value.

    Results

    Confirm the configuration of the policer by entering the show firewall configuration mode command. If the command output does not display the intended configuration, repeat the instructions in this procedure to correct the configuration.

    [edit]user@host# show firewallpolicer shared-policer-A {physical-interface-policer;if-exceeding {bandwidth-limit 100m;burst-size-limit 500k;}then discard;}

    Configuring an IPv4 Physical Interface Filter

    Step-by-Step Procedure

    To configure a physical interface policer as the action for terms in an IPv4 physical interface policer:

    1. Configure a standard stateless firewall filter under a specific protocol family.

      [edit]user@host# edit firewall family inet filter ipv4-filter
      You cannot configure a physical interface firewall filter for family any.
    2. Configure the filter as a physical interface filter so that you can apply the physical interface policer as an action.

      [edit firewall family inet filter ipv4-filter]user@host# set physical-interface-filter
    3. Configure the first term to match IPv4 packets received through TCP with the IP precedence fields critical-ecp, immediate, or priority and to apply the physical interface policer as a filter action.

      [edit firewall family inet filter ipv4-filter]user@host# set term tcp-police-1 from precedence [ critical-ecp immediate priority ]user@host# set term tcp-police-1 from protocol tcpuser@host# set term tcp-police-1 then policer shared-policer-A
    4. Configure the first term to match IPv4 packets received through TCP with the IP precedence fields internet-control or routine and to apply the physical interface policer as a filter action.

      [edit firewall family inet filter ipv4-filter]user@host# set term tcp-police-2 from precedence [ internet-control routine ]user@host# set term tcp-police-2 from protocol tcpuser@host# set term tcp-police-2 then policer shared-policer-A

    Results

    Confirm the configuration of the firewall filter by entering the show firewall configuration mode command. If the command output does not display the intended configuration, repeat the instructions in this procedure to correct the configuration.

    [edit]user@host# show firewallfamily inet {filter ipv4-filter {physical-interface-filter;term tcp-police-1 {from {precedence [ critical-ecp immediate priority ];protocol tcp;}then policer shared-policer-A;}term tcp-police-2 {from {precedence [ internet-control routine ];protocol tcp;}then policer shared-policer-A;}}}policer shared-policer-A {physical-interface-policer;if-exceeding {bandwidth-limit 100m;burst-size-limit 500k;}then discard;}

    Applying the IPv4 Physical interface Filter to a Physical Interface

    Step-by-Step Procedure

    To apply the physical interface filter to a physical interface:

    1. Enable configuration of IPv4 on the logical interface.

      [edit]user@host# edit interfaces so-1/0/0 unit 0 family inet
    2. Apply the IPv4 physical interface filter in the input direction.

      [edit interfaces so-1/0/0 unit 0 family inet]user@host# set filter input ipv4-filter

    Results

    Confirm the configuration of the firewall filter by entering the show interfaces configuration mode command. If the command output does not display the intended configuration, repeat the instructions in this procedure to correct the configuration.

    [edit]user@host# show interfacesso-1/0/0 {unit 0 {family inet {filter {input ipv4-filter;}address 192.168.1.1/24;}family vpls;}unit 1 {family mpls;}}

    If you are done configuring the device, enter commit from configuration mode.

    Verification

    Confirm that the configuration is working properly.

    Displaying the Firewall Filters Applied to an Interface

    Purpose

    Verify that the firewall filter ipv4-filter is applied to the IPv4 input traffic at logical interface so-1/0/0.0.

    Action

    Use the show interfaces statistics operational mode command for logical interface so-1/0/0.0, and include the detail option. In the Protocol inet section of the command output, the Input Filters field shows that the firewall filter ipv4-filter is applied in the input direction.

    user@host> show interfaces statistics so-1/0/0 detail
      Logical interface so-1/0/0.0 (Index 79) (SNMP ifIndex 510) (Generation 149)
        Flags: Hardware-Down Point-To-Point SNMP-Traps 0x4000 Encapsulation: PPP
        Protocol inet, MTU: 4470, Generation: 173, Route table: 0
          Flags: Sendbcast-pkt-to-re, Protocol-Down
          Input Filters: ipv4-filter
          Addresses, Flags: Dest-route-down Is-Preferred Is-Primary
            Destination: 10.39/16, Local: 10.39.1.1, Broadcast: 10.39.255.255, Generation: 163
    

    Displaying the Number of Packets Processed by the Policer at the Logical Interface

    Purpose

    Verify the traffic flow through the logical interface and that the policer is evaluated when packets are received on the logical interface.

    Action

    Use the show firewall operational mode command for the filter you applied to the logical interface.

    user@host> show firewall filter ipv4-filter
    Filter: ipv4-filter                                          
    Policers:
    Name                                              Packets 
    shared-policer-A-tcp-police-1                       32863
    shared-policer-A-tcp-police-2                        3870
    

    The command output displays the name of policer (shared-policer-A), the name of the filter term (police-1) under which the policer action is specified, and the number of packets that matched the filter term. This is only the number of out-of-specification (out-of-spec) packet counts, not all packets policed by the policer.

     

    Related Documentation

     

    Published: 2012-11-16