lsgrun

executes a task on a set of hosts

Synopsis

lsgrun [-i][-p -P -S][-v]

-fhost_file -mhost_name ... -nnum_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-Dor EOF. The command is then executed on the specified hosts.

Options

-iInteractive 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.

-PCreates 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.

-pParallel run mode. Executes the task on all hosts simultaneously and without pseudo tty support.

If this option is specified and the -Poption is specified, the -Poption 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.

Platform LSF Command Reference 243