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

Changes between Version 1 and Version 2 of OverSimInstallMacOSX


Ignore:
Timestamp:
Dec 11, 2012, 3:30:28 PM (12 years ago)
Author:
hartmann@…
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • OverSimInstallMacOSX

    v1 v2  
    1 = !OverSim Installation Instructions for Mac OS X=
     1== !OverSim Installation Instructions for Mac OS X ==
    22
    3 These instructions show you how to install !OverSim on Mac OS X 10.6 (Snow Leopard) to 10.8 (Mountain Lion):
     3These instructions show you how to install !OverSim on Mac OS X 10.6 (Snow Leopard) to 10.8 (Mountain Lion).
    44
    5 0. Installing X11 (Mountain Lion only)
    6 --------------------------------------
     5=== 1. Installing X11 (Mountain Lion only) ===
     6
    77OS X 10.8 (Mountain Lion) does not bundle required X11 anymore, so some extra work is needed here. If you are using Snow Leopard or Lion, you can skip to step 1 (Installing OmNET++)
    8 * Download and install: http://xquartz.macosforge.org/landing/
    9 * Open a terminal and enter: cd /usr/include; sudo ln -s /opt/X11/include/X11
    108
    11 1. Installing OmNET++
    12 ==================
    13 * Install OmNET++ by the official OmNET++ instructions for OS X.
    14 * Note: If you use Mountain Lion, just follow the Lion instruction. You should be fine since you installed X11 in Step 0.
     9   * Download and install: http://xquartz.macosforge.org/landing/
     10   * Open a terminal and enter:
     11   {{{cd /usr/include; sudo ln -s /opt/X11/include/X11}}}
    1512
    16 2. Installing GMP
    17 =================
    18 After completing step 1 you have the required command line tools like g++.  Additionally, the gmp library is required for building Oversim. There are several package managers which let you install it, you can choose either: Fink, MacPorts, Homebrew should all be fine. Personally, I use Homebrew, it's lightweight and awesome. If you are unsure, just follow the instructions.
    19 
    20 * Open a terminal and copy / paste the following line into it
    21 ** ruby -e "$(curl -fsSkL raw.github.com/mxcl/homebrew/go)"
    22 ** Enter your admin password if needed
    23 * If this did not work, visit http://mxcl.github.com/homebrew/ for up-to-date Homebrew install instructions
    24 * Enter 'brew install gmp'
    25 
    26 
    27 1. Requirements for OMNeT++ and !OverSim:
    28     * For Linux:
    29       * [http://tcl.sourceforge.net/ Tcl/Tk with BLT] and [http://gmplib.org/ libgmp]
    30       * On Ubuntu you can install these packages with:
    31 {{{
    32   sudo apt-get install tk-dev blt-dev libgmp-dev
    33 }}}
    34     * For Mac OS X 10.5
    35       * [http://developer.apple.com/TOOLS/xcode/ Xcode 3.x] and [http://www.finkproject.org/ Fink (includes libgmp)]
    36       * After installation of Fink open a terminal and install libgmp with:
    37 {{{
    38   sudo apt-get install libgmp3-dev
    39 }}}
    40     * For Windows: Everything you need is already included in the OMNeT++ 4.2.2 package.
    41 
    42 2. Download OMNeT++ 4.2.2 ([http://www.omnetpp.org/omnetpp/doc_download/2245-omnet-422-source--ide-tgz Linux/Mac] or [http://www.omnetpp.org/omnetpp/doc_download/2246-omnet-422-win32-source--ide--mingw-zip Windows] version) from http://www.omnetpp.org/ after reading the [http://www.omnetpp.org/home/license License]
    43 
    44 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++:
    45 {{{
     13=== 2. Installing OmNET++ ===
     14   *  Download [http://omnetpp.org/omnetpp/doc_details/2245-omnet-422-source--ide-tgz OMNeT++ 4.2.2] from http://www.omnetpp.org/ after reading the [http://www.omnetpp.org/home/license License]
     15   * Create a new directory (in the following we assume you want to install OMNeT++ and OverSim to ~/sim/) and extract OMNeT++:
     16   {{{
    4617  mkdir ~/sim
    4718  cd ~/sim
    4819  tar xzvf ~/Downloads/omnetpp-4.2.2-src.tgz
     20   }}}
     21   * Install OmNET++ by the [http://omnetpp.org/doc/omnetpp/InstallGuide.pdf official instructions for OS X] (PDF).
     22       * Note: If you use Mountain Lion, just follow the Lion instructions. You should be fine since you installed X11 in Step 1.
     23
     24=== 3. Installing GMP ===
     25After completing step 2 you have the required command line tools like g++.  Additionally, the GMP library is required for building Oversim. There are several package managers which let you install it, you can choose either: [http://www.finkproject.org/ Fink], [http://www.macports.org/ MacPorts], [http://mxcl.github.com/homebrew/ Homebrew] should all be fine. Personally, I use Homebrew, it's lightweight and awesome. If you are unsure, just follow the instructions.
     26
     27   * Open a terminal and copy / paste the following line into it
     28 {{{
     29ruby -e "$(curl -fsSkL raw.github.com/mxcl/homebrew/go)"
     30}}}
     31   * Enter your admin password if needed
     32   * If this did not work, visit [http://mxcl.github.com/homebrew/ the official Homebrew website] for up-to-date install instructions
     33   * Enter
     34{{{
     35brew install gmp
    4936}}}
    5037
    51 3b. (Windows only): Extract the OMNeT++ archive to a new directory (e.g. C:\sim\omnetpp-4.2.2) and double click on {{{mingwenv.cmd}}}
    52 
    53 4. (!Linux/Mac only): Add the following lines to your .bashrc or .profile:
    54 {{{
    55   export PATH=~/sim/omnetpp-4.2.2/bin:$PATH
    56 }}}
    57 
    58 5. Compile OMNeT++ (no need to change the directoy on Windows):
    59 {{{
    60   cd ~/sim/omnetpp-4.2.2
    61   ./configure
    62   make
    63 }}}
    64 
    65 6. Download the INET framework [http://omnetpp.org/download/contrib/models/inet-20111118-src.tgz inet-20111118-src.tgz] and extract in next to your OMNeT++ installation:
     38=== 4. Installing the INET Framework ===
     39   * Download the INET framework [http://omnetpp.org/download/contrib/models/inet-20111118-src.tgz inet-20111118-src.tgz] and extract in next to your OMNeT++ installation:
    6640{{{
    6741  cd ~/sim
     
    6943}}}
    7044
    71 8. Compile the INET framework:
     45    * Compile the INET framework:
    7246{{{
    7347  cd ~/sim/inet
     
    7650}}}
    7751
    78 9. Download the latest !OverSim snapshot [http://www.oversim.org/chrome/site/OverSim-20121206.tgz OverSim-20121206.tgz] and extract in next to your OMNeT++ installation:
     52=== 5. Installing OverSim ===
     53   * Download the latest !OverSim snapshot [http://www.oversim.org/chrome/site/OverSim-20121206.tgz OverSim-20121206.tgz] and extract in next to your OMNeT++ installation:
    7954{{{
    8055  cd ~/sim
     
    8257}}}
    8358
    84 10. Compile !OverSim (for ReaSE support read the following [wiki:OverSimReaSE instructions]):
     59   * Compile !OverSim (for ReaSE support read the following [wiki:OverSimReaSE instructions]):
    8560{{{
    8661  cd ~/sim/OverSim
     
    9873  * ''File''->''Import''->''General''->''Existing Projects into Workspace''->''Next''->select the ''inet'' directory->''Finish''
    9974  * Repeat the same steps for the !OverSim project
    100   * The build process should start automatically - if not, hit ''Ctrl->B''
    101 
    102 == How to build !OverSim for a simulation machine or embedded device without X11 ==
    103 
    104   * You don't have to install !Tcl/Tk, if you only need ''Cmdenv''. Add the following option to ''omnetpp-4.2.2/configure.user'':
    105 {{{
    106   NO_TCL=true
    107 }}}
    108   * Use "make MODE=release" to compile INET and !OverSim for optimized binaries without debug information.
     75  * The build process should start automatically - if not, hit ''⌘-B''