Go back --> [wiki:Tutorial Tutorials]

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

If you have not done so yet: 

 * [http://www.orbit-lab.org/wiki/Registration 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
 }}}

=== Getting Started ===

Then, to switch some nodes On/Off on the 'grid' testbed, use the command:

 {{{
  tellnode on all
  # will turn On the entire set of 20x20 nodes on the 'grid'
  
  tellnode 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

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

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

=== Learning More ===

The complete available option/commands for ''tellnode'' are:

 {{{
tellnode --help

Switch ON/OFF the nodes in a testbed
Usage:
      tellnode [-h]
      tellnode [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: 
                    tellnode on all grid
                    tellnode on 1,1..2
                    tellnode offs [[1,2],[1,1]] sb1 
                    tellnode offs [[1,1],[2..6,1..2]] 
                    tellnode offh system:topo:all
                    tellnode offh topo_grid_active
 }}}