Open MPI v5.0.x

The Open MPI Project is an open source implementation of the Message Passing Interface (MPI) specification that is developed and maintained by a consortium of academic, research, and industry partners. Open MPI is therefore able to combine the expertise, technologies, and resources from all across the High Performance Computing community in order to build the best MPI library available. Open MPI offers advantages for system and software vendors, application developers and computer science researchers.

Documentation locations

Documentation for Open MPI can be found in the following locations:

Open MPI version	Documentation location
v5.0.0 and later	Web: https://docs.open-mpi.org/ Tarball: docs/_build/html/index.html Installed: $prefix/share/doc/openmpi/html/index.html
v4.1.x and earlier	See the legacy Open MPI FAQ and the README file in the source tarball. For example: v4.1.x README file v4.0.x README file

Release announcements

The best way to hear about new Open MPI releases is via the low-volume announcement mailing list.

Additionally, if you are a downstream packager of Open MPI (e.g., you package Open MPI for an operating system distribution), you may wish to sign up for the low-volume packagers list.

Table of contents

• 1. Quick start
• 2. Getting help
  • 2.1. Where to send?
  • 2.2. For problems building or installing Open MPI
  • 2.3. For problems launching MPI or OpenSHMEM applications
  • 2.4. For problems running MPI or OpenSHMEM applications
• 3. Release notes
  • 3.1. General notes
  • 3.2. Platform Notes
  • 3.3. Compiler Notes
  • 3.4. General Run-Time Support Notes
  • 3.5. MPI Functionality and Features
  • 3.6. OpenSHMEM Functionality and Features
  • 3.7. MPI Collectives
  • 3.8. OpenSHMEM Collectives
  • 3.9. Network Support
  • 3.10. Open MPI Extensions
• 4. Building and installing Open MPI
  • 4.1. Quick start: Installing Open MPI
  • 4.2. Definitions
  • 4.3. Filesystem requirements
  • 4.4. VPATH builds
  • 4.5. Specifying compilers and flags
  • 4.6. Required support libraries
  • 4.7. configure command line options
  • 4.8. configure output summary
  • 4.9. make targets
  • 4.10. Installation location
  • 4.11. Advice for packagers
• 5. Open MPI-specific features
  • 5.1. Open MPI profiling interface
  • 5.2. Open MPI extensions
  • 5.3. User-Level Fault Mitigation (ULFM)
  • 5.4. Open MPI Java bindings
• 6. Validating your installation
  • 6.1. Checking your Open MPI configuration
  • 6.2. Testing your Open MPI installation
• 7. Version numbers and binary compatibility
  • 7.1. Backwards Compatibility
  • 7.2. Software Version Number
  • 7.3. Shared Library Version Number
• 8. Building MPI applications
  • 8.1. Quick start: Building MPI applications
  • 8.2. Customizing wrapper compiler behavior
  • 8.3. Extracting flags from the wrapper compilers
  • 8.4. Removed MPI constructs
  • 8.5. Deprecation warnings while compiling MPI applications
  • 8.6. Building fully-static MPI applications
• 9. Running MPI applications
  • 9.1. Quick start: Running MPI applications
  • 9.2. The role of PMIx and PRRTE
  • 9.3. Prerequisites
  • 9.4. Run-time tuning
  • 9.5. Launching only on the local node
  • 9.6. Launching with SSH
  • 9.7. Launching with Slurm
  • 9.8. Launching with LSF
  • 9.9. Launching with PBS / Torque
  • 9.10. Launching with Grid Engine
• 10. Networking system support
  • 10.1. OpenFabrics Interfaces (OFI) / Libfabric support
  • 10.2. TCP
  • 10.3. Shared Memory
  • 10.4. Omni-Path Architecture (OPA)
  • 10.5. InifiniBand / RoCE support
  • 10.6. iWARP Support
  • 10.7. CUDA
  • 10.8. ROCm
• 11. Frequently Asked Questions (FAQ)
  • 11.1. Supported systems
  • 11.2. System administrator-level technical information
  • 11.3. Building Open MPI
  • 11.4. Running MPI applications
  • 11.5. Fault Tolerance
  • 11.6. Troubleshooting
  • 11.7. Parallel debugging
  • 11.8. Large Clusters
  • 11.9. Open MPI IO (“OMPIO”)
  • 11.10. MacOS
  • 11.11. General Tuning
• 12. Developer’s guide
  • 12.1. Prerequisites
  • 12.2. GitHub, Git, and related topics
  • 12.3. Compiler Pickyness by Default
  • 12.4. Running autogen.pl
  • 12.5. Building Open MPI
  • 12.6. Open MPI terminology
  • 12.7. Source code
  • 12.8. Internal frameworks
  • 12.9. Manually installing the GNU Autootools
  • 12.10. Installing and running Sphinx (building the Open MPI docs)
  • 12.11. ReStructured Text for those who know Markdown
• 13. Contributing to Open MPI
  • 13.1. Open source contributions
  • 13.2. Closed source contributions
• 14. License
  • 14.1. Open MPI license
  • 14.2. Additional licenses
  • 14.3. Redistributed code
• 15. History of Open MPI
  • 15.1. Goals of the Open MPI Project
  • 15.2. Community
• 16. News
  • 16.1. Main updates (not on release branches yet)
  • 16.2. Open MPI v5.0.x series
  • 16.3. Open MPI v4.1.x series
  • 16.4. Open MPI v4.0.x series
  • 16.5. Open MPI v3.1.x series
  • 16.6. Open MPI v3.0.x series
  • 16.7. Open MPI v2.x series
  • 16.8. Open MPI v1.x series
• 17. Open MPI manual pages
  • 17.1. Commands (section 1)
  • 17.2. MPI API manual pages (section 3)
  • 17.3. Config file manual pages (section 5)
• 18. OpenSHMEM manual pages
  • 18.1. Commands (section 1)
  • 18.2. OpenSHMEM API manual pages (section 3)