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

Timestamp:

Nov 28, 2007, 11:41:53 PM (17 years ago)

Author:

thierry

Comment:

—

Tutorials/a0Basic/Tutorial2

@@ -171 +171 @@
  * [http://www.orbit-lab.org/wiki/Registration Register] for an account (if you have not done so yet)
  * [https://www.orbit-lab.org/schedule/ Make a reservation] on the Scheduler for a time slot on one of the sandbox testbed
- * Log into the console machine corresponding to this testbed
+ * 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.
  {{{
   # User Bob reserved a time slot on the sandbox1 testbed. 
@@ -177 +177 @@
  
   ssh bob@console.sb1.orbit-lab.org
+
+  # To see a list of commands available through the orbit command:
+  orbit help
+
+  # which will give the following output
+  Run a command on the testbed(s)
+
+  Usage: orbit [COMMAND] [ARGUMENT]...
+
+  Available COMMANDs:
+
+    help   Print this help message or a specif command usage
+    exec   Execute an experiment script
+    load   Load a disk image on a given set of nodes
+    save   Save a disk image from a given node into a file
+    tell   Switch a given set of nodes ON/OFF
+    stat   Returns the status of a given set of nodes
+
+  To get more help on individual commands: 'omf help [COMMAND]'
+  Examples:
+            orbit help exec   Return usage/help for the 'exec' command
+            orbit help load   Return usage/help for the 'load' command
+
  }}}
 
- * 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]
-
-Once the nodes have been imaged, you can run the "Hello World" experiment with the command:
-
-{{{
-nodehandler --tutorial
-}}}
-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.
+ * 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].
+
+
+Once the nodes have been imaged, you can run the "Hello World" experiment with the ''orbit exec'' command as follows:
+
+{{{
+orbit exec --tutorial
+}}}
+Normally 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.
 
 After running the above command, your console output should look like this:
 
 {{{
-console.sb1:~# nodehandler --tutorial
+console.sb1:~# orbit exec --tutorial
 DEBUG Experiment: Domain: sb1
  INFO init: NodeHandler Version 4.2.0 (1272)