CSIT-618 CSIT rls1707 Report - Update I
[csit.git] / docs / report / nsh_sfc_functional_tests / test_environment.rst
diff --git a/docs/report/nsh_sfc_functional_tests/test_environment.rst b/docs/report/nsh_sfc_functional_tests/test_environment.rst
new file mode 100644 (file)
index 0000000..79ca0e9
--- /dev/null
@@ -0,0 +1,440 @@
+Test Environment\r
+================\r
+\r
+CSIT NSH_SFC functional tests are currently executed in FD.IO VIRL testbed. The\r
+physical VIRL testbed infrastructure consists of three identical VIRL hosts:\r
+\r
+- All hosts are Cisco UCS C240-M4 (2x Intel(R) Xeon(R) CPU E5-2699 v3 @2.30GHz,\r
+  18c, 512GB RAM)\r
+- Hosts run Ubuntu 14.04.3\r
+- VIRL software versions:\r
+\r
+  - STD server version 0.10.24.7\r
+  - UWM server version 0.10.24.7\r
+\r
+The VIRL host to run VIRL simulation is selected based on least load algorithm\r
+per VIRL simulation.\r
+\r
+Every VIRL simulation uses the same three-node - Traffic Generator (TG node) and\r
+two Systems Under Test (SUT1 and SUT2) - "double-ring" topology. The appropriate\r
+pre-built VPP packages built by Jenkins for the patch under review are then\r
+installed on the two SUTs, along with their /etc/vpp/startup.conf file, in all\r
+VIRL simulations.\r
+\r
+SUT Configuration - VIRL Guest VM\r
+---------------------------------\r
+\r
+Configuration of the SUT VMs is defined in file\r
+\r
+   /csit/resources/tools/virl/topologies/double-ring-nested.xenial.virl\r
+\r
+- List of SUT VM interfaces:::\r
+\r
+    <interface id="0" name="GigabitEthernet0/4/0"/>\r
+    <interface id="1" name="GigabitEthernet0/5/0"/>\r
+    <interface id="2" name="GigabitEthernet0/6/0"/>\r
+    <interface id="3" name="GigabitEthernet0/7/0"/>\r
+\r
+- Number of 2MB hugepages: 1024\r
+\r
+- Maximum number of memory map areas: 20000\r
+\r
+- Kernel Shared Memory Max: 2147483648 (vm.nr_hugepages * 2 * 1024 * 1024)\r
+\r
+SUT Configuration - VIRL Guest OS Linux\r
+---------------------------------------\r
+\r
+In CSIT terminology, the VM operating system for both SUTs that |vpp-release| has\r
+been tested with, is the following:\r
+\r
+**#. Ubuntu VIRL image**\r
+\r
+This image implies Ubuntu 16.04.1 LTS, current as of yyyy-mm-dd (that is,\r
+package versions are those that would have been installed by a "apt-get update",\r
+"apt-get upgrade" on that day), produced by CSIT disk image build scripts.\r
+\r
+The exact list of installed packages and their versions (including the Linux\r
+kernel package version) are included in CSIT source repository:\r
+\r
+  resources/tools/disk-image-builder/ubuntu/lists/|virl-image-ubuntu|\r
+\r
+A replica of this VM image can be built by running the "build.sh" script in CSIT\r
+repository resources/tools/disk-image-builder/ubuntu.\r
+\r
+**#. CentOS VIRL image**\r
+\r
+The Centos7.3 image is ready to be used but no tests running on it now.\r
+Corresponding Jenkins jobs are under preparation.\r
+\r
+The exact list of installed packages and their versions (including the Linux\r
+kernel package version) are included in CSIT source repository:\r
+\r
+  resources/tools/disk-image-builder/ubuntu/lists/|virl-image-centos|\r
+\r
+A replica of this VM image can be built by running the "build.sh" script in CSIT\r
+repository resources/tools/disk-image-builder/centos.\r
+\r
+**#. Nested VM image**\r
+\r
+In addition to the "main" VM image, tests which require VPP to communicate to a\r
+VM over a vhost-user interface, utilize a "nested" VM image.\r
+\r
+This "nested" VM is dynamically created and destroyed as part of a test case,\r
+and therefore the "nested" VM image is optimized to be small, lightweight and\r
+have a short boot time. The "nested" VM image is not built around any\r
+established Linux distribution, but is based on `BuildRoot\r
+<https://buildroot.org/>`_, a tool for building embedded Linux systems. Just as\r
+for the "main" image, scripts to produce an identical replica of the "nested"\r
+image are included in CSIT GIT repository, and the image can be rebuilt using\r
+the "build.sh" script at:\r
+\r
+   resources/tools/disk-image-builder/ubuntu/lists/nested\r
+\r
+DUT Configuration - VPP\r
+-----------------------\r
+\r
+Every System Under Test runs VPP SW application in Linux user-mode as a Device\r
+Under Test (DUT) node.\r
+\r
+**DUT port configuration**\r
+\r
+Port configuration of DUTs is defined in topology file that is generated per\r
+VIRL simulation based on the definition stored in file\r
+\r
+   /csit/resources/tools/virl/topologies/double-ring-nested.xenial.yaml\r
+\r
+Example of DUT nodes configuration:::\r
+\r
+    DUT1:\r
+        type: DUT\r
+        host: "10.30.51.157"\r
+        port: 22\r
+        username: cisco\r
+        honeycomb:\r
+          user: admin\r
+          passwd: admin\r
+          port: 8183\r
+          netconf_port: 2831\r
+        priv_key: |\r
+          -----BEGIN RSA PRIVATE KEY-----\r
+          MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb\r
+          v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd\r
+          vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2\r
+          4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc\r
+          1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs\r
+          8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7\r
+          0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN\r
+          EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN\r
+          0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU\r
+          MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD\r
+          p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW\r
+          79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG\r
+          OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD\r
+          GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef\r
+          bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg\r
+          8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu\r
+          f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u\r
+          UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/\r
+          +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT\r
+          D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/\r
+          sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn\r
+          g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY\r
+          qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8\r
+          EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD\r
+          BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN\r
+          -----END RSA PRIVATE KEY-----\r
+\r
+        interfaces:\r
+          port1:\r
+            mac_address: "fa:16:3e:9b:89:52"\r
+            pci_address: "0000:00:04.0"\r
+            link: link1\r
+          port2:\r
+            mac_address: "fa:16:3e:7a:33:60"\r
+            pci_address: "0000:00:05.0"\r
+            link: link4\r
+          port3:\r
+            mac_address: "fa:16:3e:29:b7:ae"\r
+            pci_address: "0000:00:06.0"\r
+            link: link3\r
+          port4:\r
+            mac_address: "fa:16:3e:76:8d:ff"\r
+            pci_address: "0000:00:07.0"\r
+            link: link6\r
+      DUT2:\r
+        type: DUT\r
+        host: "10.30.51.156"\r
+        port: 22\r
+        username: cisco\r
+        honeycomb:\r
+          user: admin\r
+          passwd: admin\r
+          port: 8183\r
+          netconf_port: 2831\r
+        priv_key: |\r
+          -----BEGIN RSA PRIVATE KEY-----\r
+          MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb\r
+          v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd\r
+          vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2\r
+          4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc\r
+          1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs\r
+          8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7\r
+          0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN\r
+          EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN\r
+          0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU\r
+          MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD\r
+          p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW\r
+          79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG\r
+          OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD\r
+          GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef\r
+          bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg\r
+          8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu\r
+          f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u\r
+          UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/\r
+          +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT\r
+          D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/\r
+          sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn\r
+          g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY\r
+          qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8\r
+          EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD\r
+          BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN\r
+          -----END RSA PRIVATE KEY-----\r
+\r
+        interfaces:\r
+          port1:\r
+            mac_address: "fa:16:3e:ad:6c:7d"\r
+            pci_address: "0000:00:04.0"\r
+            link: link2\r
+          port2:\r
+            mac_address: "fa:16:3e:94:a4:99"\r
+            pci_address: "0000:00:05.0"\r
+            link: link5\r
+          port3:\r
+            mac_address: "fa:16:3e:75:92:da"\r
+            pci_address: "0000:00:06.0"\r
+            link: link3\r
+          port4:\r
+            mac_address: "fa:16:3e:2c:b1:2a"\r
+            pci_address: "0000:00:07.0"\r
+            link: link6\r
+\r
+**VPP Version**\r
+\r
+|vpp-release|\r
+\r
+**VPP Installed Packages**\r
+::\r
+\r
+    $ dpkg -l vpp\*\r
+    Desired=Unknown/Install/Remove/Purge/Hold\r
+    | 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
+**VPP Startup Configuration**\r
+\r
+VPP startup configuration is common for all test cases.\r
+\r
+::\r
+\r
+    $ cat /etc/vpp/startup.conf\r
+    unix {\r
+      nodaemon\r
+      log /tmp/vpp.log\r
+      full-coredump\r
+    }\r
+\r
+    api-trace {\r
+      on\r
+    }\r
+\r
+    api-segment {\r
+      gid vpp\r
+    }\r
+\r
+    cpu {\r
+        ## In the VPP there is one main thread and optionally the user can create worker(s)\r
+        ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically\r
+\r
+        ## Manual pinning of thread(s) to CPU core(s)\r
+\r
+        ## Set logical CPU core where main thread runs\r
+        # main-core 1\r
+\r
+        ## Set logical CPU core(s) where worker threads are running\r
+        # corelist-workers 2-3,18-19\r
+\r
+        ## Automatic pinning of thread(s) to CPU core(s)\r
+\r
+        ## Sets number of CPU core(s) to be skipped (1 ... N-1)\r
+        ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).\r
+        ## The main thread is automatically pinned to the first available CPU core and worker(s)\r
+        ## are pinned to next free CPU core(s) after core assigned to main thread\r
+        # skip-cores 4\r
+\r
+        ## Specify a number of workers to be created\r
+        ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)\r
+        ## and main thread's CPU core\r
+        # workers 2\r
+\r
+        ## Set scheduling policy and priority of main and worker threads\r
+\r
+        ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)\r
+        ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)\r
+        # scheduler-policy fifo\r
+\r
+        ## Scheduling priority is used only for "real-time policies (fifo and rr),\r
+        ## and has to be in the range of priorities supported for a particular policy\r
+        # scheduler-priority 50\r
+    }\r
+\r
+    dpdk {\r
+        ## Change default settings for all intefaces\r
+        # dev default {\r
+            ## Number of receive queues, enables RSS\r
+            ## Default is 1\r
+            # num-rx-queues 3\r
+\r
+            ## Number of transmit queues, Default is equal\r
+            ## to number of worker threads or 1 if no workers treads\r
+            # num-tx-queues 3\r
+\r
+            ## Number of descriptors in transmit and receive rings\r
+            ## increasing or reducing number can impact performance\r
+            ## Default is 1024 for both rx and tx\r
+            # num-rx-desc 512\r
+            # num-tx-desc 512\r
+\r
+            ## VLAN strip offload mode for interface\r
+            ## Default is off\r
+            # vlan-strip-offload on\r
+        # }\r
+\r
+        ## Whitelist specific interface by specifying PCI address\r
+        # dev 0000:02:00.0\r
+\r
+        ## Whitelist specific interface by specifying PCI address and in\r
+        ## addition specify custom parameters for this interface\r
+        # dev 0000:02:00.1 {\r
+        #      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
+\r
+        ## Disable mutli-segment buffers, improves performance but\r
+        ## disables Jumbo MTU support\r
+        # no-multi-seg\r
+\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
+        # 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
+\r
+TG Configuration\r
+----------------\r
+\r
+Traffic Generator node is VM running the same OS Linux as SUTs. Ports of this\r
+VM are used as source (Tx) and destination (Rx) ports for the traffic.\r
+\r
+Traffic scripts of test cases are executed on this VM.\r
+\r
+**TG VM configuration**\r
+\r
+Configuration of the TG VMs is defined in file\r
+\r
+   /csit/resources/tools/virl/topologies/double-ring-nested.xenial.virl\r
+\r
+- List of TG VM interfaces:::\r
+\r
+    <interface id="0" name="eth1"/>\r
+    <interface id="1" name="eth2"/>\r
+    <interface id="2" name="eth3"/>\r
+    <interface id="3" name="eth4"/>\r
+    <interface id="4" name="eth5"/>\r
+    <interface id="5" name="eth6"/>\r
+\r
+**TG node port configuration**\r
+\r
+Port configuration of TG is defined in topology file that is generated per VIRL\r
+simulation based on the definition stored in file\r
+\r
+   /csit/resources/tools/virl/topologies/double-ring-nested.xenial.yaml\r
+\r
+Example of TG node configuration:::\r
+\r
+    TG:\r
+        type: TG\r
+        host: "10.30.51.155"\r
+        port: 22\r
+        username: cisco\r
+        priv_key: |\r
+          -----BEGIN RSA PRIVATE KEY-----\r
+          MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb\r
+          v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd\r
+          vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2\r
+          4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc\r
+          1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs\r
+          8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7\r
+          0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN\r
+          EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN\r
+          0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU\r
+          MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD\r
+          p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW\r
+          79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG\r
+          OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD\r
+          GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef\r
+          bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg\r
+          8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu\r
+          f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u\r
+          UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/\r
+          +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT\r
+          D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/\r
+          sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn\r
+          g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY\r
+          qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8\r
+          EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD\r
+          BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN\r
+          -----END RSA PRIVATE KEY-----\r
+\r
+        interfaces:\r
+          port3:\r
+            mac_address: "fa:16:3e:b9:e1:27"\r
+            pci_address: "0000:00:06.0"\r
+            link: link1\r
+            driver: virtio-pci\r
+          port4:\r
+            mac_address: "fa:16:3e:e9:c8:68"\r
+            pci_address: "0000:00:07.0"\r
+            link: link4\r
+            driver: virtio-pci\r
+          port5:\r
+            mac_address: "fa:16:3e:e8:d3:47"\r
+            pci_address: "0000:00:08.0"\r
+            link: link2\r
+            driver: virtio-pci\r
+          port6:\r
+            mac_address: "fa:16:3e:cf:ca:58"\r
+            pci_address: "0000:00:09.0"\r
+            link: link5\r
+            driver: virtio-pci\r
+\r
+**Traffic generator**\r
+\r
+Functional tests utilize Scapy as a traffic generator. There was used Scapy\r
+v2.3.1 for |vpp-release| tests.\r
+\r