flux-pmix

The flux-pmix project adds PMIx support to the Flux resource manager framework, so that Flux can launch MPI programs that bootstrap with PMIx, and can itself be launched by a resource manager that offers only PMIx. It contains two components:

Shell plugin

A flux-shell(1) plugin that runs a PMIx server in each job shell, for programs built with Open MPI, MPICH, or another PMIx client. It is enabled per job on the submission command line:

$ flux run -o pmi=pmix myprogram

PMI client plugin

A Flux PMI client plugin that lets Flux bootstrap under a launcher that provides only PMIx, such as jsrun. It is selected on the broker command line:

$ jsrun flux start -o,-Sbroker.boot-method=pmix

Guides

• Building and Installing
  • Dependencies
  • Building
• Feature Checklist
  • Initialization and Finalization
  • Data Access and Sharing
  • Reserved Keys
  • Query Operations
  • Synchronization
  • Publish/Lookup Operations
  • Event Notification
  • Process Management
  • Job Management and Reporting
  • Process Sets and Groups
  • Fabric Support
  • Security
  • Tools and Debuggers
  • Beyond Standard 5.0
• OpenPMIx Version Interoperability
  • The server version
  • The client version
  • Components by version
  • Data store selection
  • Conclusions
• Tracing the PMIx Protocol
  • How it works
  • Capture a job
  • Merge the files of a job
  • List the messages
  • Show the messages in full
  • Follow one rank
  • Show one message in full
  • Time a phase
  • Capture a particular configuration
  • Open in Wireshark
• The OpenPMIx Wire Protocol
  • Scope
  • Transport
  • Connect request
  • Connect response
  • Message header
  • Encodings
  • Commands
  • Job information
  • Data stores
  • The server's side
  • Version summary

Manual Pages

• man7
  • flux-shell-pmix(7)

Related Information

Description	Links
Main Flux Documentation Pages	Docs
flux-core, the base Flux framework	Docs
OpenPMIx, the PMIx reference implementation	Docs
The PMIx Standard	GitHub
flux-pmix source and issues	GitHub