Changes between Version 19 and Version 20 of Tutorials/a0Basic/Tutorial2


Ignore:
Timestamp:
Nov 28, 2007, 11:41:53 PM (17 years ago)
Author:
thierry
Comment:

Legend:

Unmodified
Added
Removed
Modified
  • Tutorials/a0Basic/Tutorial2

    v19 v20  
    171171 * [http://www.orbit-lab.org/wiki/Registration Register] for an account (if you have not done so yet)
    172172 * [https://www.orbit-lab.org/schedule/ Make a reservation] on the Scheduler for a time slot on one of the sandbox testbed
    173  * Log into the console machine corresponding to this testbed
     173 * Log into the console machine corresponding to this testbed. To control the Node Handler, your experiment, and the nodes on the testbed(s), you will use the generic '''orbit''' command and its options.
    174174 {{{
    175175  # User Bob reserved a time slot on the sandbox1 testbed.
     
    177177 
    178178  ssh bob@console.sb1.orbit-lab.org
     179
     180  # To see a list of commands available through the orbit command:
     181  orbit help
     182
     183  # which will give the following output
     184  Run a command on the testbed(s)
     185
     186  Usage: orbit [COMMAND] [ARGUMENT]...
     187
     188  Available COMMANDs:
     189
     190    help   Print this help message or a specif command usage
     191    exec   Execute an experiment script
     192    load   Load a disk image on a given set of nodes
     193    save   Save a disk image from a given node into a file
     194    tell   Switch a given set of nodes ON/OFF
     195    stat   Returns the status of a given set of nodes
     196
     197  To get more help on individual commands: 'omf help [COMMAND]'
     198  Examples:
     199            orbit help exec   Return usage/help for the 'exec' command
     200            orbit help load   Return usage/help for the 'load' command
     201
    179202 }}}
    180203
    181  * Image the nodes of this testbed with a disk image such as the latest ''baseline.ndz'' image, which includes ''nodeAgent4''. Instructions on how to image the nodes on a testbed can be found [wiki:Tutorial/HowToImage here]
    182 
    183 Once the nodes have been imaged, you can run the "Hello World" experiment with the command:
    184 
    185 {{{
    186 nodehandler --tutorial
    187 }}}
    188 Note: Normally an experiment is described in a script file, e.g. "my_experiment.rb", which is run by using the command "nodehandler my_experiment". However in this particular case, the tutorial script is already stored in a repository known by the ''nodehandler'' application. Thus the "--tutorial" option instructs the ''nodehandler'' to fetch that script and execute it.
     204 * Install a disk image which includes ''nodeAgent4'' on the nodes of this testbed. For example, you can use the latest ''baseline.ndz'' disk image. This disk image installation is done using the ''orbit load'' command above, and detailed instructions on how to execute it on the nodes on a testbed can be found [wiki:Tutorial/HowToImage here].
     205
     206
     207Once the nodes have been imaged, you can run the "Hello World" experiment with the ''orbit exec'' command as follows:
     208
     209{{{
     210orbit exec --tutorial
     211}}}
     212Normally an experiment is described in a script file, e.g. "my_experiment.rb", which is run by using the command "orbit exec my_experiment". However in this particular case, the tutorial script is already stored in a repository known by the ''orbit exec'' application. Thus the "--tutorial" option instructs the ''orbit exec'' application to fetch that script and execute it.
    189213
    190214After running the above command, your console output should look like this:
    191215
    192216{{{
    193 console.sb1:~# nodehandler --tutorial
     217console.sb1:~# orbit exec --tutorial
    194218DEBUG Experiment: Domain: sb1
    195219 INFO init: NodeHandler Version 4.2.0 (1272)