OBAMP

Overlay Borůvka Based Ad-hoc Multicast Protocol BR

Project home page: http://www.radiolabs.it/obamp/ BR

The source code of OBAMP is on our SVN server

You can use the nice Trac interface http://test.ninux.org/svntrac/browser/OBAMPxP/trunk

Or you can checkout the code

svn co http://test.ninux.org/svn/OBAMPxP/trunk

Compile the sources with Apache Ant

First download the last version of Ant at the following URL: http://ant.apache.org/bindownload.cgi Untar the file somewhere in your file system. Export the ANT_HOME variable and update your PATH variable. We assume you have already installed a JDK and correctly exported the JAVA_HOME variable

For example, if ant_home is the directory where you untarred Apache Ant and java_home is the directory where is your Java JDK:

1) On a Linux Box:

export ANT_HOME=/usr/local/ant_home
export JAVA_HOME=/usr/local/jdk_home
export PATH=${PATH}:${ANT_HOME}/bin:${JAVA_HOME}/bin

2) On a Windows PC:

set ANT_HOME=C:\ant_home
set JAVA_HOME=C:\jdk_home
set PATH=%PATH%;%ANT_HOME%\bin;%JAVA_HOME%\bin

At this point go with your shell into the trunk directory of the source code  OBAMPxP\trunk  and execute

ant dist

to compile automatically all the sources

When the compiling process is finished you will find a bin directory with all the compiled classes and a dist directory with the binary distribution OBAMPxP.jar and the needed configuration files.

Compile on Gentoo Quick Guide

As root emerge the Apache Ant ebuild

emerge dev-java/ant

Now with your normal user you can compile and execute!

cd
svn co http://test.ninux.org/svn/OBAMPxP/trunk/ obamp
cd obamp
ant dist
cd dist
java -jar OBAMPxP.jar 

Gentoo specific guidelines are over... follow the rest of the documentation!

Using OBAMPxP proxy

Before starting the proxy, you must edit the following files:

obamp.cfg
obamp_nodes.txt

In the first file insert the IP address of your machine, and the operating system you are using. Currently only ipv4 is supported Currently only Windows and Linux are supported. Mac OS X and BSD support is coming soon.

<local_address> 
<Operative_System>

In the second file we have to write the list of the IP addresses that are running OBAMP on the network This file must be exactly the same on every PC partecipating to the multicast session, so it could be a good idea to place it on a web server on a RSS feed stuff.

I know this sounds stupid, but a patch is on the way to avoid this step.

Configuration is over, you can now launche the OBAMPxP.jar with a simple click of your mouse, or using the shell:

java -jar OBAMPxP.jar

Una volta settati corretamente questi parametri, si può eseguire il file OBAMPxP.jar con un semplice click del mouse, oppure da shell con il seguente comando:

• java -jar OBAMPxP.jar

Per avviare la sessione, premere il pulsante Join sulla GUI di OBAMPxP.

Invio e ricezione di dati multicast

Le porte locali per l'invio e la ricezione dei dati sull'albero di multicast sono rispettivamente la 9000 e la 9002. Se per esempio vogliamo trasmettere una canzone tramite VLC al gruppo di multicast dobbiamo settare VLC in modo che trasmetti all'indirizzo della macchina locale (localhost) sulla porta 9000. Per la ricezione invece dobbiamo mettere in ascolto VLC in locale sulla porta 9002.