| Scyld ClusterWare HPC: Reference Guide | ||
|---|---|---|
| << Previous | Next >> | |
bpsh [-h ] [-v ] [-a ] [-A] [-n] [-N] [-L] [-p] [-s] [-d] [-b num] [-I file, --stdin file] [-O file, --stdout file]
[-E file, --stderr file] nodenumber command [command-args]
This utility is part of the BProc package and is installed by default on Scyld ClusterWare systems. It is the basic mechanism for running programs on nodes, and is patterned after the rsh and ssh commands.
Nodenumber can range from -1 (the master) to one less than the number of accessible nodes. bpsh will also accept a delimited list of nodes; use -a for all nodes that are "up" and -A for all nodes that are communicating (this includes the states "up", "error" and "unavailable").
bpsh will forward stdin, stdout and stderror for the remote processes. stdin will be duplicated for every process on each remote node selected. For a single remote process, the exit status of bpsh will be the exit status of that process. Non-normal exit status will also be captured and displayed. For multiple processes, bpsh exits with the highest exit status.
The following options are available to the bpsh program.
Print the command usage message and exit. If -h is the first option, all other options will be ignored. If -h is not the first option, the other options will be parsed up to the -h option, but no action will be taken.
Print the command version number and exit. If -v is the first option, all other options will be ignored. If -v is not the first option, the other options will be parsed up to the -v option, but no action will be taken.
Specifies that the command will be run on all nodes in the "up" state.
Specifies that the command will be run on all nodes in either the "up", "error", and "unavailable" states. Note that non-root users may get "BProc move failed" errors, since they are only allowed to run on "up" nodes, regardless of other node permissions.
Get stdin from /dev/null. On any read from stdin, /dev/null will return EOF. This is useful for any program that you background or daemonize. Like rsh, bpsh will not exit immediately if stdin is left open and the program has not completed. bpsh assumes the program may want input from stdin.
No IO forwarding.
Line buffer output from nodes.
Prefix the node number on each output line from the node that sent it.
List sequentially all the output from each node.
Print a divider line between the sequential output from each node.
Set the IO line buffer size to the number of bytes. The default is 4096.
Redirect standard input from the specified file on the remote node.
Redirect standard output to the specified file on the remote node.
Redirect standard error to the specified file on the remote node.
The node to run the command on.
The command/program to run.
Run the ls command on nodes -1, 0 and 2, and prefix the node number to each line. Note, due to the way getopt works, the master (node -1) cannot be first in the node list.
[user@cluster user] $ bpsh 0,-1,2 -p ls /tmp -1: f1.txt -1: foo.txt 0: f3.txt 2: newfoo.txt 2: oops.txt |
Run the uptime command on nodes in the "up" state.
[user@cluster user] $ bpsh -a -d uptime
0 -------------------------------------------------------------------
2:42pm up 2 days, 23:51, 0 users
1 -------------------------------------------------------------------
2:41pm up 3 days, 5:38, 0 users
3 -------------------------------------------------------------------
2:42pm up 3 days, 5:38, 0 users |
Run a single instance of the uptime command on a node chosen by the scheduler, displaying the node number before the output.
[user@cluster user] $ bpsh `beomap --nolocal` -d uptime
1 -------------------------------------------------------------------
22:19:27 up 21:28, 0 users, load average: 0.00, 0.00, 0.00 |
| << Previous | Home | Next >> |
| bpcp | Up | bpstat |