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 (if it works!)

Download Binary Distribution

Here is a zip file with the binary distribution: attachment:OBAMPxP.zip Please read the README file inside the archive!

Or you can grab it directly from the SVN

Download the folder with the OBAMPxP.jar file, and just use it! Please read the README file!

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

Compile the sources with Apache Ant

Checkout the code

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

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
chmod 755 obamp.sh
./obamp.sh

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.

Once parameters are set correcty you can execute the OBAMPxP.jar clicking on it with the mouse or opening a shell

java -cp OBAMPxP.jar:lib/log4j-1.2.14.jar CollabTool

on Unix/Linux just run

chmod 755 obamp.sh
./obamp.sh

To start the OBAMP session click on the Join button on the GUI

Sending and receiving multicast data

Local ports for sending and receiving on the multicast overlay tree are

sending 9000

receiving 9002

For example if you want to trasmit data with VLC to the multicast group you have to set VLC so that it trasmits to current IP address on port 9000

To receive data we have to set VLC to listen on current IP address on port 9002

Of course ALL ports mentioned are UDP