Difference between revisions of "VPP/Installing VPP binaries from packages"

From fd.io
< VPP
Jump to: navigation, search
(Ubuntu/Debian)
Line 10: Line 10:
 
** vpp_api_test - vector packet engine API test tool
 
** vpp_api_test - vector packet engine API test tool
 
** vpp_json_test - vector packet engine JSON 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:
 
* '''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.
 
** vppinfra - foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
** dpdk - Intel DPDK library
 
 
** svm - vm library
 
** svm - vm library
 
** vlib - vector processing library
 
** vlib - vector processing library
 
** vlib-api - binary API library
 
** vlib-api - binary API library
 
** vnet -  network stack library
 
** vnet -  network stack library
 +
* '''vpp-plugins''' - Description: Vector Packet Processing--plugin modules
 +
** acl
 +
** dpdk
 +
** flowprobe
 +
** gtpu
 +
** ixge
 +
** kubeproxy
 +
** l2e
 +
** lb
 +
** memif
 +
** nat
 +
** pppoe
 +
** sixrd
 +
** stn
 +
* '''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-api-java''' - Description: JAVA binding for the VPP Binary API.
 
* '''vpp-api-python''' - Description: Python binding for the VPP Binary API.
 
* '''vpp-api-python''' - Description: Python binding for the VPP Binary API.
 
* '''vpp-api-lua''' - Description: Lua binding for the VPP Binary API.
 
* '''vpp-api-lua''' - Description: Lua binding for the VPP Binary API.
* '''vpp-api-java''' - Description: JAVA binding for the VPP Binary API.
 
  
 
== Ubuntu/Debian ==
 
== Ubuntu/Debian ==
Line 47: Line 58:
 
   echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io$RELEASE.ubuntu.$UBUNTU.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list
 
   echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io$RELEASE.ubuntu.$UBUNTU.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list
 
   sudo apt-get update
 
   sudo apt-get update
   sudo apt-get install vpp vpp-plugins
+
   sudo apt-get install vpp vpp-lib
 +
 
 +
Optional packages:
 +
  sudo apt-get install vpp-plugins vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
  
 
=== Uninstalling ===
 
=== Uninstalling ===
  
 
   sudo apt-get remove --purge vpp vpp-lib
 
   sudo apt-get remove --purge vpp vpp-lib
 +
 +
Optional packages:
 +
  sudo apt-get remove --purge vpp-plugins vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua
  
 
== Centos ==
 
== Centos ==

Revision as of 23:24, 23 January 2018

Intro

If you are simply using vpp, it can be convenient to simply install the packages. The instructions below will pull the latest freshest package build from the master branch (updated on every merge).

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:
    • vppinfra - foundation library supporting vectors, hashes, bitmaps, pools, and string formatting.
    • svm - vm library
    • vlib - vector processing library
    • vlib-api - binary API library
    • vnet - network stack library
  • vpp-plugins - Description: Vector Packet Processing--plugin modules
    • acl
    • dpdk
    • flowprobe
    • gtpu
    • ixge
    • kubeproxy
    • l2e
    • lb
    • memif
    • nat
    • pppoe
    • sixrd
    • stn
  • 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-api-java - Description: JAVA binding for the VPP Binary API.
  • vpp-api-python - Description: Python binding for the VPP Binary API.
  • vpp-api-lua - Description: Lua binding for the VPP Binary API.

Ubuntu/Debian

Add fd.io repo

1. Pick Ubuntu version:

  • Ubuntu 16.04 - Xenial
 export UBUNTU="xenial"

2. Pick VPP version:

  • Released (VPP 18.01)
 export RELEASE=".stable.1801"
  • Released (VPP 17.10)
 export RELEASE=".stable.1710"
  • Released (VPP 17.07)
 export RELEASE=".stable.1707"
  • MASTER (in development)
 export RELEASE=".master"

3. Then run:

 sudo rm /etc/apt/sources.list.d/99fd.io.list
 echo "deb [trusted=yes] https://nexus.fd.io/content/repositories/fd.io$RELEASE.ubuntu.$UBUNTU.main/ ./" | sudo tee -a /etc/apt/sources.list.d/99fd.io.list
 sudo apt-get update
 sudo apt-get install vpp vpp-lib 

Optional packages:

 sudo apt-get install vpp-plugins vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua

Uninstalling

 sudo apt-get remove --purge vpp vpp-lib

Optional packages:

 sudo apt-get remove --purge vpp-plugins vpp-dbg vpp-dev vpp-api-java vpp-api-python vpp-api-lua

Centos

Add fd.io repo

CentOS 7.3 - VPP Release RPMs (Latest)

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

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

CentOS 7.3 - VPP stable/1801 branch RPMs

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

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

CentOS 7.3 - VPP stable/1710 branch RPMs

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

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

CentOS 7.3 - VPP stable/1707 branch RPMs

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

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

CentOS 7.3 - VPP master branch RPMs (in development)

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.master.centos7/
enabled=1
gpgcheck=0

Install vpp packages

sudo yum install vpp

openSUSE

Blog-post: https://www.suse.com/communities/blog/vector-packet-processing-vpp-opensuse/

Install

openSUSE Tumbleweed (rolling release)

sudo zypper install vpp vpp-plugins

openSUSE Leap 42.3

sudo zypper addrepo --name network https://download.opensuse.org/repositories/network/openSUSE_Leap_42.3/network.repo
sudo zypper install vpp vpp-plugins

Uninstall

openSUSE Tumbleweed (rolling release)

sudo zypper remove -u vpp vpp-plugins

openSUSE Leap 42.3

sudo zypper remove -u vpp vpp-plugins
sudo zypper removerepo network