Message ID | 1489146442-17001-1-git-send-email-ian.stokes@intel.com |
---|---|
State | Accepted |
Headers | show |
2017-03-10 3:47 GMT-08:00 Ian Stokes <ian.stokes@intel.com>: > 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@intel.com> Thanks, applied to branch-2.6 > --- > 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 > > _______________________________________________ > dev mailing list > dev@openvswitch.org > https://mail.openvswitch.org/mailman/listinfo/ovs-dev
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: --------------
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@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(-)