summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/release/userguide/feature.userguide.rst52
-rwxr-xr-xsystems/centos/7/build_base_machine.sh1
-rwxr-xr-xsystems/fedora/22/build_base_machine.sh1
-rwxr-xr-xsystems/rhel/7/build_base_machine.sh1
-rwxr-xr-xsystems/ubuntu/14.04/build_base_machine.sh3
-rwxr-xr-xsystems/ubuntu/16.04/build_base_machine.sh3
6 files changed, 56 insertions, 5 deletions
diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst
index 45b5d8c4..4d2469c0 100644
--- a/docs/release/userguide/feature.userguide.rst
+++ b/docs/release/userguide/feature.userguide.rst
@@ -74,6 +74,11 @@ Other plugins existing as a pull request into collectd master:
statistics about virtualized guests on a system directly from the hypervisor,
without a need to install collectd instance on the guest.
+Third party application in Barometer repository:
+
+* *Open vSwitch PMD stats*: An aplication that retrieves PMD stats from OVS. It is run
+ through exec plugin.
+
**Plugins included in the Danube release:**
* Hugepages
@@ -121,11 +126,14 @@ will be /opt/collectd.
Sample configuration files can be found in '/opt/collectd/etc/collectd.conf.d'
.. note::
- - If you plan on using the Exec plugin, the plugin requires non-root
- user to execute scripts. By default, `collectd_exec` user is used. Barometer
- scripts do *not* create this user. It needs to be manually added or exec plugin
- configuration has to be changed to use other, existing user before starting
- collectd service.
+ - If you plan on using the Exec plugin (for OVS_PMD_STATS or for executing scripts
+ on notification generation), the plugin requires a non-root
+ user to execute scripts. By default, `collectd_exec` user is used in the exec.conf
+ provided in the sample configurations directory under src/collectd in the Barometer
+ repo. The scripts *DO NOT* create this user. You need to create this user before you
+ run build_base_machine.sh. Or modify configuration in the sample configurations
+ directory under src/collectd to use another existing non root user before running
+ run build_base_machine.sh.
- If you don't want to use one of the Barometer plugins, simply remove the
sample config file from '/opt/collectd/etc/collectd.conf.d'
@@ -760,6 +768,40 @@ to include:
For more information on the plugin parameters, please see:
https://github.com/collectd/collectd/blob/master/src/collectd.conf.pod
+OVS PMD stats
+^^^^^^^^^^^^^^
+Repo: https://gerrit.opnfv.org/gerrit/barometer
+
+Prequistes:
+1. Open vSwitch dependencies are installed.
+2. Open vSwitch service is running.
+3. Ovsdb-server manager is configured.
+You can refer `Open vSwitch Plugins`_ section above for each one of them.
+
+OVS PMD stats application is run through the exec plugin.
+
+To configure the OVS PMD stats application you need to modify the exec plugin configuration
+to include:
+
+.. code:: bash
+
+ <LoadPlugin exec>
+ Interval 1
+ </LoadPlugin
+ <Plugin exec>
+ Exec "user:group" "<path to ovs_pmd_stat.sh>"
+ #NotificationExec "nobody" "/usr/lib/collectd/notify.sh"
+ </Plugin>
+
+.. note:: Exec plugin configuration has to be changed to use appropriate user before starting collectd service.
+
+ovs_pmd_stat.sh calls the script for OVS PMD stats application with its argument:
+
+.. code:: bash
+
+ sudo python /usr/local/src/ovs_pmd_stats.py" "--socket-pid-file"
+ "/var/run/openvswitch/ovs-vswitchd.pid"
+
SNMP Agent Plugin
^^^^^^^^^^^^^^^^^
Repo: https://github.com/maryamtahhan/collectd/
diff --git a/systems/centos/7/build_base_machine.sh b/systems/centos/7/build_base_machine.sh
index 438c1435..0e56c770 100755
--- a/systems/centos/7/build_base_machine.sh
+++ b/systems/centos/7/build_base_machine.sh
@@ -52,6 +52,7 @@ gtk2-devel
libvirt-devel
mcelog
wget
+net-snmp-devel
# install epel release required for git-review
epel-release
diff --git a/systems/fedora/22/build_base_machine.sh b/systems/fedora/22/build_base_machine.sh
index 942c799d..be225117 100755
--- a/systems/fedora/22/build_base_machine.sh
+++ b/systems/fedora/22/build_base_machine.sh
@@ -34,6 +34,7 @@ kernel-devel
kernel-modules-extra
pixman-devel
openssl-devel
+net-snmp-devel
# tools
curl
diff --git a/systems/rhel/7/build_base_machine.sh b/systems/rhel/7/build_base_machine.sh
index 583089a5..c5191f73 100755
--- a/systems/rhel/7/build_base_machine.sh
+++ b/systems/rhel/7/build_base_machine.sh
@@ -52,6 +52,7 @@ gtk2-devel
libvirt-devel
mcelog
wget
+net-snmp-devel
# install epel release required for git-review
epel-release
diff --git a/systems/ubuntu/14.04/build_base_machine.sh b/systems/ubuntu/14.04/build_base_machine.sh
index e1b1c9f3..0dc21d9a 100755
--- a/systems/ubuntu/14.04/build_base_machine.sh
+++ b/systems/ubuntu/14.04/build_base_machine.sh
@@ -56,6 +56,9 @@ apt-get -y install \
libsensors4-dev \
libsigrok-dev \
libsnmp-dev \
+ snmp \
+ snmp-mibs-downloader \
+ snmpd \
perl \
libtokyocabinet-dev \
libtokyotyrant-dev \
diff --git a/systems/ubuntu/16.04/build_base_machine.sh b/systems/ubuntu/16.04/build_base_machine.sh
index 119bca22..ba64ad45 100755
--- a/systems/ubuntu/16.04/build_base_machine.sh
+++ b/systems/ubuntu/16.04/build_base_machine.sh
@@ -56,6 +56,9 @@ apt-get -y install \
libsigrok-dev \
libsnmp-dev \
libsnmp9-dev \
+ snmp \
+ snmp-mibs-downloader \
+ snmpd \
perl \
libtokyocabinet-dev \
libtokyotyrant-dev \