main

MPIRun.exe

Use MPIRun.exe to launch an mpich application. It is in the [MPICH Launcher Home]\bin directory. You will probably want to add this directory to your path environment variable.

Usage:

- MPIRun configfile [-logon] [args ...]
- MPIRun -np #processes [-logon] [-env "var1=val1|var2=val2..."] executable [args ...]
- MPIRun -localonly #processes [-env "var1=val1|var2=val2..."] executable [args ...]

Bracketed sections are optional.

Configuration files.

The config file format is as follows:

>     exe c:\somepath\myapp.exe
>      OR \\host\share\somepath\myapp.exe
>     [args arg1 arg2 arg3 ...]
>     [env VAR1=VAL1|VAR2=VAL2|...|VARn=VALn]
>     hosts
>     hostA #procs [path\myapp.exe]
>     hostB #procs [\\host\share\somepath\myapp2.exe]
>     hostC #procs
>     ...

Bracketed lines are optional. The # character will comment out a line. You may specify a path to an executable on each host line, thus enabling MPMD programming. If you do not specify a path, then the default is used from the exe line.

Here are two sample configuration files:

>     exe c:\temp\myapp.exe
>     hosts
>     fry 1
>     jazz 2

This one shows a more complicated scenario:

>     exe c:\temp\slave.exe
>     env MINX=0|MAXX=2|MINY=0|MAXY=2
>     args -i c:\temp\cool.points
>     hosts
>     fry 1 c:\temp\master.exe
>     fry 1
>     #light 1
>     jazz 2

Command line options for MPIRun

-np #procs

Launch #procs, starting on the current machine and then one on each of the rest of the machines specified at install time until #procs are launched. This mechanism loops if more processes are specified than there are machines available.

-localonly #procs

This runs the application on the local machine using the shared memory device.

-localonly #procs -tcp

Add the -tcp switch to force the use of sockets instead of shared memory

-env "var1=val1|var2=val2|var3=val3|...varn=valn"

This will set the environment variables specified in the string before each process is launched. Remember to quote the string so the command prompt doesn't interpret the vertical bar as a pipe command.

-logon

This option will cause mpirun to prompt for an account and password. If you use this option then you can specify an executable that is located in a shared directory. If you don't -logon then the executable must reside on each host locally. Use mpiregister.exe to encrypt an account and password into the registry and avoid the prompt.

main
MPIRun
MPIRegister
MPIConfig