5ef248903f5f874a791cf818a9c44d55b29db102
[csit.git] / docs / report / vpp_performance_tests / test_environment.rst
1
2 .. raw:: latex
3
4     \clearpage
5
6 .. _vpp_test_environment:
7
8 .. include:: ../introduction/test_environment_intro.rst
9
10 .. include:: ../introduction/test_environment_sut_calib_skx.rst
11
12 .. include:: ../introduction/test_environment_sut_calib_clx.rst
13
14 .. include:: ../introduction/test_environment_sut_calib_hsw.rst
15
16 .. include:: ../introduction/test_environment_sut_calib_dnv.rst
17
18 .. include:: ../introduction/test_environment_sut_calib_tsh.rst
19
20 .. include:: ../introduction/test_environment_sut_conf_1.rst
21
22
23 DUT Settings - VPP
24 ------------------
25
26 VPP Version
27 ~~~~~~~~~~~
28
29 |vpp-release|
30
31 VPP Compile Parameters
32 ~~~~~~~~~~~~~~~~~~~~~~
33
34 `FD.io VPP compile job`_
35
36 VPP Install Parameters
37 ~~~~~~~~~~~~~~~~~~~~~~
38
39 ::
40
41     $ dpkg -i --force-all *vpp*
42
43 VPP Startup Configuration
44 ~~~~~~~~~~~~~~~~~~~~~~~~~
45
46 VPP startup configuration vary per test case, with different settings
47 for `$$CORELIST_WORKERS`, `$$NUM_RX_QUEUES`, `$$UIO_DRIVER`, and
48 `$$NO_MULTI_SEG` parameter. List of plugins to enable is driven by test
49 requirements. Default template is provided below:
50
51 ::
52
53     ip
54     {
55       heap-size 4G
56     }
57     statseg
58     {
59       size 4G
60       per-node-counters on
61     }
62     unix
63     {
64       cli-listen /run/vpp/cli.sock
65       log /tmp/vpe.log
66       nodaemon
67       full-coredump
68     }
69     socksvr {
70       socket-name /run/vpp/api.sock
71     }
72     ip6
73     {
74       heap-size 4G
75       hash-buckets 2000000
76     }
77     heapsize 4G
78     plugins
79     {
80       plugin default
81       {
82         disable
83       }
84       plugin <$$test_requirement>_plugin.so
85       {
86         enable
87       }
88     }
89     cpu
90     {
91       corelist-workers $$CORELIST_WORKERS
92       main-core 1
93     }
94     buffers
95     {
96       buffers-per-numa 215040
97     }
98
99     # Below: in case of dpdk based drivers (vfio-pci) only
100     dpdk
101     {
102       uio-driver $$UIO_DRIVER
103       $$NO_MULTI_SEG
104       log-level debug
105       dev default
106       {
107         num-rx-queues $$NUM_RX_QUEUES
108       }
109       no-tx-checksum-offload
110       dev $$DEV_1
111       dev $$DEV_2
112     }
113
114 Description of VPP startup settings used in CSIT is provided in
115 :ref:`test_methodology`.
116
117 .. include:: ../introduction/test_environment_tg.rst