Command Reference Guide

Platform LSF Command Reference 243
lsgrun
executes a task on a set of hosts
Synopsis
lsgrun [-i] [-p | -P | -S] [-v]
-f host_file | -m host_name ... | -n num_hosts [-R"res_req"]
[command [argument ...]]
lsgrun [-h | -V]
Description
Executes a task on the specified hosts. lsgrun is useful for fast global operations
such as starting daemons, replicating files to or from local disks, looking for
processes running on all hosts, checking who is logged in on each host, and so on.
The hosts can be specified using a host file, a list of host names or by letting the
system select the hosts. If
LSB_DISABLE_LIMLOCK_EXCL=y (to enable preemption of
exclusive jobs, for example), you can use
lsgrun to start a task on hosts that are
currently running exclusive jobs.
By default:
◆ lsgrun is not interactive.
◆ The specified task is executed sequentially on hosts with full pseudo tty
support.
◆ lsgrun does not create a pseudo-terminal.
◆ LSF uses as many processors as available to run the specified task.
◆ The resource requirement for host selection is r15s:pg.
◆ The prompt Command> is displayed to allow users to type in a command (task)
terminated by a
CTRL-D or EOF. The command is then executed on the specified
hosts.
Options
-i Interactive operation mode. You are asked whether the task is to be executed on all
hosts. If you answer
y, the task is started on all specified hosts; otherwise, you are
asked to specify hosts interactively.
-P Creates a pseudo-terminal on UNIX hosts. This is necessary to run programs
requiring a pseudo-terminal (for example,
vi).
This option is not supported on Windows.
-p Parallel run mode. Executes the task on all hosts simultaneously and without
pseudo
tty support.
If this option is specified and the
-P option is specified, the -P option is ignored.
This option is useful for fast start-up of tasks. However, any output from remote
tasks arrive at the terminal in arbitrary order, depending on task execution speeds
on individual hosts.