Go back --> [wiki:Tutorial Tutorials]

== How to query the status of 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
 }}}

Then, to query the status of some nodes on the 'grid' testbed, use the command:

 {{{
  statnode all
  # will query the status of the entire set of 20x20 nodes on the 'grid'
  
  statnode 3,1 5,6 1,1..2 
  # will query the status of nodes 3,1 and 5,6 and 1,1 and 1,2
 }}}

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

 {{{
  statnode --help

  Returns the status of the nodes in a testbed
Usage:
      status [OPTION] NODES NODES NODES ...
      status [OPTION] COMMAND
 
      [OPTION] are: 
      -h, --help         print this help message
      -d, --domain NAME  query nodes on the testbed NAME 
                         (default is the testbed where this command is executed)
 
      Valid NODES format are: 
      all         returns status of all nodes 
      x,y         returns status of the node at coordinate ( x , y )
      x1..x2,y    returns status of all the nodes with coordinates 
                  in the range ( [x1..x2] , y )
                  (other valid combinations:  x1..x2,y1..y2   and   x,y1..y2 )
 
      Valid COMMAND are: 
      -t, --topo FILENAME  return status of nodes from the topology file FILENAME
      -on, --counton       return the number of nodes in 'ON' state
      -off, --countoff     return the number of nodes in 'OFF' state
      -ko, --countko       return the number of nodes in 'Not Available' state
 
      Examples:
               status all
               status 1,1 4,2 6,3..5
               status --d sb1 1,1..2
               status --domain sb2 all
               status --topo topo_grid_active.rb
               status -on
               status --countoff
 }}}