Go back --> [wiki:Tutorial Tutorials]
[[TOC(heading=Tutorial TOC, Tutorial, depth=2)]]

= How to use execute a shell command on the nodes =

=== Prerequisite ===

Before 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]).

You should also have installed a disk image with omf agent on the nodes of the testbed you are using (e.g. "baseline.ndz"). See [wiki:Tutorial/HowToImage "How to install a disk image"].

=== Goal ===

In this tutorial, you will learn a simple way to run a shell commands on the nodes of a testbed.
  
=== The tutorial experiment ===

This experiment is given in the attached script [attachment:tut_cmd_1.rb tut_cmd_1.rb]. 

This file contains extensive comments that should help you understand the different steps involved in executing a shell command on the nodes of a testbed. It also shows how you could process the command outputs, e.g. redirect them to a text file.

To run this example script, use the following command:

 {{{
  omf exec tut_cmd_1
 }}}

=== The Results ===

The experiment screen output should then look like [attachment:sb1_2007_11_19_18_45_06-Output.txt this]. And the experiment log file should look like  [attachment:sb1_2007_11_19_18_45_06.log this]. 

=== More... ===

This method of executing a shell command on nodes is well suited for one-off or temporary experiments. If you plan on re-using or sharing the same commands among multiple experiment scripts, then you should consider [wiki:Tutorial/HowToApplication this other method] which uses application definition.