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=15c27ec708e934c16654451d3a0bb70e66bbe00d;hp=ba9b0f01d151db7c9d7b545749bf3995a374f38c;hb=1e2bf354994a7ec53c1acee2d1c2fe2208f7c905;hpb=0956f4f87140b878a3a4da2e192dddd2c9ecc975 diff --git a/docs/report/vpp_functional_tests/test_environment.rst b/docs/report/vpp_functional_tests/test_environment.rst index ba9b0f01d1..15c27ec708 100644 --- a/docs/report/vpp_functional_tests/test_environment.rst +++ b/docs/report/vpp_functional_tests/test_environment.rst @@ -2,7 +2,7 @@ Test Environment ================ CSIT functional tests are currently executed in FD.IO VIRL testbed. The physical -VIRL testbed infrastructure consists of three identical VIRL hosts: +VIRL testbed infrastructure consists of three VIRL hosts: - All hosts are Cisco UCS C240-M4 (2x Intel(R) Xeon(R) CPU E5-2699 v3 @2.30GHz, 18c, 512GB RAM) @@ -42,9 +42,7 @@ VIRL simulations. SUT Configuration - VIRL Guest VM --------------------------------- -Configuration of the SUT VMs is defined in file - - /csit/resources/tools/virl/topologies/double-ring-nested.xenial.virl +Configurations of the SUT VMs is defined in `VIRL topologies directory`_ - List of SUT VM interfaces::: @@ -65,48 +63,43 @@ SUT Configuration - VIRL Guest OS Linux In CSIT terminology, the VM operating system for both SUTs that |vpp-release| has been tested with, is the following: -**#. Ubuntu VIRL image** - -This image implies Ubuntu 16.04.1 LTS, current as of yyyy-mm-dd (that is, -package versions are those that would have been installed by a "apt-get update", -"apt-get upgrade" on that day), produced by CSIT disk image build scripts. - -The exact list of installed packages and their versions (including the Linux -kernel package version) are included in CSIT source repository: - - resources/tools/disk-image-builder/ubuntu/lists/|virl-image-ubuntu| - -A replica of this VM image can be built by running the "build.sh" script in CSIT -repository resources/tools/disk-image-builder/ubuntu. - -**#. CentOS VIRL image** - -The Centos7.3 image is ready to be used but no tests running on it now. -Corresponding Jenkins jobs are under preparation. - -The exact list of installed packages and their versions (including the Linux -kernel package version) are included in CSIT source repository: - - resources/tools/disk-image-builder/ubuntu/lists/|virl-image-centos| - -A replica of this VM image can be built by running the "build.sh" script in CSIT -repository resources/tools/disk-image-builder/centos. - -**#. Nested VM image** - -In addition to the "main" VM image, tests which require VPP to communicate to a -VM over a vhost-user interface, utilize a "nested" VM image. - -This "nested" VM is dynamically created and destroyed as part of a test case, -and therefore the "nested" VM image is optimized to be small, lightweight and -have a short boot time. The "nested" VM image is not built around any -established Linux distribution, but is based on `BuildRoot -`_, a tool for building embedded Linux systems. Just as -for the "main" image, scripts to produce an identical replica of the "nested" -image are included in CSIT GIT repository, and the image can be rebuilt using -the "build.sh" script at: - - resources/tools/disk-image-builder/ubuntu/lists/nested +#. **Ubuntu VIRL image** + + This image implies Ubuntu 16.04.1 LTS, current as of yyyy-mm-dd (that is, + package versions are those that would have been installed by a "apt-get + update", "apt-get upgrade" on that day), produced by CSIT disk image build + scripts. + + The exact list of installed packages and their versions (including the Linux + kernel package version) are included in `VIRL images lists`_. + + A replica of this VM image can be built by running the "build.sh" script in + CSIT repository. + +#. **CentOS VIRL image** + + The Centos7.3 image is ready to be used but no tests running on it now. + Corresponding Jenkins jobs are under preparation. + + The exact list of installed packages and their versions (including the Linux + kernel package version) are included in `VIRL images lists`_. + + A replica of this VM image can be built by running the "build.sh" script in + CSIT repository. + +#. **Nested VM image** + + In addition to the "main" VM image, tests which require VPP to communicate to + a VM over a vhost-user interface, utilize a "nested" VM image. + + This "nested" VM is dynamically created and destroyed as part of a test case, + and therefore the "nested" VM image is optimized to be small, lightweight and + have a short boot time. The "nested" VM image is not built around any + established Linux distribution, but is based on `BuildRoot + `_, a tool for building embedded Linux systems. Just + as for the "main" image, scripts to produce an identical replica of the + "nested" image are included in CSIT GIT repository, and the image can be + rebuilt using the "build.sh" script at `VIRL nested`_. DUT Configuration - VPP ----------------------- @@ -117,9 +110,7 @@ Under Test (DUT) node. **DUT port configuration** Port configuration of DUTs is defined in topology file that is generated per -VIRL simulation based on the definition stored in file - - /csit/resources/tools/virl/topologies/double-ring-nested.xenial.yaml +VIRL simulation based on the definition stored in `VIRL topologies directory`_. Example of DUT nodes configuration::: @@ -373,7 +364,7 @@ Traffic scripts of test cases are executed on this VM. **TG VM configuration** -Configuration of the TG VMs is defined in file +Configuration of the TG VMs is defined in `VIRL topologies directory`_. /csit/resources/tools/virl/topologies/double-ring-nested.xenial.virl @@ -389,9 +380,7 @@ Configuration of the TG VMs is defined in file **TG node port configuration** Port configuration of TG is defined in topology file that is generated per VIRL -simulation based on the definition stored in file - - /csit/resources/tools/virl/topologies/double-ring-nested.xenial.yaml +simulation based on the definition stored in `VIRL topologies directory`_. Example of TG node configuration:::