[wiki:Documentation]
| !orbitHandler

= Orbit Handler =

orbitHandler is an alternative framework for controlling the ORBIT lab. It consists of a series of console commands that that operate on subsets of nodes. The major features:

 * Precisely specifiy large, intricate node sets
 * Send specific commands to each node in the set
 * Distributed ftp equivilant
 * Entirely command line driven
 * No global grid operations
 * Easy to create repeatable experiments

== Node Sets ==

Node sets are contained in a file. This file name is the first parameter for every function. For example:

{{{
joeuser@console.sb1:~$ ./imageNodes nodeset baseline.ndz
}}}

An example node set file looks like this:

{{{
# A node set file
[1..16,1..15]
[18,18..19]
[19..20,1..2]
-[10,2]
-[2..3,5..3]
}}}

Each line includes a different range of nodes. The lines are processed in order and the results are merged. Any node range with a '-' in front of it removes that range from the current set. This can be used to remove non-functional nodes, or a particular class of nodes (ie. those nodes using intel wifi cards).

== Node Commands ==

The following are list of supported commands. 

= test =


*under construction*