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

= How to switch !On/Off the nodes of a Testbed =

If you have not done so yet: 

 * [http://www.orbit-lab.org/register Register] for an account
 * [https://www.orbit-lab.org/schedule/ Make a reservation] on the Schedular for a given tesbed

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:

 {{{
  ssh bob@console.grid.orbit-lab.org
 }}}

[[BR]]
== Getting Started ==

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


== Learning More ==

The complete available options for this command is given by ''"omf help tell"'':

{{{
 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
 
      -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)
 
      -c, --config AGGREGATE    use testbed AGGREGATE
      -t, --topology TOPOLOGY   a valid topology file or description (defaults to 'system:topo:all')
 
      Some Examples: 
                    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
}}}