Report: functional tests static content
[csit.git] / docs / report / vpp_functional_tests / test_environment.rst
index 1d00263..10a50a5 100644 (file)
@@ -62,8 +62,8 @@ SUT VMs' settings are defined in `VIRL topologies directory`_
 SUT Settings - VIRL Guest OS Linux
 ----------------------------------
 
-In CSIT terminology, the VM operating system for both SUTs that |vpp-release| has
-been tested with, is the following:
+In CSIT terminology, the VM operating system for both SUTs that |vpp-release|
+has been tested with, is the following:
 
 #. Ubuntu VIRL image
 
@@ -119,9 +119,12 @@ VIRL simulation based on the definition stored in `VIRL topologies directory`_.
 
 Example of DUT nodes configuration:
 
+::
+
     DUT1:
         type: DUT
         host: "10.30.51.157"
+        arch: x86_64
         port: 22
         username: cisco
         honeycomb:
@@ -178,6 +181,7 @@ Example of DUT nodes configuration:
       DUT2:
         type: DUT
         host: "10.30.51.156"
+        arch: x86_64
         port: 22
         username: cisco
         honeycomb:
@@ -242,38 +246,51 @@ VPP Installed Packages - Ubuntu
 
 ::
 
-    $ dpkg -l vpp\*
-    Desired=Unknown/Install/Remove/Purge/Hold
-    | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
-    |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
-    ||/ Name           Version       Architecture Description
-    +++-==============-=============-============-=================================================
-    ii  vpp                                 18.07-release                              amd64        Vector Packet Processing--executables
-    ii  vpp-dbg                             18.07-release                              amd64        Vector Packet Processing--debug symbols
-    ii  vpp-dev                             18.07-release                              amd64        Vector Packet Processing--development support
-    ii  vpp-dpdk-dkms                       18.05-vpp2                                 amd64        DPDK Development Package for VPP - Kernel Modules
-    ii  vpp-lib                             18.07-release                              amd64        Vector Packet Processing--runtime libraries
-    ii  vpp-plugins                         18.07-release                              amd64        Vector Packet Processing--runtime plugins
-
+    $ dpkg -l | grep vpp
+    ii  libvppinfra                           19.08-release                              amd64        Vector Packet Processing--runtime libraries
+    ii  libvppinfra-dev                       19.08-release                              amd64        Vector Packet Processing--runtime libraries
+    ii  python3-vpp-api                       19.08-release                              amd64        VPP Python3 API bindings
+    ii  vpp                                   19.08-release                              amd64        Vector Packet Processing--executables
+    ii  vpp-api-python                        19.08-release                              amd64        VPP Python API bindings
+    ii  vpp-dbg                               19.08-release                              amd64        Vector Packet Processing--debug symbols
+    ii  vpp-dev                               19.08-release                              amd64        Vector Packet Processing--development support
+    ii  vpp-plugin-core                       19.08-release                              amd64        Vector Packet Processing--runtime core plugins
+    ii  vpp-plugin-dpdk                       19.08-release                              amd64        Vector Packet Processing--runtime dpdk plugin
 
 VPP Installed Packages - Centos
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 ::
 
-    $ rpm -qai vpp*
+    $ rpm -qai *vpp*
+    vpp-api-python
+    Version     : 19.08
+    Release     : release
+    Architecture: x86_64
+    Install Date: Wed 28 Aug 2019 01:35:57 AM EDT
+    Group       : Development/Libraries
+    Size        : 195318
+    License     : ASL 2.0
+    Signature   : (none)
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
+    Relocations : (not relocatable)
+    Summary     : VPP api python bindings
+    Description :
+    This package contains the python bindings for the vpp api
     Name        : vpp
-    Version     : 18.07
+    Version     : 19.08
     Release     : release
     Architecture: x86_64
-    Install Date: Tue 31 Jul 2018 02:59:45 AM EDT
+    Install Date: Wed 28 Aug 2019 01:35:57 AM EDT
     Group       : Unspecified
-    Size        : 2396993
+    Size        : 2681317
     License     : ASL 2.0
     Signature   : (none)
-    Source RPM  : vpp-18.07-release.src.rpm
-    Build Date  : Mon 30 Jul 2018 08:20:19 PM EDT
-    Build Host  : c3de88e7d43c
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
     Relocations : (not relocatable)
     Summary     : Vector Packet Processing
     Description :
@@ -282,17 +299,17 @@ VPP Installed Packages - Centos
     vpp_api_test - vector packet engine API test tool
     vpp_json_test - vector packet engine JSON test tool
     Name        : vpp-lib
-    Version     : 18.07
+    Version     : 19.08
     Release     : release
     Architecture: x86_64
-    Install Date: Tue 31 Jul 2018 02:59:45 AM EDT
+    Install Date: Wed 28 Aug 2019 01:35:57 AM EDT
     Group       : System Environment/Libraries
