Manually compiling DPDK is more a developer/packager job.
"Normal" users should focus on using the Linux distribution package.
Simplify the documentation and recommend using the DPDK package.
Signed-off-by: David Marchand <david.march...@redhat.com>
---
Documentation/howto/dpdk.rst | 15 ++++++++-------
Documentation/intro/install/dpdk.rst | 9 ++++++---
Documentation/topics/dpdk/vhost-user.rst | 4 +++-
3 files changed, 17 insertions(+), 11 deletions(-)
diff --git a/Documentation/howto/dpdk.rst b/Documentation/howto/dpdk.rst
index 493e2c99e5..ab6da3c35d 100644
--- a/Documentation/howto/dpdk.rst
+++ b/Documentation/howto/dpdk.rst
@@ -32,8 +32,9 @@ This document describes how to use Open vSwitch with DPDK.
Using DPDK with OVS requires configuring OVS at build time to use
the DPDK library. The version of DPDK that OVS supports varies
from one OVS release to another, as described in the :doc:`releases
- FAQ </faq/releases>`. For build instructions refer to
- :doc:`/intro/install/dpdk`.
+ FAQ </faq/releases>`. Most distributions now provide a package for
+ DPDK and it is recommended you use it. Though for custom usecases,
+ build instructions for DPDK are provided in :doc:`/intro/install/dpdk`.
Ports and Bridges
-----------------
@@ -216,12 +217,12 @@ You can do this directly with QEMU via the
``qemu-system-x86_64`` application::
For a explanation of this command, along with alternative approaches such as
booting the VM via libvirt, refer to :doc:`/topics/dpdk/vhost-user`.
-Once the guest is configured and booted, configure DPDK packet forwarding
-within the guest. To accomplish this, build the ``dpdk-testpmd`` application as
-described in :ref:`dpdk-testpmd`. Once compiled, run the application::
+Once the guest is configured and booted, install DPDK (most distributions
+provide a package, otherwise you may build DPDK, see
+:doc:`/intro/install/dpdk`) and configure DPDK packet forwarding within the
+guest::
- $ cd /path/to/dpdk/build/
- $ ./dpdk-testpmd -c 0x3 --in-memory -- --burst=64 -i
+ $ dpdk-testpmd -c 0x3 --in-memory -- --burst=64 -i
$ set fwd mac retry
$ start
diff --git a/Documentation/intro/install/dpdk.rst
b/Documentation/intro/install/dpdk.rst
index a1939f9041..4b2c7deaeb 100644
--- a/Documentation/intro/install/dpdk.rst
+++ b/Documentation/intro/install/dpdk.rst
@@ -25,9 +25,8 @@
Open vSwitch with DPDK
======================
-This document describes how to build and install Open vSwitch using a DPDK
-datapath. Open vSwitch can use the DPDK library to operate entirely in
-userspace.
+This document describes how to build and install Open vSwitch using DPDK
+in the userspace datapath.
.. important::
@@ -70,6 +69,10 @@ Installing
Install DPDK
~~~~~~~~~~~~
+One important note is that most Linux distributions provide a DPDK package and
+using it is recommended.
+If you still require to use a manually compiled DPDK, here are the steps.
+
#. Download the `DPDK sources`_, extract the file and set ``DPDK_DIR``::
$ cd /usr/src/
diff --git a/Documentation/topics/dpdk/vhost-user.rst
b/Documentation/topics/dpdk/vhost-user.rst
index 0c0054b754..b992c79203 100644
--- a/Documentation/topics/dpdk/vhost-user.rst
+++ b/Documentation/topics/dpdk/vhost-user.rst
@@ -396,7 +396,9 @@ DPDK in the Guest
-----------------
The ``dpdk-testpmd`` application can be run in guest VMs for high speed packet
-forwarding between vhostuser ports. DPDK has to be compiled on the guest VM.
+forwarding between vhostuser ports. DPDK is provided as a package in most Linux
+distributions (though you may want to build it manually, see
+:doc:`/intro/install/dpdk`).
Below are the steps for setting up the environment in the VM.
.. note::
--
2.49.0
_______________________________________________
dev mailing list
d...@openvswitch.org
https://mail.openvswitch.org/mailman/listinfo/ovs-dev
