HP-MPI Version 1.0 for Windows Release Note

HP-MPI V1.0 for Windows Release Note

Building Applications

Running with an appfile

mpirun jobs submitted to CCP can run using appfile mode. The resources in the appfile must

match the allocated job resources for this to run correctly.

The -ccp flag will generate an appfile that uses the allocated CCP job resources as the

machines and rank counts in the appfile, then launches the mpirun job using this appfile.

If the user wishes to provide their own appfile, the tools described below have been provided.

The user can write an appfile, then select the exact resources needed from the Submit Jobs

window, Advanced tab if they wish. But this defeats the purpose of the job scheduler. And

because the CCP_NODES environment variable only lists the resources allocated to the task, not

the job, this environment variable isn't very useful for HP-MPI. Instead, the executable

mpi_nodes.exe (located in "%MPI_ROOT%\bin") has been provided which will return the job

resources, in the same format as the CCP_NODES environment variable:

<Node-Count> [<Node> <Processors-on-node>] ...

The script submission_script.vbs (found in "%MPI_ROOT%\help") is an example of using

mpi_nodes.exe to generate an appfile, and submit the mpirun command.

There are many other ways to accomplish the same thing. Other scripting languages can be

used to convert the output of mpi_nodes.exe into the appropriate appfile.

Or a script using all the job resources and the CCP_NODES environment variable can construct

the appropriate appfile, then submit a single processor mpirun task to CCP_JOBID and exit.

Here the mpirun task will be queued up with no available processors until the script (using all

job processors) finishes, then start executing.

NOTE If using this method, don't forget to include /stdout and /stderr options when

adding the mpirun task.

Again, there are many different ways to generate your own appfile for use by mpirun. In all

cases, the mpirun command that is launched will look like a 'normal' HP-MPI appfile launch:

mpirun -f generated-appfile [other HP-MPI options]

C command line basics

The utility "%MPI_ROOT%\bin\mpicc" is included to aid in command line compilation. To

compile with this utility, set MPI_CC to the path of the command line compiler you want to use.

Specify -mpi32 or -mpi64 to indicate if you are compiling a 32- or 64-bit application. Specify

the command line options that you would normally pass to the compiler on the mpicc

command line. The mpicc utility will add additional command line options for HP-MPI