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_64andaarch64architectures. 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
lspcicommand 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,userspacepacket 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.
- Hardware discovery - Uses the
- 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-datapathtest 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.
- Enable Fast Datapath repository, for example:
- 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> --previewTo 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
- Loads
- Run the following command to plan the test: