5bd81abac2fc7be282178a5474061567eeb55d01
[csit.git] / docs / report / testpmd_performance_tests_hw / overview.rst
1 Overview
2 ========
3
4 Testpmd Performance Test Topologies
5 -----------------------------------
6
7 CSIT Testpmd performance tests are executed on physical baremetal servers hosted
8 by LF FD.io project. Testbed physical topology is shown in the figure below.::
9
10     +------------------------+           +------------------------+
11     |                        |           |                        |
12     |  +------------------+  |           |  +------------------+  |
13     |  |                  |  |           |  |                  |  |
14     |  |                  <----------------->                  |  |
15     |  |       DUT1       |  |           |  |       DUT2       |  |
16     |  +--^---------------+  |           |  +---------------^--+  |
17     |     |                  |           |                  |     |
18     |     |            SUT1  |           |  SUT2            |     |
19     +------------------------+           +------------------^-----+
20           |                                                 |
21           |                                                 |
22           |                  +-----------+                  |
23           |                  |           |                  |
24           +------------------>    TG     <------------------+
25                              |           |
26                              +-----------+
27
28 SUT1 and SUT2 are two System Under Test servers (Cisco UCS C240, each with two
29 Intel XEON CPUs), TG is a Traffic Generator (TG, another Cisco UCS C240, with
30 two Intel XEON CPUs). SUTs run Testpmd SW application in Linux user-mode as a
31 Device Under Test (DUT). TG runs TRex SW application as a packet Traffic
32 Generator. Physical connectivity between SUTs and to TG is provided using
33 different NIC models that need to be tested for performance. Currently
34 installed and tested NIC models include:
35
36 #. 2port10GE X520-DA2 Intel.
37 #. 2port10GE X710 Intel.
38 #. 2port10GE VIC1227 Cisco.
39 #. 2port40GE VIC1385 Cisco.
40 #. 2port40GE XL710 Intel.
41
42 Detailed LF FD.io test bed specification and topology is described on `CSIT LF
43 testbed wiki page <https://wiki.fd.io/view/CSIT/CSIT_LF_testbed>`_.
44
45 Testpmd Performance Tests Overview
46 ----------------------------------
47
48 Performance tests are split into two main categories:
49
50 - Throughput discovery - discovery of packet forwarding rate using binary search
51   in accordance to RFC2544.
52
53   - NDR - discovery of Non Drop Rate, zero packet loss.
54   - PDR - discovery of Partial Drop Rate, with specified non-zero packet loss.
55
56 - Throughput verification - verification of packet forwarding rate against
57   previously discovered throughput rate. These tests are currently done against
58   0.9 of reference NDR, with reference rates updated periodically.
59
60 CSIT |release| includes following performance test suites:
61
62 - 2port10GE X520-DA2 Intel
63
64   - **L2XC** - L2 Cross-Connect forwarding of untagged Ethernet frames.