Skip to content

Commit 1cad5f5

Browse files
authored
DOC add notes for openmpi external packages
1 parent 22943a5 commit 1cad5f5

File tree

1 file changed

+8
-13
lines changed

1 file changed

+8
-13
lines changed

src/user/tipsandtricks.rst

Lines changed: 8 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -86,25 +86,20 @@ a package from ``conda-forge`` that relies on MPI, ``conda`` will install the MP
8686
built by ``conda-forge`` and the package will link to those binaries. This setup often either
8787
does not work at all or functions in unexpected ways on HPC systems.
8888

89-
To solve these issues, ``conda-forge`` has created special dummy builds of the ``mpich`` libraries
90-
that are simply shell packages with no contents. These packages allow the ``conda`` solver to produce
89+
To solve these issues, ``conda-forge`` has created special dummy builds of the ``mpich`` and ``openmpi``
90+
libraries that are simply shell packages with no contents. These packages allow the ``conda`` solver to produce
9191
correct environments while avoiding installing MPI binaries from ``conda-forge``. You can install the
9292
dummy package with the following command
9393

9494
.. code-block:: shell
9595
96-
$ conda install mpich=3.3.*=external_*
96+
$ conda install mpich=x.y.z=external_*
97+
$ conda install openmpi=x.y.z=external_*
9798
98-
As long as you have the local copies of the ``mpich`` library in your linking paths and
99-
the local version matches the ``conda`` version up to the minor version number (e.g., ``3.3.1``
100-
matches ``3.3.2`` but not ``3.4.1``), then this procedure should work. At runtime, the ``conda-forge``
101-
package that depends on MPI should find the local copy of ``mpich`` and link to it.
102-
103-
.. note::
104-
105-
``mpich`` has a high degree of ABI compatibility, making this procedure possible.
106-
We have not currently implemented this procedure with ``openmpi``, but can do so at a later date
107-
as ABI compatibility allows.
99+
As long as you have the local copies of the ``mpich``/``openmpi`` library in your linking paths and
100+
the local version matches the ``conda`` version within the proper ABI range, then this procedure should
101+
work. At runtime, the ``conda-forge`` package that depends on MPI should find the
102+
local copy of ``mpich``/``openmpi`` and link to it.
108103

109104

110105
.. _apple_silicon_rosetta:

0 commit comments

Comments
 (0)