aboutsummaryrefslogtreecommitdiffstats
path: root/hicn-plugin
diff options
context:
space:
mode:
authorMauro Sardara <msardara@cisco.com>2019-07-05 09:24:41 +0000
committerGerrit Code Review <gerrit@fd.io>2019-07-05 09:24:41 +0000
commit4d86f3ed3c000a5cfa96ad24cf77d57bc1a811e8 (patch)
tree37152065583eef1a6f018afe12e83b47bc51d12a /hicn-plugin
parent116ae69101edd5ea88231d7aa25aedf568136f3a (diff)
parent25b1eeedffa4914212695e98a8b1346556ef2c34 (diff)
Merge "[HICN-237] Updated README for vpp 19.04"
Diffstat (limited to 'hicn-plugin')
-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