Name

mpirun-ipath-ps — run a InfiniPath™ MPI program on a ParaStation MPI cluster.

Synopsis

mpirun-ipath-ps -np nodes [[-nodes nodelist] | [-hosts hostlist] | [-hostfile hostfile]] [-sort { proc | load | proc+load | none } ] [-exports=envlist] [-keep-mpihosts] [-keep-mpihosts] [ -v | --verbose ] [ -V | --version ] [ -n | -num-recv-bufs=num ] [ -N | -num-send-bufs=num ] [ -q | -quiescence-timeout=num ] [ -S | -short-len=length ] [ -L | -long-len=length ] [ -W | -rndv-window-size=size ] [ -c | -psc-spin-count=count ] [-stdin=filename] [-wdir=path] [-stdin-target=rank] [ -? | --help ] [--usage] command [ args ]

Description

mpirun-ipath-ps is a tool that enables programs linked with the InfiniPath MPI library to run on a ParaStation MPI cluster under control of the ParaStation MPI management facility. Within ParaStation MPI the startup of parallel jobs is handled as described within the process_placement(7) manual page. The spawning mechanism is steered by environment variables, which are described in detail within ps_environment(7).

Note

The command mpirun-ipath-ps is part of the psipath.rpm package. Please contact for details how to obtain this package.

mpirun-ipath-ps typically works like this:

  mpirun-ipath-ps -np num prog [args]

This will startup the program prog num times in parallel forming a parallel job. Args are optional argument which will be passed to each instance of prog.

Options

-np nodes

Number of processes to create.

-nodes=nodeslist

list of nodes to use.

-hosts=hosts

list of hosts to use.

-hostfile=hostfile

hostfile to use.

-sort=criteria

Sorting criteria to use: proc, load, proc+load or none.

-exports=envlist

Environment to export to foreign nodes.

-keep-mpihosts

don't remove mpihosts file upon exit.

-v, --verbose

Print diagnostic messages.

-V, --version

Output version information and exit.

-n, -num-recv-bufs=num

Number of receive buffers in runtime (deprecated and ignored).

-N, -num-send-bufs=num

Number of send buffers in runtime.

-q, -quiescence-timeout=secs

Wait time in seconds for quiescence on the nodes. Useful for detecting deadlocks. Value of 0 disables quiescence detection.

-S, -short-len=len

Message length in bytes below which short message protocol is to be used (deprecated and ignored).

-L, -long-len=len

Message length in bytes above which rendezvous protocol is to be used.

-W, -rndv-window-size=size

Window size in bytes to use for native rendezvous.

-c, -psc-spin-count=count

Number of times to loop for packets before yielding.

-stdin=filename

Filename that should be fed as stdin to the node program.

-wdir=path

Sets the working directory for the node program.

-stdin-target=rank

Process rank that should receive the stdin file specified via -stdin option. Specify -1 if every process needs stdin.

-?, --help

Show this help messages.

--usage

Display brief usage message.

See also

psmstart(1), ps_environment(7), process_placement(7)