[ovs-dev] [PATCH v2 branch-2.6] docs: Use DPDK 16.07.2 stable release

Ian Stokes ian.stokes at intel.com
Fri Mar 10 11:47:22 UTC 2017


DPDK now provides a stable release branch. Modify dpdk docs and travis
linux build script to use the DPDK 16.07.2 stable branch to benefit from
most recent bug fixes.

Signed-off-by: Ian Stokes <ian.stokes at intel.com>
---
v1 -> v2
* Set correct path to DPDK stable branch for EXTRA_OPTS in travis linux
  build.
---
 .travis/linux-build.sh   |   14 +++++++-------
 FAQ.md                   |    4 ++--
 INSTALL.DPDK-ADVANCED.md |    6 +++---
 INSTALL.DPDK.md          |   22 ++++++++++------------
 4 files changed, 22 insertions(+), 24 deletions(-)

diff --git a/.travis/linux-build.sh b/.travis/linux-build.sh
index 3bcec93..f15f706 100755
--- a/.travis/linux-build.sh
+++ b/.travis/linux-build.sh
@@ -52,13 +52,13 @@ function install_kernel()
 function install_dpdk()
 {
     if [ -n "$DPDK_GIT" ]; then
-        git clone $DPDK_GIT dpdk-$1
-        cd dpdk-$1
-        git checkout v$1
+        git clone $DPDK_GIT dpdk-stable-$1
+        cd dpdk-stable-$1
+        git checkout tags/v$1
     else
-        wget http://www.dpdk.org/browse/dpdk/snapshot/dpdk-$1.tar.gz
+        wget http://fast.dpdk.org/rel/dpdk-$1.tar.gz
         tar xzvf dpdk-$1.tar.gz > /dev/null
-        cd dpdk-$1
+        cd dpdk-stable-$1
     fi
     find ./ -type f | xargs sed -i 's/max-inline-insns-single=100/max-inline-insns-single=400/'
     echo 'CONFIG_RTE_BUILD_FPIC=y' >>config/common_linuxapp
@@ -80,14 +80,14 @@ fi
 
 if [ "$DPDK" ]; then
     if [ -z "$DPDK_VER" ]; then
-        DPDK_VER="16.07"
+        DPDK_VER="16.07.2"
     fi
     install_dpdk $DPDK_VER
     if [ "$CC" = "clang" ]; then
         # Disregard cast alignment errors until DPDK is fixed
         CFLAGS="$CFLAGS -Wno-cast-align"
     fi
-    EXTRA_OPTS="$EXTRA_OPTS --with-dpdk=./dpdk-$DPDK_VER/build"
+    EXTRA_OPTS="$EXTRA_OPTS --with-dpdk=./dpdk-stable-$DPDK_VER/build"
 elif [ "$CC" != "clang" ]; then
     # DPDK headers currently trigger sparse errors
     SPARSE_FLAGS="$SPARSE_FLAGS -Wsparse-error"
diff --git a/FAQ.md b/FAQ.md
index cf30f9b..75a393b 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -256,12 +256,12 @@ A: The following table lists the DPDK version against which the
    given versions of Open vSwitch will successfully build.
 
 | Open vSwitch | DPDK
-|:------------:|:-----:
+|:------------:|:-------:
 |    2.2.x     | 1.6
 |    2.3.x     | 1.6
 |    2.4.x     | 2.0
 |    2.5.x     | 2.2
-|    2.6.x     | 16.07
+|    2.6.x     | 16.07.2
 
 ### Q: I get an error like this when I configure Open vSwitch:
 
diff --git a/INSTALL.DPDK-ADVANCED.md b/INSTALL.DPDK-ADVANCED.md
index e3603a1..ae21aca 100755
--- a/INSTALL.DPDK-ADVANCED.md
+++ b/INSTALL.DPDK-ADVANCED.md
@@ -46,7 +46,7 @@ for DPDK and OVS.
     For IVSHMEM case, set `export DPDK_TARGET=x86_64-ivshmem-linuxapp-gcc`
 
     ```
-    export DPDK_DIR=/usr/src/dpdk-16.07
+    export DPDK_DIR=/usr/src/dpdk-stable-16.07.2
     export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
     make install T=$DPDK_TARGET DESTDIR=install
     ```
@@ -342,7 +342,7 @@ For users wanting to do packet forwarding using kernel stack below are the steps
        cd /usr/src/cmdline_generator
        wget https://raw.githubusercontent.com/netgroup-polito/un-orchestrator/master/orchestrator/compute_controller/plugins/kvm-libvirt/cmdline_generator/cmdline_generator.c
        wget https://raw.githubusercontent.com/netgroup-polito/un-orchestrator/master/orchestrator/compute_controller/plugins/kvm-libvirt/cmdline_generator/Makefile
-       export RTE_SDK=/usr/src/dpdk-16.07
+       export RTE_SDK=/usr/src/dpdk-stable-16.07.2
        export RTE_TARGET=x86_64-ivshmem-linuxapp-gcc
        make
        ./build/cmdline_generator -m -p dpdkr0 XXX
@@ -366,7 +366,7 @@ For users wanting to do packet forwarding using kernel stack below are the steps
        mount -t hugetlbfs nodev /dev/hugepages (if not already mounted)
 
        # Build the DPDK ring application in the VM
-       export RTE_SDK=/root/dpdk-16.07
+       export RTE_SDK=/root/dpdk-stable-16.07.2
        export RTE_TARGET=x86_64-ivshmem-linuxapp-gcc
        make
 
diff --git a/INSTALL.DPDK.md b/INSTALL.DPDK.md
index 30e9258..9ab29f3 100644
--- a/INSTALL.DPDK.md
+++ b/INSTALL.DPDK.md
@@ -21,7 +21,7 @@ The DPDK support of Open vSwitch is considered 'experimental'.
 
 ### Prerequisites
 
-* Required: DPDK 16.07
+* Required: DPDK 16.07.2
 * Hardware: [DPDK Supported NICs] when physical ports in use
 
 ## <a name="build"></a> 2. Building and Installation
@@ -42,10 +42,9 @@ advanced install guide [INSTALL.DPDK-ADVANCED.md]
 
      ```
      cd /usr/src/
-     wget http://dpdk.org/browse/dpdk/snapshot/dpdk-16.07.zip
-     unzip dpdk-16.07.zip
-
-     export DPDK_DIR=/usr/src/dpdk-16.07
+     wget http://fast.dpdk.org/rel/dpdk-16.07.2.tar.xz
+     tar xf dpdk-16.07.2.tar.xz
+     export DPDK_DIR=/usr/src/dpdk-stable-16.07.2
      cd $DPDK_DIR
      ```
 
@@ -372,9 +371,9 @@ can be found in [Vhost Walkthrough].
 
   ```
   cd /root/dpdk/
-  wget http://dpdk.org/browse/dpdk/snapshot/dpdk-16.07.zip
-  unzip dpdk-16.07.zip
-  export DPDK_DIR=/root/dpdk/dpdk-16.07
+  wget http://fast.dpdk.org/rel/dpdk-16.07.2.tar.xz
+  tar xf dpdk-16.07.2.tar.xz
+  export DPDK_DIR=/usr/src/dpdk-stable-16.07.2
   export DPDK_TARGET=x86_64-native-linuxapp-gcc
   export DPDK_BUILD=$DPDK_DIR/$DPDK_TARGET
   cd $DPDK_DIR
@@ -530,7 +529,7 @@ can be found in [Vhost Walkthrough].
            </disk>
            <disk type='dir' device='disk'>
              <driver name='qemu' type='fat'/>
-             <source dir='/usr/src/dpdk-16.07'/>
+             <source dir='/usr/src/dpdk-stable-16.07.2'/>
              <target dev='vdb' bus='virtio'/>
              <readonly/>
            </disk>
@@ -599,10 +598,9 @@ can be found in [Vhost Walkthrough].
     DPDK. It is recommended that users update Network Interface firmware to
     match what has been validated for the DPDK release.
 
-    For DPDK 16.07, the list of validated firmware versions can be found at:
-
-    http://dpdk.org/doc/guides/rel_notes/release_16.07.html
+    For DPDK 16.07.2, the list of validated firmware versions can be found at:
 
+    http://dpdk.org/doc/guides-16.07/rel_notes/release_16_07.html
 
 Bug Reporting:
 --------------
-- 
1.7.0.7



More information about the dev mailing list