diff options
author | Dave Wallace <dwallacelf@gmail.com> | 2021-06-28 17:36:30 -0400 |
---|---|---|
committer | Tibor Frank <tifrank@cisco.com> | 2021-07-13 04:48:46 +0000 |
commit | e930951711d81caf4c5efa9d2eafe44d0a044227 (patch) | |
tree | cbb8d919964b9d21121c395432e17d782757d57c /docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst | |
parent | 72d9b91a6be3f0fbb39ddbfe3c6059b2cec62f41 (diff) |
Hoststack report content
- Methodology section
- Align dynamic content structure with methodology section
Signed-off-by: Dave Wallace <dwallacelf@gmail.com>
Change-Id: I852c0f8147947dd8418de5fc2fdbd16a1c1e2057
(cherry picked from commit c77930b44bd1a35786a4b843bb75a9cbc8741b4b)
Diffstat (limited to 'docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst')
-rw-r--r-- | docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst | 42 |
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst b/docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst new file mode 100644 index 0000000000..b0525f989f --- /dev/null +++ b/docs/report/introduction/methodology_hoststack_testing/methodology_udp_with_iperf3.rst @@ -0,0 +1,42 @@ +UDP/IP with iperf3 +^^^^^^^^^^^^^^^^^^ + +`iperf3 goodput measurement tool <https://github.com/esnet/iperf>`_ +is used for measuring the maximum attainable goodput of the VPP Host +Stack connection across two instances of VPP running on separate DUT +nodes. iperf3 is a popular open source tool for active measurements +of the maximum achievable goodput on IP networks. + +Because iperf3 utilizes the POSIX socket interface APIs, the current +test configuration utilizes the LD_PRELOAD mechanism in the linux +kernel to connect iperf3 to the VPP Host Stack using the VPP +Communications Library (VCL) LD_PRELOAD library (libvcl_ldpreload.so). + +In the future, a forked version of iperf3 which has been modified to +directly use the VCL application APIs may be added to determine the +difference in performance of 'VCL Native' applications versus utilizing +LD_PRELOAD which inherently has more overhead and other limitations. + +The test configuration is as follows: + +:: + + DUT1 Network DUT2 + [ iperf3-client -> VPP1 ]=======[ VPP2 -> iperf3-server] + +where, + +1. iperf3 server attaches to VPP2 and LISTENs on VPP2:UDP port 5201. +2. iperf3 client attaches to VPP1 and transmits one or more streams + of packets to VPP2:UDP port 5201. +3. iperf3 client transmits a uni-directional stream as fast as the + VPP Host Stack allows to the iperf3 server for the test duration. +4. At the end of the test the iperf3 client emits the goodput + measurements for all streams and the sum of all streams. + +Test cases include 1 and 10 Streams with a 20 second test duration +with the VPP Host Stack using the UDP transport layer.. + +Note: iperf3 is single threaded, so it is expected that the 10 stream +test shows little or no performance improvement due to +multi-thread/multi-core execution. |