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

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 on all
  # will turn On the entire set of 20x20 nodes on the 'grid'
  
  omf tell offs [[3,1],[5,6],[1,1..2]] 
  # will turn Off (soft) the nodes 3,1 and 5,6 and 1,1 and 1,2

  omf tell offh system:topo:circle 
  # will turn Off (hard) the nodes in the topology file 'repository/system/topo/circle.rb'

  omf tell on mytopo 
  # will turn On the nodes in the topology file './mytopo.rb'
 }}}


[[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]
 
      With: 
      -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)
 
      TOPOLOGY      a valid topology description or file
                    (default is the entire set of nodes on the default testbed)
 
      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
 
 }}}