INSTALLATION INSTRUCTIONS
=========================

The INET Framework can be compiled on any platform supported by OMNeT++.

PREREQUISITES

You should have a working OMNeT++ installation, version 4.0 or later.
If you are running on Windows you will have to install the winpcap driver,
which is used by INET to capture network packets from external interfaces
(visit http://www.winpcap.org)

General
-------
1. Make sure your OMNeT++ installation works OK (e.g. try running the samples)
   and it is in the path (to test, try the command "which nedtool"). On
   Windows, open a console with the "mingwenv.cmd" command. The PATH and other
   variables will be automatically adjusted for you. Use this console to compile
   and run INET.

2. Extract the downloaded tarball into a directory of your choice (usually into your
   workspace directory, if you are using the IDE). NOTE: The built-in Windows
   archiver has bugs and cannot extract the file correctly. Use some other archiver
   or do it from command line (tar xvfz inet-yyyymmdd-opp4-src.tgz)

If you are building from command line:
--------------------------------------
3. Change to the INET directory.

4. Type "make makefiles". This should generate the makefiles for you automatically.

5. Type "make" to build the inet executable (debug version). Use "make MODE=release"
   to build release version.

6. you can run specific examples by changing into the example's directory and executing "./run"

If you are using the IDE:
-------------------------
3. Open the OMNeT++ IDE and choose the workspace where you have extracted the inet directory.
   The extracted directory must be a subdirectory of the workspace dir.

4. Import the project using: File | Import | General | Existing projects into Workspace.
   Then select the workspace dir as the root directory, and be sure NOT to check the
   "Copy projects into workspace" box. Click Finish.

5. Open the project (if already not open) and wait until the indexer finishes.
   Now you can build the project by pressing CTRL-B (Project | Build all)

6. To run an example from the IDE open the example's directory in the Project Explorer view,
   find the corresponding omnetpp.ini file. Right click on it and select Run As / Simulation.
   This should create a Launch Configuration for this example.

If the build was successful, you may try running the demo simulations.
Change into examples/ and type "./rundemo".

Note:
-----
- by default INET is creating a shared library (libinet.dll, libinet.so etc.)
  in the "src" directory. To use the shared library you can use the "opp_run"
  command to load it dynamically. Open the "src/run_inet" script to see how
  to do it.
- If you add/remove files/directories later in the src directory, you MUST
  re-create your makefile. Run "make makefiles" again if you are building
  from the command line. (The IDE does it for you automatically)
