How to install and run an application on a node

Prerequisite

This feature is only available in NodeHandler v4 and above. Before going through this tutorial, you should:

Objective

In this tutorial, you will learn a simple way to execute and install an application on the nodes of a testbed.

Tutorial Experiments

This first experiment script tut_app_1.rb shows how to execute an application which is already installed on the nodes, such as tcpdump.

This second experiment script tut_app_2.rb shows how to install and then execute an application on the nodes.

These files contain extensive comments that should help you understand the different steps involved.

To run these example scripts, use the following command:

omf exec tut_app_1

omf exec tut_app_2

The Results

Click here to view the experiment screen output.
Click here to view the experiment log file.

NOTE: For the first example, tcpdump displays its message on STDERR and not STDOUT, thus when running this tutorial script, please ignore false error messages such as: "ERROR nodeApp: tcpdump: listening on ath0, link-type EN10MB (Ethernet), capture size 96 bytes" .

If you would like to use the same application but with different parameters (or with parameters that you would like to dynamically change during the course of the experiment), you should consider using a "prototype" around your application, as explained in this tutorial.