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).

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-3/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++. If your gcc is older than 4.x please read ​this page!

     cd ~/sim/omnetpp-3.3
     ./configure
     make
   

7. Download the patched version of the INET framework 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 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.