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.

• orbitImage - Images a set of nodes
• orbitPower - Turns on or off a set of nodes
• orbitPutFile - Copies a file from the console to a set of nodes
• orbitGetFileMerged - Merges a file from each node into one file on the console
• orbitCmd - Runs a user definable command that affects nodes in the set
• orbitWait - Waits for a set of processes to finish
• orbitRun - Executes a command on each node in the set
• orbitRunWait - Executes a command on each nodes and blocks on completion
• orbitKillAll - Kills all matching processes on each node in the set
• orbitKillOne - Kills the first matching process on each node in the set

test

*under construction*