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