File: run-time.rst

package info (click to toggle)
openmpi 5.0.8-3
  • links: PTS, VCS
  • area: main
  • in suites:
  • size: 201,692 kB
  • sloc: ansic: 613,078; makefile: 42,353; sh: 11,194; javascript: 9,244; f90: 7,052; java: 6,404; perl: 5,179; python: 1,859; lex: 740; fortran: 61; cpp: 20; tcl: 12
file content (30 lines) | stat: -rw-r--r-- 1,532 bytes parent folder | download | duplicates (10)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
General Run-Time Support Notes
==============================

* The Open MPI installation must be in your ``PATH`` on all nodes (and
  potentially ``LD_LIBRARY_PATH`` or ``DYLD_LIBRARY_PATH``, if
  ``libmpi``/``libshmem`` is a shared library), unless using the
  ``--prefix`` or ``--enable-mpirun-prefix-by-default`` functionality (see
  below).

* Open MPI's run-time behavior can be customized via Modular Component
  Architecture (MCA) parameters (see :ref:`this section
  <label-running-setting-mca-param-values>`) for more information on
  how to get/set MCA parameter values).  Some MCA parameters can be
  set in a way that renders Open MPI inoperable.  In particular, some
  parameters have required options that must be included:

  * If specified, the ``btl`` parameter must include the ``self``
    component, or Open MPI will not be able to deliver messages to the
    same rank as the sender.  For example: ``mpirun --mca btl tcp,self
    ...``
  * If specified, the ``btl_tcp_if_exclude`` parameter must include the
    loopback device (``lo`` on many Linux platforms), or Open MPI will
    not be able to route MPI messages using the TCP BTL.  For example:
    ``mpirun --mca btl_tcp_if_exclude lo,eth1 ...``

* Running on nodes with different endian and/or different datatype
  sizes within a single parallel job is supported in this release.
  However, Open MPI does not resize data when datatypes differ in size
  (for example, sending a 4 byte ``MPI_DOUBLE`` and receiving an 8 byte
  ``MPI_DOUBLE`` will fail).