launches parallel tasks on a set of hosts
Most MPI implementations and many distributed applications use rsh and ssh as their task launching mechanism. The blaunch command provides a drop-in replacement for rsh and ssh as a transparent method for launching parallel applications within LSF.
blaunch supports the following core command line options as rsh and ssh:
rsh host_name command
ssh host_name command
All other rsh and ssh options are silently ignored.
blaunch transparently connects directly to the RES/SBD on the remote host, and subsequently creates and tracks the remote tasks, and provides the connection back to LSF. You do not need to insert pam, taskstarter or any other wrapper.
blaunch only works under LSF. It can only be used to launch tasks on remote hosts that are part of a job allocation. It cannot be used as a standalone command.
When no host names are specified, LSF runs tasks on all allocated hosts, one remote task per job slot.
Windows: blaunch is supported on Windows 2000 or later with the following exceptions:
Only the following signals are supported: SIGKILL, SIGSTOP, SIGCONT.
The -n option is not supported.
CMD.EXE /C <user command line> is used as intermediate command shell when:
-no-shell is not specified
CMD.EXE /C is not used when -no-shell is specified.
Windows Vista User Account Control must be configured correctly to run jobs.
Any tasks killed outside of LSF (for example, with taskkill) are assumed to have a normal exit.
Standard input is taken from /dev/null. (Not supported on Windows.)
Executes the task on all hosts listed in the host_file.
Specify the path to a file that contains a list of host names. Each host name must listed on a separator line in the host list file.
This option is exclusive of the -z option.
The name of the host where remote tasks are to be launched.
Executes the task on all specified hosts.
Whereas the host name value for rsh and ssh is a single host name, you can use the -z option to specify a space-delimited list of hosts where tasks are started in parallel.
Specify a list of hosts on which to execute the task. If multiple host names are specified, the host names must be enclosed by quotation marks (" or ') and separated by white space.
This option is exclusive of the -u option.
Launches commands through user's login shell.
Only applies to UNIX and Linux hosts.
Launches commands without any intermediate shell.
Specify the command to execute. This must be the last argument on the command line.
Prints command usage to stderr and exits.
Prints LSF release version to stderr and exits.
Exit status is 0 if all commands are executed correctly.
lsb_getalloc, lsb_launch