Report 1804: SRv6 adn func part update
[csit.git] / docs / report / vpp_functional_tests / test_environment.rst
index 5b29b2d..6a70336 100644 (file)
@@ -240,30 +240,47 @@ Example of DUT nodes configuration:::
     | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend\r
     |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)\r
     ||/ Name           Version       Architecture Description\r
-    +++-==============-=============-============-=============================================\r
-    ii  vpp            17.07-release amd64        Vector Packet Processing--executables\r
-    ii  vpp-dbg        17.07-release amd64        Vector Packet Processing--debug symbols\r
-    ii  vpp-dev        17.07-release amd64        Vector Packet Processing--development support\r
-    ii  vpp-dpdk-dev   17.07-release amd64        Vector Packet Processing--development support\r
-    ii  vpp-dpdk-dkms  17.07-release amd64        DPDK 2.1 igb_uio_driver\r
-    ii  vpp-lib        17.07-release amd64        Vector Packet Processing--runtime libraries\r
-    ii  vpp-plugins    17.07-release amd64        Vector Packet Processing--runtime plugins\r
+    +++-==============-=============-============-=================================================\r
+    ii  vpp            18.04-release amd64        Vector Packet Processing--executables\r
+    ii  vpp-dbg        18.04-release amd64        Vector Packet Processing--debug symbols\r
+    ii  vpp-dev        18.04-release amd64        Vector Packet Processing--development support\r
+    ii  vpp-dpdk-dkms  18.02-vpp1    amd64        DPDK Development Package for VPP - Kernel Modules\r
+    ii  vpp-lib        18.04-release amd64        Vector Packet Processing--runtime libraries\r
+    ii  vpp-plugins    18.04-release amd64        Vector Packet Processing--runtime plugins\r
 \r
 **VPP Startup Configuration**\r
 \r
-VPP startup configuration is common for all test cases.\r
+VPP startup configuration is common for all test cases except test cases related\r
+to SW Crypto device.\r
+\r
+**Default**\r
 \r
 ::\r
 \r
     $ cat /etc/vpp/startup.conf\r
     unix {\r
       nodaemon\r
-      log /tmp/vpp.log\r
+      log /var/log/vpp/vpp.log\r
       full-coredump\r
+      cli-listen /run/vpp/cli.sock\r
+      gid vpp\r
     }\r
 \r
     api-trace {\r
+    ## This stanza controls binary API tracing. Unless there is a very strong reason,\r
+    ## please leave this feature enabled.\r
       on\r
+    ## Additional parameters:\r
+    ##\r
+    ## To set the number of binary API trace records in the circular buffer, configure nitems\r
+    ##\r
+    ## nitems <nnn>\r
+    ##\r
+    ## To save the api message table decode tables, configure a filename. Results in /tmp/<filename>\r
+    ## Very handy for understanding api message changes between versions, identifying missing\r
+    ## plugins, and so forth.\r
+    ##\r
+    ## save-api-table <filename>\r
     }\r
 \r
     api-segment {\r
@@ -306,7 +323,7 @@ VPP startup configuration is common for all test cases.
         # scheduler-priority 50\r
     }\r
 \r
-    dpdk {\r
+    dpdk {\r
         ## Change default settings for all intefaces\r
         # dev default {\r
             ## Number of receive queues, enables RSS\r
@@ -337,9 +354,19 @@ VPP startup configuration is common for all test cases.
         #      num-rx-queues 2\r
         # }\r
 \r
-        ## Change UIO driver used by VPP, Options are: uio_pci_generic, vfio-pci\r
-        ## and igb_uio (default)\r
-        # uio-driver uio_pci_generic\r
+        ## Specify bonded interface and its slaves via PCI addresses\r
+        ##\r
+        ## Bonded interface in XOR load balance mode (mode 2) with L3 and L4 headers\r
+        # vdev eth_bond0,mode=2,slave=0000:02:00.0,slave=0000:03:00.0,xmit_policy=l34\r
+        # vdev eth_bond1,mode=2,slave=0000:02:00.1,slave=0000:03:00.1,xmit_policy=l34\r
+        ##\r
+        ## Bonded interface in Active-Back up mode (mode 1)\r
+        # vdev eth_bond0,mode=1,slave=0000:02:00.0,slave=0000:03:00.0\r
+        # vdev eth_bond1,mode=1,slave=0000:02:00.1,slave=0000:03:00.1\r
+\r
+        ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,\r
+        ## uio_pci_generic or auto (default)\r
+        # uio-driver vfio-pci\r
 \r
         ## Disable mutli-segment buffers, improves performance but\r
         ## disables Jumbo MTU support\r
@@ -347,12 +374,57 @@ VPP startup configuration is common for all test cases.
 \r
         ## Increase number of buffers allocated, needed only in scenarios with\r
         ## large number of interfaces and worker threads. Value is per CPU socket.\r
-        ## Default is 32768\r
+        ## Default is 16384\r
         # num-mbufs 128000\r
 \r
         ## Change hugepages allocation per-socket, needed only if there is need for\r
         ## larger number of mbufs. Default is 256M on each detected CPU socket\r
         # socket-mem 2048,2048\r
+\r
+        ## Disables UDP / TCP TX checksum offload. Typically needed for use\r
+        ## faster vector PMDs (together with no-multi-seg)\r
+        # no-tx-checksum-offload\r
+    # }\r
+\r
+\r
+    # plugins {\r
+        ## Adjusting the plugin path depending on where the VPP plugins are\r
+        #      path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins\r
+\r
+        ## Disable all plugins by default and then selectively enable specific plugins\r
+        # plugin default { disable }\r
+        # plugin dpdk_plugin.so { enable }\r
+        # plugin acl_plugin.so { enable }\r
+\r
+        ## Enable all plugins by default and then selectively disable specific plugins\r
+        # plugin dpdk_plugin.so { disable }\r
+        # plugin acl_plugin.so { disable }\r
+    # }\r
+\r
+        ## Alternate syntax to choose plugin path\r
+        # plugin_path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins\r
+\r
+**SW Crypto Device**\r
+\r
+::\r
+\r
+    $ cat /etc/vpp/startup.conf\r
+    unix\r
+    {\r
+      cli-listen /run/vpp/cli.sock\r
+      gid vpp\r
+      nodaemon\r
+      full-coredump\r
+      log /tmp/vpp.log\r
+    }\r
+    api-segment\r
+    {\r
+      gid vpp\r
+    }\r
+    dpdk\r
+    {\r
+      vdev cryptodev_aesni_gcm_pmd,socket_id=0\r
+      vdev cryptodev_aesni_mb_pmd,socket_id=0\r
     }\r
 \r
 TG Configuration\r