Difference between revisions of "VPP/Getting VPP Release Binaries"

From fd.io
< VPP
Jump to: navigation, search
(Created page with "= Intro = = Getting the Source = [https://git.fd.io/cgit/vpp/tag/?h=v16.06 Download a vpp tarball] Or check out via git: <pre> git clone https://gerrit.fd.io/r/vpp git che...")
 
(Getting jvpp via maven)
 
(12 intermediate revisions by 4 users not shown)
Line 3: Line 3:
 
= Getting the Source =
 
= Getting the Source =
  
[https://git.fd.io/cgit/vpp/tag/?h=v16.06 Download a vpp tarball]
+
[https://git.fd.io/cgit/vpp/tag/?h=v18.10 Download a vpp tarball]
  
 
Or check out via git:
 
Or check out via git:
Line 9: Line 9:
 
<pre>
 
<pre>
 
git clone https://gerrit.fd.io/r/vpp
 
git clone https://gerrit.fd.io/r/vpp
git checkout v16.06
+
git checkout v18.10
 
</pre>
 
</pre>
  
Line 32: Line 32:
 
** vlib-api - binary API library
 
** vlib-api - binary API library
 
** vnet -  network stack library
 
** vnet -  network stack library
 
=== Install and run on Ubuntu 14.04 (Trusty) ===
 
<code>
 
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
 
 
&nbsp;# Optional, suggested / required for plugin development
 
 
&nbsp;sudo apt-get install vpp-dev vpp-dpdk-dev vpp-dbg
 
 
sudo start vpp
 
</code>
 
  
 
=== Install and run on Ubuntu 16.04 (Xenial) ===
 
=== Install and run on Ubuntu 16.04 (Xenial) ===
Line 65: Line 50:
 
</code>
 
</code>
  
== Centos ==
+
== CentOS ==
  
 
=== Package Descriptions ===
 
=== Package Descriptions ===
Line 81: Line 66:
 
** vnet -  network stack library
 
** vnet -  network stack library
  
=== Installing and running on Centos 7 ===
+
=== CentOS Release Packages ===
 +
 
 +
To install development release packages on updated 7.4 Centos system:
 +
 
 +
<pre>
 +
sudo yum install centos-release-fdio
 +
</pre>
 +
then
 +
<pre>
 +
sudo yum install vpp
 +
sudo systemctl start vpp
 +
</pre>
 +
 
 +
=== Installing and running on CentOS 7 ===
  
 
Create a file /etc/yum.repos.d/fdio-master.repo with contents:
 
Create a file /etc/yum.repos.d/fdio-master.repo with contents:
Line 95: Line 93:
 
Then:
 
Then:
  
<code>
+
<pre>
 
sudo yum install vpp
 
sudo yum install vpp
</code>
+
</pre>
  
<code>
+
<pre>
sudo service vpp start
+
sudo systemctl start vpp
</code>
+
</pre>
 +
 
 +
== openSUSE ==
 +
 
 +
=== 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
 +
 
 +
=== openSUSE Leap 15 Release Packages ===
 +
 
 +
To install development release packages on Leap 15 system:
 +
 
 +
<pre>
 +
curl -s https://packagecloud.io/install/repositories/fdio/master/script.rpm.sh | sudo bash
 +
</pre>
 +
 
 +
Then:
 +
 
 +
<pre>
 +
sudo zypper install vpp vpp-plugins
 +
</pre>
 +
 
 +
<pre>
 +
sudo systemctl start vpp
 +
</pre>
  
 
= Getting jvpp jar =  
 
= Getting jvpp jar =  
Line 134: Line 166:
 
   <groupId>io.fd.vpp</groupId>
 
   <groupId>io.fd.vpp</groupId>
 
   <artifactId>jvpp-core</artifactId>
 
   <artifactId>jvpp-core</artifactId>
   <version>16.09</version>
+
   <version>18.10</version>
 
</dependency>
 
</dependency>
 
<dependency>
 
<dependency>
 
   <groupId>io.fd.vpp</groupId>
 
   <groupId>io.fd.vpp</groupId>
 
   <artifactId>jvpp-registry</artifactId>
 
   <artifactId>jvpp-registry</artifactId>
   <version>16.09</version>
+
   <version>18.10</version>
 
</dependency>
 
</dependency>
 
</code>
 
</code>
  
 
[https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html More information on maven dependency managment]
 
[https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html More information on maven dependency managment]

Latest revision as of 07:56, 15 October 2018

Intro

Getting the Source

Download a vpp tarball

Or check out via git:

git clone https://gerrit.fd.io/r/vpp
git checkout v18.10

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 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

CentOS Release Packages

To install development release packages on updated 7.4 Centos system:

sudo yum install centos-release-fdio

then

sudo yum install vpp
sudo systemctl start vpp

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 systemctl start vpp

openSUSE

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

openSUSE Leap 15 Release Packages

To install development release packages on Leap 15 system:

curl -s https://packagecloud.io/install/repositories/fdio/master/script.rpm.sh | sudo bash

Then:

sudo zypper install vpp vpp-plugins
sudo systemctl start vpp

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>18.10</version>

</dependency> <dependency>

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

</dependency>

More information on maven dependency managment