An Overlay-based
Virtual Network Substrate
SpoVNet

source: INSTALL @ 10700

Last change on this file since 10700 was 10700, checked in by s_taenzer@…, 6 years ago

Merge CMake branch into trunk

File size: 6.8 KB
Line 
1Please see the latest Installation instructions on http://ariba-underlay.org/
2here: http://ariba-underlay.org/trac/spovnet-base/wiki/BaseInstall
3
4Please see also http://spovnet.de/ for further information
5about Ariba and its application.
6
7
8Prerequisites
9=============
10ariba depends on libraries that may not be installed on your system:
11
12    * Boost (version >=1.42)
13    * GMP
14    * CMake (version >=2.8)
15
16and optionally on
17
18    * Log4Cxx (version >= 0.10.0) for more sophisticated logging
19    * Avahi for more efficient bootstrapping in local networks
20    * LibBluetooth/Bluez for bluetooth support
21    * Doxygen to build the documentation
22
23Furthermore, you need default development tools - that are most likely already
24installed on your system - such as gcc/g++, libtool, liblt-dev ...
25
26
27Quick Install (If all dependencies are satisfied)
28=============
29
30ariba currently builds on Linux systems. Our reference platform is Ubuntu 8.04
31with the g++ compiler version 4.1. However, latest Ubuntu releases should work
32too.
33
34Download the latest ariba package from the the download site
35http://ariba-underlay.org/downloads or get the latest trunk code:
36> svn co https://svn.tm.kit.edu/SpoVNet-KA/entwicklung/ariba/trunk ariba-trunk
37
38If you downloaded ariba from the website extract the archive and change into the
39project directory:
40> tar xfz ./ariba-x.x.x.tar.gz
41> cd ariba-x.x.x
42
43For SVN checkout you have to:
44> cd ariba-trunk
45
46Now create a directory to build ariba in:
47> mkdir build
48> cd build
49
50Next the makefiles have to be generated and the source compiled:
51> cmake ..
52> make
53
54HINT: you may use
55> make -j 2
56for a double processor/core system to speed up the compilation,
57make -j 4 if you have quad-core respectively, and so on. If
58the compilation stops, try make without the -j option again.
59
60And finally ariba will be installed into the system:
61> make install
62
63
64Custom Build Options
65====================
66The build may be customized in various ways by setting CMake options. This can
67be done by giving them as arguments on the command line:
68> cmake .. -DOPTION=value
69
70by using the CMake GUI which lets you set the variables graphically:
71> cmake-gui ..
72
73or running cmake in interactive mode:
74> cmake -i ..
75
76The last two ways also give an overview which options exist.
77
78Important options:
79
80CMAKE_INSTALL_PREFIX - Where to install the compiled files. The default on Unix
81                       platforms is /usr/local/. If you for example don't want
82                       or can't install system wide, you can specify a directory
83                       you have control over. The files will be installed to
84                       "${prefix}/include/", "${prefix}/lib/" and so on.
85
86CMAKE_BUILD_TYPE     - One of "", "Release", "Debug", "RelWithDebInfo" or
87                       "MinSizeRel". This influences the build in various ways
88                       (e.g. which compiler optimizations are turned on, whether
89                       debug symbols are included, what warnings to show).
90
91ENABLE_{AVAHI,BLUETOOTH,LOG4CXX}
92                     - If set to OFF or 0 (ON is the default) it disables the
93                       support of the feature even if the corresponding library
94                       (see above) was detected to be present.
95
96<library>_INCLUDE_DIR - Where the directory containing the header files for
97                       <library> is located. If the library is installed in the
98                       usual system paths CMake should be able to automatically
99                       find the right location. If the library is located
100                       elsewhere (e.g. because you compiled it yourself in your
101                       home directory) then you may need to set this variable
102                       manually.
103
104<library>_LIBRARY    - Where the library file (aka the .so, .a or .dll file) for
105                       <library> is located. If the library is installed in the
106                       usual system paths CMake should be able to automatically
107                       find the right location. If the library is located
108                       elsewhere (e.g. because you compiled it yourself in your
109                       home directory) then you may need to set this variable
110                       manually.
111
112DOCUMENTATION_GENERATE_GRAPHICS
113                     - Whether the documentation should include graphics such as
114                       inheritance and include graphs (OFF by default). This
115                       might take a long time and consume a lot of space.
116
117CMAKE_{C,CXX}_COMPILER - Which C/C++ compiler to use
118CMAKE_{C,CXX}_FLAGS  - Which additional flags to give to the compiler (e.g. -pg
119                       for profiling support)
120
121
122Running the PingPong Sample
123===========================
124The PingPong binary pingpong is installed in "${prefix}/lib/ariba/" or found
125directly in the build tree at "sample/pingpong/pingpong". It has one parameter,
126a configuration file. You can find sample configuration files in the
127"etc/pingpong" folder. If no configuration file is given, the node will randomly
128select its NodeID but will not find other nodes. This is because bootstrap
129modules are selected in the configuration file.
130> ./sample/pingpong/pingpong ../etc/pingpong/settings_node1.cnf
131
132If this fails to find the libariba you may have to set the LD_LIBRARY_PATH
133correctly in your current terminal, or better add it to your .bashrc
134> export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/user/ariba/build/source/ariba
135
136When running the pingpong application it will output a large number of log
137messages and the initiator will wait for other nodes to join. You can start them
138using the configuration files settings_node1.cnf and settings_node2.cnf. You may
139need to adjust the configurations files: currently both node1 and node2 try to
140join the initiator on the local machine. This will only work if you start all
141instances on a local machine.
142
143Once the PingPong sample is running and the nodes have connected, each node will
144send out ping messages to every node he knows in the overlay structure every
1455 seconds. You can now e.g. test mobility of Ariba and change the IP address of
146a node, or swith from LAN connection to WLAN. The links established by the
147PingPong sample through Ariba are mobility invariant and automatically repaired.
148
149
150Cross-Compiling for Maemo
151=========================
152Ariba runs on Nokia Maemo 4 (tested) and probably Maemo 5. We have tested Ariba
153on an N810 device. Cross-Compiling is done using Scratchbox. Use the
154preassembled Scratchbox version provided by Nokia which will install and
155configure the complete Scratchbox system automatically.
156
157If you compile for Maemo you have to set the HAVE_MAEMO option in CMake.
158
159Internally there are a number of special cases where handling on Maemo is
160different from normal Linux. If you require special handling, do the following
161in your code:
162
163#include "ariba/config.h"
164...
165#ifdef HAVE_MAEMO
166 // special Maemo handling
167#endif
Note: See TracBrowser for help on using the repository browser.