docs:update tcp tuning page #13584
docs:update tcp tuning page #13584
Conversation
docs/tuning-apps/networking/tcp.rst
Outdated
| also need/want to investigate the corresponding PRRTE | ||
| parameters that control use of network interfaces by the runtime | ||
| (e.g., communications setup and coordination during | ||
| ``MPI_INIT`` and ``MPI_FINALIZE``) using the `prte_info command <https://docs.prrte.org/en/latest/man/man1/prte_info.1.html>`_. |
There was a problem hiding this comment.
I just tested this to be sure, but in the v5.0.x tarball (and therefore likely the main/v6.0.x tarballs), we include the prte_info.1 HTML man page. Is there a way we can link to that here, rather than linking to the one in docs.prrte.org?
There was a problem hiding this comment.
what happens if an external prrte/openpmix is used? i'm not seeing any prrte or pmix htmls in the <install_dir>/share/doc in that event.
There was a problem hiding this comment.
We do some complicated stuff in Makefiles about copying PRTE RSTs -- even from external PRTE installs -- to our RST tree and then building our docs (this only happens if you have Sphinx, of course).
If you build with external PRTE and don't have Sphinx, this doesn't happen, of course. In that case, IIRC (it's been a little while since I checked), we put in template "you didn't get docs because you don't have Sphinx" documentation.
|
PMIx can do network params too: PMIX_MCA_ptl_if_include/exclude However it's true that you can't totally disable it |
hppritcha
force-pushed
the
docs_tcp_updates
branch
from
1f93f3d to
4a686e1
Compare
reference prrte docs for prrte tcp related mca parameters. use intersphinx to avoid needing to use external URL references. Signed-off-by: Howard Pritchard <howardp@lanl.gov>
hppritcha
force-pushed
the
docs_tcp_updates
branch
from
4a686e1 to
57b7f08
Compare
|
@jsquyres okay switched to using intersphinx. |
Signed-off-by: Howard Pritchard <howardp@lanl.gov>
Signed-off-by: Howard Pritchard <howardp@lanl.gov>
Signed-off-by: Howard Pritchard <howardp@lanl.gov>
|
i can't get this intersphinx thing to work. looks like firewalls or something are preventing downloads the objects.inv files for prrte and pmix (same rule for openmpi). closing this PR. someone else can try to figure this out. |
|
Not sure of the path you were pursuing - I think what @jsquyres had in mind was to simply create a link to the already-generated PRRTE and PMIx pages in their external install locations. I personally wouldn't want to try and generate those pages from within OMPI. Since you know (from configure) where those locations are, and you know where PMIx and PRRTE install those HTML renderings under those locations, I think it's just a simple Makefile change to add the "ln -s" commands. |
3 participants
reference prrte docs for prrte tcp related mca parameters.