From 25b1eeedffa4914212695e98a8b1346556ef2c34 Mon Sep 17 00:00:00 2001 From: Alberto Compagno Date: Fri, 5 Jul 2019 11:10:17 +0200 Subject: [HICN-237] Updated README for vpp 19.04 Change-Id: I6e372f1c366ecfc67b6ecc438fcd24d2cd26aba8 Signed-off-by: Alberto Compagno --- hicn-plugin/README.md | 41 ++++++++++++++++++++++++++++++++--------- 1 file 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 down ``` +or +``` +$ sudo ip link set 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 -- cgit 1.2.3-korg