-    Size        : 27134058
+    Size        : 43222411
     License     : ASL 2.0
     Signature   : (none)
-    Source RPM  : vpp-18.07-release.src.rpm
-    Build Date  : Mon 30 Jul 2018 08:20:19 PM EDT
-    Build Host  : c3de88e7d43c
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
     Relocations : (not relocatable)
     Summary     : VPP libraries
     Description :
@@ -302,34 +319,18 @@ VPP Installed Packages - Centos
     vlib - vector processing library
     vlib-api - binary API library
     vnet -  network stack library
-    Name        : vpp-selinux-policy
-    Version     : 18.07
-    Release     : release
-    Architecture: x86_64
-    Install Date: Tue 31 Jul 2018 02:59:44 AM EDT
-    Group       : System Environment/Base
-    Size        : 86709
-    License     : ASL 2.0
-    Signature   : (none)
-    Source RPM  : vpp-18.07-release.src.rpm
-    Build Date  : Mon 30 Jul 2018 08:20:19 PM EDT
-    Build Host  : c3de88e7d43c
-    Relocations : (not relocatable)
-    Summary     : VPP Security-Enhanced Linux (SELinux) policy
-    Description :
-    This package contains a tailored VPP SELinux policy
     Name        : vpp-devel
-    Version     : 18.07
+    Version     : 19.08
     Release     : release
     Architecture: x86_64
-    Install Date: Tue 31 Jul 2018 02:59:47 AM EDT
+    Install Date: Wed 28 Aug 2019 01:35:59 AM EDT
     Group       : Development/Libraries
-    Size        : 11452203
+    Size        : 13906969
     License     : ASL 2.0
     Signature   : (none)
-    Source RPM  : vpp-18.07-release.src.rpm
-    Build Date  : Mon 30 Jul 2018 08:20:19 PM EDT
-    Build Host  : c3de88e7d43c
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
     Relocations : (not relocatable)
     Summary     : VPP header files, static libraries
     Description :
@@ -341,18 +342,34 @@ VPP Installed Packages - Centos
     vnet - devices, classify, dhcp, ethernet flow, gre, ip, etc.
     vpp-api
     vppinfra
+    Name        : vpp-selinux-policy
+    Version     : 19.08
+    Release     : release
+    Architecture: x86_64
+    Install Date: Wed 28 Aug 2019 01:35:56 AM EDT
+    Group       : System Environment/Base
+    Size        : 102929
+    License     : ASL 2.0
+    Signature   : (none)
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
+    Relocations : (not relocatable)
+    Summary     : VPP Security-Enhanced Linux (SELinux) policy
+    Description :
+    This package contains a tailored VPP SELinux policy
     Name        : vpp-plugins
-    Version     : 18.07
+    Version     : 19.08
     Release     : release
     Architecture: x86_64
-    Install Date: Tue 31 Jul 2018 02:59:47 AM EDT
+    Install Date: Wed 28 Aug 2019 01:35:59 AM EDT
     Group       : System Environment/Libraries
-    Size        : 52282610
+    Size        : 34150451
     License     : ASL 2.0
     Signature   : (none)
-    Source RPM  : vpp-18.07-release.src.rpm
-    Build Date  : Mon 30 Jul 2018 08:20:19 PM EDT
-    Build Host  : c3de88e7d43c
+    Source RPM  : vpp-19.08-release.src.rpm
+    Build Date  : Wed 21 Aug 2019 02:30:08 PM EDT
+    Build Host  : 05ab23f629ba
     Relocations : (not relocatable)
     Summary     : Vector Packet Processing--runtime plugins
     Description :
@@ -361,187 +378,11 @@ VPP Installed Packages - Centos
 VPP Startup Configuration
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-VPP startup configuration is common for all test cases except test cases related
-to SW Crypto device.
+VPP startup configuration is common for all test cases.
 
 **Common Configuration**
 
