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

=== Getting Started ===

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

  statnode system:topo:circle 
  # will query the status of the nodes in the topology file 'repository/system/topo/circle.rb'

  statnode mytopo 
  # will query the status of the nodes in the topology file './mytopo.rb'

  statnode -c
  # will return a summary of the state of the nodes on the grid
 }}}

=== Learning More ===

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

 {{{
  statnode --help

Returns the status of the nodes in a testbed
Usage:
      statnode [-h]
      statnode [-c] [DOMAIN]
      statnode [TOPOLOGY] [DOMAIN]
 
      With: 
      -h, --help    print this help message
      -c, --count   print a summary of the node status for the testbed DOMAIN
                    (default is the testbed where this command is executed)
      TOPOLOGY      a valid topology description or file without the trailing '.rb'
                    (default is the entire set of nodes on the default testbed)
 
      Some Examples: 
                    statnode all grid
                    statnode 1,1..2
                    statnode [[1,2],[1,1]] sb1 
                    statnode [[1,1],[2..6,1..2]] 
                    statnode system:topo:all
                    statnode system:topo:circle
                    statnode topo_grid_active
 }}}