Revision as of 20:09, 19 April 2017

Intro

Getting the Source

Download a vpp tarball

Or check out via git:

git clone https://gerrit.fd.io/r/vpp
git checkout v17.04

Getting Binary Packages

Ubuntu

Package Descriptions

• vpp - Description: Vector Packet Processing--executables. This package provides VPP executables: vpp, vpp_api_test, vpp_json_test
  • vpp - the vector packet engine
  • vpp_api_test - vector packet engine API test tool
  • vpp_json_test - vector packet engine JSON test tool
• vpp-dbg - Description: Vector Packet Processing--debug symbols
• vpp-dev - Description: Vector Packet Processing--development support. This package contains development support files for the VPP libraries
• vpp-dpdk-dev - Description: Vector Packet Processing--development support. This package contains dpdk header files which match the dpdk version compiled into the vpp executable
• vpp-dpdk-dkms - Description: DPDK 2.1 igb_uio_driver. This package contains Linux kernel modules distributed with DPDK.
• vpp-lib - Description: Vector Packet Processing--runtime libraries. This package contains the VPP shared libraries, including:
  • vppinfra - foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
  • dpdk - Intel DPDK library
  • svm - vm library
  • vlib - vector processing library
  • vlib-api - binary API library
  • vnet - network stack library

Install and run on Ubuntu 14.04 (Trusty)

echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.trusty.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list

sudo apt-get update

sudo apt install vpp vpp-lib vpp-dpdk-dkms

 # Optional, suggested / required for plugin development

 sudo apt-get install vpp-dev vpp-dpdk-dev vpp-dbg

sudo start vpp

Install and run on Ubuntu 16.04 (Xenial)

echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io.ubuntu.xenial.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list

sudo apt update

sudo apt install vpp vpp-lib vpp-dpdk-dkms

 # Optional, suggested / required for plugin development

 sudo apt install vpp-dev vpp-dpdk-dev vpp-dbg

sudo systemctl start vpp

Centos

Package Descriptions

• vpp - Description: Vector Packet Processing--executables. This package provides VPP executables: vpp, vpp_api_test, vpp_json_test
  • vpp - the vector packet engine
  • vpp_api_test - vector packet engine API test tool
  • vpp_json_test - vector packet engine JSON test tool
• vpp-lib - Description: Vector Packet Processing--runtime libraries. This package contains the VPP shared libraries, including:
• vpp-devel - Description: Vector Packet Processing--development support. This package contains development support files for the VPP libraries
  • vppinfra - foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
  • dpdk - Intel DPDK library
  • svm - vm library
  • vlib - vector processing library
  • vlib-api - binary API library
  • vnet - network stack library

Installing and running on Centos 7

Create a file /etc/yum.repos.d/fdio-master.repo with contents:

[fdio-master]
name=fd.io master branch latest merge
baseurl=https://nexus.fd.io/content/repositories/fd.io.centos7/
enabled=1
gpgcheck=0

Then:

sudo yum install vpp

sudo service vpp start

Getting jvpp jar

Directly downloading jvpp.jar

vpp provides java bindings which can be downloaded

Getting jvpp via maven

Add the following to the repositories section in your ~/.m2/settings.xml to pick up the fd.io maven repo:

<repository>

 <id>fd.io-release</id>
 <name>fd.io-release</name>
 <url>https://nexus.fd.io/content/repositories/fd.io.release/</url>
 <releases>
   <enabled>false</enabled>
 </releases>
 <snapshots>
   <enabled>true</enabled>
 </snapshots>

</repository>

More information on setting up maven repositories in settings.xml.

Then you can get jvpp by putting in the dependencies section of your pom.xml file:

<dependency>

 <groupId>io.fd.vpp</groupId>
 <artifactId>jvpp-core</artifactId>
 <version>17.04</version>

 <groupId>io.fd.vpp</groupId>
 <artifactId>jvpp-registry</artifactId>
 <version>17.04</version>

</dependency>

More information on maven dependency managment