81c5e4e73e053a4c1648e756b83df7302f1fb066
[csit.git] / docs / report / introduction / methodology_vpp_startup_settings.rst
1 VPP Startup Settings
2 --------------------
3
4 CSIT code manipulates a number of VPP settings in startup.conf for optimized
5 performance. List of common settings applied to all tests and test
6 dependent settings follows.
7
8 See `VPP startup.conf`_
9 for a complete set and description of listed settings.
10
11 Common Settings
12 ~~~~~~~~~~~~~~~
13
14 List of vpp startup.conf settings applied to all tests:
15
16 #. heap-size <value> - set separately for ip4, ip6, stats, main
17    depending on scale tested.
18 #. no-tx-checksum-offload - disables UDP / TCP TX checksum offload in DPDK.
19    Typically needed for use faster vector PMDs (together with
20    no-multi-seg).
21 #. buffers-per-numa <value> - increases number of buffers allocated, needed
22    in scenarios with large number of interfaces and worker threads.
23    Value is per CPU socket. Default is 16384. CSIT is setting statically
24    107520 buffers per CPU thread (215040 if HTT is enabled). This value is also
25    maximum possible amount limited by number of memory mappings in DPDK
26    libraries for 2MB Hugepages used in CSIT.
27
28 Per Test Settings
29 ~~~~~~~~~~~~~~~~~
30
31 List of vpp startup.conf settings applied dynamically per test:
32
33 #. corelist-workers <list_of_cores> - list of logical cores to run VPP
34    worker data plane threads. Depends on HyperThreading and core per
35    test configuration.
36 #. num-rx-queues <value> - depends on a number of VPP threads and NIC
37    interfaces.
38 #. no-multi-seg - disables multi-segment buffers in DPDK, improves
39    packet throughput, but disables Jumbo MTU support. Disabled for all
40    tests apart from the ones that require Jumbo 9000B frame support.
41 #. UIO driver - depends on topology file definition.
42 #. QAT VFs - depends on NRThreads, each thread = 1QAT VFs.

©2016 FD.io a Linux Foundation Collaborative Project. All Rights Reserved.
Linux Foundation is a registered trademark of The Linux Foundation. Linux is a registered trademark of Linus Torvalds.
Please see our privacy policy and terms of use.