mpiLibConf - Location of MPI implementation

Syntax

[primaryLib, extras] = mpiLibConf

Arguments

primaryLib	MPI implementation library used by a parallel job.
extras	Cell array of other required library names.

Description

[primaryLib, extras] = mpiLibConf returns the MPI implementation library to be used by a parallel job. primaryLib is the name of the shared library file containing the MPI entry points. extras is a cell array of other library names required by the MPI library.

To supply an alternative MPI implementation, create a file named mpiLibConf.m, and place it on the MATLAB path. The recommended location is matlabroot/toolbox/distcomp/user. Your mpiLibConf.m file must be higher on the cluster workers' path than matlabroot/toolbox/distcomp/mpi. (Sending mpiLibConf.m as a file dependency for this purpose does not work.)

Tips

Under all circumstances, the MPI library must support all MPI-1 functions. Additionally, the MPI library must support null arguments to MPI_Init as defined in section 4.2 of the MPI-2 standard. The library must also use an mpi.h header file that is fully compatible with MPICH2.

When used with the MathWorks job manager or the local scheduler, the MPI library must support the following additional MPI-2 functions:

• MPI_Open_port

• MPI_Comm_accept

• MPI_Comm_connect

When used with any third-party scheduler, it is important to launch the workers using the version of mpiexec corresponding to the MPI library being used. Also, you might need to launch the corresponding process management daemons on the cluster before invoking mpiexec.

Examples

Use the mpiLibConf function to view the current MPI implementation library:

mpiLibConf
    mpich2.dll

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS