<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>ObampDocsEnglish</title><revhistory><revision><revnumber>61</revnumber><date>2009-03-26 16:04:06</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>60</revnumber><date>2008-03-18 17:27:59</date><authorinitials>localhost</authorinitials><revremark>converted to 1.6 markup</revremark></revision><revision><revnumber>59</revnumber><date>2008-03-05 11:10:49</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 57.</revremark></revision><revision><revnumber>58</revnumber><date>2008-03-05 10:40:06</date><authorinitials>132-5.sh.cgocable.ca</authorinitials><revremark>pills</revremark></revision><revision><revnumber>57</revnumber><date>2008-02-06 10:07:30</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 55.</revremark></revision><revision><revnumber>56</revnumber><date>2008-02-05 21:46:42</date><authorinitials>116.212-142-143.static.clientes.euskaltel.es</authorinitials><revremark>None</revremark></revision><revision><revnumber>55</revnumber><date>2008-02-03 14:48:28</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 21.</revremark></revision><revision><revnumber>54</revnumber><date>2008-02-03 13:47:35</date><authorinitials>ppp3240.kitakyushu01.bbiq.jp</authorinitials><revremark>Songs Ringtones</revremark></revision><revision><revnumber>53</revnumber><date>2008-02-03 13:37:21</date><authorinitials>219x113x165x91.ap219.ftth.ucom.ne.jp</authorinitials><revremark>None</revremark></revision><revision><revnumber>52</revnumber><date>2008-02-03 10:03:38</date><authorinitials>tctvnet22176.ccnw.ne.jp</authorinitials><revremark>FreeRingtones</revremark></revision><revision><revnumber>51</revnumber><date>2008-02-03 08:52:21</date><authorinitials>ev1s-64-246-18-25.ev1servers.net</authorinitials><revremark>Ringtones</revremark></revision><revision><revnumber>50</revnumber><date>2008-02-03 03:53:36</date><authorinitials>202.84.17.42</authorinitials><revremark>None</revremark></revision><revision><revnumber>49</revnumber><date>2008-02-03 03:04:12</date><authorinitials>c-75-72-189-187.hsd1.mn.comcast.net</authorinitials></revision><revision><revnumber>48</revnumber><date>2008-02-03 02:57:51</date><authorinitials>69.50.64.135</authorinitials><revremark>None</revremark></revision><revision><revnumber>47</revnumber><date>2008-02-03 02:14:09</date><authorinitials>ideation.mit.edu</authorinitials><revremark>FreeRingtones</revremark></revision><revision><revnumber>46</revnumber><date>2008-02-03 02:05:13</date><authorinitials>59x87x124x101.ap59.ftth.ucom.ne.jp</authorinitials><revremark>None</revremark></revision><revision><revnumber>45</revnumber><date>2008-02-03 01:09:17</date><authorinitials>221x241x160x111.ap221.ftth.ucom.ne.jp</authorinitials><revremark>Songs Ringtones</revremark></revision><revision><revnumber>44</revnumber><date>2008-02-03 00:37:27</date><authorinitials>ibcj.postech.ac.kr</authorinitials><revremark>Ringtones Free</revremark></revision><revision><revnumber>43</revnumber><date>2008-02-02 23:37:34</date><authorinitials>ZioPRoTo</authorinitials><revremark>Ripristinata la revisione 39.</revremark></revision><revision><revnumber>42</revnumber><date>2008-02-02 23:27:52</date><authorinitials>bd46ab5.fln.virtua.com.br</authorinitials><revremark>Ringtones Free</revremark></revision><revision><revnumber>41</revnumber><date>2008-02-02 22:41:50</date><authorinitials>38.99.101.236</authorinitials><revremark>None</revremark></revision><revision><revnumber>40</revnumber><date>2008-02-02 22:19:44</date><authorinitials>38.99.101.236</authorinitials><revremark>Free Ringtone</revremark></revision><revision><revnumber>39</revnumber><date>2008-02-01 19:26:51</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 21.</revremark></revision><revision><revnumber>38</revnumber><date>2008-02-01 14:51:31</date><authorinitials>202.84.17.42</authorinitials><revremark>None</revremark></revision><revision><revnumber>37</revnumber><date>2008-02-01 12:26:44</date><authorinitials>so7.cty-net.ne.jp</authorinitials><revremark>None</revremark></revision><revision><revnumber>36</revnumber><date>2008-02-01 11:38:11</date><authorinitials>59-171-79-152.rev.home.ne.jp</authorinitials><revremark>None</revremark></revision><revision><revnumber>35</revnumber><date>2008-02-01 09:11:56</date><authorinitials>221.232.159.112</authorinitials><revremark>None</revremark></revision><revision><revnumber>34</revnumber><date>2008-02-01 08:32:15</date><authorinitials>218.106.244.90</authorinitials><revremark>None</revremark></revision><revision><revnumber>33</revnumber><date>2008-02-01 05:58:54</date><authorinitials>218.84.25.250</authorinitials><revremark>None</revremark></revision><revision><revnumber>32</revnumber><date>2008-02-01 05:17:29</date><authorinitials>cliente-41025.iberbanda.es</authorinitials><revremark>None</revremark></revision><revision><revnumber>31</revnumber><date>2008-02-01 03:52:09</date><authorinitials>201-88-107-130.pvoce300.ipd.brasiltelecom.net.br</authorinitials><revremark>None</revremark></revision><revision><revnumber>30</revnumber><date>2008-01-31 23:58:26</date><authorinitials>202.105.182.87</authorinitials><revremark>None</revremark></revision><revision><revnumber>29</revnumber><date>2008-01-31 16:52:10</date><authorinitials>59-171-79-152.rev.home.ne.jp</authorinitials><revremark>None</revremark></revision><revision><revnumber>28</revnumber><date>2008-01-31 13:50:24</date><authorinitials>85.187.15.249</authorinitials><revremark>None</revremark></revision><revision><revnumber>27</revnumber><date>2008-01-31 11:41:35</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 23.</revremark></revision><revision><revnumber>26</revnumber><date>2008-01-31 10:26:30</date><authorinitials>ideation.mit.edu</authorinitials><revremark>Ring Tones</revremark></revision><revision><revnumber>25</revnumber><date>2008-01-31 07:10:10</date><authorinitials>ZioPRoTo</authorinitials><revremark>Ripristinata la revisione 23.</revremark></revision><revision><revnumber>24</revnumber><date>2008-01-31 06:56:11</date><authorinitials>202.70.199.133.iolbroadband.net</authorinitials><revremark>Ringtones Free</revremark></revision><revision><revnumber>23</revnumber><date>2008-01-27 09:44:53</date><authorinitials>ClauzClauz</authorinitials><revremark>Ripristinata la revisione 21.</revremark></revision><revision><revnumber>22</revnumber><date>2008-01-26 20:25:17</date><authorinitials>c-ceffe155.1111-1-64736c12.cust.bredbandsbolaget.se</authorinitials><revremark>Ringtone Free</revremark></revision><revision><revnumber>21</revnumber><date>2007-06-20 14:54:37</date><authorinitials>ClauzClauz</authorinitials></revision><revision><revnumber>20</revnumber><date>2007-06-20 14:54:05</date><authorinitials>ClauzClauz</authorinitials><revremark>direttiva #language en</revremark></revision><revision><revnumber>19</revnumber><date>2007-06-05 16:51:20</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>updated doc to reflect changes in current svn version (fabian)</revremark></revision><revision><revnumber>18</revnumber><date>2007-06-04 11:02:02</date><authorinitials>ClauzClauz</authorinitials><revremark>added to CategoryEnglishPages</revremark></revision><revision><revnumber>17</revnumber><date>2007-05-31 14:59:28</date><authorinitials>160.80.82.69</authorinitials></revision><revision><revnumber>16</revnumber><date>2007-05-31 01:02:35</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>typos ... (fabian)</revremark></revision><revision><revnumber>15</revnumber><date>2007-05-31 01:00:45</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>fixed typo, added note about http ... (fabian)</revremark></revision><revision><revnumber>14</revnumber><date>2007-05-31 00:58:44</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>added infos about log4j and eclipse build path settings etc. (fabian)</revremark></revision><revision><revnumber>13</revnumber><date>2007-05-29 22:32:40</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>12</revnumber><date>2007-05-29 22:31:25</date><authorinitials>ZioPRoTo</authorinitials><revremark>Fixed all the links that now point to the new SVN server</revremark></revision><revision><revnumber>11</revnumber><date>2007-05-26 12:31:51</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>Fixed Windows cmd-line startup instructions (Fabian)</revremark></revision><revision><revnumber>10</revnumber><date>2007-05-24 20:46:40</date><authorinitials>port-212-202-0-11.dynamic.qsc.de</authorinitials><revremark>added new run instructions to include log4j (by Fabian Bieker)</revremark></revision><revision><revnumber>9</revnumber><date>2007-04-28 10:24:37</date><authorinitials>213.61.66.94</authorinitials></revision><revision><revnumber>8</revnumber><date>2007-04-27 23:11:47</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>7</revnumber><date>2007-04-26 15:08:56</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>6</revnumber><date>2007-04-26 15:07:19</date><authorinitials>Remo Pomposini</authorinitials></revision><revision><revnumber>5</revnumber><date>2007-04-26 14:52:33</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>4</revnumber><date>2007-04-18 16:15:19</date><authorinitials>Remo Pomposini</authorinitials></revision><revision><revnumber>3</revnumber><date>2007-04-17 22:00:33</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>2</revnumber><date>2007-04-17 21:54:14</date><authorinitials>ZioPRoTo</authorinitials></revision><revision><revnumber>1</revnumber><date>2007-04-17 21:46:10</date><authorinitials>ZioPRoTo</authorinitials></revision></revhistory></articleinfo><section><title>OBAMP</title><para>Overlay Borůvka Based Ad-hoc Multicast Protocol </para><para>Project home page: <ulink url="http://netgroup.uniroma2.it/Andrea_Detti/obamp/"/> </para><para>The source code of OBAMP cross-layer version for OLSR (named OBAMPxP) is on our SVN server <ulink url="https://svn.ninux.org/svn/ninuxdeveloping/"/> </para><para>You can use the nice Trac interface <ulink url="https://svn.ninux.org/ninuxdeveloping/browser/OBAMPxP/trunk"/>  </para><section><title>Download Binary Distribution</title><para>Here is a zip file with the binary distribution: <ulink url="http://www.nnx.me/ObampDocsEnglish/ObampDocsEnglish?action=AttachFile&amp;do=get&amp;target=OBAMPxP.zip">OBAMPxP.zip</ulink> Please read the README file inside the archive! <inlinemediaobject><imageobject><imagedata depth="16" fileref="http://www.nnx.me//moin_static197/ninuxtheme02/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para><para>Or you can grab it directly from the SVN </para><para>Download the folder with the OBAMPxP.jar file, and just use it! Please read the README file! <inlinemediaobject><imageobject><imagedata depth="16" fileref="http://www.nnx.me//moin_static197/ninuxtheme02/img/smile.png" width="16"/></imageobject><textobject><phrase>:)</phrase></textobject></inlinemediaobject> </para><screen><![CDATA[svn co http://svn.ninux.org/svn/ninuxdeveloping/OBAMPxP/trunk/dist OBAMPxP]]></screen></section><section><title>Compile the sources with Apache Ant</title><para>Checkout the code </para><screen><![CDATA[svn co http://svn.ninux.org/svn/ninuxdeveloping/OBAMPxP/trunk]]></screen><para>Download the last version of Ant at the following URL: <ulink url="http://ant.apache.org/bindownload.cgi"/> Untar the file somewhere in your file system. Export the <code>ANT_HOME</code> variable and update your <code>PATH</code> variable. We assume you have already installed a JDK and correctly exported the JAVA_HOME variable </para><para>For example, if <code>ant_home</code> is the directory where you untarred Apache Ant and <code>java_home</code> is the directory where is your Java JDK: </para><para>1) On a Linux Box: </para><screen><![CDATA[export ANT_HOME=/usr/local/ant_home
export JAVA_HOME=/usr/local/jdk_home
export PATH=${PATH}:${ANT_HOME}/bin:${JAVA_HOME}/bin]]></screen><para>2) On a Windows PC: </para><screen><![CDATA[set ANT_HOME=C:\ant_home
set JAVA_HOME=C:\jdk_home
set PATH=%PATH%;%ANT_HOME%\bin;%JAVA_HOME%\bin]]></screen><para>At this point go with your shell into the trunk directory of the source code  <code> OBAMPxP\trunk </code> and execute </para><screen><![CDATA[ant dist]]></screen><para>to compile automatically all the sources </para><para>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 <code>OBAMPxP.jar</code> and the needed configuration files. </para></section><section><title>Compile on Gentoo Quick Guide</title><para>As root emerge the Apache Ant ebuild </para><screen><![CDATA[emerge dev-java/ant]]></screen><para>Now with your normal user you can compile and execute! </para><screen><![CDATA[cd
svn co http://svn.ninux.org/svn/ninuxdeveloping/OBAMPxP/trunk/ obamp
cd obamp
ant dist
cd dist
chmod 755 obamp.sh
./obamp.sh]]></screen><para>Gentoo specific guidelines are over... follow the rest of the documentation! </para></section><section><title>Using OBAMPxP proxy</title><para>Before starting the proxy, you must edit the following files: </para><screen><![CDATA[obamp.cfg
obamp_nodes.txt]]></screen><para>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. </para><screen><![CDATA[<local_address> 
<Operative_System>]]></screen><para>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. </para><para>I know this sounds stupid, but a patch is on the way to avoid this step. </para><para>Once parameters are set correcty you can execute the OBAMPxP.jar .  Click on it with the mouse or open a shell and type  </para><screen><![CDATA[java -jar OBAMPxP.jar]]></screen><para>on Unix/Linux. Are just use the shellscript wrapper: </para><screen><![CDATA[chmod 755 obamp.sh
./obamp.sh]]></screen><para>On Windows double click the OBAMPxP.jar or run: </para><screen><![CDATA[java -jar OBAMPxP.jar]]></screen><para>or just start the script wrapper by executing: </para><screen><![CDATA[obamp.bat]]></screen><para>To start the OBAMP session click on the Join button on the GUI. </para></section><section><title>Sending and receiving multicast data</title><para>Local ports for sending and receiving on the multicast overlay tree are </para><para>sending 9000 </para><para>receiving 9002 </para><para>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 </para><para>To receive data we have to set VLC to listen on current IP address on port 9002 </para><para>Of course ALL ports mentioned are UDP </para></section><section><title>OBAMPxP and log4j</title><para>The current svn version of OBAMPxP uses <ulink url="http://logging.apache.org/log4j/docs/">log4j</ulink> for logging. log4j init is done the following way: </para><orderedlist numeration="arabic"><listitem><para>read log4j settings from $PWD/log4j.properties </para></listitem><listitem><para>if the above fails, then read log4j setting from inside the OBAMPxP.jar  </para></listitem><listitem><para>if the above fails, then init log4j using calling <ulink url="http://www.nnx.me/ObampDocsEnglish/BasicConfigurator#">BasicConfigurator</ulink>.configure()  </para></listitem></orderedlist><para>The code to do this, is in <ulink url="http://www.nnx.me/ObampDocsEnglish/Log4Init#">Log4Init</ulink>.java and is called by <ulink url="http://www.nnx.me/ObampDocsEnglish/CollabTool#">CollabTool</ulink>.main(String[]) . </para></section><section><title>Quick Howto for Eclipse Users</title><para>Just a few notes on using <ulink url="http://www.eclipse.org/">Eclipse</ulink> IDE to edit the OBAMPxP source code:  </para><itemizedlist><listitem><para>use the <ulink url="http://subclipse.tigris.org/install.html">subclipse</ulink> svn plugin to check out the source code from the SVN: </para><itemizedlist><listitem><para>Set the svn repository to <ulink url="https://svn.ninux.org/svn/ninuxdeveloping/"/> (http is availible, too) </para></listitem><listitem><para>check out OBAMPxP/trunk </para></listitem></itemizedlist></listitem><listitem><para>Tell eclipse to use java 1.5 for code and source </para></listitem><listitem><para>Close eclipse </para></listitem><listitem><para>In your project directory do the following:  </para><itemizedlist><listitem><para>Copy eclipse.classpath to .classpath </para></listitem><listitem><para>Create a directory called eclipse-bin (to prevent eclipse from messing around with the ant build) </para></listitem></itemizedlist></listitem><listitem><para>Start eclipse </para></listitem><listitem><para>Delete any output folders created by eclipse </para></listitem><listitem><para>You can use ant / build.xml to build the project </para></listitem><listitem><para>If you just want to run OBAMPxP from inside eclipse, select <ulink url="http://www.nnx.me/ObampDocsEnglish/CollabTool#">CollabTool</ulink>.java (it is in the it.radiolabs.obampxp package) and choose &quot;Run as Java Application&quot; </para><itemizedlist><listitem><para>Set to working directory to &quot;dist&quot; or create a seperate directory containing the obamp.cfg etc.  </para></listitem><listitem><para>If you want to do some debuging you should set &quot;-ea&quot; to enable assertions (currently there are not many assertions, but that's going to change soon...)  </para></listitem></itemizedlist></listitem></itemizedlist></section></section></article>