Copyright

Authors

(Please add yourself and your copyright to this page if you make changes to the manual.)

License

This material may be distributed only subject to the terms and conditions set forth in the Open Publication License, v1.0 or later (the latest version is currently available at http://www.opencontent.org/openpub/). Distribution of substantively modified version of this document is prohibited without the explicit permission of the copyright holder.

Other company, product, or service names may be trademarks or service marks of others.

The Basics

OpenHPI is an open source project created with the intent of providing an implementation of the Service Availability Forum's Hardware Platform Interface (HPI). HPI provides a universal interface for creating resource system models, typically for chassis and rack based servers, but extendable for other problem domains such as clustering, virtualization and simulation.

This is meant to be a living document that follows the progression of OpenHPI. As this is a Wiki, anyone is free to modify the contents of the document if they feel it is inaccurate. Please feel free to contribute content.

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.