<?xml version="1.0" encoding="UTF-8"?>
<chapter id="gettingstarted">
   <title>Download</title>
   <para>The official IronJacamar project page is <ulink
   url="http://www.ironjacamar.org/">http://www.ironjacamar.org/</ulink> where you can download the software.</para>

   <section id="download">
      <title>Download</title>

      <para>The download location is: <ulink url="http://www.ironjacamar.org/downloads/">http://www.ironjacamar.org/downloads/</ulink></para>

      <para>Each release is labelled with a version number and an identifier.</para>

      <programlisting>
ironjacamar-&lt;major&gt;.&lt;minor&gt;.&lt;patch&gt;.&lt;identifier&gt;
      </programlisting>

      <para>where</para>

      <itemizedlist spacing="compact">
         <listitem>
           Major: The major version number. Signifies major changes in the implementation.
         </listitem>
         <listitem>
           Minor: The minor version number. Signifies functional changes to a major version.
         </listitem>
         <listitem>
           Patch: The patch version number. Signifies a binary compatible change to a minor version.
         </listitem>
         <listitem>
           Identifier: The identifier. Identifies the level of the quality of the release.
           <itemizedlist spacing="compact">
             <listitem>
               Final: Stable release
             </listitem>
             <listitem>
               CR: Candidate for Release quality. The implementation is functional complete.
             </listitem>
             <listitem>
               Beta: Beta quality. The implementation is almost functional complete.
             </listitem>
             <listitem>
               Alpha: Alpha quality. The implementation is a snapshot of the development.
             </listitem>
           </itemizedlist>
         </listitem>
      </itemizedlist>

      <para>An example</para>

      <programlisting>
ironjacamar-1.2.0.Final.tar.gz
      </programlisting>

      <para>which is a stable release of the project.</para>

   </section>

   <section id="download_maven">
      <title>Maven repository</title>
      <para>The IronJacamar distribution is deployed to the JBoss Nexus repository.</para>

      <para>Repository: <code>http://repository.jboss.org/nexus/content/groups/public/</code></para>

      <para>Group id: <code>org.jboss.ironjacamar</code></para>
      
      <table frame="all">
        <title>Maven artifacts</title>
        <tgroup cols="2" align="left" colsep="1" rowsep="1">
          <colspec colname="c1" colwidth="2*"/>
          <colspec colname="c2" colwidth="3*"/>
          <thead>
            <row>
              <entry align="left">Artifact</entry>
              <entry align="left">Description</entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry><code>ironjacamar-arquillian-embedded</code></entry>
              <entry>
                The Arquillian extension for the embedded module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-arquillian-embedded-byteman</code></entry>
              <entry>
                The Arquillian/Byteman extension for the embedded module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-as</code></entry>
              <entry>
                WildFly integration tools
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-codegenerator</code></entry>
              <entry>
                The code generator
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-common-api</code></entry>
              <entry>
                The API for the common module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-common-impl</code></entry>
              <entry>
                The implementation for the common module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-common-spi</code></entry>
              <entry>
                The SPI for the common module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-core-api</code></entry>
              <entry>
                The API / SPI for the core module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-core-impl</code></entry>
              <entry>
                The implementation for the core module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-depchain</code></entry>
              <entry>
                The dependency chain for the IronJacamar container
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-deployers-common</code></entry>
              <entry>
                The common classes for the deployer chains
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-deployers-fungal</code></entry>
              <entry>
                The deployers for the Fungal kernel based setup
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-embedded</code></entry>
              <entry>
                The embedded module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-jdbc</code></entry>
              <entry>
                The core library for the JDBC resource adapters
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-spec-api</code></entry>
              <entry>
                The Java EE Connector Architecture 1.7 API
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-test-eis</code></entry>
              <entry>
                The Enterprise Information System test server
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-validator</code></entry>
              <entry>
                The validator module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-validator-ant</code></entry>
              <entry>
                The Apache Ant tasks for the validator module
              </entry>
            </row>
            <row>
              <entry><code>ironjacamar-validator-cli</code></entry>
              <entry>
                The command line interface for the validator module
              </entry>
            </row>
            <row>
              <entry><code>jdbc-local</code></entry>
              <entry>
                A JDBC resource adapter backing standard datasources
              </entry>
            </row>
            <row>
              <entry><code>jdbc-xa</code></entry>
              <entry>
                A JDBC resource adapter backing XA datasources
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      
   </section>


   <section id="GIT">
      <title>Git Access</title>
      <para>
        If you want to experiment with the latest developments you may
        checkout the latest code from Git. Be aware that the
        information provided in this manual might then not be accurate.
      </para>

      <para>The Git repository is located at:</para>

      <programlisting>
http://github.com/ironjacamar/ironjacamar
      </programlisting>

      <para>You can find additional information about this in the developer guide.</para>

   </section>
</chapter>
