docs: add contiv vpp

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

diff --git a/docs/usecases/contiv/MULTI_NIC_SETUP.md b/docs/usecases/contiv/MULTI_NIC_SETUP.md
new file mode 100644 (file)
index 0000000..5cbb031
--- /dev/null
+++ b/docs/usecases/contiv/MULTI_NIC_SETUP.md
@@ -0,0 +1,21 @@
+### 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 thenode 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.
+