From 25b1eeedffa4914212695e98a8b1346556ef2c34 Mon Sep 17 00:00:00 2001
From: Alberto Compagno <acompagn+fdio@cisco.com>
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 <acompagn+fdio@cisco.com>
---
 hicn-plugin/README.md | 41 ++++++++++++++++++++++++++++++++---------
 1 file changed, 32 insertions(+), 9 deletions(-)

(limited to 'hicn-plugin')

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
 
-- 
cgit 1.2.3-korg