NAME¶
gfrun, gfrsh, gfssh - run Gfarm parallel programs
SYNOPSIS¶
gfrun [
options ]
command
arg ...
gfrsh [
options ]
command
arg ...
gfssh [
options ]
command
arg ...
DESCRIPTION¶
gfrun executes a parallel command on filesystem nodes, which is
determined by the
-G option, the
-H option, or the
-N
option.
The
-G option specifies the
gfarm-URL, which will be used by
file-affinity scheduling. In this case,
gfrun schedules the same number
of filesystem nodes as the number of Gfarm fragments, taking into
consideration the physical locations of each fragment replica of the Gfarm
file, and filesystem node status. The
-H option specifies the
hostfile that lists filesystem nodes. The
-N option specifies
the number of filesystem nodes.
The
-G,
-H, and
-N options are exclusive. When none of the
-G,
-H, or
-N options are specified,
gfrun
schedules filesystem nodes by file-affinity scheduling using the first
existent Gfarm file in the argument list,
args. If there are no
existent Gfarm files in the argument list, an appropriate filesystem node is
selected to be executed.
gfrsh and
gfssh utilize rsh and ssh, respectively, instead of
gfrcmd.
A
command can be specified by a gfarm-URL that is registered using
gfreg(1).
OPTIONS¶
- -G gfarm-URL
- Specifies a Gfarm file gfarm-URL for file-affinity
scheduling. Please read the DESCRIPTION section about how file-affinity
scheduling works.
- -H hostfile
- Specifies a hostfile that lists filesystem nodes.
if ``-'' is specified, standard input is used to read the host list.
- -N np
- Specifies the number of nodes, np, which are
selected in the increasing order of load average.
- -r
- Specifies an on-demand replication mode. In this mode,
every file will be replicated before it is accessed remotely.
- -o gfarm-URL
- Specifies a Gfarm file that the standard output of the
executed program will be redirected to.
- -e gfarm-URL
- Specifies a Gfarm file that the standard error of the
executed program will be redirected to.
- -I fragment-index
- Specifies a Gfarm fragment index executed by the gfrun
command. This option is available only when either file-affinity
scheduling is selected by the -G option or a gfarm file in the
argument list, or the -N option is specified.
- -v
- Displays error message verbosely.
- -p
- Displays the elapsed time of each Gfarm parallel I/O API
after the program terminates.
- -g
- Explicitly specifies that the command is a Gfarm program.
Gfarm specific options will be passed to the command as the result.
- -u
- Explicitly specifies that the command is an ordinary
program, and does not take Gfarm specific options.
- -b
- Specifies global file view as the default file view for
programs linked with the Gfarm syscall-hooking library. If this option is
not specified, the default is local file view.
- -?
- Displays a list of command options.
ENVIRONMENT VARIABLES¶
- GFRUN_CMD
- Specifies a remote shell command. If globus-job-run is
specified, gfrun executes each process using globus-job-run.
SEE ALSO¶
gfmpirun_p4(1)