Revision as of 00:27, 17 June 2016

Intro

Getting the Source

Download a vpp tarball

Or check out via git:

git clone https://gerrit.fd.io/r/vpp
git checkout v16.06

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 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-get install vpp vpp-dpdk-dkms

sudo start vpp

Install and run on Ubuntu 16.06 (Xenial)

echo "deb 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-dpdk-dkms sudo service vpp start

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-snapshot</id>
 <name>fd.io-snapshot</name>
 <url>https://nexus.fd.io/content/repositories/fd.io.snapshot/</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</artifactId>
 <version>16.06</version>

</dependency>

More information on maven dependency managment