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:

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