[ovs-dev,Branch-2.9] dpdk: Use DPDK 17.11.1 release.

Message ID 1520599604-27904-1-git-send-email-ian.stokes@intel.com
State Accepted
Headers show
Series
  • [ovs-dev,Branch-2.9] dpdk: Use DPDK 17.11.1 release.
Related show

Commit Message

Stokes, Ian March 9, 2018, 12:46 p.m.
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>
---
 .travis/linux-build.sh                   |  2 +-
 Documentation/faq/releases.rst           |  4 ++--
 Documentation/intro/install/dpdk.rst     |  8 ++++----
 Documentation/topics/dpdk/vhost-user.rst | 14 +++++++-------
 4 files changed, 14 insertions(+), 14 deletions(-)

Comments

Kevin Traynor March 9, 2018, 4:01 p.m. | #1
On 03/09/2018 12:46 PM, Ian Stokes wrote:
> 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>
> ---
>  .travis/linux-build.sh                   |  2 +-
>  Documentation/faq/releases.rst           |  4 ++--
>  Documentation/intro/install/dpdk.rst     |  8 ++++----
>  Documentation/topics/dpdk/vhost-user.rst | 14 +++++++-------
>  4 files changed, 14 insertions(+), 14 deletions(-)
> 
> diff --git a/.travis/linux-build.sh b/.travis/linux-build.sh
> index 8fd9aa0..004953f 100755
> --- a/.travis/linux-build.sh
> +++ b/.travis/linux-build.sh
> @@ -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
> diff --git a/Documentation/faq/releases.rst b/Documentation/faq/releases.rst
> index baa9e97..59252fa 100644
> --- a/Documentation/faq/releases.rst
> +++ b/Documentation/faq/releases.rst
> @@ -162,9 +162,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:
> diff --git a/Documentation/intro/install/dpdk.rst b/Documentation/intro/install/dpdk.rst
> index ed358d5..e0a96ac 100644
> --- a/Documentation/intro/install/dpdk.rst
> +++ b/Documentation/intro/install/dpdk.rst
> @@ -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`_
>  
> @@ -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-17.11.1
>         $ cd $DPDK_DIR
>  
>  #. (Optional) Configure DPDK as a shared library
> diff --git a/Documentation/topics/dpdk/vhost-user.rst b/Documentation/topics/dpdk/vhost-user.rst
> index 95517a6..b1d0995 100644
> --- a/Documentation/topics/dpdk/vhost-user.rst
> +++ b/Documentation/topics/dpdk/vhost-user.rst
> @@ -320,9 +320,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-17.11.1
>      $ export DPDK_TARGET=x86_64-native-linuxapp-gcc
>      $ export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
>      $ cd $DPDK_DIR
> @@ -357,11 +357,11 @@ Finally, start the application::
>  
>  .. important::
>  
> -  DPDK v17.11 virtio PMD contains a bug in the vectorized Rx function that
> +  DPDK v17.11.1 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
> +The DPDK v17.11.1 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

The bug is fixed in v17.11.1, so these can be removed.

> @@ -428,7 +428,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>
> @@ -530,4 +530,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>`__
>
Stokes, Ian March 12, 2018, 10:06 a.m. | #2
> -----Original Message-----
> From: Kevin Traynor [mailto:ktraynor@redhat.com]
> Sent: Friday, March 9, 2018 4:02 PM
> To: Stokes, Ian <ian.stokes@intel.com>; dev@openvswitch.org
> Subject: Re: [ovs-dev] [PATCH Branch-2.9] dpdk: Use DPDK 17.11.1 release.
> 
> On 03/09/2018 12:46 PM, Ian Stokes wrote:
> > 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>
> > ---
> >  .travis/linux-build.sh                   |  2 +-
> >  Documentation/faq/releases.rst           |  4 ++--
> >  Documentation/intro/install/dpdk.rst     |  8 ++++----
> >  Documentation/topics/dpdk/vhost-user.rst | 14 +++++++-------
> >  4 files changed, 14 insertions(+), 14 deletions(-)
> >
> > diff --git a/.travis/linux-build.sh b/.travis/linux-build.sh index
> > 8fd9aa0..004953f 100755
> > --- a/.travis/linux-build.sh
> > +++ b/.travis/linux-build.sh
> > @@ -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
> > diff --git a/Documentation/faq/releases.rst
> > b/Documentation/faq/releases.rst index baa9e97..59252fa 100644
> > --- a/Documentation/faq/releases.rst
> > +++ b/Documentation/faq/releases.rst
> > @@ -162,9 +162,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:
> > diff --git a/Documentation/intro/install/dpdk.rst
> > b/Documentation/intro/install/dpdk.rst
> > index ed358d5..e0a96ac 100644
> > --- a/Documentation/intro/install/dpdk.rst
> > +++ b/Documentation/intro/install/dpdk.rst
> > @@ -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`_
> >
> > @@ -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-17.11.1
> >         $ cd $DPDK_DIR
> >
> >  #. (Optional) Configure DPDK as a shared library diff --git
> > a/Documentation/topics/dpdk/vhost-user.rst
> > b/Documentation/topics/dpdk/vhost-user.rst
> > index 95517a6..b1d0995 100644
> > --- a/Documentation/topics/dpdk/vhost-user.rst
> > +++ b/Documentation/topics/dpdk/vhost-user.rst
> > @@ -320,9 +320,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-17.11.1
> >      $ export DPDK_TARGET=x86_64-native-linuxapp-gcc
> >      $ export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
> >      $ cd $DPDK_DIR
> > @@ -357,11 +357,11 @@ Finally, start the application::
> >
> >  .. important::
> >
> > -  DPDK v17.11 virtio PMD contains a bug in the vectorized Rx function
> > that
> > +  DPDK v17.11.1 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
> > +The DPDK v17.11.1 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
> 
> The bug is fixed in v17.11.1, so these can be removed.
> 

My bad, I thought I had removed this in my branch, I'll re-submit in a v2 for both the 2.9 and master.

Ian
> > @@ -428,7 +428,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>
> > @@ -530,4 +530,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>`__
> >

