X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_functional_tests%2Ftest_environment.rst;h=10a50a5e32c07f6847115cc380ad90b2ff8343e0;hp=1d00263ab834a4807c1935b20e3a664e0d25c81f;hb=c1fc33a96cb00139dc2e8cc99cac8674556e7249;hpb=ab0b18bf513bb292b5d24d2eb339c2dddfbcd955 diff --git a/docs/report/vpp_functional_tests/test_environment.rst b/docs/report/vpp_functional_tests/test_environment.rst index 1d00263ab8..10a50a5e32 100644 --- a/docs/report/vpp_functional_tests/test_environment.rst +++ b/docs/report/vpp_functional_tests/test_environment.rst @@ -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 - ## - ## To save the api message table decode tables, configure a filename. Results in /tmp/ - ## Very handy for understanding api message changes between versions, identifying missing - ## plugins, and so forth. - ## - ## save-api-table - } - - 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: |