wiki:Tutorials/a0Basic/Tutorial0

Version 2 (modified by seskar, 10 years ago) ( diff )

—

Testbed Tour

Table of Contents

  1. Basic Tutorials
    1. Testbed Tour
      1. Developing a Script for an Experiment
    1. ORBIT Basics: Six Step Experiment Life Cycle
    1. Basic Tutorial: Hello World Example
      1. Experiment Script
      2. Understanding the "Hello World" script
      3. Running the experiment
      4. Beyond the Basics
    1. Analyzing Results
      1. Using Result Service
      2. Using Direct Database Access
      3. Microsoft Excel Example
      4. Matlab Example
    1. WiSHFUL Tutorial: Basic Controller-Agent Interaction
      1. About This Experiment
      2. Experiment Script
      3. Executing the Experiment Script
      4. Retrieving Results

Developing a Script for an Experiment

If you are a new OMF users, you may want to read the short ​OMF System Overview and/or ​the Experiment Life-cycle Overview. To run an experiment on the ORBIT testbed, in addtion to all the steps from getting started, a user needs to first describe the experiment in a script. This script/experiment description is then passed on to a Experiment Controller, which will use it to run and control the experiment execution. This process is illustrated in figure 1.

This script contains the experiment configuration and scenario. More precisely, it includes:

  • a description of the required resources (e.g. nodes on the testbed, applications to run),
  • their initializations and optional associations (e.g. nodeX is connected to NodeY, all nodes use channel 6 of 802.11g),
  • a description of their operation throughout the experiment duration (e.g. applicationX starts at T0 and run for 60sec, nodeY switch wireless configuration after 100sec).

ORBIT experiment scripts are written using the Ruby scripting language. However, a user does not necessarily need to be familiar with Ruby to be able to write and run simple experiments. The only prerequisite skills are some prior basic knowledge and practice of any other scripting and/or programming languages (e.g. python, perl, c, java,…). Of course, to be able to develop more complex experiments a user will have to learn basics of Ruby and read about ORBIT-specific Ruby methods at some stage (more on these two issues at the end of this tutorial).

No image "OMF-User-View.png" attached to Tutorials/a0Basic/Tutorial0
Figure 1. Execution of an Experiment from a User's point-of-view

Note: See TracWiki for help on using the wiki.