wiki:OverSimInstall
close Warning: BrowserModule failed with ConfigurationError: Look in the Trac log for more information.

Version 57 (modified by Ingmar Baumgart, 14 years ago) ( diff )

--

OverSim Installation Instructions

These instructions show you how to install OverSim on Linux, Mac OS X and Windows:

  1. Requirements for OMNeT++ and OverSim:
    • For Linux:
    • For Mac OS X 10.5
    • For Windows: Everything you need is already included in the OMNeT++ 4.0 package.
  1. Download OMNeT++ 4.1 (Linux/Mac or Windows version) from http://www.omnetpp.org/ after reading the License

3a. (Linux/Mac only): 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 xzvf /tmp/omnetpp-4.1rc1-src.tgz

3b. (Windows only): Extract the OMNeT++ archive to a new directory (e.g. C:\sim\omnetpp-4.1) and double click on mingwenv.cmd

  1. (Linux/Mac only): Add the following lines to your .bashrc or .profile:
      export PATH=~/sim/omnetpp-4.1/bin:$PATH
    
  1. Compile OMNeT++ (no need to change the directoy on Windows):
      cd ~/sim/omnetpp-4.1
      ./configure
      make
    
  1. Download the patched version of the INET framework INET-OverSim-20101019.tgz and extract in next to your OMNeT++ installation:
      cd ~/sim
      tar xzvf /tmp/INET-OverSim-20101019.tgz
    
  1. Compile the INET framework:
      cd ~/sim/INET-OverSim-20101019
      make
    
  1. Download the latest OverSim snapshot OverSim-20101103.tgz and extract in next to your OMNeT++ installation:
      cd ~/sim
      tar xzvf /tmp/OverSim-20101103.tgz
    
  1. Compile OverSim:
      cd ~/sim/OverSim-20101103
      make
    

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

How to use Eclipse to compile OverSim

You can also use the included Eclipse IDE to compile OverSim:

  • Start Eclipse with omnetpp
  • Create a new workspace by choosing a new workspace directory on Eclipse startup
  • File->Import->General->Existing Projects into Workspace->Next->select the INET-OverSim-20101019 directory->Finish
  • Repeat the same steps for the OverSim project
  • The build process should start automatically - if not, hit Ctrl->B

How to build OverSim for a simulation machine or embedded device without X11

  • You don't have to install Tcl/Tk, if you only need Cmdenv. Add the following option to omnetpp-4.1/configure.user:
      NO_TCL=true
    
  • Use "make MODE=release" to compile INET and OverSim for optimized binaries without debug information.

Tips for migrating your own OverSim simulation models to OMNeT++ 4.x

  • Read the official OMNeT++ 4.0 migration guide!
  • Try to use the OMNeT++ migration tools migratened, migrateini, migratemsg and migratecpp.
  • Pay special attention to the changed NED and INI syntax - OverSim now uses NED inheritance (e.g. for BaseOverlay).
  • Some ini file parameters now have units like seconds or bytes.
Note: See TracWiki for help on using the wiki.