= !OverSim Installation Instructions = These instructions show you how to install !OverSim for Linux, but compiling and running !OverSim for Windows or Mac OS X works similar. 1. Requirements for OMNeT++ and !OverSim: * For Linux: * [http://tcl.sourceforge.net/ Tcl/Tk 8.4 with BLT] and [http://gmplib.org/ libgmp] * On Ubuntu you can install these packages with: {{{ sudo apt-get install tk8.4-dev libgmp3-dev blt-dev }}} * For Mac OS X 10.5 * [http://developer.apple.com/TOOLS/xcode/ Xcode 3.x] and [http://www.finkproject.org/ Fink (includes libgmp)] * After installation of Fink open a terminal and install libgmp with: {{{ sudo apt-get install libgmp3-dev }}} * For Windows: Everything you need is already included in the OMNeT++ 4.0 package. 2. Download OMNeT++ 4.0 ([http://www.omnetpp.org/filemgmt/visit.php?lid=164 Linux/Mac] or [http://www.omnetpp.org/filemgmt/visit.php?lid=163 Windows] version) from http://www.omnetpp.org/ after reading the [http://www.omnetpp.org/external/license.php 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.0-src.tgz }}} 3b. (Windows only): Extract the OMNeT++ archive to a new directory (e.g. C:\sim\omnetpp-4.0) and double click on {{{mingwenv.cmd}}} 4. (Linux/Mac only): Add the following lines to your .bashrc or .profile: {{{ export PATH=~/sim/omnetpp-4.0/bin:$PATH }}} 5. Compile OMNeT++ (no need to change the directoy on Windows): {{{ cd ~/sim/omnetpp-4.0 ./configure make }}} 6. Download the patched version of the INET framework [http://www.oversim.org/chrome/site/INET-OverSim-20090317.tgz INET-OverSim-20090317.tgz] and extract in next to your OMNeT++ installation: {{{ cd ~/sim tar xzvf /tmp/INET-OverSim-20090317.tgz }}} 7. Compile the INET framework: {{{ cd ~/sim/INET-OverSim-20090317 make }}} 8. Download the latest !OverSim snapshot [http://www.oversim.org/chrome/site/OverSim-20090320.tgz OverSim-20090320.tgz] and extract in next to your OMNeT++ installation: {{{ cd ~/sim tar xzvf /tmp/OverSim-20090320.tgz }}} 9. Compile !OverSim: {{{ cd ~/sim/OverSim-20090320 make }}} Congratulations - now you should have a working !OverSim installation! For instructions how to use !OverSim look at OverSimUsage. 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-20090317'' directory->''Finish'' * Repeat the same steps for the !OverSim project * The build process should start automatically - if not, hit ''Ctrl->B'' If you want to install obsolete !OverSim releases visit the OldOverSimInstall page.