This is an implementation of the Service Availability Forum's 
Hardware Platform Interface B.03 specification.

The following components are supported:
* OpenHPI base library
* OpenHPI utility functions
* OpenHPI Daemon
* HPI Client programs and HPI shell

* Simulator Plugin
* Dynamic Simulator Plugin
* Slave Plugin
* Test Agent Plugin
* IMPI Direct Plugin
* SNMP BladeCenter/RSA Plugin
* iLO2 RIBCL Plugin
* SOAP/XML BladeSystem c-Class Plugin
* rtas Plugin
* sysfs Plugin
* watchdog Plugin

NOTE: The ipmi plugin is still provided with this release, but 
will not be maintained any longer. Please use ipmidirect instead.

Feedback, as always, is welcome and encouraged:
openhpi-devel@lists.sourceforge.net

---------------------------------------------------------
PREREQUISITES
---------------------------------------------------------
The following software is required to build openhpi

autoconf >= 2.57
automake >= 1.8
gcc      >= 3.2.0
glib2    >= 2.12
gcrypt   >= 1.4
pkgconfig (may be called pkg-config depending on distro)

The follow libraries are needed to build certain plugins

sysfs plugin
  libsysfs =< 1.3

snmp_bc plugin
  net-snmp >= 5.07
  libuuid (may be found in e2fsprogs or libuuid depending on distro)

oa_soap plugin
  libssl >= 0.9.7
  libxml2

