13.3. Building Open MPI
This section represents old content from the <= v4.x FAQ that has not been properly converted to the new-style documentation. The content here was perfunctorily converted to RST, but it still needs to be:
Converted from a question-and-answer style to a regular documentation style (like the rest of these docs).
Removed from this section and folded into other sections in these docs.
To be clear, this section will eventually be deleted; do not write any new content in this section.
13.3.1. How do I statically link to the libraries of Intel compiler suite?
The Intel compiler suite, by default, dynamically links its runtime libraries against the Open MPI binaries and libraries. This can cause problems if the Intel compiler libraries are installed in non-standard locations. For example, you might get errors like:
error while loading shared libraries: libimf.so: cannot open shared object file: No such file or directory
To avoid such problems, you can pass flags to Open MPI’s configure script that instruct the Intel compiler suite to statically link its runtime libraries with Open MPI:
shell$ ./configure CC=icc CXX=icpc FC=ifort LDFLAGS=-Wc,-static-intel ...
13.3.2. Why do I get errors about hwloc or libevent not found?
Sometimes you may see errors similar to the following when attempting to build Open MPI:
... PPFC profile/pwin_unlock_f08.lo PPFC profile/pwin_unlock_all_f08.lo PPFC profile/pwin_wait_f08.lo FCLD libmpi_usempif08.la ld: library not found for -lhwloc collect2: error: ld returned 1 exit status make``2``: *** ``libmpi_usempif08.la`` Error 1
This error can happen when a number of factors occur together:
If Open MPI’s
configurescript chooses to use an “external” installation of hwloc and/or Libevent (i.e., outside of Open MPI’s source tree).
If Open MPI’s
configurescript chooses C and Fortran compilers from different suites/installations.
Put simply: if the default search library search paths differ between
the C and Fortran compiler suites, the C linker may find a
libevent, but the Fortran linker
This may tend to happen more frequently starting with Open MPI v4.0.0 on Mac OS because:
In v4.0.0, Open MPI’s
configurescript was changed to “prefer” system-installed versions of hwloc and Libevent (vs. preferring the hwloc and Libevent that are bundled in the Open MPI distribution tarballs).
In MacOS, it is common for Homebrew or MacPorts to install: * hwloc and/or Libevent * gcc and gfortran
For example, as of July 2019, Homebrew:
Installs hwloc v2.0.4 under
Installs the Gnu C and Fortran compiler suites v9.1.0 under
/usr/local. However, the C compiler executable is named
gcc!), whereas the Fortran compiler executable is named
These factors, taken together, result in Open MPI’s
script deciding the following:
The C compiler is
gcc(which is the MacOS-installed C compiler).
The Fortran compiler is
gfortran(which is the Homebrew-installed Fortran compiler).
There is a suitable system-installed hwloc in
/usr/local, which can be found – by the C compiler/linker – without specifying any additional linker search paths.
The careful reader will realize that the C and Fortran compilers are from two entirely different installations. Indeed, their default library search paths are different:
gfortranwill not search
Hence, since the majority of Open MPI’s source code base is in C, it
compiles/links against hwloc successfully. But when Open MPI’s
Fortran code for the
mpi_f08 module is compiled and linked, the
gfortran – which does not search
/usr/local/lib by default – cannot find
libhwloc, and the link
There are a few different possible solutions to this issue:
The best solution is to always ensure that Open MPI uses a C and Fortran compiler from the same suite/installation. This will ensure that both compilers/linkers will use the same default library search paths, and all behavior should be consistent. For example, the following instructs Open MPI’s
configurescript to use
gcc-9for the C compiler, which (as of July 2019) is the Homebrew executable name for its installed C compiler:
shell$ ./configure CC=gcc-9 ... # You can be precise and specify an absolute path for the C # compiler, and/or also specify the Fortran compiler: shell$ ./configure CC=/usr/local/bin/gcc-9 FC=/usr/local/bin/gfortran ...
Note that this will likely cause
configureto not find the Homebrew-installed hwloc, and instead fall back to using the bundled hwloc in the Open MPI source tree.
Alternatively, you can simply force
configureto select the bundled versions of hwloc and libevent, which avoids the issue altogether:
shell$ ./configure --with-hwloc=internal --with-libevent=internal ...
Finally, you can tell
configureexactly where to find the external hwloc library. This can have some unintended consequences, however, because it will prefix both the C and Fortran linker’s default search paths with
shell$ ./configure --with-hwloc-libdir=/usr/local/lib ...
Be sure to see this section of the Installation guide for more information about the bundled hwloc and/or Libevent vs. system-installed versions.