Changes between Initial Version and Version 1 of Tutorial/HowToTopology2


Ignore:
Timestamp:
Nov 20, 2007, 5:42:42 AM (17 years ago)
Author:
thierry
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorial/HowToTopology2

    v1 v1  
     1
     2Go back --> [wiki:Tutorial Tutorials]
     3
     4= How to define and use multi-hop Topologies =
     5
     6=== Prerequisite ===
     7
     8This feature is only available in NodeHandler v4 and above.
     9
     10Before going through this tutorial, you should know the basics of writing and running an experiment script (see [wiki:Tutorial/HelloWorld here] and [wiki:Tutorial/HowtoWriteScripts here]).
     11
     12You should also have installed a disk image with Node Agent v4 on the nodes of the testbed you are using (e.g. "baseline-7.11.ndz"). See [wiki:Tutorial/HowToImage "How to install a disk image"].
     13
     14=== Goal ===
     15
     16In this tutorial, you will learn how to define and use multi-hop topologies in your experiments.
     17
     18As explained [wiki:Tutorial/HowToImage here], after installing an image on all the nodes of a testbed, 3 default topologies will be generated. One of them (system:topo:active) defines all the nodes that were correctly imaged. In other words, it contains a list of all nodes on the testbed that are currently working and have the requested disk image.
     19
     20In this tutorial experiment, you will use this default active topology to create your own multi-hop topologies.
     21 
     22=== The tutorial experiment ===
     23
     24This experiment is given in the attached script [attachment:tut_topo_2.rb tut_topo_2.rb].
     25
     26This file contains extensive comments that should help you understand the different steps involved in defining and using multi-hop topologies.
     27
     28Since all nodes are more or less within each others 802.11 radio range in the current testbeds, this experiment is using a MAC address filtering tool to force given nodes to ignore other ones, thus emulating a multi-hop connectivity map.
     29
     30There are currently three filtering tools to choose from: iptable, ebtable, and mackill. Before running this tutorial script, you have to make sure that the particular tool that you selected is indeed installed on the experiment nodes.
     31
     32You can find more detailed information on the available commands to define topologies [wiki:Documentation/NodeHandler/Commands/defTopology here].
     33
     34To run this example script, use the following command:
     35
     36 {{{
     37  nodehandler4 tut_topo_2
     38 }}}
     39
     40=== The Results ===
     41
     42The experiment screen output should then look like [attachment:grid_2007_08_27_20_45_37-Output.txt this]. And the experiment log file should look like  [attachment:grid_2007_08_27_20_45_37.log this].
     43
     44You can also access the results of this particular experiment example in the MySQL database, using the experiment ID: "grid_2007_08_27_20_45_37" (please refer to [wiki:Tutorial/AnalyzeResults this page] for more information on accessing the results).
     45
     46=== More... ===
     47
     48ToDo - Put here a link to the AODV/OLSR tutorial when it will be ready.