This tutorial will explain you, step-by-step how to experiment with OverSwarm and implement a swarm algorithm tutorial. It assumes you are using a Debian/Ubuntu Linux distribution.
Install the required dependencies:
sudo apt-get install build-essential gcc g++ bison flex perl \ tcl-dev tk-dev blt libxml2-dev zlib1g-dev openjdk-6-jre \ doxygen graphviz openmpi-bin libopenmpi-dev libpcap-dev libgmp3-dev
For RHEL/Centos/SL/Fedora the following should work:
yum install flex bison perl tcl-devel tk-devel blt libxml2-devel zlib-devel doxygen graphviz openmpi-devel libpcap-devel gmp-devel gcc java-1.6.0-openjdk java-1.6.0-openjdk-devel gcc-c++ make
Download OMNet++ 4.1 from www.omnetpp.org/omnetpp/doc_download/2217-omnet-41-source--ide-tgz to /tmp. We will install omnet under $HOME/sim
mkdir ~/sim cd ~/sim tar xzvf /tmp/omnetpp-4.1-src.tgz
Add the following in your $HOME/.bashrc :
export PATH=~/sim/omnetpp-4.1/bin:$PATH
Then run
source ~/.bashrc
Compile OMNet++
cd ~/sim/omnetpp-4.1 ./configure make
Download the patched INet from www.oversim.org/chrome/site/INET-OverSim-20101019.tgz, uncompress and compile it:
cd ~/sim tar xzvf /tmp/INET-OverSim-20101019.tgz cd ~/sim/INET-OverSim-20101019 make
Download OverSim from www.oversim.org/chrome/site/OverSim-20101103.tgz, uncompress and compile it:
cd ~/sim tar xzvf /tmp/OverSim-20101103.tgz cd ~/sim/OverSim-20101103 make
Install the required packages:
sudo apt-get install git-core openjdk-6-jdk
Get the OverSim sources from Gitorious. Two packages are essential for running OverSwarm: the compiler and the library. The compiler repository is at the following address:
git://gitorious.org/overswarm/ovswcompiler.git
The compiler is written in Java. From the ~/sim directory, download the code with:
git clone git://gitorious.org/overswarm/ovswcompiler.git
and compile all source files using javac.
cd ovswcompiler/src for i in `find -name *.java`; do javac $i; done
The library (called OvSwLib) is at the following address:
git://gitorious.org/overswarm/ovswlib.git
and can be similarly downloaded with
cd ~/sim git clone git://gitorious.org/overswarm/ovswlib.git
Compile it with
cd ovswlib/oversim make
Modify the OverSim Makefile (in ~/sim/OverSim-20101103) by adding the following line at the beginning:
OVSWDIR = <your home directory>/sim/ovswlib/oversim
Change ”<your home directory>” with the path to your home directory. Then modify the BUILD_OPTIONS line by adding the following directives:
-I$(OVSWDIR) -L$(OVSWDIR)
Furthermore, in change the following line:
BUILD_OPTIONS += -- -lgmp -lovsw
Recompile OverSim from the ~/sim/OverSim-20101103 directory:
make makefiles make
Download and uncompress the overswarm-patch-20101103.diff.tar.gz into your OverSim install directory. Uncompress the tar.gz and apply patch:
cd ~/sim/OverSim-20101103 wget http://syscall.org/lib/exe/fetch.php/overswarm-patch-20101103.diff.tar.gz tar xvfz overswarm-patch-20101103.diff.tar.gz patch -p1 < OverSwarm-Patch-20101103.diff