docs:add note about needing hwloc 2.8.0 for PV

accelerators. related to issue open-mpi#11246 Signed-off-by: Howard Pritchard <howardp@lanl.gov> (cherry picked from commit c1b5e6e)
hppritcha · Mar 23, 2023 · 6bc06b8 · 6bc06b8
1 parent c0858c2
commit 6bc06b8
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/docs/installing-open-mpi/required-support-libraries.rst b/docs/installing-open-mpi/required-support-libraries.rst
@@ -44,6 +44,9 @@ and not universally available in all environments, they are directly
 incorporated into Open MPI's configure, build, and installation
 process.  More on this below.
 
+  .. note:: The versions listed in this table are the *minimum* versions needed.  In general, the Open MPI community recommends using more recent versions of both the :ref:`required support libraries <label-install-required-support-libraries>` and any other optional support libraries.  This is because more recent versions typically tend to include bug fixes, sometimes affecting Open MPI functionality.  As a specific example, there is a known issue with `Hardware Locality <https://www.open-mpi.org/projects/hwloc/>`_ releases older than v2.8.0 on systems with Intel Ponte Vecchio accelerators.  If you run Open MPI on such systems, you need to use Hwloc v2.8.0 or newer, or you will experience undefined behavior.
+   This effect is not unique to the Hardware Locality library; this is why the Open MPI community recommends using as recent as possible versions of all support libraries.
+
 Library dependencies
 --------------------