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


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 ]


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


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.


-np nodes

Number of processes to create.


list of nodes to use.


list of hosts to use.


hostfile to use.


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


Environment to export to foreign nodes.


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.


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


Sets the working directory for the node program.


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

-?, --help

Show this help messages.


Display brief usage message.

See also

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