90. L3 forwarding test in LPM mode with IPV4 packets

This document provides the plan for testing the performance of Intel Ethernet Controller. The Layer-3 Forwarding performance results are produced using l3fwd application. For detail test plan, please refer to l3fwd_test_plan.rst.

90.1. Prerequisites

90.1.1. Topology

It requires at least 1 port connected traffic generator::
Port0 — TG0
2 ports::
Port0 — TG0 Port1 — TG1
4 ports::
Port0 — TG0 Port1 — TG1 Port2 — TG2 Port3 — TG3

90.1.2. Hardware

This suite focus on l3fwd application, so any standard Ethernet Network Adapter is qualified.

90.1.3. Software

dpdk: git clone http://dpdk.org/git/dpdk trex: git clone http://trex-tgn.cisco.com/trex/release/v2.93.tar.gz

90.2. Test Case

The test case check the throughput result with lpm mode and ipv4, in the case, we will send the bi-direction flows with line rate, then we can check the passthrough rate.

The l3fwd application has a number of command line options, here list the key options will be tested:

./dpdk-l3fwd [EAL options] -- -p PORTMASK
                         [--rx-queue-size NPKTS]
                         [--tx-queue-size NPKTS]
    --force-max-simd-bitwidth: This setting is used to determine the vector path for component selection.
                               And the default is avx2.
    --rx-queue-size: Rx queue size in decimal and default is 1024.
    --tx-queue-size: Tx queue size in decimal and default is 1024.
    --parse-ptype: Optional, set to use software to analyze packet type.
                   Without this option, hardware will check the packet type.
    [-L]|[-E]: L3fwd uses the parameters "-L" and "-E" to correspond to LPM and EM modes respectively.
               And the default is LPM mode.

90.2.1. Common Steps

  1. Bind tested ports to vfio-pci:

    <dpdk_dir>#./usertools/dpdk-devbind.py -s
    0000:17:00.0 'Device 1592' if=ens5f0 drv=ice unused=vfio-pci
    <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci <pci device id>
    <dpdk_dir>#./usertools/dpdk-devbind.py -b vfio-pci 0000:17:00.0
  2. Configure traffic generator to send traffic

    Routing table for IPv4 packets
    • In LPM mode, the LPM table used for packet routing is:
    # LPM prefix (IP/length)
    The flows need to be configured and started by the traffic generator:
    • IPv4 packets
    Flow Traffic Gen. Port IPv4 Dst. Address IPv4 Src. Address
    1 TG0 Any Ip
    2 TG1 Any Ip
    3 TG2 Any Ip
    4 TG3 Any Ip

    Set the packet length : 64 bytes-1518 bytes The IPV4 Src Address increase with the num 1024.

  3. Test result table

    Fwd_core Frame Size Throughput Rate
    1C/1T 64 xxxxx Mpps xxx %
    1C/1T ... xxxxx Mpps xxx %
    2C/2T 64 xxxxx Mpps xxx %
    2C/2T ... xxxxx Mpps xxx %
    4C/4T 64 xxxxx Mpps xxx %
    4C/4T ... xxxxx Mpps xxx %
    8C/8T 64 xxxxx Mpps xxx %
    8C/8T ... xxxxx Mpps xxx %

90.2.2. Test Case: test_perf_throughput_ipv4_lpm

  1. Bind PF ports to dpdk driver as common step 1.

  2. Launch l3fwd:

    <build_dir>/examples/dpdk-l3fwd -l 5-8 -n 8 --force-max-simd-bitwidth=512 \
    -- -p 0x1 --config "(0,0,5),(0,1,6),(0,2,7),(0,3,8)" --rx-queue-size 1024 \
    --tx-queue-size 1024
  3. Configure traffic generator to send traffic as common step 2.

  4. Record Test results as common step 3.