DPDK

The DPDK test validates network interface controller compatibility with Data Plane Development Kit features as a Technology Preview.

The DPDK test validates network interface controller (NIC) compatibility with Data Plane Development Kit (DPDK). It tests driver binding, bidirectional packet I/O, and throughput performance. You can run the DPDK test to certify that your NIC works correctly with DPDK for high-performance userspace packet processing.

What the test covers

This test supports the x86_64 and aarch64 architectures. The test performs the following tasks:

  • Certifies standalone DPDK NICs directly
  • Validates that the NIC can bind and unbind cleanly to vfio-pci
  • Verifies that the DPDK Environment Abstraction Layer (EAL) detects the NIC
  • Receives and transmits packets through DPDK
  • Forwards packets and meets throughput targets through DPDK
RHEL version supported
  • RHEL 9
  • RHEL 10
What the test does

The test runs in two phases:

  • Hardware discovery - Uses the lspci command to find Ethernet controllers vendors known to support DPDK.
  • Certification testing - Runs software prerequisite checks, peer validation, and hardware certification. Hardware testing includes NIC binding to vfio-pci, userspace packet forwarding validation, and throughput performance measurement. The test compares the throughput against the IEEE 802.3 wire-rate reference. The test requires a minimum of 50% of the reference throughput to pass.
Preparing for the test

Before you begin testing, you must enable the Fast Datapath repository. You must also install the certification test suite to access the DPDK test. You must configure both the host under test and a bare-metal peer server. Ensure that you meet the following prerequisites:

  • Enable Fast Datapath repository, for example:
    # subscription-manager repos --enable=fast-datapath-for-rhel-9-$(uname -m)-rpms
  • Install the certification framework and the fast-datapath test suite:
    # dnf install -y redhat-certification-fast-datapath
  • Identify the DPDK-capable NIC. Do not test the management network interface.
  • Enable IOMMU (Intel VT-d, AMD-Vi, or ARM SMMU) in the system firmware and kernel parameters.
  • Configure at least 1 GB of hugepages.
  • Set up a peer server with a DPDK-capable NIC, IOMMU, hugepages, vfio-pci, and root SSH access.
Running the test

The test requires a peer server to generate traffic.

  • Run the following command to plan the test:
    # rhcert-cli plan --preview
  • Run the following command to run the test:
    # rhcert-cli run --test dpdk --server-ip <peer_ip> --preview

    To run the test for a specific NIC, use the --device <pci_address> command-line argument. The test automatically manages the peer server by using SSH and performs the following actions:

    • Loads vfio-pci
    • Starts dpdk-testpmd
    • Measures throughput
    • Restores the original driver when the test completes