Installing OpenHPI

Version Numbers

OpenHPI goes by the standard Open Source convention for version numbers which is odd numbers are devel releases, even numbers are stable releases.

For instance:

OpenHPI 1.0.2 - Stable release
OpenHPI 1.9.4 - Devel release
OpenHPI 2.0.1 - Stable release
OpenHPI 2.1.0 - Devel release

In addition, the OpenHPI 1.x releases support the HPI A specification (deprecated) while the OpenHPI 2.x releases support the HPI B specification (current). HPI A and HPI B are not compatible interfaces, so OpenHPI 1.0 and OpenHPI 2.x are not compatible either. As all future HPI versions will be backward compatible to HPI B.01.01, all future OpenHPI versions will be HPI compatible as well.

Download

Open HPI source code and binaries are provided in a number of ways. The latest source code tar archives can always be found at http://sourceforge.net/project/showfiles.php?group_id=71730.

As RPM files are often specific to particular Linux distributions, we recommend downloading source code and compiling OpenHPI yourself.

Installing From Source

Please read the README file included in the source for dependencies and required libraries and packages.

Having all dependencies satisfied, simply:

bash$ tar -zvxf openhpi-2.x.y.tar.gz
bash$ cd openhpi-2.x.y
bash$ ./configure 
        (you can pass many flags here, ./configure --help will list them)
bash$ make
bash$ make check
        (this step ensures the base components are operating correctly)
bash$ make install
bash$ mkdir -p /etc/openhpi
bash$ cp examples/openhpi.conf.example /etc/openhpi/openhpi.conf

Configuring OpenHPI

If you installed the RPMs, then the configuration file /etc/openhpi/openhpi.conf will be installed. If you installed from the source using make install then you should have copied the file manually by now.

Edit the /etc/openhpi.conf file to enable and configure the plug-in you intend to use. See the OpenHpi Manual secion OpenHpi Plug-in Usage for more info.