Section index Manual top page Document Top page

scout

SCore parallel shell. More...

Scout is an environment for executing shell command on every host in a cluster.

SYNOPSIS

scout [OPTIONS] -g GROUP
scout [OPTIONS] COMMAND ...
scout

The first form of the SCOUT invokation is to create a SCOUT environment. The second form of invokation is to run the shell commands on compute hosts in parallel. The third form of invokation is used to determine if the current einvironment is already in a SCOUT environment or not.
When a SCOUT environment is created, the scout command creates a new shell.
To exit a SCOUT environment, terminate the shell.

Parameters:

	GROUP	group name to specify the set of compute hosts
	COMMAND	any shell command and associated arguments if any

OPTIONS

-force

Force to create new SCOUT environment while in a SCOUT environment already

-merge

Merge same output of command execution on each compute node (default).

-sort

Sort alphabetically output of command execution on each compute node

-rev

Reverse-sort alphabetically output of command execution on each compute node

-nosort

Do not sort nor merge output of command execution on each compute node

-stdin

Run command on compute nodes with STDIN

-X

Enables X11 forwarding.

-rsh RSH

Specify the remote shell command name or path to spawn remote process. See allso the SCORE_RSH environment description below.

STANDARD INPUT

When the scout command is invoked with the -stdin option, the standard input of the local scout command is broadcasted to the remote processes in a parallel way. The following example shows how a local file is copied into every compute hosts.

	% scout -g HOSTGROUP
	% scout -stdin "cat > /tmp/remote-file" < ./local-file

Here, the copy of ./local-file is created on every remote hosts. Note that the remote shell command must be quoted so that the local shell will not interpret it.

ENVIRONMENT

SCBDSERV

Scoreboard server

DISPLAY

The DISPLAY environment variable indicates the location of the X11 server. To use X11 in the SCOUT environment, combine with the -X option described above.

SCORE_RSH

Specify the remote shell command name or path to spawn remote process. If the -rsh option is specified then this variable is ignored. ssh(1) can also be specified for the SCORE_RSH environment or the -rsh option value, however, ssh(1) must be setup to enable the agent forwarding, and the -A option of the ssh(1) command will not work.