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

[[BR]]
=== Getting Started ===

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

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

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

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

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

[[BR]]
=== Learning More ===

The complete available options for this command is given by ''"orbit help stat"'':

 {{{
  orbit help stat

Returns the status of the nodes in a testbed
Usage:
      orbit stat [-h]
      orbit stat [-c] [DOMAIN]
      orbit stat [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: 
                    orbit stat all grid
                    orbit stat 1,1..2
                    orbit stat [[1,2],[1,1]] sb1 
                    orbit stat [[1,1],[2..6,1..2]] 
                    orbit stat system:topo:all
                    orbit stat system:topo:circle
                    orbit stat topo_grid_active
 }}}