Click framework: Difference between revisions

From
Jump to navigation Jump to search
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 1: Line 1:
=Introduction=
=Introduction=
The folder "simulation/click-brn-scripts/" contains different click scripts for different experiments. Running this scripts (see below) the click framework generates dumps of the communicating nodes. These dumps are then automatically analyzed and evaluated, putting the results into the folder "simulation/click-brn-scripts/<SOME_SCRIPT>/<NUMBER_OF_EXPERIMENT>".

The click scripts use the following files:
* Mes-files contain the devices which will be prepared for the experiment.
* Mes-files contain the devices which will be prepared for the experiment.
* Des-Files contain a gross description for the experiment. E.g.: Duration of the experiment; Directory for log-files; network topology; etc...
* Des-Files contain a gross description for the experiment. E.g.: Duration of the experiment; Directory for log-files; network topology; etc...
* The folder "simulation/click-brn-scripts/" contains special scripts to analyze and evaluate the dumps generated by the participating devices of the experiment. The results are stored at "simulation/click-brn-scripts/<SOME_SCRIPT>/1/Evaluation"


=Prerequisits=
* Install git
* Generate SSH key-pair and send public key to Robert Sombrutzki in order to get access to the repositories
*


=Scripts=
=Scripts=


* /helper/host/bin/clickctrl.sh:
== /helper/host/bin/clickctrl.sh ==
This scripts allows communication with every node. This is made available from the node through an click element called "ControlSocket" (more: http://read.cs.ucla.edu/click/elements/controlsocket) which receives the remote commands from the user. Example of usage: Get statistics of the experiment while the node is running.
This scripts allows communication with every node. This is made available from the node through an click element called "ControlSocket" (more: http://read.cs.ucla.edu/click/elements/controlsocket) which receives the remote commands from the user. Example of usage: Get statistics of the experiment while the node is running.


* /helper/simulation/bin/run_sim.sh:
== /helper/simulation/bin/run_sim.sh ==
Execute the simulation within simulator.
Execute the simulation within simulator.
Usage: run_sim.sh ns <des-File>
Usage: run_sim.sh ns <des-File>


* /click-brn/elements/brn2/tools/brn-tools.sh:
== /click-brn/elements/brn2/tools/brn-tools.sh ==
This powerful tool downloads automatically all important sources, including the NS-Simulator. Additionally it builds the click framework and the simulator.
This powerful tool downloads automatically all important sources, including the NS-Simulator. Additionally it builds the click framework and the simulator. Steps to go:
# Download brn-tools.sh over ssh@testbed@192.168.4.117 being connected to the "4er-Netz" (ask Robert for password) OR ask Robert for the actual "brn-tools.sh"-script
# copy to destination folder
# Establish an ssh-tunnel using ''ssh <YOUR HU-USERNAME>@gruenau.informatik.hu-berlin.de -L 23452:sar.informatik.hu-berlin.de:2222''
# Change to the local directory where you want your own version of the HWL-Suite (click, ns, ...)
# execute "sh ./brn-tools.sh" in destination folder


* /click-brn-scripts/test.sh
== /click-brn-scripts/test.sh ==
This script executes a group of click-scripts (located in click-brn-scripts) for testing and starts the simulation.
This script executes a group of click-scripts (located in click-brn-scripts) for testing and starts the simulation.


Line 23: Line 34:
=References=
=References=
* Search click documentation: http://read.cs.ucla.edu/click/docs
* Search click documentation: http://read.cs.ucla.edu/click/docs
* Publications about click and stuff that uses click: http://read.cs.ucla.edu/click/publications
* Manual how to program click elements: http://read.cs.ucla.edu/click/doxygen/class_element.html
* Manual how to program click elements: http://read.cs.ucla.edu/click/doxygen/class_element.html
* Information about click elements: http://www.read.cs.ucla.edu/click/elements
* Information about click elements: http://www.read.cs.ucla.edu/click/elements
* Network Simulator 2 (NS2) Docu: http://isi.edu/nsnam/ns/

Latest revision as of 08:37, 2 August 2012

Introduction

The folder "simulation/click-brn-scripts/" contains different click scripts for different experiments. Running this scripts (see below) the click framework generates dumps of the communicating nodes. These dumps are then automatically analyzed and evaluated, putting the results into the folder "simulation/click-brn-scripts/<SOME_SCRIPT>/<NUMBER_OF_EXPERIMENT>".

The click scripts use the following files:

  • Mes-files contain the devices which will be prepared for the experiment.
  • Des-Files contain a gross description for the experiment. E.g.: Duration of the experiment; Directory for log-files; network topology; etc...

Prerequisits

  • Install git
  • Generate SSH key-pair and send public key to Robert Sombrutzki in order to get access to the repositories

Scripts

/helper/host/bin/clickctrl.sh

This scripts allows communication with every node. This is made available from the node through an click element called "ControlSocket" (more: http://read.cs.ucla.edu/click/elements/controlsocket) which receives the remote commands from the user. Example of usage: Get statistics of the experiment while the node is running.

/helper/simulation/bin/run_sim.sh

Execute the simulation within simulator. Usage: run_sim.sh ns <des-File>

/click-brn/elements/brn2/tools/brn-tools.sh

This powerful tool downloads automatically all important sources, including the NS-Simulator. Additionally it builds the click framework and the simulator. Steps to go:

  1. Download brn-tools.sh over ssh@testbed@192.168.4.117 being connected to the "4er-Netz" (ask Robert for password) OR ask Robert for the actual "brn-tools.sh"-script
  2. copy to destination folder
  3. Establish an ssh-tunnel using ssh <YOUR HU-USERNAME>@gruenau.informatik.hu-berlin.de -L 23452:sar.informatik.hu-berlin.de:2222
  4. Change to the local directory where you want your own version of the HWL-Suite (click, ns, ...)
  5. execute "sh ./brn-tools.sh" in destination folder

/click-brn-scripts/test.sh

This script executes a group of click-scripts (located in click-brn-scripts) for testing and starts the simulation.


References