Download Platform MPI User's Guide - Platform Cluster Manager

Understanding Platform MPI
Platform MPI also provides implied srun mode. The implied srun mode allows the user to omit the
-srun argument from the mpirun command line with the use of the environment variable
MPI_USESRUN.
LSF on HP XC Systems
Platform MPI jobs can be submitted using LSF. LSF uses the SLURM srun launching mechanism. Because
of this, Platform MPI jobs must specify the -srun option whether LSF is used or srun is used.
% bsub -I -n2 $MPI_ROOT/bin/mpirun -srun ./a.out
LSF on Non-HP XC Systems
On non-HP XC systems, to invoke the Parallel Application Manager (PAM) feature of LSF for applications
where all processes execute the same program on the same host:
% bsub <lsf_options> pam -mpi mpirun <mpirun_options> program <args>
Appfiles
An appfile is a text file that contains process counts and a list of programs. When you invoke mpirun
with the name of the appfile, mpirun parses the appfile to get information for the run.
Creating an appfile
The format of entries in an appfile is line oriented. Lines that end with the backslash (\) character are
continued on the next line, forming a single logical line. A logical line starting with the pound (#) character
is treated as a comment. Each program, along with its arguments, is listed on a separate logical line.
The general form of an appfile entry is:
[-h remote_host] [-e var[=val] [...]] [-sp paths] [-np #] program [args]
where
-h remote_host
Specifies the remote host where a remote executable file is stored. The default is to search
the local host. remote_host is a host name or an IP address.
-e var=val
Sets the environment variable var for the program and gives it the value val. The default
is not to set environment variables. When you use -e with the -h option, the environment
variable is set to val on the remote host.
-sp paths
Sets the target shell PATH environment variable to paths. Search paths are separated by
a colon. Both -sp path and -e PATH=path do the same thing. If both are specified, the
-e PATH=path setting is used.
-np #
Specifies the number of processes to run. The default value for # is 1.
program
Specifies the name of the executable to run. mpirun searches for the executable in the
paths defined in the PATH environment variable.
Platform MPI User's Guide 75