<!-- ...................................................................... -->
<!-- $Id: obtaining.sgml,v 1.10 2009/01/19 07:36:20 subrata_modak Exp $ ................................................ -->
<!-- 
        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.
-->
<chapter>
  <title>Getting OpenHPI</title>
  <sect1>
    <title>Download</title>
    <para>
	OpenHPI is available for download from the project's SourceForge
	page in the
	<ulink
		url="http://sourceforge.net/project/showfiles.php?group_id=71730"
	>Files</ulink> section.
    </para>
    <para>You can download a tar archive of the source or binary pre-packaged 
	RPMs.
    </para>
    </sect1>
    <sect1>
      <title>Installing OpenHPI</title>
      <para>
	The quickest way to get going with OpenHPI would be to install
	the binary RPMs.  Simply by doing:
     <programlisting role="command">
	bash$ rpm -Uvh openhpi-0.x-x.i386.rpm
     </programlisting>
      </para>
	<para>
	However, you can also install by compiling the source from the tar archive.
	Please read the README file included in the source for dependencies and
	required libraries and packages.
	</para>
	<para>
	Having all dependencies satisfied, simply:
	<programlisting role="bash">
	bash$ tar -zvxf openhpi-0.x.tar.gz
	bash$ cd openhpi-0.x
	bash$ ./configure 
	(you can pass many flags here, ./configure --help will list them)
	bash$ make
	bash$ make install
	bash$ mkdir -p /etc/openhpi
	bash$ cp examples/openhpi.conf.example /etc/openhpi/openhpi.con
	</programlisting>
	</para>
	</sect1>

	<sect1>
	<title>Configuring OpenHpi</title>
	<para>
	If you installed the RPMs, then the configuration file <literal>
	/etc/openhpi/openhpi.conf</literal> will be installed.  If you installed
	from the source using <literal>make install</literal> then you should
	have copied the file manually by now.
	</para>
	<para>
	Edit the <literal>/etc/openhpi.conf</literal> file to enable and configure
	the plug-in you intend to use.  See the OpenHpi Manual section<link linkend="plugin-usage">
	OpenHpi Plug-in Usage</link> for more info.
	</para>
    </sect1>
</chapter>
