OverSim Installation Instructions

These instructions show you how to install OverSim for Linux. Compiling and
running OverSim for Windows is currently not supported (If you want to
compile OverSim for Windows, you should take a look at the
OMNeT++ install instructions for Windows on
http://www.omnetpp.org/pmwiki/index.php?n=Main.OmnetppInstallation


1. Requirements for OMNeT++ and OverSim:
    * Tcl/Tk 8.4
    * libgmp
    * Perl::Descriptive (optional, for simulation output postprocessing with
                         overStat.pl)

If you have a debian-based distribution like Ubuntu you can install these
packages with:
   
>  sudo apt-get install tk8.4-dev libgmp3-dev libstatistics-descriptive-perl
   

2. Download OMNeT++ 3.3 from http://www.omnetpp.org/ after reading the
   License

3. Create a new directory (in the following we assume you want to install
   OMNeT++ and OverSim to ~/sim/) and extract OMNeT++:
 
>  mkdir ~/sim
>  cd ~/sim
>  tar xzf /tmp/omnetpp-3.3-src.tgz
 

4. Add the following lines to your .bashrc or .profile:
 
>  export PATH=$PATH:~/sim/omnetpp-3.3/bin:~/sim/INET-20061020-OverSim-2/bin
>  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:~/sim/omnetpp-3.3/lib
 

5. Optionally edit omnetpp-3.3/configure.user and change CFLAGS for speed
   and profiling:
 
>  CFLAGS='-O3 -DNDEBUG=1 -gstabs+3 -Wall'
 

6. Compile OMNeT++:
 
>  cd ~/sim/omnetpp-3.3
>  ./configure
>  make
 

7. Download the patched version of the INET framework
   INET-20061020-OverSim-2.tgz from
   http://www.oversim.org/wiki/OverSimDownload
   and extract in next to your OMNeT++ installation:
 
>  cd ~/sim
>  tar xzf /tmp/INET-20061020-OverSim-2.tgz
 

8. Edit INET-20061020-OverSim-2/inetconfig and change ROOT to your install of
the INET framework:
 
>  ROOT=$(HOME)/sim/INET-20061020-OverSim-2
 

9. Compile the INET framework:
 
>  cd ~/sim/INET-20061020-OverSim-2
>  ./makemake
>  make
 

10. Download the latest OverSim snapshot OverSim-20070404.tgz
    and extract in next to your OMNeT++ installation (you probably
    already did this, if you are reading this INSTALL file):
 
>  cd ~/sim
>  tar xzf /tmp/OverSim-20070404.tgz
 

11. Compile OverSim:
 
>  cd ~/sim/OverSim-20070404
>  ./makemake
>  make
 

Congratulations - now you should have a working OverSim installation! For
instructions how to use OverSim look at http://www.oversim.org/
