X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Fvpp-device.rst;h=4289887c6b5e8c4ca1850419362081cd493957f0;hp=86aa0461f8136b85a7b535a675978db75bf3338a;hb=4c8b382e0034ed2660d749cbd01d5b304aeb54bc;hpb=59f8cd1c8fabf0517253280335865153fb925d8b diff --git a/docs/vpp-device.rst b/docs/vpp-device.rst index 86aa0461f8..4289887c6b 100644 --- a/docs/vpp-device.rst +++ b/docs/vpp-device.rst @@ -1,5 +1,5 @@ -VPP_Device Integration Tests -============================ +Integration Tests +================= Abstract -------- @@ -13,7 +13,7 @@ continuous VPP testing by extending existing test environments. Furthermore it describes and summarizes implementation details of Integration and System tests platform *1-Node VPP_Device*. It aims to provide a complete end-to-end view of *1-Node VPP_Device* environment in order to improve -extendibility and maintenance, under the guideline of VPP core team. +extendability and maintenance, under the guideline of VPP core team. The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be @@ -22,9 +22,22 @@ interpreted as described in :rfc:`8174`. Overview -------- -.. todo: Covert to SVG +.. only:: latex + + .. raw:: latex + + \begin{figure}[H] + \centering + \graphicspath{{../_tmp/src/vpp_device_tests/}} + \includegraphics[width=0.90\textwidth]{vpp_device} + \label{fig:vpp_device} + \end{figure} -.. image:: vpp-device.png +.. only:: html + + .. figure:: vpp_device.svg + :alt: vpp_device + :align: center Physical Testbeds ----------------- @@ -36,7 +49,7 @@ project. Two 1-node testbed topologies are used: - **2-Container Topology**: Consisting of one Docker container acting as SUT (System Under Test) and one Docker container as TG (Traffic Generator), both - connected in ring topology via physical NIC crossconnecting. + connected in ring topology via physical NIC cross-connecting. Current FD.io production testbeds are built with servers based on one processor generation of Intel Xeons: Skylake (Platinum 8180). Testbeds built @@ -83,7 +96,7 @@ NIC interfaces are shared using Linux vfio_pci and VPP VF drivers: - DPDK VF driver, - Fortville AVF driver. -Provided Intel x710-da4 4p10GE NICs suppport 32 VFs per interface, 128 per NIC. +Provided Intel x710-da4 4p10GE NICs support 32 VFs per interface, 128 per NIC. Complete 1n-skx testbeds specification is available on `CSIT LF Testbeds `_ wiki page. @@ -152,7 +165,7 @@ service. Versioning ~~~~~~~~~~ -As of initial version of vpp-device, we do have only single `:latest` version of +As of initial version of vpp-device, we do have only single latest version of Docker image hosted on [dockerhub]_. This will be addressed as further improvement with proper semantic versioning. @@ -199,8 +212,10 @@ that only Y number of simulations are spawned on any given HW node. *root* user account as primary. From the jenkins slave it will be able to connect via env variable, since the jenkins slave doesn't actually know what host its running on. + :: - ssh -p 6022 root@10.30.51.node + + ssh -p 6022 root@10.30.51.node csit-sut-dcr ~~~~~~~~~~~~ @@ -240,6 +255,10 @@ including those required by DUT/TG. # Mount vfio to be able to bind to see binded interfaces. We cannot use # --device=/dev/vfio as this does not see newly binded interfaces. --volume /dev/vfio:/dev/vfio + # Mount nested_vm image to be able to run VM tests. + --volume /var/lib/vm/vhost-nested.img:/var/lib/vm/vhost-nested.img + # Mount docker.sock to be able to use docker deamon of the host. + --volume /var/run/docker.sock:/var/run/docker.sock # Image of csit-sut-dcr snergster/csit-vpp-device-test:latest @@ -489,12 +508,6 @@ Maintainability Stability ~~~~~~~~~ -.. note:: - - Improve NIC selection pair-wise: As of now script is taking first two - interfaces from discovered list regardless of sibling pairing. Implement - more advance method of selection of interfaces based on VF 802.1Q siblings. - .. note:: Implement queueing mechanism: Currently there is no mechanics that