[spp] [PATCH 5/5] docs: add note regarding NUMA configuration

x-fn-spp-ml at ntt-tx.co.jp x-fn-spp-ml at ntt-tx.co.jp
Fri Jun 5 02:28:54 CEST 2020


From: Hideyuki Yamashita <yamashita.hideyuki at ntt-tx.co.jp>

This patch adds new notes for NUMA configuration when starting
spp_primary.

This is pointed out by the following DPDK Bugzilla tickets.
https://bugs.dpdk.org/show_bug.cgi?id=457

Signed-off-by: Hideyuki Yamashita <yamashita.hideyuki at ntt-tx.co.jp>
Signed-off-by: Naoki Takada <ntakada14 at gmail.com>
---
 docs/guides/gsg/howto_use.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/guides/gsg/howto_use.rst b/docs/guides/gsg/howto_use.rst
index f182198..4f2e6cd 100644
--- a/docs/guides/gsg/howto_use.rst
+++ b/docs/guides/gsg/howto_use.rst
@@ -422,6 +422,18 @@ if you run the process on single NUMA node.
    If you use DPDK v18.11 or later, ``--base-virtaddr 0x100000000`` is enabled
    in default. You need to use this option only for changing the default value.
 
+.. note::
+
+   ``spp_primary`` tries to create memory pool in the same NUMA node where
+   it is launched. Under NUMA configuration, the NUMA node where ``spp_primary``
+   is launched and the NUMA node where NIC is connected can be different
+   (e.g. spp_primary runs in NUMA node 0 while NIC is connected with NUMA
+   node 1).
+   Such configuration may cause performance degradation. In general, under
+   NUMA configuration, it is best practice to use CPU and NIC which belongs
+   to the same NUMA node for best performance. So user should align those
+   when performance degradation makes the situation critical.
+
 If ``spp_primary`` is launched with two or more lcores, forwarder or monitor
 is activated. The default is forwarder and monitor is optional in this case.
 If you use monitor thread, additional option ``--disp-stat`` is required.
-- 
2.25.1



More information about the spp mailing list