Changes between Version 9 and Version 10 of Tutorial/HowToSwitch

Timestamp:

Jan 11, 2013, 10:28:08 PM (12 years ago)

Author:

ssugrim

Comment:

—

Tutorial/HowToSwitch

@@ -2 +2 @@
 [[TOC(heading=Tutorial TOC, Tutorial, Tutorial/HowToSwitch, depth=2)]]
 
-= How to switch On/Off the nodes of a Testbed =
+= How to switch !On/Off the nodes of a Testbed =
 
 If you have not done so yet: 
@@ -9 +9 @@
  * [https://www.orbit-lab.org/schedule/ Make a reservation] on the Schedular for a given tesbed
 
-Lets assume that you registered as user 'bob' and made a reservation for the 'grid' testbed. You then access the 'grid' console using the command:
+n general you can reserve either the main grid, or one of the sandboxes, the fully qualified domain name will reflect the resouce you reserved. Lets assume that you registered as user 'bob' and made a reservation for the '''grid''' testbed. You then access the '''grid''' console using the command:
 
  {{{
@@ -20 +20 @@
 Then, to switch some nodes On/Off on the 'grid' testbed, use the command:
 
- {{{
-  omf tell -a on -t all
-  # will turn On the entire set of 20x20 nodes on the 'grid'
-  
-  omf tell -a offs -t node3-1.domain,node5-6.domain,node1-1.domain,node1-2.domain
-  # will turn Off (soft) the nodes 3,1 and 5,6 and 1,1 and 1,2
- }}}
+{{{
+omf tell -a on -t all
+}}}
+will turn On the entire set of 20x20 nodes on the '''grid'''.
+
+{{{  
+omf tell -a offs -t node3-1.grid.orbit-lab.org,node5-6.grid.orbit-lab.org,node1-1.grid.orbit-lab.org,node1-2.grid.orbit-lab.org
+}}}
+will turn Off (soft, that is attempt a graceful shutdown) the nodes 3,1 and 5,6 and 1,1 and 1,2
+
+{{{  
+omf tell -a offh -t node3-1.grid.orbit-lab.org,node5-6.grid.orbit-lab.org,node1-1.grid.orbit-lab.org,node1-2.grid.orbit-lab.org
+}}}
+will turn Off (hard, that is "hold down" the power button) the nodes 3,1 and 5,6 and 1,1 and 1,2
 
 
-[[BR]]
 == Learning More ==
 
 The complete available options for this command is given by ''"omf help tell"'':
 
- {{{
-   omf help tell
-
-Switch ON/OFF the nodes in a testbed
-
-Usage:
-      omf tell [-h]
-      omf tell [COMMAND] [TOPOLOGY] [DOMAIN]
+{{{
+ user@console.grid:~$ omf help tell
+ Switch ON/OFF and reboot the nodes in a testbed
+ Usage:
+      omf tell -a ACTION [-h] [-t TOPOLOGY] [-c AGGREGATE]
  
       With: 
-      -h, --help    print this help message
+      -h, --help           print this help message
  
-      COMMAND:
-      on, -on, --turn-on              turn node(s) ON
-      offs, -offs, --turn-off-soft    turn node(s) OFF (soft)
-      offh, -offh, --turn-off-hard    turn node(s) OFF (hard)
+      -a, --action ACTION  specify an action
+      ACTION:
+      on              turn node(s) ON
+      offs            turn node(s) OFF (soft)
+      offh            turn node(s) OFF (hard)
+      reboot          reboots node(s) (soft)
+      reset           resets node(s) (hard)
  
-      TOPOLOGY      a valid topology description or file
-                    (default is the entire set of nodes on the default testbed)
+      -c, --config AGGREGATE    use testbed AGGREGATE
+      -t, --topology TOPOLOGY   a valid topology file or description (defaults to 'system:topo:all')
  
       Some Examples: 
-                    omf tell on all grid
-                    omf tell on 1,1..2
-                    omf tell offs [[1,2],[1,1]] sb1 
-                    omf tell offs [[1,1],[2..6,1..2]] 
-                    omf tell offh system:topo:all
-                    omf tell offh topo_grid_active
- 
- }}}
-
+                    omf tell -a reset
+                    omf tell -a on -t system:topo:all -c grid
+                    omf tell -a reboot -t omf.nicta.node1
+                    omf tell -a offs -t omf.nicta.node1,omf.nicta.node2 -c sb1
+                    omf tell -a offh -t system:topo:all
+                    omf tell -a reset -t topo_grid_active
+}}}