152 lines
4.8 KiB
ReStructuredText
152 lines
4.8 KiB
ReStructuredText
|
.. _building:
|
||
|
|
|
||
|
|
.. toctree::
|
||
|
|
|
||
|
|
Building VPP
|
||
|
|
============
|
||
|
|
|
||
|
|
To get started developing with VPP you need to get the sources and build the packages.
|
||
|
|
|
||
|
|
.. _setupproxies:
|
||
|
|
|
||
|
|
Set up Proxies
|
||
|
|
--------------
|
||
|
|
|
||
|
|
Depending on the environment, proxies may need to be set.
|
||
|
|
You may run these commands:
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ export http_proxy=http://<proxy-server-name>.com:<port-number>
|
||
|
|
$ export https_proxy=https://<proxy-server-name>.com:<port-number>
|
||
|
|
|
||
|
|
|
||
|
|
Get the VPP Sources
|
||
|
|
-------------------
|
||
|
|
|
||
|
|
To get the VPP sources and get ready to build execute the following:
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ git clone https://gerrit.fd.io/r/vpp
|
||
|
|
$ cd vpp
|
||
|
|
|
||
|
|
Build VPP Dependencies
|
||
|
|
----------------------
|
||
|
|
|
||
|
|
Before building, make sure there are no FD.io VPP or DPDK packages installed by entering the following
|
||
|
|
commands:
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ dpkg -l | grep vpp
|
||
|
|
$ dpkg -l | grep DPDK
|
||
|
|
|
||
|
|
There should be no output, or packages showing after each of the above commands.
|
||
|
|
|
||
|
|
Run this to install the dependencies for FD.io VPP.
|
||
|
|
If it hangs during downloading at any point, you may need to set up :ref:`proxies for this to work <setupproxies>`.
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ make install-dep
|
||
|
|
Hit:1 http://us.archive.ubuntu.com/ubuntu xenial InRelease
|
||
|
|
Get:2 http://us.archive.ubuntu.com/ubuntu xenial-updates InRelease [109 kB]
|
||
|
|
Get:3 http://security.ubuntu.com/ubuntu xenial-security InRelease [107 kB]
|
||
|
|
Get:4 http://us.archive.ubuntu.com/ubuntu xenial-backports InRelease [107 kB]
|
||
|
|
Get:5 http://us.archive.ubuntu.com/ubuntu xenial-updates/main amd64 Packages [803 kB]
|
||
|
|
Get:6 http://us.archive.ubuntu.com/ubuntu xenial-updates/main i386 Packages [732 kB]
|
||
|
|
...
|
||
|
|
...
|
||
|
|
Update-alternatives: using /usr/lib/jvm/java-8-openjdk-amd64/bin/jmap to provide /usr/bin/jmap (jmap) in auto mode
|
||
|
|
Setting up default-jdk-headless (2:1.8-56ubuntu2) ...
|
||
|
|
Processing triggers for libc-bin (2.23-0ubuntu3) ...
|
||
|
|
Processing triggers for systemd (229-4ubuntu6) ...
|
||
|
|
Processing triggers for ureadahead (0.100.0-19) ...
|
||
|
|
Processing triggers for ca-certificates (20160104ubuntu1) ...
|
||
|
|
Updating certificates in /etc/ssl/certs...
|
||
|
|
0 added, 0 removed; done.
|
||
|
|
Running hooks in /etc/ca-certificates/update.d...
|
||
|
|
|
||
|
|
done.
|
||
|
|
done.
|
||
|
|
|
||
|
|
Build VPP (Debug Mode)
|
||
|
|
----------------------
|
||
|
|
|
||
|
|
This build version contains debug symbols which is useful to modify VPP. The command below will build debug version of VPP.
|
||
|
|
This build will come with /build-root/vpp_debug-native.
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ make build
|
||
|
|
make[1]: Entering directory '/home/vagrant/vpp-master/build-root'
|
||
|
|
@@@@ Arch for platform 'vpp' is native @@@@
|
||
|
|
@@@@ Finding source for dpdk @@@@
|
||
|
|
@@@@ Makefile fragment found in /home/vagrant/vpp-master/build-data/packages/dpdk.mk @@@@
|
||
|
|
@@@@ Source found in /home/vagrant/vpp-master/dpdk @@@@
|
||
|
|
@@@@ Arch for platform 'vpp' is native @@@@
|
||
|
|
@@@@ Finding source for vpp @@@@
|
||
|
|
@@@@ Makefile fragment found in /home/vagrant/vpp-master/build-data/packages/vpp.mk @@@@
|
||
|
|
@@@@ Source found in /home/vagrant/vpp-master/src @@@@
|
||
|
|
...
|
||
|
|
...
|
||
|
|
make[5]: Leaving directory '/home/vagrant/vpp-master/build-root/build-vpp_debug-native/vpp/vpp-api/java'
|
||
|
|
make[4]: Leaving directory '/home/vagrant/vpp-master/build-root/build-vpp_debug-native/vpp/vpp-api/java'
|
||
|
|
make[3]: Leaving directory '/home/vagrant/vpp-master/build-root/build-vpp_debug-native/vpp'
|
||
|
|
make[2]: Leaving directory '/home/vagrant/vpp-master/build-root/build-vpp_debug-native/vpp'
|
||
|
|
@@@@ Installing vpp: nothing to do @@@@
|
||
|
|
make[1]: Leaving directory '/home/vagrant/vpp-master/build-root'
|
||
|
|
|
||
|
|
Build VPP (Release Version)
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
To build the release version of FD.io VPP.
|
||
|
|
This build is optimized and will not create debug symbols.
|
||
|
|
This build will come with /build-root/build-vpp-native
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ make release
|
||
|
|
|
||
|
|
|
||
|
|
Building Necessary Packages
|
||
|
|
---------------------------
|
||
|
|
|
||
|
|
To build the debian packages, one of the following commands below depending on the system:
|
||
|
|
|
||
|
|
Building Debian Packages
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ make pkg-deb
|
||
|
|
|
||
|
|
|
||
|
|
Building RPM Packages
|
||
|
|
^^^^^^^^^^^^^^^^^^^^^
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ make pkg-rpm
|
||
|
|
|
||
|
|
The packages will be found in the build-root directory.
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ ls *.deb
|
||
|
|
|
||
|
|
If packages built correctly, this should be the Output
|
||
|
|
|
||
|
|
vpp_18.07-rc0~456-gb361076_amd64.deb vpp-dbg_18.07-rc0~456-gb361076_amd64.deb
|
||
|
|
vpp-api-java_18.07-rc0~456-gb361076_amd64.deb vpp-dev_18.07-rc0~456-gb361076_amd64.deb
|
||
|
|
vpp-api-lua_18.07-rc0~456-gb361076_amd64.deb vpp-lib_18.07-rc0~456-gb361076_amd64.deb
|
||
|
|
vpp-api-python_18.07-rc0~456-gb361076_amd64.deb vpp-plugins_18.07-rc0~456-gb361076_amd64.deb
|
||
|
|
|
||
|
|
Packages built installed end up in build-root directory. Finally, the command below installs all built packages.
|
||
|
|
|
||
|
|
.. code-block:: console
|
||
|
|
|
||
|
|
$ sudo bash
|
||
|
|
# dpkg -i *.deb
|