Click framework

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

• 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/