Code Review / csit.git / blobdiff
? search:
summary | shortlog | log | commit | commitdiff | review | tree
raw | inline | side by side
Report: add 3n-alt static content
[csit.git] / docs / report / vpp_performance_tests / test_environment.rst
diff --git a/docs/report/vpp_performance_tests/test_environment.rst b/docs/report/vpp_performance_tests/test_environment.rst
index fb1ed94..dec8780 100644 (file)
--- 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\r
-\r
-.. include:: test_environment_sut_conf_1.rst\r
-\r
-.. include:: test_environment_sut_conf_2.rst\r
-\r
-.. include:: test_environment_sut_conf_3.rst\r
-\r
-\r
-DUT Configuration - VPP\r
------------------------\r
-\r
-**VPP Version**\r
-\r
-|vpp-release|\r
-\r
-**VPP Compile Parameters**\r
-\r
-`FD.io VPP compile job`_\r
-\r
-**VPP Install Parameters**\r
-\r
-::\r
-\r
-    $ dpkg -i --force-all vpp*\r
-\r
-**VPP Startup Configuration**\r
-\r
-VPP startup configuration changes per test case with different settings for CPU\r
-cores, rx-queues and no-multi-seg parameter. Startup config is aligned with\r
-applied test case tag:\r
-\r
-Tagged by **1T1C**\r
-\r
-::\r
-\r
-    unix\r
-    {\r
-      cli-listen localhost:5002\r
-      log /tmp/vpe.log\r
-      nodaemon\r
-    }\r
-    cpu\r
-    {\r
-      corelist-workers 2\r
-      main-core 1\r
-    }\r
-    ip4\r
-    {\r
-      heap-size "4G"\r
-    }\r
-    ip6\r
-    {\r
-      heap-size "4G"\r
-      hash-buckets "2000000"\r
-    }\r
-    plugins\r
-    {\r
-      plugin pppoe_plugin.so { disable }\r
-      plugin kubeproxy_plugin.so { disable }\r
-      plugin ioam_plugin.so { disable }\r
-      plugin ila_plugin.so { disable }\r
-      plugin stn_plugin.so { disable }\r
-      plugin acl_plugin.so { disable }\r
-      plugin l2e_plugin.so { disable }\r
-      plugin sixrd_plugin.so { disable }\r
-      plugin nat_plugin.so { disable }\r
-      plugin ixge_plugin.so { disable }\r
-      plugin lb_plugin.so { disable }\r
-      plugin memif_plugin.so { disable }\r
-      plugin gtpu_plugin.so { disable }\r
-      plugin flowprobe_plugin.so { disable }\r
-    }\r
-    heapsize "4G"\r
-    dpdk\r
-    {\r
-      dev 0000:88:00.1\r
-      dev 0000:88:00.0\r
-      no-multi-seg\r
-      dev default\r
-      {\r
-        num-rx-desc 2048\r
-        num-rx-queues 1\r
-        num-tx-desc 2048\r
-      }\r
-      socket-mem "1024,1024"\r
-      no-tx-checksum-offload\r
-    }\r
-\r
-Tagged by **2T2C**\r
-\r
-::\r
-\r
-    unix\r
-    {\r
-      cli-listen localhost:5002\r
-      log /tmp/vpe.log\r
-      nodaemon\r
-    }\r
-    cpu\r
-    {\r
-      corelist-workers 2,3\r
-      main-core 1\r
-    }\r
-    ip4\r
-    {\r
-      heap-size "4G"\r
-    }\r
-    ip6\r
-    {\r
-      heap-size "4G"\r
-      hash-buckets "2000000"\r
-    }\r
-    plugins\r
-    {\r
-      plugin pppoe_plugin.so { disable }\r
-      plugin kubeproxy_plugin.so { disable }\r
-      plugin ioam_plugin.so { disable }\r
-      plugin ila_plugin.so { disable }\r
-      plugin stn_plugin.so { disable }\r
-      plugin acl_plugin.so { disable }\r
-      plugin l2e_plugin.so { disable }\r
-      plugin sixrd_plugin.so { disable }\r
-      plugin nat_plugin.so { disable }\r
-      plugin ixge_plugin.so { disable }\r
-      plugin lb_plugin.so { disable }\r
-      plugin memif_plugin.so { disable }\r
-      plugin gtpu_plugin.so { disable }\r
-      plugin flowprobe_plugin.so { disable }\r
-    }\r
-    heapsize "4G"\r
-    dpdk\r
-    {\r
-      dev 0000:88:00.1\r
-      dev 0000:88:00.0\r
-      no-multi-seg\r
-      dev default\r
-      {\r
-        num-rx-desc 2048\r
-        num-rx-queues 1\r
-        num-tx-desc 2048\r
-      }\r
-      socket-mem "1024,1024"\r
-      no-tx-checksum-offload\r
-    }\r
-\r
-Tagged by **4T4C**\r
-\r
-::\r
-\r
-    unix\r
-    {\r
-      cli-listen localhost:5002\r
-      log /tmp/vpe.log\r
-      nodaemon\r
-    }\r
-    cpu\r
-    {\r
-      corelist-workers 2,3,4,5\r
-      main-core 1\r
-    }\r
-    ip4\r
-    {\r
-      heap-size "4G"\r
-    }\r
-    ip6\r
-    {\r
-      heap-size "4G"\r
-      hash-buckets "2000000"\r
-    }\r
-    plugins\r
-    {\r
-      plugin pppoe_plugin.so { disable }\r
-      plugin kubeproxy_plugin.so { disable }\r
-      plugin ioam_plugin.so { disable }\r
-      plugin ila_plugin.so { disable }\r
-      plugin stn_plugin.so { disable }\r
-      plugin acl_plugin.so { disable }\r
-      plugin l2e_plugin.so { disable }\r
-      plugin sixrd_plugin.so { disable }\r
-      plugin nat_plugin.so { disable }\r
-      plugin ixge_plugin.so { disable }\r
-      plugin lb_plugin.so { disable }\r
-      plugin memif_plugin.so { disable }\r
-      plugin gtpu_plugin.so { disable }\r
-      plugin flowprobe_plugin.so { disable }\r
-    }\r
-    heapsize "4G"\r
-    dpdk\r
-    {\r
-      dev 0000:88:00.1\r
-      dev 0000:88:00.0\r
-      no-multi-seg\r
-      dev default\r
-      {\r
-        num-rx-desc 2048\r
-        num-rx-queues 2\r
-        num-tx-desc 2048\r
-      }\r
-      socket-mem "1024,1024"\r
-      no-tx-checksum-offload\r
-    }\r
-\r
-.. include:: test_environment_tg.rst\r
+
+.. 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
Integration tests