Version 25 (modified by 16 years ago) ( diff ) | ,
---|
Installation
Prerequisites
ariba depends on libraries that may not be installed on your system:
Furthermore, you need default development tools - that are most likely already installed on your system - such as gcc/g++, autoconf, automake, aclocal, libtool, liblt-dev ...
Quick Install
ariba currently build on Linux systems. Our reference platform is Ubuntu 8.04 with the g++ compiler version 4.1. Download the latest ariba package from the the download site:
Extract the archive and change into the project directory:
> tar xfz ./ariba-x.x.x.tar.gz > cd ariba-x.x.x
Now, configure, compile, and install ariba (if not all libraries needed by Ariba are available on your system, read the section 'Prequisites'). If no configure
script is available (e.g. when you checked out an svn version), run the ./bootstrap
script first.:
> ./configure > make > make install
In case you don't want to install Ariba into your system but to a local place, do:
> mkdir build > ./configure --prefix=$PWD/build > make > make install
Local install
If the required libraries are not available on your system or don't want to install them to the system you can install them locally with
the bootstrap_libs
command from the ariba tarball. This script will automatically download all necessary libraries and compile them inside a new ./libs
subdirectory and install them into ./build
. In the end the ariba library itself is compiled to ./build
.
Running the PingPong Sample
The PingPong binary pingpong
is installed in build/bin
. It has one parameter, a configuration file. You can find sample configuration files in the etc/pingpongconfig
folder. Three configuration files are provided. You can start the initiator as follows:
> ./pingpong ../../etc/pingpongconfig/settings_initiator.cnf
If this will fail to find the libariba
you may have to set the LD_LIBRARY_PATH
correctly:
> export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/home/user/ariba/build/lib
When running the pingpong
application it will output a large number of log messages and the initiator will wait for other nodes to join. You can start them using the configuration files settings_node1.cnf
and settings_node2.cnf
. You may need to adjust the configurations files: currently both node1 and node2 try to join the initiator on the local machine. This will only work if you start all instances on a local machine.
Once the PingPong sample is running and the nodes have connected, each node will send out ping messages to every node he knows in the overlay structure every 5 seconds. You can now e.g. test mobility of Ariba and change the IP address of a node, or swith from LAN connection to WLAN. The links established by the PingPong sample through Ariba are mobility invariant and automatically repaired.
Selecting a compiler
As the g++-4.3 compiler is very restrictive when compiling C++ and you will have some trouble with Boost and Log4cxx, we suggest to use e.g. g++-4.1. You then have to compile the libraries and Ariba with this compiler. You can tell Log4cxx and Ariba to use a different compiler using:
./configure --prefix=... CXX=g++-4.1
This will not work in Boost as the configure
script is just a wrapper around the Boost Build.System bjam
. You can edit the jamfile in the Boost root directory:
using gcc : 4.1 ;
and then build using bjam as described in http://www.boost.org/doc/libs/1_38_0/more/getting_started/unix-variants.html
.
Overview of special configure
options
There are several options to configure
that are specific to Ariba:
--enable-debug=yes
- for building a debug build--enable-profiling=yes
- for profiling with gprof--enable-logcolors=yes
- for colorful logging output