Skip to content

docs: clients of earlier PMIx releases need legacy peers - #2879

Merged
rhc54 merged 1 commit into
openpmix:masterfrom
rhc54:topic/docs-legacy-peers
Nov 2, 2026
Merged

rhc54 merged 1 commit into
openpmix:masterfrom
rhc54:topic/docs-legacy-peers

Conversation

@rhc54

@rhc54 rhc54 commented Nov 2, 2026

Copy link
Copy Markdown
Contributor

Docs only.

With PMIx v7.0 or later, a daemon's PMIx server accepts clients and tools of earlier PMIx releases only when legacy peers are on. That covers, for example, an Open MPI 5 application or a prun built against an earlier PMIx. Without legacy peers, each such process comes up as a singleton, so an N-process job runs as N one-process jobs, each logging one PMIX ERROR: BAD-PARAM line.

The troubleshooting guide now has an entry for that symptom, with the remedy:

  • use a PMIx built with --enable-legacy-peers;
  • set ptl_base_legacy_peers with --pmixmca, or with PMIX_MCA_ptl_base_legacy_peers in the environment.

Either setting reaches every daemon: schizo exposes --pmixmca values as PMIX_MCA_* variables, and the daemon launch forwards those.

Testing

  • Docs: sphinx-build adds no warnings.
  • Both settings, by hand: each turns on the TCP listener (prterun --report-uri tcp- prints a TCP URI with either one, and is refused without).

With PMIx v7.0 or later, a daemon's PMIx server takes clients and tools
of earlier PMIx releases - an Open MPI 5 application, or a prun built
against an earlier PMIx - only with legacy peers on. Without them each
such process comes up as a singleton, so an N-process job runs as N
one-process jobs, with one PMIX ERROR: BAD-PARAM line apiece.

Say so in the troubleshooting guide, by the symptom, with the remedy:
a PMIx built with --enable-legacy-peers, and ptl_base_legacy_peers set
through --pmixmca or PMIX_MCA_ptl_base_legacy_peers, which reach every
daemon of the DVM.

Signed-off-by: Ralph Castain <rhc@pmix.org>
@rhc54
rhc54 merged commit ed6ef75 into openpmix:master Nov 2, 2026
18 checks passed
@rhc54
rhc54 deleted the topic/docs-legacy-peers branch November 2, 2026 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant