<!-- ...................................................................... -->
<!-- $Id: introduction.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>Introduction</title>
  <sect1>
    <title>The Basics</title>
    <para>
      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.
    </para>
    <sect2>
      <title>Purpose of this Document</title>
      <para>
        This document is intended to serve as the user and developer
        manual for OpenHPI.
      </para>
    </sect2>
    <sect2>
      <title>Document Scope</title>
      <para>
        This manual covers the entire breadth of the OpenHPI project.
        This includes, but is not limited to, and overview of the SAF
        HPI, OpenHPI internal design, OpenHPI plugin interfaces,
        OpenHPI configuration, and OpenHPI usage scenarios.  It is a
        living document, and as such will evolve along with the
        OpenHPI project itself.
      </para>
    </sect2>
    <sect2>
      <title>Terminology</title>
      <para>
        <informaltable frame="all">
          <tgroup cols="2">
            <thead>
              <row>
                <entry>Acronym</entry>
                <entry>Description</entry>
              </row>
            </thead>
            <tbody>
              <row>
                <entry>HPI</entry>
                <entry>Hardware Platform Interface</entry>
              </row>
              <row>
                <entry>RPT</entry>
                <entry>Resource Presence Table</entry>
              </row>
              <row>
                <entry>SA Forum</entry>
                <entry>Service Availability Forum</entry>
              </row>
            </tbody>
          </tgroup>
        </informaltable>
      </para>
    </sect2>
  </sect1>
</chapter>
