Go back —> Tutorials

How to query the status of the nodes of a Testbed

If you have not done so yet:

• ​Register for an account
• ​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:

 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

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