Parallel Programming Guide for HP-UX Systems

MPI
Running
Chapter 2 37
We recommend using the mpirun launch utility. However, for users that are unable to install
MPI on all hosts, HP MPI provides a self-contained launch utility, mpirun.all.
The restrictions for mpirun.all include
• Applications must be linked statically
• Start-up may be slower
• TotalView is unavailable to executables launched with mpirun.all
• Files will be copied to a temporary directory on target hosts
• The remote shell must accept stdin
mpirun syntax has five formats:
• For applications where all processes execute the same program on the same host:
mpirun [-np #] [-help] [-version] [-djpv] [-ck] [-t spec ] [-i spec ] [-h host ]
[-l user ] [-e var [= val ]]... [-sp paths ] [-tv] program [ args ]
For example:
% $MPI_ROOT/bin/mpirun -j -np 3 send_receive
runs the send_receive application with three processes and prints out the job ID.
• For applications that consist of multiple programs or that run on multiple hosts:
mpirun [-help] [-version] [-djpv] [-ck] [-t spec ] [-i spec ] [-commd] [-tv] -f
appfile [-- extra_args_for_appfile ]
In this case, each program in the application is listed in a file called an appfile. Refer to
“Appfiles” on page 42 for more information.
For example:
% $MPI_ROOT/bin/mpirun -t my_trace -f my_appfile
enables tracing, specifies the prefix for the tracing output file is my_trace, and runs an
appfile named my_appfile.
• Applications using the Quadrics Elan3 communication processor on Linux or Tru64UNIX
require the -prun option:
% $MPI_ROOT/bin/mpirun [ mpirun options ] -prun [ prun options ]
This method is only supported when linking with shared libraries.
This method allows full MPI-2 functionality. Some features like mpirun -stdio
processing are still unavailable.