ipmi plugin
  OpenIPMI >= 1.4.20 (http://openipmi.sf.net)


---------------------------------------------------------
RPM BUILD NOTE
---------------------------------------------------------
The library libuuid.so can be provided with e2fsprogs RPM
or with libuuid RPM.
And the header file uuid.h can be provided with
e2fsprogs-devel RPM or with libuuid-devel RPM
correspondingly.

The default RPM spec for openhpi is configured for the
first case libuuid/libuuid-devel.

If your distribution falls into the second case just
change uuid_provider in openhpi.spec.in before
running ./configure script.

---------------------------------------------------------
BUILD / INSTALLATION
---------------------------------------------------------

FOR RELEASED TARBALLS

Use standard UNIX mechanisms:
./configure && make && make install

Note: by default all plugins that *can* be built, will be built, all
other plugins will be silently disabled.

If you wish to disable a plugin, any flags you pass to configure
will be passed to the configure program.
("./configure --help" for more info on the options)

i.e. ./configure --disable-simulator will disable the simulator plugin

Note that for a production-type installation you will want to pass
the following options at the least:
./configure --prefix=/usr --sysconfdir=/etc --with-varpath=/var/lib/openhpi

then 
        make (or make rpm, but you will need to be root on some distros.)
and then (as root or with proper system install permissions)
        make install (or install from the rpm).

It will install the openhpi library, enabled plug-ins and sample 
applications that uses the library and plug-ins.

NOTE: Modify the configuration file, openhpi.conf, for your needs.
This will be in ${sysconfdir}/openhpi/openhpi.conf, where $sysconfdir is
${prefix}/etc by default (and ${prefix} is /usr/local by default) unless
you set $sysconfdir when you ran ./configure as shown above.

FOR SUBVERSION EXTRACTS

svn export https://svn.code.sf.net/p/openhpi/code/openhpi/trunk mydir

It will extract OpenHPI trunk to mydir.
First time after extracting the code:
run ./bootstrap

This will generate the configure script and all files needed by it.

Then, use the instructions provided for RELEASED TARBALLS

---------------------------------------------------------
CLEANUP
---------------------------------------------------------
To remove the temporary build files, type:

make clean

If you are a maintainer, and need to remove all autogenerated files, type:

make clean
make maintainer-clean
(will neeed to run bootstrap and configure again after that)
If bootstrap is not present (tarball does not contain it), download it using
svn export http://svn.code.sf.net/p/openhpi/code/openhpi/tags/$rtag/bootstrap .
($rtag is release version, for example 3.6.0)

---------------------------------------------------------
Active Plug-ins
---------------------------------------------------------
simulator -         plugin for simple testing. It uses a static database 
                    for hardware configuration.
dynamic_simulator - plugin for advanced testing. It uses a configuration file 
                    to simulate any hardware.
slave -             allows to aggregate resources from different domains (slave domains)
                    and to provide aggregated resources as part of the one domain (master domain).
test_agent -        plugin for advanced testing. Provides console for runtime configuration.
ipmidirect -        IPMI plugin that directly uses ipmi protocol to ipmi 
                    infrastructure, e.g. chassis managers.
snmp_bc -           IBM BladeCenter/RSA plugin (uses snmp)
ilo2_ribcl -        HP ProLiant Rack Mount Server plug-in
oa_soap -           HP BladeSystem c-Class plugin
rtas -              Run-Time Abstraction Services (RTAS) plug-in
sysfs -             Linux sysfs plugin (LM sensors and I2C devices exported in 
                    sysfs requires kernel 2.6 or >= 2.5.72)
watchdog -          Linux watchdog device interface


For information on recent changes, see the changelogs at
http://openhpi.org
http://openhpi.sf.net

---------------------------------------------------------
CLIENT PROGRAMS
---------------------------------------------------------

Openhpi provides a set of client programs, that can be use as examples for 
typical HPI usage. They also help testing when invoked from a command line, 
or could even be called by applications.

The hpi_shell provides are command shell for calling HPI functions 
interactively.

The following client programs are provided:

hpialarms -      show Alarm Control management instruments.
hpicrypt -       Encrypt or decrypt a file. Back up the file to a secure
                 location before encrypting the file.
hpidomain -      show information about domains or set the domain tag.
hpiel -          displays HPI event log entries
hpievents -      polls for events
hpifan -         show Fan Control management instruments
hpigensimdata -  generate data file for dynamic simulator plugin
hpiinv -         show inventory records for hardware resources
hpionIBMblade -  display and manage resources of an IBM Blade with 
                 Basedboard Management Controller (BMC)
hpipower -       Invoke HPI Power Management APIs
hpireset -       Invoke HPI Reset Management APIs
hpisensor -      display sensor info for all resources with Sensor Capability
hpisettime -     Invoke Event Log clock APIs.
hpithres -       display sensor thresholds and sensor info.
hpitop -         display highlevel topology for a managed openHPI complex.
hpitree -        show in details the resources (rpt's) and resources' 
                 management instruments (rdr's) data structures
hpiwdt -         read and enables the watchdog timer.
hpixml -         display system view in XML

ohdomainlist -   show information about domains on the level of the openhpi 
                 base library
ohhandler -      uses the openhpi additional interfaces to control openhpi 
                 configuration. That is plugins can be loaded, plugin instances
                 (handlers) created, unloaded or their configuration displayed.
ohparam -        control openhpi configuration parameters

hpi_shell -      allows a user to interactively perform a number of HPI 
                 operations in a command shell with prompting.

---------------------------------------------------------
HPI EXTENSIONS
---------------------------------------------------------

OpenHPI provides a small set of functions in addition to the SAF standard.
Mainly they are needed because of the OpenHPI architecture:
- manage plugins
- manage OpenHPI configuration dynamically

* oHpiVersionGet
* oHpiHandlerCreate 
* oHpiHandlerDestroy 
* oHpiHandlerInfo 
* oHpiHandlerGetNext
* oHpiHandlerFind
* oHpiHandlerRetry 
* oHpiGlobalParamGet 
* oHpiGlobalParamSet
* oHpiInjectEvent 
* oHpiDomainAdd 
* oHpiDomainAddById 
* oHpiDomainEntryGet 
* oHpiDomainEntryGetByDomainId 

Please find more information in the inline documentation in files:
include/oHpi.h  - function declarations
baselib/ohpi.c  - function implementation in Base Library
openhpid/ohpi.c - function implementation in OpenHPI Daemon

---------------------------------------------------------
FOR MORE INFO
---------------------------------------------------------

Please refer also to README.daemon and README.windows.

Please find more documentation in the docs subdirectory and in the 
man pages (openhpi, openhpid, clients).

For more information please see the project webiste at:
http://openhpi.org
http://openhpi.sourceforge.net

Also visit SAForum's website at http://www.saforum.org
