<?xml version="1.0" encoding="UTF-8"?>
<section version="5.0"
         xmlns="http://docbook.org/ns/docbook"
         xmlns:xlink="http://www.w3.org/1999/xlink"
         xmlns:xi="http://www.w3.org/2001/XInclude"
         xmlns:svg="http://www.w3.org/2000/svg"
         xmlns:mml="http://www.w3.org/1998/Math/MathML"
         xmlns:html="http://www.w3.org/1999/xhtml"
         xmlns:db="http://docbook.org/ns/docbook"
         xml:lang="en"
         xml:id="install.jonas">
  <info><title>Installing JOnAS from scratch</title></info>

      <para>The JOnAS distribution can be downloaded as a .tar.gz or .zip
      file.</para>

      <para>The installation process simply consists of unzipping the
      downloaded .tar.gz file.</para>

      <para>To install using the .tar.gz file, select a location for JOnAS
      installation, for example <filename
      class="directory">your_install_dir</filename>, and point to it.</para>

      <itemizedlist>
        <listitem>
          <para>Unix platforms</para>

          <screen><prompt>bash&gt;</prompt> <userinput>tar -zxvf &lt;jonas-file-name&gt;.tar.gz</userinput>
<computeroutput> jonas-osgi-5.x.y/
 jonas-osgi-5.x.y/conf/
 jonas-osgi-5.x.y/examples/
 jonas-osgi-5.x.y/examples/javaee5-earsample/
 jonas-osgi-5.x.y/examples/javaee5-earsample/etc/
...
</computeroutput></screen>

          <caution>
            <para>Be aware that if the same version of JOnAS has already been
            unpacked in the same directory, the new installation will
            overwrite previous files, and configuration files that have been
            customized may be lost. In this case, it is recommended that these
            files be saved before re-starting the installation process.</para>
          </caution>
        </listitem>

        <listitem>
          <para>Windows platforms</para>

          <para>Open a new DOS window and proceed as follows:</para>

          <para>If the <filename class="extension">.zip </filename>file format
          was downloaded, you must use a utility program such as WinZip or
          <link xlink:href="http://www.izarc.org/">IZArc</link> to extract the
          files from the archive.</para>
        </listitem>
      </itemizedlist>
    </section>
