Improve hoststack methodology pages
[csit.git] / docs / report / introduction / methodology_hoststack_testing / methodology_quic_with_vppecho.rst
1 QUIC/UDP/IP with vpp_echo
2 ^^^^^^^^^^^^^^^^^^^^^^^^^
3
4 `vpp_echo performance testing tool <https://wiki.fd.io/view/VPP/HostStack#External_Echo_Server.2FClient_.28vpp_echo.29>`_
5 is a bespoke performance test application which utilizes the 'native
6 HostStack APIs' to verify performance and correct handling of
7 connection/stream events with uni-directional and bi-directional
8 streams of data.
9
10 Because iperf3 does not support the QUIC transport protocol, vpp_echo
11 is used for measuring the maximum attainable goodput of the VPP Host
12 Stack connection utilizing the QUIC transport protocol across two
13 instances of VPP running on separate DUT nodes. The QUIC transport
14 protocol supports multiple streams per connection and test cases
15 utilize different combinations of QUIC connections and number of
16 streams per connection.
17
18 The test configuration is as follows:
19
20 ::
21
22             DUT1               Network                DUT2
23     [ vpp_echo-client -> VPP1 ]=======[ VPP2 -> vpp_echo-server]
24                           N-streams/connection
25
26 where,
27
28 1. vpp_echo server attaches to VPP2 and LISTENs on VPP2:TCP port 1234.
29 2. vpp_echo client creates one or more connections to VPP1 and opens
30    one or more stream per connection to VPP2:TCP port 1234.
31 3. vpp_echo client transmits a uni-directional stream as fast as the
32    VPP Host Stack allows to the vpp_echo server for the test duration.
33 4. At the end of the test the vpp_echo client emits the goodput
34    measurements for all streams and the sum of all streams.
35
36 Test cases include
37
38 1. 1 QUIC Connection with 1 Stream
39 2. 1 QUIC connection with 10 Streams
40 3. 10 QUIC connetions with 1 Stream
41 4. 10 QUIC connections with 10 Streams
42
43 with stream sizes to provide reasonable test durations. The VPP Host
44 Stack QUIC transport is configured to utilize the picotls encryption
45 library. In the future, tests utilizing addtional encryption
46 algorithms will be added.