Skip to content

Commit d23d18f

Browse files
Adding usage tip for ignore cpu affinity (#1948)
* Adding usage tip for ignore cpu affinity * Update docs/how-to/rccl-usage-tips.rst Co-authored-by: Jeffrey Novotny <[email protected]> * Update docs/how-to/rccl-usage-tips.rst Co-authored-by: Jeffrey Novotny <[email protected]> --------- Co-authored-by: Jeffrey Novotny <[email protected]>
1 parent 65b69bf commit d23d18f

File tree

1 file changed

+15
-1
lines changed

1 file changed

+15
-1
lines changed

docs/how-to/rccl-usage-tips.rst

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,6 +82,20 @@ set the HSA environment variable as follows:
8282
This feature requires GPUs that support peer-to-peer access along with
8383
proper large BAR addressing support.
8484

85+
Ignoring CPU affinity with multi-node
86+
=====================================
87+
88+
Depending on the job launcher and the requirements of your workload, performance as the communication workload scales
89+
can be improved by setting ``NCCL_IGNORE_CPU_AFFINITY``. This allows the RCCL communication library to
90+
ignore the job's supplied CPU affinity and use the GPU affinity only.
91+
92+
.. code-block:: shell
93+
94+
NCCL_IGNORE_CPU_AFFINITY=1
95+
96+
For general usage, this environment variable is not set so it doesn't interfere with the user or launcher
97+
supplied preferences.
98+
8599
Improving performance on the MI300X
86100
===================================
87101

@@ -262,4 +276,4 @@ To disable context tracking for Radeon GPUs, set the following environment varia
262276

263277
.. code-block:: shell
264278
265-
export RCCL_DISABLE_CONTEXT_TRACKING=1
279+
export RCCL_DISABLE_CONTEXT_TRACKING=1

0 commit comments

Comments
 (0)