Go back --> [wiki:Tutorial Tutorials]

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

This feature is only available in NodeHandler v4 and above.

Before going through this tutorial, you should know [wiki:Tutorial/HowToImage how to install a disk image]. 

You 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").

=== 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. For more information on the basics of writing and using an experiment script, please refer to the previous tutorials, [wiki:Tutorial/HowtoWriteScripts here] and [wiki:Tutorial/HelloWorld here].

To run this example script, use the following command:

 {{{
  nodehandler4 tut_cmd_1
 }}}

(This assumes that you previously logged in to the a testbed, and imaged its nodes with a disk image such as "baseline-7.11.ndz".)

=== The Results ===

The 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]. 

=== More... ===

This other script [attachment:tut_topo_1_more.rb tut_topo_1_more.rb] contains an extended version of the above script with more optional features.