Skip to content

Commit

Permalink
dpdk: Use DPDK 17.11.1 release.
Browse files Browse the repository at this point in the history
Modify docs and travis linux build script to use the DPDK 17.11.1
release branch to benefit from most recent bug fixes.

There are no new features introduced in the DPDK release, only back
ported bug fixes. For completeness these bug fixes have been documented
under the 17.11.1 section in the link below.

http://dpdk.org/doc/guides-17.11/rel_notes/release_17_11.html#id1

Signed-off-by: Ian Stokes <ian.stokes@intel.com>
Acked-by: Kevin Traynor <ktraynor@redhat.com>
  • Loading branch information
istokes committed Mar 21, 2018
1 parent d70a862 commit d7404f6
Show file tree
Hide file tree
Showing 4 changed files with 12 additions and 34 deletions.
2 changes: 1 addition & 1 deletion .travis/linux-build.sh
Expand Up @@ -83,7 +83,7 @@ fi

if [ "$DPDK" ]; then
if [ -z "$DPDK_VER" ]; then
DPDK_VER="17.11"
DPDK_VER="17.11.1"
fi
install_dpdk $DPDK_VER
if [ "$CC" = "clang" ]; then
Expand Down
4 changes: 2 additions & 2 deletions Documentation/faq/releases.rst
Expand Up @@ -163,9 +163,9 @@ Q: What DPDK version does each Open vSwitch release work with?
2.4.x 2.0
2.5.x 2.2
2.6.x 16.07.2
2.7.x 16.11.4
2.7.x 16.11.5
2.8.x 17.05.2
2.9.x 17.11
2.9.x 17.11.1
============ =======

Q: I get an error like this when I configure Open vSwitch:
Expand Down
8 changes: 4 additions & 4 deletions Documentation/intro/install/dpdk.rst
Expand Up @@ -40,7 +40,7 @@ Build requirements
In addition to the requirements described in :doc:`general`, building Open
vSwitch with DPDK will require the following:

- DPDK 17.11
- DPDK 17.11.1

- A `DPDK supported NIC`_

Expand Down Expand Up @@ -69,9 +69,9 @@ Install DPDK
#. Download the `DPDK sources`_, extract the file and set ``DPDK_DIR``::

$ cd /usr/src/
$ wget http://fast.dpdk.org/rel/dpdk-17.11.tar.xz
$ tar xf dpdk-17.11.tar.xz
$ export DPDK_DIR=/usr/src/dpdk-17.11
$ wget http://fast.dpdk.org/rel/dpdk-17.11.1.tar.xz
$ tar xf dpdk-17.11.1.tar.xz
$ export DPDK_DIR=/usr/src/dpdk-stable-17.11.1
$ cd $DPDK_DIR

#. (Optional) Configure DPDK as a shared library
Expand Down
32 changes: 5 additions & 27 deletions Documentation/topics/dpdk/vhost-user.rst
Expand Up @@ -323,9 +323,9 @@ To begin, instantiate a guest as described in :ref:`dpdk-vhost-user` or
DPDK sources to VM and build DPDK::

$ cd /root/dpdk/
$ wget http://fast.dpdk.org/rel/dpdk-17.11.tar.xz
$ tar xf dpdk-17.11.tar.xz
$ export DPDK_DIR=/root/dpdk/dpdk-17.11
$ wget http://fast.dpdk.org/rel/dpdk-17.11.1.tar.xz
$ tar xf dpdk-17.11.1.tar.xz
$ export DPDK_DIR=/root/dpdk/dpdk-stable-17.11.1
$ export DPDK_TARGET=x86_64-native-linuxapp-gcc
$ export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
$ cd $DPDK_DIR
Expand Down Expand Up @@ -358,28 +358,6 @@ Finally, start the application::

# TODO

.. important::

DPDK v17.11 virtio PMD contains a bug in the vectorized Rx function that
affects testpmd/DPDK guest applications. As such, guest DPDK applications
should use a non-vectorized Rx function.

The DPDK v17.11 virtio net driver contains a bug that prevents guest DPDK
applications from receiving packets when the vectorized Rx function is used.
This only occurs when guest-bound traffic is live before a DPDK application is
started within the guest, and where two or more forwarding cores are used. As
such, it is not recommended for guests which execute DPDK applications to use
the virtio vectorized Rx function. A simple method of ensuring that a non-
vectorized Rx function is used is to enable mergeable buffers for the guest,
with the following QEMU command line option::

mrg_rxbuf=on

Additional details regarding the virtio driver bug are available on the
`DPDK mailing list`_.

.. _DPDK mailing list: http://dpdk.org/ml/archives/dev/2017-December/082801.html

.. _dpdk-vhost-user-xml:

Sample XML
Expand Down Expand Up @@ -431,7 +409,7 @@ Sample XML
</disk>
<disk type='dir' device='disk'>
<driver name='qemu' type='fat'/>
<source dir='/usr/src/dpdk-stable-17.05.2'/>
<source dir='/usr/src/dpdk-stable-17.11.1'/>
<target dev='vdb' bus='virtio'/>
<readonly/>
</disk>
Expand Down Expand Up @@ -533,4 +511,4 @@ issue can be found on

Further information can be found in the
`DPDK documentation
<http://dpdk.readthedocs.io/en/v17.05/prog_guide/vhost_lib.html>`__
<http://dpdk.readthedocs.io/en/v17.11/prog_guide/vhost_lib.html>`__

0 comments on commit d7404f6

Please sign in to comment.