diff options
| author |   Maryam Tahhan <maryam.tahhan@intel.com> | 2017-04-24 08:40:51 +0000 |
|---|---|---|
| committer |   Gerrit Code Review <gerrit@opnfv.org> | 2017-04-24 08:40:51 +0000 |
| commit | a6c9c4e51d5035a4583ea08f7673d49b667025ae (patch) | |
| tree | a6e3e5bb28f28a81269442993c32532559f03014 /docs | |
| parent | f88957cc68ef57f872f502e3d6fa462f2222dc1b (diff) | |
| parent | d4a27420b54a69be4200ecb400f4f910375cc826 (diff) | |
Merge "dpdk stats: add known issues/limitations"
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/release/userguide/feature.userguide.rst | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst index 2ecc4376..ef366326 100644 --- a/docs/release/userguide/feature.userguide.rst +++ b/docs/release/userguide/feature.userguide.rst @@ -230,6 +230,17 @@ include: </Event> </Plugin> +.. note:: Currently, the DPDK library doesn’t support API to de-initialize + the DPDK resources allocated on the initialization. It means, the collectd + plugin will not be able to release the allocated DPDK resources + (locks/memory/pci bindings etc.) correctly on collectd shutdown or reinitialize + the DPDK library if primary DPDK process is restarted. The only way to release + those resources is to terminate the process itself. For this reason, the plugin + forks off a separate collectd process. This child process becomes a secondary + DPDK process which can be run on specific CPU cores configured by user through + collectd configuration file (“Coremask” EAL configuration option, the + hexadecimal bitmask of the cores to run on). + For more information on the plugin parameters, please see: https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod @@ -262,6 +273,24 @@ To fully enable ASLR: For more information on multi-process support, please see: http://dpdk.org/doc/guides/prog_guide/multi_proc_support.html +**DPDK stats plugin limitations:** + +1. The DPDK primary process application should use the same version of DPDK + that collectd DPDK plugin is using; + +2. L2 statistics are only supported; + +3. The plugin has been tested on Intel NIC’s only. + +**DPDK stats known issues:** + +* DPDK port visibility + + When network port controlled by Linux is bound to DPDK driver, the port + will not be available in the OS. It affects the SNMP write plugin as those + ports will not be present in standard IF-MIB. Thus addition work is + required to be done to support DPDK ports and statistics. + Hugepages Plugin ^^^^^^^^^^^^^^^^^ Repo: https://github.com/collectd/collectd |