1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
|
.. _JVPP:
.. toctree::
Building JVPP from source
=========================
JVPP uses cmake to configure and build source code. The minimal version of cmake is 3.5.
Ensure that you have proper version of cmake installed.
JVPP depends on VPP packages (Debian or Centos):
* vpp
* vpp-plugins
* vpp-dev (vpp-devel on Centos)
Vpp and vpp-plugins packages contain API source file, which are used to generate Java API bindings. Vpp dev package
contains header files needed for build.
Obtaining the source
--------------------
You can get JVPP source code from gerrit.fd.io using git:
git clone https://gerrit.fd.io/r/jvpp
or from github:
https://github.com/FDio/jvpp.git
Install dependencies (Optional, one time only)
------------------
You can install all dependencies using provided install-dep target:
.. code-block:: console
make install-dep
Cleanup (Optional)
------------------
Whenever you need to clean the setup you can use "clean.sh" script in the root folder. This cleans the build and clears
the cache. This is usefull mostly when you change something in JVPP to ensure everything is rebuild from scratch.
Configuring using cmake
-----------------------
Configuration using cmake is very easy, the whole process is automated. All you need to do is issue following command
from JVPP's root directory:
.. code-block:: console
cmake .
This will configure all variables and setup the build.
If needed there are several optional parameters that can be set. You can list all configuration parameters using:
.. code-block:: console
cmake -LH
as an example you can enable packaging using ZIP or TGZ. DEB or RPM packages are automatically configured based on OS.
To enable packaging using ZIP or TGZ (or both) add optional parameter to cmake like this:
.. code-block:: console
cmake -DPackZip=ON -DPackTgz=ON .
.. note::
PackZip, PackTgz are boolean variables. You can use "1, ON, YES, TRUE, Y, or a non-zero number" to enable
or "0, OFF, NO, FALSE, N, IGNORE, NOTFOUND" to disable these options.
Building the source
-------------------
To build the source use make command:
.. code-block:: console
make
You can also install the library (Optional) using (you need to use sudo or have root privileges to install libraries):
.. code-block:: console
sudo make install
Building the packages
---------------------
During the setup using cmake the operating system is automatically recognised and everything is set up so you can build
packages for your current operating system. Only Debian based (tested on Ubuntu) and Centos (tested on Centos 7)
are supported for now.
To build the package you need to call:
.. code-block:: console
make package
You can find the packages in build-root/packages folder.
Getting JVPP jar
================
VPP provides java bindings which can be downloaded at:
* https://nexus.fd.io/content/repositories/fd.io.release/io/fd/vpp/jvpp-core/19.01/jvpp-core-19.01.jar
Getting JVPP via maven
------------------------------------
**1. Add the following to the repositories section in your ~/.m2/settings.xml to pick up the fd.io maven repo:**
.. code-block:: console
<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>
For more information on setting up maven repositories in settings.xml, please look at:
* https://maven.apache.org/guides/mini/guide-multiple-repositories.html
**2. Then you can get JVPP by putting in the dependencies section of your pom.xml file:**
.. code-block:: console
<dependency>
<groupId>io.fd.vpp</groupId>
<artifactId>jvpp-core</artifactId>
<version>19.01</version>
</dependency>
For more information on maven dependency managment, please look at:
* https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html
Installing JVPP manually to local maven repository
--------------------------------------------------
Once JVPP is successfully built, you can install it to local .m2 repository.
To do so use provided script in JVPP root directory:
.. code-block:: console
./install_jvpp.sh
|
