diff options
| author |   Alberto Compagno <acompagn+fdio@cisco.com> | 2019-07-05 11:10:17 +0200 |
|---|---|---|
| committer | Alberto Compagno <acompagn+fdio@cisco.com> | 2019-07-05 11:10:17 +0200 |
| commit | 25b1eeedffa4914212695e98a8b1346556ef2c34 (patch) | |
| tree | 089f6f053732554c4ffebbf20f5d0802debd4b8e | |
| parent | 34883ae53b4aa7be68d9750fa0f33fc7a5c8f17a (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.md | 41 |
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 |