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

  1. scout [OPTIONS] -g GROUP
  2. scout [OPTIONS] COMMAND ...
  3. 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

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

SEE ALSO

scorehosts(1), scoregroups(1), scorehosts.db(5), scoreboard(8).
CREDIT
This document is a part of the SCore cluster system software developed at PC Cluster Consortium, Japan. Copyright (C) 2003-2008 PC Cluster Consortium.