Changes between Version 1 and Version 2 of eVRRgettingStarted

Timestamp:

Dec 15, 2011, 5:25:47 PM (14 years ago)

Author:

mies@…

Comment:

--

eVRRgettingStarted

@@ -1 @@
-sdf
+= Quickstart =
+
+ 1. Go to the simulations/Demo Folder
+ 1. Right-Click on Demo.ini
+ 1. Select Run as.. Omnet++ Simulation
+ 1. Select the Config "Demo" by clicking Ok
+ 1. You will see two windows:
+   ||[[Image(eVRR-Demo-Network.png, 200px)]]||[[Image(eVRR-Demo-Startup.png, 400px)]]||
+   Right-clicking on "manager" and selecting "Inspect as graphics" will show you the network:
+   [[Image(eVRR-Demo-NetworkAsGraphics.png, 400px)]][[BR]]
+   and allow you to observe the simulation in detail (at least for small-sized simulations << 1000 nodes).
+ 1. Push the "Run"-Button
+
+= Detailed Explanation =
+
+You have two possibilities to build the network topology for your simulation.
+
+ 1. Running from an OMNet++ NEtwork Description (NED)
+  a. Using a given .ned file
+  NED files are OMNet++'s integrated language for the description of networks. Let's take a look at a simple Network Topology for RoutingSim:
+  {{{
+  package routingsim.simulations;
+  import routingsim.foundation.Node;
+
+
+  }}}
+  a. Using OMNet++'s Topology Generator
+   1. Select, e.g., Random Topology and click "Next"
+   1. Determine network size and connectivity and click "Next"
+   1. Name the network and as NED type for Node select routingsim.foundation.Node before clicking on "Next"
+   1. as "Gate to connect", choose "inout toNeighbors[]", which is the OMNet++ gate vector for the interconnection of nodes (in contrast to, e.g., node-internal connctions (toProtocols[]) or connections to other modules (Statistics, Dynamics, NetworkManager).
+   1. Click finish and inspect the generated topology
+ 1. Running from a [wiki:TopologyFiles topology file]
+    Along with the !RoutingSim package, there comes a ready to start configuration for the included eVRR that you can use as example for further configurations (file !RoutingSim/simulations/Demo/Demo.ini)
+{{{
+#!c
+ 1  [General]
+ 2  network = routingsim.simulations.DefaultNetwork
+ 3 
+ 4  [Config Demo]
+ 5  # logging
+ 6  **.samplingInterval=1.0
+ 7
+ 8  # evrr
+ 9  **.immediateResponse=false
+10  **.updateFrequency=1.0
+11  **.vneighbors = 1
+12 
+13  # network manager
+14  **.protocols = "routingsim.routing.evrr.VirtualRing"
+15  **.topologyFile = "Demo-Grid-100.txt"
+16  #**.spath = "path/to/file.spath"
+17
+18  # general
+19  sim-time-limit = 1000s
+}}}
+
+Line 2 sets the default network. This network is the base for every simulation that is driven with file-based topology input and consists solely of the NetworkManager module (file !RoutingSim/simulations/DefaultNetwork.ned)
+{{{
+#!c
+1  package routingsim.simulations;
+2 
+3  import routingsim.foundation.*;
+4  import routingsim.dynamics.*;
+5 
+6  network DefaultNetwork
+7  {
+8      submodules:
+9          manager: NetworkManager;
+10 }
+}}}
+On startup, the !NetworkManager module is created and based on the configuration parameters dynamically sets up the simulation with the above parameters:
+
+Line 6 defines the sampling interval, i.e., the time span between statistics are polled from your protocol by the statistics module.[[BR]]
+Lines 8-11 set protocol-specific parameters.[[BR]]
+Line 14 defines the protocol that you want to simulate and that needs to be instantiated within each node.[[BR]]
+Line 15 sets the topology to be instantiated[[BR]]
+Line 16 is commented out, but for larger topologies may set the precalculated shortest path file.[[BR]]
+Line 19 sets an OMNeT++ parameter that restricts the runtime of the simulation measured in simulation time.