= !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 [http://www.omnetpp.org/pmwiki/index.php?n=Main.OmnetppInstallation OMNeT++ install instructions for Windows]).

1. Requirements for OMNeT++ and !OverSim:
    * [http://tcl.sourceforge.net/ Tcl/Tk 8.4]
    * [http://www.swox.com/gmp/ libgmp]
    * [http://search.cpan.org/dist/Statistics-Descriptive/Descriptive.pm 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 [http://www.omnetpp.org/filemgmt/visit.php?lid=125 OMNeT++ 3.4b2] from http://www.omnetpp.org/ after reading the [http://www.omnetpp.org/external/license.php 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.4b2-src.tgz
}}}

4. Add the following lines to your .bashrc or .profile:
{{{
  export PATH=$PATH:~/sim/omnetpp-3.4b2/bin:~/sim/INET-20061020-OverSim-3/bin
  export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:~/sim/omnetpp-3.4b2/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++. If your gcc is older than 4.x please read [http://www.omnetpp.org/pmwiki/index.php?n=Main.INETLinkerErrorIPv6ExtensionHeader this page]!
{{{
  cd ~/sim/omnetpp-3.4b2
  ./configure
  make
}}}

7. Download the patched version of the INET framework [http://www.oversim.org/chrome/site/INET-20061020-OverSim-3.tgz INET-20061020-OverSim-3.tgz] and extract in next to your OMNeT++ installation:
{{{
  cd ~/sim
  tar xzf /tmp/INET-20061020-OverSim-3.tgz
}}}

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

9. Compile the INET framework:
{{{
  ./makemake
  make
}}}

10. Download the latest !OverSim snapshot [http://www.oversim.org/chrome/site/OverSim-20080919.tgz OverSim-20080919.tgz] and extract in next to your OMNeT++ installation:
{{{
  cd ~/sim
  tar xzf /tmp/OverSim-20080919.tgz
}}}

11. Compile !OverSim:
{{{
  cd ~/sim/OverSim-20080919
  ./makemake
  make
}}}

Congratulations - now you should have a working !OverSim installation! For instructions how to use !OverSim look at OverSimUsage.