Patch

diff --git a/.travis/linux-build.sh b/.travis/linux-build.sh
index 8fd9aa0..004953f 100755
--- a/.travis/linux-build.sh
+++ b/.travis/linux-build.sh
@@ -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
diff --git a/Documentation/faq/releases.rst b/Documentation/faq/releases.rst
index baa9e97..59252fa 100644
--- a/Documentation/faq/releases.rst
+++ b/Documentation/faq/releases.rst
@@ -162,9 +162,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:
diff --git a/Documentation/intro/install/dpdk.rst b/Documentation/intro/install/dpdk.rst
index ed358d5..e0a96ac 100644
--- a/Documentation/intro/install/dpdk.rst
+++ b/Documentation/intro/install/dpdk.rst
@@ -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`_
 
@@ -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-17.11.1
        $ cd $DPDK_DIR
 
 #. (Optional) Configure DPDK as a shared library
diff --git a/Documentation/topics/dpdk/vhost-user.rst b/Documentation/topics/dpdk/vhost-user.rst
index 95517a6..b1d0995 100644
--- a/Documentation/topics/dpdk/vhost-user.rst
+++ b/Documentation/topics/dpdk/vhost-user.rst
@@ -320,9 +320,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-17.11.1
     $ export DPDK_TARGET=x86_64-native-linuxapp-gcc
     $ export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
     $ cd $DPDK_DIR
@@ -357,11 +357,11 @@  Finally, start the application::
 
 .. important::
 
-  DPDK v17.11 virtio PMD contains a bug in the vectorized Rx function that
+  DPDK v17.11.1 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
+The DPDK v17.11.1 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
@@ -428,7 +428,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>
@@ -530,4 +530,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>`__