= !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. Download [http://www.omnetpp.org/filemgmt/visit.php?lid=122 OMNeT++ 3.3] from http://www.omnetpp.org/ after reading the [http://www.omnetpp.org/external/license.php License]

  2. 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
}}}

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

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

  5. Compile OMNeT++:
{{{
  cd ~/sim/omnetpp-3.3
  ./configure
  make
}}}

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

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

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

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

  10. Compile OverSim:
{{{
  cd ~/sim/OverSim
  ./makemake
  make
}}}

Congratulations - now you should have a working !OverSim installation!