docs/report/vpp_functional_tests/test_environment.rst

   1 Test Environment
   2 ================
   3
   4 CSIT functional tests are currently executed in FD.IO VIRL testbed. The physical
   5 VIRL testbed infrastructure consists of three VIRL hosts:
   6
   7 - All hosts are Cisco UCS C240-M4 (2x Intel(R) Xeon(R) CPU E5-2699 v3 @2.30GHz,
   8   18c, 512GB RAM)
   9
  10 - tb4-virl1:
  11
  12   - Status: Production
  13   - OS: Ubuntu 16.04.2
  14   - STD server version 0.10.32.16
  15   - UWM server version 0.10.32.16
  16
  17 - tb4-virl2:
  18
  19   - Status: Production
  20   - OS: Ubuntu 16.04.2
  21   - STD server version 0.10.32.16
  22   - UWM server version 0.10.32.16
  23
  24 - tb4-virl3:
  25
  26   - Status: Testing
  27   - OS: Ubuntu 16.04.2
  28   - STD server version 0.10.32.19
  29   - UWM server version 0.10.32.19
  30
  31 Whenever a patch is submitted to gerrit for review, parallel VIRL simulations
  32 are started to reduce the time of execution of all functional tests. The number
  33 of parallel VIRL simulations is equal to number of test groups defined by
  34 TEST_GROUPS variable in :file:`csit/bootstrap.sh` file. The VIRL host to run
  35 VIRL simulation is selected based on least load algorithm per VIRL simulation.
  36
  37 Every VIRL simulation uses the same three-node - Traffic Generator (TG node) and
  38 two Systems Under Test (SUT1 and SUT2) - "double-ring" topology. The appropriate
  39 pre-built VPP packages built by Jenkins for the patch under review are then
  40 installed on the two SUTs, along with their :file:`/etc/vpp/startup.conf` file,
  41 in all VIRL simulations.
  42
  43 SUT Configuration - VIRL Guest VM
  44 ---------------------------------
  45
  46 Configurations of the SUT VMs is defined in `VIRL topologies directory`_
  47
  48 - List of SUT VM interfaces:::
  49
  50     <interface id="0" name="GigabitEthernet0/4/0"/>
  51     <interface id="1" name="GigabitEthernet0/5/0"/>
  52     <interface id="2" name="GigabitEthernet0/6/0"/>
  53     <interface id="3" name="GigabitEthernet0/7/0"/>
  54
  55 - Number of 2MB hugepages: 1024
  56
  57 - Maximum number of memory map areas: 20000
  58
  59 - Kernel Shared Memory Max: 2147483648 (vm.nr_hugepages * 2 * 1024 * 1024)
  60
  61 SUT Configuration - VIRL Guest OS Linux
  62 ---------------------------------------
  63
  64 In CSIT terminology, the VM operating system for both SUTs that |vpp-release| has
  65 been tested with, is the following:
  66
  67 #. **Ubuntu VIRL image**
  68
  69    This image implies Ubuntu 16.04.1 LTS, current as of yyyy-mm-dd (that is,
  70    package versions are those that would have been installed by a
  71    :command:`apt-get update`, :command:`apt-get upgrade` on that day), produced
  72    by CSIT disk image build scripts.
  73
  74    The exact list of installed packages and their versions (including the Linux
  75    kernel package version) are included in `VIRL ubuntu images lists`_.
  76
  77    A replica of this VM image can be built by running the :command:`build.sh`
  78    script in CSIT repository.
  79
  80 #. **CentOS VIRL image**
  81
  82    This image implies Centos 7.4-1711, current as of yyyy-mm-dd (that is,
  83    package versions are those that would have been installed by a
  84    :command:`yum update`, :command:`yum upgrade` on that day), produced
  85    by CSIT disk image build scripts.
  86
  87    The exact list of installed packages and their versions (including the Linux
  88    kernel package version) are included in `VIRL centos images lists`_.
  89
  90    A replica of this VM image can be built by running the :command:`build.sh`
  91    script in CSIT repository.
  92
  93 #. **Nested VM image**
  94
  95    In addition to the "main" VM image, tests which require VPP to communicate to
  96    a VM over a vhost-user interface, utilize a "nested" VM image.
  97
  98    This "nested" VM is dynamically created and destroyed as part of a test case,
  99    and therefore the "nested" VM image is optimized to be small, lightweight and
 100    have a short boot time. The "nested" VM image is not built around any
 101    established Linux distribution, but is based on `BuildRoot
 102    <https://buildroot.org/>`_, a tool for building embedded Linux systems. Just
 103    as for the "main" image, scripts to produce an identical replica of the
 104    "nested" image are included in CSIT GIT repository, and the image can be
 105    rebuilt using the "build.sh" script at `VIRL nested`_.
 106
 107 DUT Configuration - VPP
 108 -----------------------
 109
 110 Every System Under Test runs VPP SW application in Linux user-mode as a Device
 111 Under Test (DUT) node.
 112
 113 **DUT port configuration**
 114
 115 Port configuration of DUTs is defined in topology file that is generated per
 116 VIRL simulation based on the definition stored in `VIRL topologies directory`_.
 117
 118 Example of DUT nodes configuration:::
 119
 120     DUT1:
 121         type: DUT
 122         host: "10.30.51.157"
 123         port: 22
 124         username: cisco
 125         honeycomb:
 126           user: admin
 127           passwd: admin
 128           port: 8183
 129           netconf_port: 2831
 130         priv_key: |
 131           -----BEGIN RSA PRIVATE KEY-----
 132           MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb
 133           v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd
 134           vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2
 135           4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc
 136           1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs
 137           8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7
 138           0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN
 139           EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN
 140           0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU
 141           MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD
 142           p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW
 143           79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG
 144           OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD
 145           GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef
 146           bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg
 147           8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu
 148           f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u
 149           UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/
 150           +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT
 151           D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/
 152           sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn
 153           g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY
 154           qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8
 155           EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD
 156           BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN
 157           -----END RSA PRIVATE KEY-----
 158
 159         interfaces:
 160           port1:
 161             mac_address: "fa:16:3e:9b:89:52"
 162             pci_address: "0000:00:04.0"
 163             link: link1
 164           port2:
 165             mac_address: "fa:16:3e:7a:33:60"
 166             pci_address: "0000:00:05.0"
 167             link: link4
 168           port3:
 169             mac_address: "fa:16:3e:29:b7:ae"
 170             pci_address: "0000:00:06.0"
 171             link: link3
 172           port4:
 173             mac_address: "fa:16:3e:76:8d:ff"
 174             pci_address: "0000:00:07.0"
 175             link: link6
 176       DUT2:
 177         type: DUT
 178         host: "10.30.51.156"
 179         port: 22
 180         username: cisco
 181         honeycomb:
 182           user: admin
 183           passwd: admin
 184           port: 8183
 185           netconf_port: 2831
 186         priv_key: |
 187           -----BEGIN RSA PRIVATE KEY-----
 188           MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb
 189           v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd
 190           vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2
 191           4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc
 192           1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs
 193           8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7
 194           0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN
 195           EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN
 196           0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU
 197           MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD
 198           p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW
 199           79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG
 200           OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD
 201           GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef
 202           bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg
 203           8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu
 204           f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u
 205           UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/
 206           +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT
 207           D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/
 208           sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn
 209           g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY
 210           qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8
 211           EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD
 212           BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN
 213           -----END RSA PRIVATE KEY-----
 214
 215         interfaces:
 216           port1:
 217             mac_address: "fa:16:3e:ad:6c:7d"
 218             pci_address: "0000:00:04.0"
 219             link: link2
 220           port2:
 221             mac_address: "fa:16:3e:94:a4:99"
 222             pci_address: "0000:00:05.0"
 223             link: link5
 224           port3:
 225             mac_address: "fa:16:3e:75:92:da"
 226             pci_address: "0000:00:06.0"
 227             link: link3
 228           port4:
 229             mac_address: "fa:16:3e:2c:b1:2a"
 230             pci_address: "0000:00:07.0"
 231             link: link6
 232
 233 **VPP Version**
 234
 235 |vpp-release|
 236
 237 **VPP Installed Packages - Ubuntu**
 238 ::
 239
 240     $ dpkg -l vpp\*
 241     Desired=Unknown/Install/Remove/Purge/Hold
 242     | Status=Not/Inst/Conf-files/Unpacked/halF-conf/Half-inst/trig-aWait/Trig-pend
 243     |/ Err?=(none)/Reinst-required (Status,Err: uppercase=bad)
 244     ||/ Name           Version       Architecture Description
 245     +++-==============-=============-============-=================================================
 246     ii  vpp            18.04-release amd64        Vector Packet Processing--executables
 247     ii  vpp-dbg        18.04-release amd64        Vector Packet Processing--debug symbols
 248     ii  vpp-dev        18.04-release amd64        Vector Packet Processing--development support
 249     ii  vpp-dpdk-dkms  18.02-vpp1    amd64        DPDK Development Package for VPP - Kernel Modules
 250     ii  vpp-lib        18.04-release amd64        Vector Packet Processing--runtime libraries
 251     ii  vpp-plugins    18.04-release amd64        Vector Packet Processing--runtime plugins
 252
 253 **VPP Installed Packages - Centos**
 254 ::
 255
 256     $ rpm -qai vpp*
 257     Name        : vpp
 258     Version     : 18.04
 259     Release     : release
 260     Architecture: x86_64
 261     Install Date: Fri 04 May 2018 02:47:36 AM EDT
 262     Group       : Unspecified
 263     Size        : 2311324
 264     License     : ASL 2.0
 265     Signature   : (none)
 266     Source RPM  : vpp-18.04-release.src.rpm
 267     Build Date  : Wed 25 Apr 2018 01:00:24 PM EDT
 268     Build Host  : c29a51c12e88
 269     Relocations : (not relocatable)
 270     Summary     : Vector Packet Processing
 271     Description :
 272     This package provides VPP executables: vpp, vpp_api_test, vpp_json_test
 273     vpp - the vector packet engine
 274     vpp_api_test - vector packet engine API test tool
 275     vpp_json_test - vector packet engine JSON test tool
 276     Name        : vpp-lib
 277     Version     : 18.04
 278     Release     : release
 279     Architecture: x86_64
 280     Install Date: Fri 04 May 2018 02:47:36 AM EDT
 281     Group       : System Environment/Libraries
 282     Size        : 24949034
 283     License     : ASL 2.0
 284     Signature   : (none)
 285     Source RPM  : vpp-18.04-release.src.rpm
 286     Build Date  : Wed 25 Apr 2018 01:00:24 PM EDT
 287     Build Host  : c29a51c12e88
 288     Relocations : (not relocatable)
 289     Summary     : VPP libraries
 290     Description :
 291     This package contains the VPP shared libraries, including:
 292     vppinfra - foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
 293     svm - vm library
 294     vlib - vector processing library
 295     vlib-api - binary API library
 296     vnet -  network stack library
 297     Name        : vpp-selinux-policy
 298     Version     : 18.04
 299     Release     : release
 300     Architecture: x86_64
 301     Install Date: Fri 04 May 2018 02:47:35 AM EDT
 302     Group       : System Environment/Base
 303     Size        : 86170
 304     License     : ASL 2.0
 305     Signature   : (none)
 306     Source RPM  : vpp-18.04-release.src.rpm
 307     Build Date  : Wed 25 Apr 2018 01:00:24 PM EDT
 308     Build Host  : c29a51c12e88
 309     Relocations : (not relocatable)
 310     Summary     : VPP Security-Enhanced Linux (SELinux) policy
 311     Description :
 312     This package contains a tailored VPP SELinux policy
 313     Name        : vpp-devel
 314     Version     : 18.04
 315     Release     : release
 316     Architecture: x86_64
 317     Install Date: Fri 04 May 2018 02:47:38 AM EDT
 318     Group       : Development/Libraries
 319     Size        : 10632218
 320     License     : ASL 2.0
 321     Signature   : (none)
 322     Source RPM  : vpp-18.04-release.src.rpm
 323     Build Date  : Wed 25 Apr 2018 01:00:24 PM EDT
 324     Build Host  : c29a51c12e88
 325     Relocations : (not relocatable)
 326     Summary     : VPP header files, static libraries
 327     Description :
 328     This package contains the header files for VPP.
 329     Install this package if you want to write a
 330     program for compilation and linking with vpp lib.
 331     vlib
 332     vlibmemory
 333     vnet - devices, classify, dhcp, ethernet flow, gre, ip, etc.
 334     vpp-api
 335     vppinfra
 336     Name        : vpp-plugins
 337     Version     : 18.04
 338     Release     : release
 339     Architecture: x86_64
 340     Install Date: Fri 04 May 2018 02:47:37 AM EDT
 341     Group       : System Environment/Libraries
 342     Size        : 44145968
 343     License     : ASL 2.0
 344     Signature   : (none)
 345     Source RPM  : vpp-18.04-release.src.rpm
 346     Build Date  : Wed 25 Apr 2018 01:00:24 PM EDT
 347     Build Host  : c29a51c12e88
 348     Relocations : (not relocatable)
 349     Summary     : Vector Packet Processing--runtime plugins
 350     Description :
 351     This package contains VPP plugins
 352
 353 **VPP Startup Configuration**
 354
 355 VPP startup configuration is common for all test cases except test cases related
 356 to SW Crypto device.
 357
 358 **Default**
 359
 360 ::
 361
 362     $ cat /etc/vpp/startup.conf
 363     unix {
 364       nodaemon
 365       log /var/log/vpp/vpp.log
 366       full-coredump
 367       cli-listen /run/vpp/cli.sock
 368       gid vpp
 369     }
 370
 371     api-trace {
 372     ## This stanza controls binary API tracing. Unless there is a very strong reason,
 373     ## please leave this feature enabled.
 374       on
 375     ## Additional parameters:
 376     ##
 377     ## To set the number of binary API trace records in the circular buffer, configure nitems
 378     ##
 379     ## nitems <nnn>
 380     ##
 381     ## To save the api message table decode tables, configure a filename. Results in /tmp/<filename>
 382     ## Very handy for understanding api message changes between versions, identifying missing
 383     ## plugins, and so forth.
 384     ##
 385     ## save-api-table <filename>
 386     }
 387
 388     api-segment {
 389       gid vpp
 390     }
 391
 392     cpu {
 393         ## In the VPP there is one main thread and optionally the user can create worker(s)
 394         ## The main thread and worker thread(s) can be pinned to CPU core(s) manually or automatically
 395
 396         ## Manual pinning of thread(s) to CPU core(s)
 397
 398         ## Set logical CPU core where main thread runs
 399         # main-core 1
 400
 401         ## Set logical CPU core(s) where worker threads are running
 402         # corelist-workers 2-3,18-19
 403
 404         ## Automatic pinning of thread(s) to CPU core(s)
 405
 406         ## Sets number of CPU core(s) to be skipped (1 ... N-1)
 407         ## Skipped CPU core(s) are not used for pinning main thread and working thread(s).
 408         ## The main thread is automatically pinned to the first available CPU core and worker(s)
 409         ## are pinned to next free CPU core(s) after core assigned to main thread
 410         # skip-cores 4
 411
 412         ## Specify a number of workers to be created
 413         ## Workers are pinned to N consecutive CPU cores while skipping "skip-cores" CPU core(s)
 414         ## and main thread's CPU core
 415         # workers 2
 416
 417         ## Set scheduling policy and priority of main and worker threads
 418
 419         ## Scheduling policy options are: other (SCHED_OTHER), batch (SCHED_BATCH)
 420         ## idle (SCHED_IDLE), fifo (SCHED_FIFO), rr (SCHED_RR)
 421         # scheduler-policy fifo
 422
 423         ## Scheduling priority is used only for "real-time policies (fifo and rr),
 424         ## and has to be in the range of priorities supported for a particular policy
 425         # scheduler-priority 50
 426     }
 427
 428     # dpdk {
 429         ## Change default settings for all intefaces
 430         # dev default {
 431             ## Number of receive queues, enables RSS
 432             ## Default is 1
 433             # num-rx-queues 3
 434
 435             ## Number of transmit queues, Default is equal
 436             ## to number of worker threads or 1 if no workers treads
 437             # num-tx-queues 3
 438
 439             ## Number of descriptors in transmit and receive rings
 440             ## increasing or reducing number can impact performance
 441             ## Default is 1024 for both rx and tx
 442             # num-rx-desc 512
 443             # num-tx-desc 512
 444
 445             ## VLAN strip offload mode for interface
 446             ## Default is off
 447             # vlan-strip-offload on
 448         # }
 449
 450         ## Whitelist specific interface by specifying PCI address
 451         # dev 0000:02:00.0
 452
 453         ## Whitelist specific interface by specifying PCI address and in
 454         ## addition specify custom parameters for this interface
 455         # dev 0000:02:00.1 {
 456         #       num-rx-queues 2
 457         # }
 458
 459         ## Specify bonded interface and its slaves via PCI addresses
 460         ##
 461         ## Bonded interface in XOR load balance mode (mode 2) with L3 and L4 headers
 462         # vdev eth_bond0,mode=2,slave=0000:02:00.0,slave=0000:03:00.0,xmit_policy=l34
 463         # vdev eth_bond1,mode=2,slave=0000:02:00.1,slave=0000:03:00.1,xmit_policy=l34
 464         ##
 465         ## Bonded interface in Active-Back up mode (mode 1)
 466         # vdev eth_bond0,mode=1,slave=0000:02:00.0,slave=0000:03:00.0
 467         # vdev eth_bond1,mode=1,slave=0000:02:00.1,slave=0000:03:00.1
 468
 469         ## Change UIO driver used by VPP, Options are: igb_uio, vfio-pci,
 470         ## uio_pci_generic or auto (default)
 471         # uio-driver vfio-pci
 472
 473         ## Disable mutli-segment buffers, improves performance but
 474         ## disables Jumbo MTU support
 475         # no-multi-seg
 476
 477         ## Increase number of buffers allocated, needed only in scenarios with
 478         ## large number of interfaces and worker threads. Value is per CPU socket.
 479         ## Default is 16384
 480         # num-mbufs 128000
 481
 482         ## Change hugepages allocation per-socket, needed only if there is need for
 483         ## larger number of mbufs. Default is 256M on each detected CPU socket
 484         # socket-mem 2048,2048
 485
 486         ## Disables UDP / TCP TX checksum offload. Typically needed for use
 487         ## faster vector PMDs (together with no-multi-seg)
 488         # no-tx-checksum-offload
 489     # }
 490
 491
 492     # plugins {
 493         ## Adjusting the plugin path depending on where the VPP plugins are
 494         #       path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins
 495
 496         ## Disable all plugins by default and then selectively enable specific plugins
 497         # plugin default { disable }
 498         # plugin dpdk_plugin.so { enable }
 499         # plugin acl_plugin.so { enable }
 500
 501         ## Enable all plugins by default and then selectively disable specific plugins
 502         # plugin dpdk_plugin.so { disable }
 503         # plugin acl_plugin.so { disable }
 504     # }
 505
 506         ## Alternate syntax to choose plugin path
 507         # plugin_path /home/bms/vpp/build-root/install-vpp-native/vpp/lib64/vpp_plugins
 508
 509 **SW Crypto Device**
 510
 511 ::
 512
 513     $ cat /etc/vpp/startup.conf
 514     unix
 515     {
 516       cli-listen /run/vpp/cli.sock
 517       gid vpp
 518       nodaemon
 519       full-coredump
 520       log /tmp/vpp.log
 521     }
 522     api-segment
 523     {
 524       gid vpp
 525     }
 526     dpdk
 527     {
 528       vdev cryptodev_aesni_gcm_pmd,socket_id=0
 529       vdev cryptodev_aesni_mb_pmd,socket_id=0
 530     }
 531
 532 TG Configuration
 533 ----------------
 534
 535 Traffic Generator node is VM running the same OS Linux as SUTs. Ports of this
 536 VM are used as source (Tx) and destination (Rx) ports for the traffic.
 537
 538 Traffic scripts of test cases are executed on this VM.
 539
 540 **TG VM configuration**
 541
 542 Configuration of the TG VMs is defined in `VIRL topologies directory`_.
 543
 544    /csit/resources/tools/virl/topologies/double-ring-nested.xenial.virl
 545
 546 - List of TG VM interfaces:::
 547
 548     <interface id="0" name="eth1"/>
 549     <interface id="1" name="eth2"/>
 550     <interface id="2" name="eth3"/>
 551     <interface id="3" name="eth4"/>
 552     <interface id="4" name="eth5"/>
 553     <interface id="5" name="eth6"/>
 554
 555 **TG node port configuration**
 556
 557 Port configuration of TG is defined in topology file that is generated per VIRL
 558 simulation based on the definition stored in `VIRL topologies directory`_.
 559
 560 Example of TG node configuration:::
 561
 562     TG:
 563         type: TG
 564         host: "10.30.51.155"
 565         port: 22
 566         username: cisco
 567         priv_key: |
 568           -----BEGIN RSA PRIVATE KEY-----
 569           MIIEpgIBAAKCAQEAwUDlTpzSHpwLQotZOFS4AgcPNEWCnP1AB2hWFmvI+8Kah/gb
 570           v8ruZU9RqhPs56tyKzxbhvNkY4VbH5F1GilHZu3mLqzM4KfghMmaeMEjO1T7BYYd
 571           vuBfTvIluljfQ2vAlnYrDwn+ClxJk81m0pDgvrLEX4qVVh2sGh7UEkYy5r82DNa2
 572           4VjzPB1J/c8a9zP8FoZUhYIzF4FLvRMjUADpbMXgJMsGpaZLmz95ap0Eot7vb1Cc
 573           1LvF97iyBCrtIOSKRKA50ZhLGjMKmOwnYU+cP5718tbproDVi6VJOo7zeuXyetMs
 574           8YBl9kWblWG9BqP9jctFvsmi5G7hXgq1Y8u+DwIDAQABAoIBAQC/W4E0DHjLMny7
 575           0bvw2YKzD0Zw3fttdB94tkm4PdZv5MybooPnsAvLaXVV0hEdfVi5kzSWNl/LY/tN
 576           EP1BgGphc2QgB59/PPxGwFIjDCvUzlsZpynBHe+B/qh5ExNQcVvsIOqWI7DXlXaN
 577           0i/khOzmJ6HncRRah1spKimYRsaUUDskyg7q3QqMWVaqBbbMvLs/w7ZWd/zoDqCU
 578           MY/pCI6hkB3QbRo0OdiZLohphBl2ShABTwjvVyyKL5UA4jAEneJrhH5gWVLXnfgD
 579           p62W5CollKEYblC8mUkPxpP7Qo277zw3xaq+oktIZhc5SUEUd7nJZtNqVAHqkItW
 580           79VmpKyxAoGBAPfU+kqNPaTSvp+x1n5sn2SgipzDtgi9QqNmC4cjtrQQaaqI57SG
 581           OHw1jX8i7L2G1WvVtkHg060nlEVo5n65ffFOqeVBezLVJ7ghWI8U+oBiJJyQ4boD
 582           GJVNsoOSUQ0rtuGd9eVwfDk3ol9aCN0KK53oPfIYli29pyu4l095kg11AoGBAMef
 583           bPEMBI/2XmCPshLSwhGFl+dW8d+Klluj3CUQ/0vUlvma3dfBOYNsIwAgTP0iIUTg
 584           8DYE6KBCdPtxAUEI0YAEAKB9ry1tKR2NQEIPfslYytKErtwjAiqSi0heM6+zwEzu
 585           f54Z4oBhsMSL0jXoOMnu+NZzEc6EUdQeY4O+jhjzAoGBAIogC3dtjMPGKTP7+93u
 586           UE/XIioI8fWg9fj3sMka4IMu+pVvRCRbAjRH7JrFLkjbUyuMqs3Arnk9K+gbdQt/
 587           +m95Njtt6WoFXuPCwgbM3GidSmZwYT4454SfDzVBYScEDCNm1FuR+8ov9bFLDtGT
 588           D4gsngnGJj1MDFXTxZEn4nzZAoGBAKCg4WmpUPaCuXibyB+rZavxwsTNSn2lJ83/
 589           sYJGBhf/raiV/FLDUcM1vYg5dZnu37RsB/5/vqxOLZGyYd7x+Jo5HkQGPnKgNwhn
 590           g8BkdZIRF8uEJqxOo0ycdOU7n/2O93swIpKWo5LIiRPuqqzj+uZKnAL7vuVdxfaY
 591           qVz2daMPAoGBALgaaKa3voU/HO1PYLWIhFrBThyJ+BQSQ8OqrEzC8AnegWFxRAM8
 592           EqrzZXl7ACUuo1dH0Eipm41j2+BZWlQjiUgq5uj8+yzy+EU1ZRRyJcOKzbDACeuD
 593           BpWWSXGBI5G4CppeYLjMUHZpJYeX1USULJQd2c4crLJKb76E8gz3Z9kN
 594           -----END RSA PRIVATE KEY-----
 595
 596         interfaces:
 597           port3:
 598             mac_address: "fa:16:3e:b9:e1:27"
 599             pci_address: "0000:00:06.0"
 600             link: link1
 601             driver: virtio-pci
 602           port4:
 603             mac_address: "fa:16:3e:e9:c8:68"
 604             pci_address: "0000:00:07.0"
 605             link: link4
 606             driver: virtio-pci
 607           port5:
 608             mac_address: "fa:16:3e:e8:d3:47"
 609             pci_address: "0000:00:08.0"
 610             link: link2
 611             driver: virtio-pci
 612           port6:
 613             mac_address: "fa:16:3e:cf:ca:58"
 614             pci_address: "0000:00:09.0"
 615             link: link5
 616             driver: virtio-pci
 617
 618 **Traffic generator**
 619
 620 Functional tests utilize Scapy as a traffic generator. There was used Scapy
 621 v2.3.1 for |vpp-release| tests.
 622