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:

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

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

References

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
Information about click elements: http://www.read.cs.ucla.edu/click/elements
Network Simulator 2 (NS2) Docu: http://isi.edu/nsnam/ns/

@@ Line 1: / Line 1: @@
+=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:
+== /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:
+== /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:
+== /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
-* /click-brn-scripts/test.sh
+# Establish an ssh-tunnel using ''ssh <YOUR HU-USERNAME>@gruenau.informatik.hu-berlin.de -L 23452:sar.informatik.hu-berlin.de:2222''
-dieses bash-script ruft alle click-scripte in click-brn-scripts auf, die zum testen ausgewählt worden sind und startet die Simulation.
+# 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 ==
-mes-Datein enthalten die Geräte, die in der Sim eingesetzt werden sollen.
+This script executes a group of click-scripts (located in click-brn-scripts) for testing and starts the simulation.
-des-Datein enthalten eine grobe Beschreibung der Simulation
+=References=
-Später lassen sich Analysetools in des scrip-Verzeichnis legen (als Beispiel in das send_and_receiver-Verzeichnis). Diese Analysetools dienen dazu, die dumps zu analysieren und die Evaluation in ein Verzeichnis zu speichern, dass unter einer Messung liegt und Evaluation heißt (als Beispiel:  send_and_receiver/1/Evaluation)
+* Search click documentation: http://read.cs.ucla.edu/click/docs
-Referenzen
-http://read.cs.ucla.edu/click/docs (Suchfunktion der Webseite auch sehr nützlich)
+* Publications about click and stuff that uses click: http://read.cs.ucla.edu/click/publications
-http://read.cs.ucla.edu/click/doxygen/class_element.html (sehr gutes Manual dazu, wie man Elemente programmiert; „click-Programmierer“ entwickeln hauptsäch)
+* Manual how to program click elements: http://read.cs.ucla.edu/click/doxygen/class_element.html
-http://www.read.cs.ucla.edu/click/elements (Informationen über click-Elemente)
+* Information about click elements: http://www.read.cs.ucla.edu/click/elements
+* Network Simulator 2 (NS2) Docu: http://isi.edu/nsnam/ns/

Click framework: Difference between revisions