summaryrefslogtreecommitdiffstats
path: root/docs/release/userguide
diff options
context:
space:
mode:
authorMytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com>2017-03-17 12:13:02 +0000
committerMytnyk, VolodymyrX <volodymyrx.mytnyk@intel.com>2017-03-21 18:24:49 +0000
commit40e79cf78410ce297b1555739f2a3d4fa37327f9 (patch)
treefd4952e3a3385880e21ae105d43a918318b3695e /docs/release/userguide
parentf237c12fd5832dae68630f1d39e8b6c5bdb59f9d (diff)
ipmi doc: build OpenIPMI lib from sources
Add instatruction on how to build/install OpenIPMI library from sources. Change-Id: I04efc09e85829b23941e28e0e85b567c9a3cbdd7 Signed-off-by: Mytnyk, Volodymyr <volodymyrx.mytnyk@intel.com>
Diffstat (limited to 'docs/release/userguide')
-rw-r--r--docs/release/userguide/feature.userguide.rst53
1 files changed, 51 insertions, 2 deletions
diff --git a/docs/release/userguide/feature.userguide.rst b/docs/release/userguide/feature.userguide.rst
index 5ec7442d..2f4077bc 100644
--- a/docs/release/userguide/feature.userguide.rst
+++ b/docs/release/userguide/feature.userguide.rst
@@ -357,7 +357,7 @@ Repo: https://github.com/maryamtahhan/collectd
Branch: feat_ipmi_events, feat_ipmi_analog
-Dependencies: OpenIPMI library
+Dependencies: OpenIPMI library (http://openipmi.sourceforge.net/)
The IPMI plugin is already implemented in the latest collectd and sensors
like temperature, voltage, fanspeed, current are already supported there.
@@ -372,12 +372,61 @@ has been introduced.
* The feat_ipmi_analog branch includes the support of extended IPMI sensors in
collectd IPMI plugin.
-On Ubuntu, install the dependencies:
+**Install dependencies**
+
+On Ubuntu, the OpenIPMI library can be installed via apt package manager:
.. code:: bash
$ sudo apt-get install libopenipmi-dev
+Anyway, it's recommended to use the latest version of the OpenIPMI library as
+it includes fixes of known issues which aren't included in standard OpenIPMI
+library package. The latest version of the library can be found at
+https://sourceforge.net/p/openipmi/code/ci/master/tree/. Steps to install the
+library from sources are described below.
+
+Remove old version of OpenIPMI library:
+
+.. code:: bash
+
+ $ sudo apt-get remove libopenipmi-dev
+
+Download OpenIPMI library sources:
+
+.. code:: bash
+
+ $ git clone https://git.code.sf.net/p/openipmi/code openipmi-code
+ $ cd openipmi-code
+
+Patch the OpenIPMI pkg-config file to provide correct compilation flags
+for collectd IPMI plugin:
+
+.. code:: diff
+
+ diff --git a/OpenIPMIpthread.pc.in b/OpenIPMIpthread.pc.in
+ index 59b52e5..fffa0d0 100644
+ --- a/OpenIPMIpthread.pc.in
+ +++ b/OpenIPMIpthread.pc.in
+ @@ -6,6 +6,6 @@ includedir=@includedir@
+ Name: OpenIPMIpthread
+ Description: Pthread OS handler for OpenIPMI
+ Version: @VERSION@
+ -Requires: OpenIPMI pthread
+ +Requires: OpenIPMI
+ Libs: -L${libdir} -lOpenIPMIutils -lOpenIPMIpthread
+ -Cflags: -I${includedir}
+ +Cflags: -I${includedir} -pthread
+
+Build and install OpenIPMI library:
+
+.. code:: bash
+
+ $ autoreconf --install
+ $ ./configure --prefix=/usr
+ $ make
+ $ sudo make install
+
Enable IPMI support in the kernel:
.. code:: bash