-::
-
-    $ cat /etc/vpp/startup.conf
-    unix {
-      nodaemon
-      log /var/log/vpp/vpp.log
-      full-coredump
-      cli-listen /run/vpp/cli.sock
-      gid vpp
-    }
-
-    api-trace {
-    ## This stanza controls binary API tracing. Unless there is a very strong reason,
-    ## please leave this feature enabled.
-      on
-    ## Additional parameters:
-    ##
-    ## To set the number of binary API trace records in the circular buffer, configure nitems
-    ##
-    ## nitems <nnn>
-    ##
-    ## To save the api message table decode tables, configure a filename. Results in /tmp/<filename>
-    ## Very handy for understanding api message changes between versions, identifying missing
-    ## plugins, and so forth.
-    ##
-    ## save-api-table <filename>
-    }
-
-    api-segment {
-      gid vpp
-    }
-
-    socksvr {
-      default
-    }
-
-    cpu {
-        ## In the VPP there is one main thread and optionally the user can create worker(s)
-        ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
-
-        ## Manual pinning of thread(s) to CPU core(s)
-
-        ## Set logical CPU core where main thread runs, if main core is not set
-        ## VPP will use core 1 if available
-        # main-core 1
-
-        ## Set logical CPU core(s) where worker threads are running
-        # corelist-workers 2-3,18-19
-
-        ## Automatic pinning of thread(s) to CPU core(s)
-
-        ## Sets number of CPU core(s) to be skipped (1 ... N-1)
-        ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
-        ## The main thread is automatically pinned to the first available CPU core and worker(s)
-        ## are pinned to next free CPU core(s) after core assigned to main thread
-        # skip-cores 4
-
-        ## Specify a number of workers to be created
-        ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
-        ## and main thread's CPU core
-        # workers 2
-
-        ## Set scheduling policy and priority of main and worker threads
-
-        ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
-        ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
-        # scheduler-policy fifo
-
-        ## Scheduling priority is used only for "real-time policies (fifo and rr),
-        ## and has to be in the range of priorities supported for a particular policy
-        # scheduler-priority 50
-    }
-
-    # dpdk {
-        ## Change default settings for all intefaces
-        # dev default {
-            ## Number of receive queues, enables RSS
-            ## Default is 1
-            # num-rx-queues 3
-
-            ## Number of transmit queues, Default is equal
-            ## to number of worker threads or 1 if no workers treads
-            # num-tx-queues 3
-
-            ## Number of descriptors in transmit and receive rings
-            ## increasing or reducing number can impact performance
-            ## Default is 1024 for both rx and tx
-            # num-rx-desc 512
-            # num-tx-desc 512
-
-            ## VLAN strip offload mode for interface
-            ## Default is off
-            # vlan-strip-offload on
-        # }
-
-        ## Whitelist specific interface by specifying PCI address
-        # dev 0000:02:00.0
-
-        ## Whitelist specific interface by specifying PCI address and in
-        ## addition specify custom parameters for this interface
-        # dev 0000:02:00.1 {
-        #      num-rx-queues 2
-        # }
-
-        ## Specify bonded interface and its slaves via PCI addresses
-        ##
-        ## Bonded interface in XOR load balance mode (mode 2) with L3 and L4 headers
-        # vdev eth_bond0,mode=2,slave=0000:02:00.0,slave=0000:03:00.0,xmit_policy=l34
-        # vdev eth_bond1,mode=2,slave=0000:02:00.1,slave=0000:03:00.1,xmit_policy=l34
-        ##
-        ## Bonded interface in Active-Back up mode (mode 1)
-        # vdev eth_bond0,mode=1,slave=0000:02:00.0,slave=0000:03:00.0
-        # vdev eth_bond1,mode=1,slave=0000:02:00.1,slave=0000:03:00.1
-
-        ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
-        ## uio_pci_generic or auto (default)
-        # uio-driver vfio-pci
-
-        ## Disable mutli-segment buffers, improves performance but
-        ## disables Jumbo MTU support
-        # no-multi-seg
-
-        ## Increase number of buffers allocated, needed only in scenarios with
-        ## large number of interfaces and worker threads. Value is per CPU socket.
-        ## Default is 16384
-        # num-mbufs 128000
-
-        ## Change hugepages allocation per-socket, needed only if there is need for
-        ## larger number of mbufs. Default is 256M on each detected CPU socket
-        # socket-mem 2048,2048
-
-        ## Disables UDP / TCP TX checksum offload. Typically needed for use
-        ## faster vector PMDs (together with no-multi-seg)
-        # no-tx-checksum-offload
-    # }
-
-
-    # plugins {
-        ## Adjusting the plugin path depending on where the VPP plugins are
-        #      path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins
-
-        ## Disable all plugins by default and then selectively enable specific plugins
-        # plugin default { disable }
-        # plugin dpdk_plugin.so { enable }
-        # plugin acl_plugin.so { enable }
-
-        ## Enable all plugins by default and then selectively disable specific plugins
-        # plugin dpdk_plugin.so { disable }
-        # plugin acl_plugin.so { disable }
-    # }
-
-        ## Alternate syntax to choose plugin path
-        # plugin_path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins
-
-**SW Crypto Device Configuration**
-
-::
-
-    $ cat /etc/vpp/startup.conf
-    unix
-    {
-      cli-listen /run/vpp/cli.sock
-      gid vpp
-      nodaemon
-      full-coredump
-      log /tmp/vpp.log
-    }
-    api-segment
-    {
-      gid vpp
-    }
-    dpdk
-    {
-      vdev cryptodev_aesni_gcm_pmd,socket_id=0
-      vdev cryptodev_aesni_mb_pmd,socket_id=0
-    }
+There is used the default startup configuration as defined in `VPP startup.conf`_
 
 TG Settings - Scapy
 -------------------
@@ -578,6 +419,7 @@ Example of TG node configuration:::
     TG:
         type: TG
         host: "10.30.51.155"
+        arch: x86_64
         port: 22
         username: cisco
         priv_key: |