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.