docs: better docs, mv doxygen to sphinx

[vpp.git] / docs / usecases / contiv / MULTI_NIC_SETUP.rst

diff --git a/docs/usecases/contiv/MULTI_NIC_SETUP.rst b/docs/usecases/contiv/MULTI_NIC_SETUP.rst
new file mode 100644 (file)
index 0000000..57242d1
--- /dev/null
+++ b/docs/usecases/contiv/MULTI_NIC_SETUP.rst
@@ -0,0 +1,24 @@
+Setting Up a Node with Multiple NICs
+====================================
+
+-  First, configure hardware interfaces in the VPP startup config, as
+   described
+   `here <https://github.com/contiv/vpp/blob/master/docs/VPP_CONFIG.md#multi-nic-configuration>`__.
+
+-  For each interface owned by Linux, you need to provide individual
+   configuration for each interface used by VPP in the Node
+   Configuration for the node in the ``contiv-vpp.yaml``. For example,
+   if both ``ens3`` and ``ens4`` are known to Linux, then put the
+   following stanza into the node’s NodeConfig:
+
+::
+
+   ...
+       NodeConfig:
+       - NodeName: "ubuntu-1"
+         StealInterface: "ens3"
+         StealInterface: "ens4"
+   ...
+
+If only ``ens3`` is known to Linux, you only put a line for ``ens3``
+into the above NodeConfig.