Contents‎ > ‎

2 – Installing OverSim

First, installing OverSim in Windows and Linux is discussed. Second, we will discuss how to run some of the examples in OverSim. According to many discussions on OverSim mailing list, users seems to have had some issues while installing OverSim on Windows. However, when properly installed there should not be any difference whether you are using it on Windows or Linux. Instructions for Linux should also apply for Mac OS X. Following discussion is based on OverSim-20101103 version. For specific instructions on newer versions see installation instructions at OverSim.org and mailing list. Users are advised to read the respective license agreements as most of the following software is free only for academic and personal use.

2.1 Installing on Windows

Before installing OverSim you need to install OMNet++ and INET packages.
Following instructions are based on a Windows 7 machine; however, they should be readily applicable for other versions as well.

Step 1: Suppose we want to install the simulator inside Simulators directory. First create the directory as follows (assuming your are using DOS prompt):
C:\mkdir Simulators
C:\cd Simulators
Step 2: Download OMNeT++ 4.1 win32 (source + IDE + MINGW, zip) file to the Simulators directory. This file contains everything that you need to install OMNet++ in Windows. (Please note that the current version of Oversim only supports Omnet++ 4.1, and not Omnet++ 4.2 or later.)
Step 3:
Extract the directory using your favorite data decompression tool.
Then go to the omnetpp-4.1 directory and double click on mingwenv.cmd
This will open up MinGW (i.e., a minimalist development environment for native Microsoft Windows applications) window.
shell
 
64-bit compilation
The simulation of large scale systems might require more than 3 GB of memory. It is not possible to address more than 3 GB of memory on a 32 bit system. A 64 bit system will, therefore, be required for large scale simulations. Although OMNet++ can compile as a 64 bit system, the MinGW compiler used to compile OMNet++ in Windows is a 32 bit compiler. It is, therefore, not possible to compile Omnet++ as a 64 bit application in Windows, which means the no Omnet++ Windows simulation can use more than 3 GB of memory.
 
Run the configuration to set installation parameters.
$ ./configure

If you get the following warning message, ignore it as we do not need those packages.
WARNING: The configuration script could not detect the following packages:
    MPI (optional)  PCAP (optional)  Akaroa (optional)
Scroll up to see the warning messages (use shift+PgUp), and search config.log
for more details. While you can use OMNeT++ in the current configuration,
be aware that some functionality may be unavailable or incomplete.

You should see a message similar the following if your configuration is correct:
Your PATH contains c:/Simulations/omnetpp-4.1/bin. Good!

Use make command to compile OMNet++ (you may have to wait couple of minutes depending on the speed of your machine)
$ make

If installation is successful following message should appear:

Now you can type "omnetpp" to start the IDE
Step 4:
Next download patched version of the INET framework INET-OverSim-20101019.tgz and extract it to Simulators directory.
Step 5:
Go to the INET directory and compile it using make:
$ cd ..

dilum@mypc /c/Simulations
$ cd INET-OverSim-20101019/

dilum@mypc /c/Simulations/INET-OverSim-20101019
$ make
Step 6: Finally download the latest OverSim version from OverSim.org. Suppose latest version is OverSim-20101103.tgz. Extract the files to Simulators directory.
Step 7:
Go to the OverSim directory and compile it using make:
dilum@mypc /c/Simulations/INET-OverSim-20101019
$ cd ../OverSim-20101103/

dilum@mypc /c/Simulations/OverSim-20101103
$ make
By default OverSim enables debugging features. If you want to compile without debugging features use:
$ make MODE=release
If there are no error messages installation is complete.

2.2 Installing on Linux and Mac OS X

 
Note icon
Make sure the following packages/libraries are already installed before your begin

Linux (Ubuntu or Fedora)
  • Tcl/Tk 8.4 with BLT and libgmp
  • Use following command to install
    • Ubuntu – sudo apt-get install tk8.4-dev libgmp3-dev blt-dev
    • Fedora – yum install tk8.4-dev libgmp3-dev blt-dev
Mac OS X 10.5
  • Xcode 3.x and Fink (includes libgmp)
  • First install Fink. Then open a terminal and install libgmp using
    • sudo apt-get install libgmp3-dev

Step 1: Suppose we want to install the simulator inside Simulators directory. First create the directory as follows (assuming your are using shell):
$ mkdir Simulators
$ cd Simulators
Step 2: Download OMNeT++ 4.1 (source + IDE, tgz) file to the Simulators directory.
Step 3:
Extract the directory using:
$ tar -xzvf /tmp/omnetpp-4.1-src.tgz

Then go to the omnetpp-4.1 directory. If you want to install OverSim without the GUI, uncomment the line NO_TCL=true in configure.user file.
$ cd omnetpp-4.1-src.tgz
$ vim configure.user

Next you need to set the path to OMNet++ directory. Add following lines to your .bashrc or .profile using:
$ export PATH=~/Simulators/omnetpp-4.1/bin:$PATH

Then run the configuration to set installation parameters.
$ ./configure

If you get the following error messages, you need to install necessary packages.
configure: error: Bison not found, needed to build OMNeT++/OMNEST -- please install it!
configure: error: Flex not found, needed to build OMNeT++/OMNEST -- please install it!
configure: error: zlib or zlib header file not found, please install them.

$ sudo apt-get install bison flex zlib1g-dev
$ ./configure

You should see a message similar the following if your configuration is correct:
Your PATH contains /home/dilumb/Simulators/omnetpp-4.1/bin. Good!

Use make command to compile OMNet++ (you may have to wait couple of minutes depending on the speed of your machine)
$ make

If installation is successful following message should appear:

Now you can type "omnetpp" to start the IDE
Step 4:
Next download patched version of the INET framework INET-OverSim-20101019.tgz and extract it to Simulators directory.
$ tar xzvf /tmp/INET-OverSim-20101019.tgz
Step 5:
Go to the INET directory and compile it using make:
$ cd INET-OverSim-20101019/
$ make
Step 6: Finally download the latest OverSim version from OverSim.org. Suppose latest version is OverSim-20101103.tgz. Extract the files to Simulators directory.
$ tar xzvf /tmp/OverSim-20101103.tgz
 Step 7:
Go to the OverSim directory and compile it using make:
$ cd ../OverSim-20101103/
$ make

By default OverSim enables debugging features. If you want to compile without debugging features use:
$ make MODE=release

If there are no error messages installation is complete.

Previous - Introduction                                                                                                    Next - First Simulation

Comments