aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/methodology/hoststack_testing
diff options
context:
space:
mode:
authorTibor Frank <tifrank@cisco.com>2023-05-03 13:53:27 +0000
committerTibor Frank <tifrank@cisco.com>2023-05-09 05:56:22 +0000
commit374954b9d648f503f6783325a1266457953a998d (patch)
tree5514dee6af2a2e069189efe39d4e929dd25721f7 /docs/content/methodology/hoststack_testing
parent46eac7bb697e8261dba5b439a15f5a6125f31760 (diff)
C-Docs: New structure
Change-Id: I73d107f94b28b138f3350a9e1eedb0555583a9ca Signed-off-by: Tibor Frank <tifrank@cisco.com>
Diffstat (limited to 'docs/content/methodology/hoststack_testing')
-rw-r--r--docs/content/methodology/hoststack_testing/_index.md6
-rw-r--r--docs/content/methodology/hoststack_testing/quicudpip_with_vppecho.md48
-rw-r--r--docs/content/methodology/hoststack_testing/tcpip_with_iperf3.md52
-rw-r--r--docs/content/methodology/hoststack_testing/udpip_with_iperf3.md44
-rw-r--r--docs/content/methodology/hoststack_testing/vsap_ab_with_nginx.md39
5 files changed, 0 insertions, 189 deletions
diff --git a/docs/content/methodology/hoststack_testing/_index.md b/docs/content/methodology/hoststack_testing/_index.md
deleted file mode 100644
index b658313040..0000000000
--- a/docs/content/methodology/hoststack_testing/_index.md
+++ /dev/null
@@ -1,6 +0,0 @@
----
-bookCollapseSection: true
-bookFlatSection: false
-title: "Hoststack Testing"
-weight: 14
---- \ No newline at end of file
diff --git a/docs/content/methodology/hoststack_testing/quicudpip_with_vppecho.md b/docs/content/methodology/hoststack_testing/quicudpip_with_vppecho.md
deleted file mode 100644
index c7d57a51b3..0000000000
--- a/docs/content/methodology/hoststack_testing/quicudpip_with_vppecho.md
+++ /dev/null
@@ -1,48 +0,0 @@
----
-title: "QUIC/UDP/IP with vpp_echo"
-weight: 1
----
-
-# QUIC/UDP/IP with vpp_echo
-
-[vpp_echo performance testing tool](https://wiki.fd.io/view/VPP/HostStack#External_Echo_Server.2FClient_.28vpp_echo.29)
-is a bespoke performance test application which utilizes the 'native
-HostStack APIs' to verify performance and correct handling of
-connection/stream events with uni-directional and bi-directional
-streams of data.
-
-Because iperf3 does not support the QUIC transport protocol, vpp_echo
-is used for measuring the maximum attainable goodput of the VPP Host
-Stack connection utilizing the QUIC transport protocol across two
-instances of VPP running on separate DUT nodes. The QUIC transport
-protocol supports multiple streams per connection and test cases
-utilize different combinations of QUIC connections and number of
-streams per connection.
-
-The test configuration is as follows:
-
- DUT1 Network DUT2
- [ vpp_echo-client -> VPP1 ]=======[ VPP2 -> vpp_echo-server]
- N-streams/connection
-
-where,
-
-1. vpp_echo server attaches to VPP2 and LISTENs on VPP2:TCP port 1234.
-2. vpp_echo client creates one or more connections to VPP1 and opens
- one or more stream per connection to VPP2:TCP port 1234.
-3. vpp_echo client transmits a uni-directional stream as fast as the
- VPP Host Stack allows to the vpp_echo server for the test duration.
-4. At the end of the test the vpp_echo client emits the goodput
- measurements for all streams and the sum of all streams.
-
-Test cases include
-
-1. 1 QUIC Connection with 1 Stream
-2. 1 QUIC connection with 10 Streams
-3. 10 QUIC connetions with 1 Stream
-4. 10 QUIC connections with 10 Streams
-
-with stream sizes to provide reasonable test durations. The VPP Host
-Stack QUIC transport is configured to utilize the picotls encryption
-library. In the future, tests utilizing addtional encryption
-algorithms will be added.
diff --git a/docs/content/methodology/hoststack_testing/tcpip_with_iperf3.md b/docs/content/methodology/hoststack_testing/tcpip_with_iperf3.md
deleted file mode 100644
index 7baa88ab50..0000000000
--- a/docs/content/methodology/hoststack_testing/tcpip_with_iperf3.md
+++ /dev/null
@@ -1,52 +0,0 @@
----
-title: "TCP/IP with iperf3"
-weight: 2
----
-
-# TCP/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:TCP port 5201.
-2. iperf3 client attaches to VPP1 and opens one or more stream
- connections to VPP2:TCP 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 configured to utilize the Cubic TCP
-congestion algorithm.
-
-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.
-
-There are also variations of these test cases which use the VPP Network
-Simulator (NSIM) plugin to test the VPP Hoststack goodput with 1 percent
-of the traffic being dropped at the output interface of VPP1 thereby
-simulating a lossy network. The NSIM tests are experimental and the
-test results are not currently representative of typical results in a
-lossy network.
diff --git a/docs/content/methodology/hoststack_testing/udpip_with_iperf3.md b/docs/content/methodology/hoststack_testing/udpip_with_iperf3.md
deleted file mode 100644
index 01ddf61269..0000000000
--- a/docs/content/methodology/hoststack_testing/udpip_with_iperf3.md
+++ /dev/null
@@ -1,44 +0,0 @@
----
-title: "UDP/IP with iperf3"
-weight: 3
----
-
-# 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.
diff --git a/docs/content/methodology/hoststack_testing/vsap_ab_with_nginx.md b/docs/content/methodology/hoststack_testing/vsap_ab_with_nginx.md
deleted file mode 100644
index 2dc4d2b7f9..0000000000
--- a/docs/content/methodology/hoststack_testing/vsap_ab_with_nginx.md
+++ /dev/null
@@ -1,39 +0,0 @@
----
-title: "VSAP ab with nginx"
-weight: 4
----
-
-# VSAP ab with nginx
-
-[VSAP (VPP Stack Acceleration Project)](https://wiki.fd.io/view/VSAP)
-aims to establish an industry user space application ecosystem based on
-the VPP hoststack. As a pre-requisite to adapting open source applications
-using VPP Communications Library to accelerate performance, the VSAP team
-has introduced baseline tests utilizing the LD_PRELOAD mechanism to capture
-baseline performance data.
-
-[AB (Apache HTTP server benchmarking tool)](https://httpd.apache.org/docs/2.4/programs/ab.html)
-is used for measuring the maximum connections-per-second and requests-per-second.
-
-[NGINX](https://www.nginx.com) is a popular open source HTTP server
-application. Because NGINX utilizes the POSIX socket interface APIs, the test
-configuration uses the LD_PRELOAD mechanism to connect NGINX to the VPP
-Hoststack using the VPP Communications Library (VCL) LD_PRELOAD library
-(libvcl_ldpreload.so).
-
-In the future, a version of NGINX which has been modified to
-directly use the VCL application APIs will 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:
-
- TG Network DUT
- [ AB ]=============[ VPP -> nginx ]
-
-where,
-
-1. nginx attaches to VPP and listens on TCP port 80
-2. ab runs CPS and RPS tests with packets flowing from the Test Generator node,
- across 100G NICs, through VPP hoststack to NGINX.
-3. At the end of the tests, the results are reported by AB.