Learn more about Platform products at http://www.platform.com

[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]



lsgrun


executes a task on a set of hosts

SYNOPSIS

lsgrun [-i] [-p | -P | -S] [-v] -f host_file | -m host_name ... | -n num_procesors [-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.

DEFAULT BEHAVIOR

By default:

OPTIONS

-i

Interactive operation mode. You are asked whether the task will 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

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 will arrive at the terminal in arbitrary order, depending on task execution speeds on individual hosts.

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

-S

Creates a pseudo-terminal with shell mode support on UNIX hosts.

Shell mode support is required for running interactive shells or applications which redefine the CTRL-C and CTRL-Z keys (such as jove).

This option is not supported on Windows.

-v

Verbose mode. Displays the name of the host or hosts running the task.

-f host_file

Either -f host_file, -m host_name or -n num_processors is required.

Executes the task on all hosts listed in the host_file.

Specify a file that contains a list of host names. Host names must be separated by white space characters (for example, SPACE, TAB, and NEWLINE).

This option is exclusive of options -n, -R, and -m.

-m host_name ...

Either -f host_file, -m host_name or -n num_processors is required.

Executes the task on all specified hosts.

Specify hosts on which to execute the task. If multiple host names are specified, the host names must be enclosed by " or ' and separated by white space.

This option is exclusive of options -n, -R, and -f.

-n num_processors

Either -f host_file, -m host_name or -n num_processors is required.

Executes the task on hosts with the required number of available processors.

One host may be used to start several tasks if the host is multiprocessor. This option can be used together with option -R to select desired hosts.

This option is exclusive of options -m and -f.

-R "res_req"

Executes the task on hosts with the required resource requirements.

Specify the resource requirement expression for host selection. The resource requirement will be used to choose from all hosts with the same host type as the local host, unless a "type == value" exists in res_req to specify otherwise.

This option can be used together with option -n to choose a specified number of processors to run the task.

command [argument ...]

Specify the command to execute. This must be the last argument on the command line.

-h

Prints command usage to stderr and exits.

-V

Prints LSF release version to stderr and exits.

SEE ALSO

lsfintro(1), lsrun(1), lsplace(1)

DIAGNOSTICS

Exit status is 0 if all commands are executed correctly.

Otherwise, the exit status is the first non-zero status returned by a remotely executed task. lsgrun will execute the task on all hosts even if some have non-zero exit status.

Exit status is -10 if a problem is detected in LSF.

[ Top ]


[ Platform Documentation ] [ Title ] [ Contents ] [ Previous ] [ Next ] [ Index ]


      Date Modified: February 24, 2004
Platform Computing: www.platform.com

Platform Support: support@platform.com
Platform Information Development: doc@platform.com

Copyright © 1994-2004 Platform Computing Corporation. All rights reserved.