X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_performance_tests%2Ftest_environment.rst;h=dec8780904b4fa92137a08114a14abab80707fd1;hp=fb1ed948a67f9ca169edeb7173ed142e13529b3c;hb=bf0fa247e2e95c14bc76dae43a0df26be410d931;hpb=3c5428b13bdf28774922b3abe370f23e3ccc5ead

diff --git a/docs/report/vpp_performance_tests/test_environment.rst b/docs/report/vpp_performance_tests/test_environment.rst
index fb1ed948a6..dec8780904 100644
--- a/docs/report/vpp_performance_tests/test_environment.rst
+++ b/docs/report/vpp_performance_tests/test_environment.rst
@@ -1,204 +1,127 @@
-.. include:: test_environment_intro.rst
-
-.. include:: test_environment_sut_conf_1.rst
-
-.. include:: test_environment_sut_conf_2.rst
-
-.. include:: test_environment_sut_conf_3.rst
-
-
-DUT Configuration - VPP
------------------------
-
-**VPP Version**
-
-|vpp-release|
-
-**VPP Compile Parameters**
-
-`FD.io VPP compile job`_
-
-**VPP Install Parameters**
-
-::
-
-    $ dpkg -i --force-all vpp*
-
-**VPP Startup Configuration**
-
-VPP startup configuration changes per test case with different settings for CPU
-cores, rx-queues and no-multi-seg parameter. Startup config is aligned with
-applied test case tag:
-
-Tagged by **1T1C**
-
-::
-
-    unix
-    {
-      cli-listen localhost:5002
-      log /tmp/vpe.log
-      nodaemon
-    }
-    cpu
-    {
-      corelist-workers 2
-      main-core 1
-    }
-    ip4
-    {
-      heap-size "4G"
-    }
-    ip6
-    {
-      heap-size "4G"
-      hash-buckets "2000000"
-    }
-    plugins
-    {
-      plugin pppoe_plugin.so { disable }
-      plugin kubeproxy_plugin.so { disable }
-      plugin ioam_plugin.so { disable }
-      plugin ila_plugin.so { disable }
-      plugin stn_plugin.so { disable }
-      plugin acl_plugin.so { disable }
-      plugin l2e_plugin.so { disable }
-      plugin sixrd_plugin.so { disable }
-      plugin nat_plugin.so { disable }
-      plugin ixge_plugin.so { disable }
-      plugin lb_plugin.so { disable }
-      plugin memif_plugin.so { disable }
-      plugin gtpu_plugin.so { disable }
-      plugin flowprobe_plugin.so { disable }
-    }
-    heapsize "4G"
-    dpdk
-    {
-      dev 0000:88:00.1
-      dev 0000:88:00.0
-      no-multi-seg
-      dev default
-      {
-        num-rx-desc 2048
-        num-rx-queues 1
-        num-tx-desc 2048
-      }
-      socket-mem "1024,1024"
-      no-tx-checksum-offload
-    }
-
-Tagged by **2T2C**
-
-::
-
-    unix
-    {
-      cli-listen localhost:5002
-      log /tmp/vpe.log
-      nodaemon
-    }
-    cpu
-    {
-      corelist-workers 2,3
-      main-core 1
-    }
-    ip4
-    {
-      heap-size "4G"
-    }
-    ip6
-    {
-      heap-size "4G"
-      hash-buckets "2000000"
-    }
-    plugins
-    {
-      plugin pppoe_plugin.so { disable }
-      plugin kubeproxy_plugin.so { disable }
-      plugin ioam_plugin.so { disable }
-      plugin ila_plugin.so { disable }
-      plugin stn_plugin.so { disable }
-      plugin acl_plugin.so { disable }
-      plugin l2e_plugin.so { disable }
-      plugin sixrd_plugin.so { disable }
-      plugin nat_plugin.so { disable }
-      plugin ixge_plugin.so { disable }
-      plugin lb_plugin.so { disable }
-      plugin memif_plugin.so { disable }
-      plugin gtpu_plugin.so { disable }
-      plugin flowprobe_plugin.so { disable }
-    }
-    heapsize "4G"
-    dpdk
-    {
-      dev 0000:88:00.1
-      dev 0000:88:00.0
-      no-multi-seg
-      dev default
-      {
-        num-rx-desc 2048
-        num-rx-queues 1
-        num-tx-desc 2048
-      }
-      socket-mem "1024,1024"
-      no-tx-checksum-offload
-    }
-
-Tagged by **4T4C**
-
-::
-
-    unix
-    {
-      cli-listen localhost:5002
-      log /tmp/vpe.log
-      nodaemon
-    }
-    cpu
-    {
-      corelist-workers 2,3,4,5
-      main-core 1
-    }
-    ip4
-    {
-      heap-size "4G"
-    }
-    ip6
-    {
-      heap-size "4G"
-      hash-buckets "2000000"
-    }
-    plugins
-    {
-      plugin pppoe_plugin.so { disable }
-      plugin kubeproxy_plugin.so { disable }
-      plugin ioam_plugin.so { disable }
-      plugin ila_plugin.so { disable }
-      plugin stn_plugin.so { disable }
-      plugin acl_plugin.so { disable }
-      plugin l2e_plugin.so { disable }
-      plugin sixrd_plugin.so { disable }
-      plugin nat_plugin.so { disable }
-      plugin ixge_plugin.so { disable }
-      plugin lb_plugin.so { disable }
-      plugin memif_plugin.so { disable }
-      plugin gtpu_plugin.so { disable }
-      plugin flowprobe_plugin.so { disable }
-    }
-    heapsize "4G"
-    dpdk
-    {
-      dev 0000:88:00.1
-      dev 0000:88:00.0
-      no-multi-seg
-      dev default
-      {
-        num-rx-desc 2048
-        num-rx-queues 2
-        num-tx-desc 2048
-      }
-      socket-mem "1024,1024"
-      no-tx-checksum-offload
-    }
-
-.. include:: test_environment_tg.rst
+
+.. raw:: latex
+
+    \clearpage
+
+.. _vpp_test_environment:
+
+.. include:: ../introduction/test_environment_intro.rst
+
+.. include:: ../introduction/test_environment_changes_vpp.rst
+
+.. include:: ../introduction/test_environment_sut_conf_1.rst
+
+
+DUT Settings - VPP
+------------------
+
+VPP Version
+~~~~~~~~~~~
+
+|vpp-release|
+
+VPP Compile Parameters
+~~~~~~~~~~~~~~~~~~~~~~
+
+`FD.io VPP compile job`_
+
+VPP Install Parameters
+~~~~~~~~~~~~~~~~~~~~~~
+
+::
+
+    $ dpkg -i --force-all *vpp*
+
+VPP Startup Configuration
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+VPP startup configuration vary per test case, with different settings
+for `$$CORELIST_WORKERS`, `$$NUM_RX_QUEUES`, `$$UIO_DRIVER`, and
+`$$NO_MULTI_SEG` parameter. List of plugins to enable is driven by test
+requirements. Default template is provided below:
+
+::
+
+    ip
+    {
+      heap-size 4G
+    }
+    statseg
+    {
+      size 4G
+      per-node-counters on
+    }
+    unix
+    {
+      cli-listen /run/vpp/cli.sock
+      log /tmp/vpe.log
+      nodaemon
+      full-coredump
+    }
+    socksvr {
+      socket-name /run/vpp/api.sock
+    }
+    ip6
+    {
+      heap-size 4G
+      hash-buckets 2000000
+    }
+    heapsize 4G
+    plugins
+    {
+      plugin default
+      {
+        disable
+      }
+      plugin <$$test_requirement>_plugin.so
+      {
+        enable
+      }
+    }
+    cpu
+    {
+      corelist-workers $$CORELIST_WORKERS
+      main-core 1
+    }
+    buffers
+    {
+      buffers-per-numa 215040
+    }
+
+    # Below: in case of dpdk based drivers (vfio-pci) only
+    dpdk
+    {
+      uio-driver $$UIO_DRIVER
+      $$NO_MULTI_SEG
+      log-level debug
+      dev default
+      {
+        num-rx-queues $$NUM_RX_QUEUES
+      }
+      no-tx-checksum-offload
+      dev $$DEV_1
+      dev $$DEV_2
+    }
+
+Description of VPP startup settings used in CSIT is provided in
+:ref:`test_methodology`.
+
+.. include:: ../introduction/test_environment_tg.rst
+
+.. include:: ../introduction/test_environment_pre_test_server_calib.rst
+
+.. include:: ../introduction/test_environment_sut_calib_icx.rst
+
+.. include:: ../introduction/test_environment_sut_calib_skx.rst
+
+.. include:: ../introduction/test_environment_sut_calib_clx.rst
+
+.. include:: ../introduction/test_environment_sut_calib_hsw.rst
+
+.. include:: ../introduction/test_environment_sut_calib_dnv.rst
+
+.. include:: ../introduction/test_environment_sut_calib_alt.rst
+
+.. include:: ../introduction/test_environment_sut_calib_tsh.rst
+
+.. include:: ../introduction/test_environment_sut_calib_tx2.rst