Using LEPTON: a step by step tutorial

Preamble

This tutorial shows how LEPTON can be used on a Linux host.

In the following we assume that LEPTON has been installed on your host (e.g., laptop or desktop workstation). If that is not the case yet, please refer to the installation procedure.

Running LEPTON

with simulated nodes

Start LEPTON with 20 simulated nodes following the Levy Walk mobility pattern in a 200x200 m2 area:

lepton.sh start

Start LEPTON with nodes events (add, move, remove) defined by an input DGS file:

lepton.sh start in_dgs=<a_dgs_file>

Start LEPTON with 20 simulated motionless nodes. Edges between nodes must be added manually through the LEPTON GUI (by dragging the mouse between nodes):

lepton.sh start manual=true

Stop LEPTON:

lepton.sh stop

with emulated nodes

Start LEPTON with 20 emulated nodes following the Levy Walk mobility pattern in a 200x200 m2 area:

lepton.sh start oppnet_adapter=<a_bash_script>

with:

The arguments described in the previous section also apply in order to configure the way the nodes are added and move.

Stop LEPTON and the emulated nodes

lepton.sh stop oppnet_adapter=<a_bash_script>

with real nodes

Start LEPTON without nodes in a 200x200 m2 area. Nodes that will be added afterwards will follow a Levy Walk mobility pattern:

lepton.sh start oppnet_adapter=<a_bash_script> nodes=0

Start LEPTON without nodes. Edges between the nodes that will be added afterwards must be added manually through the LEPTON GUI (by dragging the mouse between nodes):

lepton.sh start oppnet_adapter=<a_bash_script> nodes=0 manual=true

with:

In order to start real nodes that communicate through LEPTON, refer to the documentation of the LEPTON adapter of the OppNet platform.

Run LEPTON with a custom configuration

lepton.sh start [<key>=<value>]* [conf=<config_file>]*

with:

The list of configuration properties is accessible here. See this tutorial for more informations about the LEPTON configuration.

Run LEPTON with an example scenario

More examples of different scenarios using custom configurations can be found in the examples directory. After the LEPTON installation, the examples directory is empty. To load an example:

bin/util/load_example.sh <example_scenario>

To display the list of available example scenarios:

bin/util/load_example.sh -h

To run LEPTION with an example scenario:

lepton.sh start conf=examples/<example_scenario>/lepton.conf