.. http://creativecommons.org/licenses/by/4.0
=================
-PACKET FORWARDING
+Packet Forwarding
=================
About Packet Forwarding
-----------------------
-Packet Forwarding is a test suite of KVMFORNFV. These latency tests measures the time taken by a
+Packet Forwarding is a test suite of KVM4NFV. These latency tests measures the time taken by a
**Packet** generated by the traffic generator to travel from the originating device through the
network to the destination device. Packet Forwarding is implemented using test framework
implemented by OPNFV VSWITCHPERF project and an ``IXIA Traffic Generator``.
| | |
+=============================+===================================================+
| | - Packet Forwarding is not part of Colorado |
-| Colorado | release of KVMFORNFV |
+| Colorado | release of KVM4NFV |
| | |
+-----------------------------+---------------------------------------------------+
-| | - Packet Forwarding is a testcase in KVMFORNFV |
+| | - Packet Forwarding is a testcase in KVM4NFV |
| | - Implements three scenarios (Host/Guest/SRIOV) |
-| | as part of testing in KVMFORNFV |
+| | as part of testing in KVM4NFV |
| Danube | - Uses automated test framework of OPNFV |
-| | VSWITCHPERF software (PVP/PVVP) |
-| | |
+| | VSWITCHPERF software (PVP/PVVP) |
| | - Works with IXIA Traffic Generator |
+-----------------------------+---------------------------------------------------+
For complete VSPERF documentation go to `link.`_
-.. _link.: http://artifacts.opnfv.org/vswitchperf/colorado/index.html
+.. _link.: http://artifacts.opnfv.org/vswitchperf/danube/index.html
Installation
Supported Hypervisors
~~~~~~~~~~~~~~~~~~~~~
-* Qemu version 2.3.
+* Qemu version 2.6.
Other Requirements
~~~~~~~~~~~~~~~~~~
script **systems/build_base_machine.sh**. It should be executed under
user account, which will be used for vsperf execution.
- **Please Note:** Password-less sudo access must be configured for given user
- before script is executed.
+ **Please Note:** Password-less sudo access must be configured for given user before script is executed.
Execution of installation script:
Installation
~~~~~~~~~~~~
-Follow the [installation instructions] to install.
+Follow the installation instructions to install.
On the CentOS 7 system
~~~~~~~~~~~~~~~~~~~~~~
support for Destination Network Address Translation (DNAT) for both the MAC and
IP addresses. l2fwd can be found in <vswitchperf_dir>/src/l2fwd
-.. figure:: images/Guest_Scenario.png
- :name: Guest_Scenario
- :width: 100%
- :align: center
-
-
Executing tests
~~~~~~~~~~~~~~~~
Packet Forwarding Test Scenarios
--------------------------------
-KVMFORNFV currently implements three scenarios as part of testing:
+KVM4NFV currently implements three scenarios as part of testing:
* Host Scenario
* Guest Scenario.
Raw virtual machine throughput performance can be measured by execution of PVP
test with direct access to NICs by PCI passthrough. To execute VM with direct
-access to PCI devices, enable vfio-pci_. In order to use virtual functions,
+access to PCI devices, enable vfio-pci. In order to use virtual functions,
SRIOV-support_ must be enabled.
Execution of test with PCI passthrough with vswitch disabled:
$ ./vsperf --conf-file=<path_to_custom_conf>/10_custom.conf \
--vswitch none --vnf QemuPciPassthrough pvp_tput
-Any of supported guest-loopback-application_ can be used inside VM with
+Any of supported guest-loopback-application can be used inside VM with
PCI passthrough support.
Note: Qemu with PCI passthrough support can be used only with PVP test
deployment.
-.. _guest-loopback-application:
+Results
+~~~~~~~
+
+The results for the packet forwarding test cases are uploaded to artifacts.
+The link for the same can be found below
+
+.. code:: bash
+
+ http://artifacts.opnfv.org/kvmfornfv.html