aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAlberto Compagno <acompagn+fdio@cisco.com>2019-07-05 11:10:17 +0200
committerAlberto Compagno <acompagn+fdio@cisco.com>2019-07-05 11:10:17 +0200
commit25b1eeedffa4914212695e98a8b1346556ef2c34 (patch)
tree089f6f053732554c4ffebbf20f5d0802debd4b8e
parent34883ae53b4aa7be68d9750fa0f33fc7a5c8f17a (diff)
[HICN-237] Updated README for vpp 19.04
Change-Id: I6e372f1c366ecfc67b6ecc438fcd24d2cd26aba8 Signed-off-by: Alberto Compagno <acompagn+fdio@cisco.com>
-rw-r--r--hicn-plugin/README.md41
1 files changed, 32 insertions, 9 deletions
diff --git a/hicn-plugin/README.md b/hicn-plugin/README.md
index 22e38a015..7a7b02271 100644
--- a/hicn-plugin/README.md
+++ b/hicn-plugin/README.md
@@ -66,15 +66,21 @@ hICN-plugin has been tested in:
Build dependencies:
- VPP 19.04
- - DEB packages:
- - vpp
- - vpp-lib
+ - DEB packages (can be found https://packagecloud.io/fdio/release/install):
+ - libvppinfra-dev
- vpp-dev
- - vpp-plugins
-Hardware support:
+Running dependencies:
+
+- VPP 19.04
+ - DEB packages (can be found https://packagecloud.io/fdio/release/install):
+ - vpp
+ - vpp-plugin-core
+ - vpp-plugin-dpdk (only to use DPDK compatible nics)
+
+Hardware support (not mandatory):
-- [DPDK](http://DPDK.org/) compatible nic
+- [DPDK](http://DPDK.org/) compatible nics
## Getting started ##
In order to start, the hICN plugin requires a running instance of VPP
@@ -96,12 +102,12 @@ Hugepages must be enabled in the system
$ sudo sysctl -w vm.nr_hugepages=1024
```
-In order to use a DPDK interface, the package vpp-dpdk-dkms must be installed in the system and the `uio` and `igb_uio` modules need to be loaded in the kernel
+In order to use a DPDK interface, the `uio` and `uio_pci_generic` or `vfio_pci` modules need to be loaded in the kernel
```
-$ sudo apt install vpp-dpdk-dkms
$ sudo modprobe uio
-$ sudo modprobe igb_uio
+$ sudo modprobe uio_pci_generic
+$ sudo modprobe vfio_pci
```
If the DPDK interface we want to assign to VPP is up, we must bring it down
@@ -109,6 +115,10 @@ If the DPDK interface we want to assign to VPP is up, we must bring it down
```
$ sudo ifconfig <interface_name> down
```
+or
+```
+$ sudo ip link set <interface_name> down
+```
### Configure VPP ###
The file /etc/VPP/startup.conf contains a set of parameters to setup VPP at startup.
@@ -132,6 +142,19 @@ api-segment {
dpdk {
dev 0000:08:00.0
}
+
+plugins {
+ ## Disable all plugins by default and then selectively enable specific plugins
+ plugin default { disable }
+ plugin dpdk_plugin.so { enable }
+ plugin acl_plugin.so { enable }
+ plugin memif_plugin.so { enable }
+ plugin hicn_plugin.so { enable }
+
+ ## Enable all plugins by default and then selectively disable specific plugins
+ # plugin dpdk_plugin.so { disable }
+ # plugin acl_plugin.so { disable }
+}
```
Where `0000:08:00.0` must be replaced with the actual PCI address of the DPDK interface