<?xml version="1.0" encoding="UTF-8"?>
<section version="5.0" xml:lang="en" 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">
  <info>
    <title>JONAS_BASE creation</title>
  </info>

  <orderedlist>
    <listitem>
      <para>To create a JONAS_BASE template from scratch :</para>

      <para><emphasis role="bold">Unix</emphasis></para>

      <screen>export JONAS_BASE=~/my_jonas_base
cd $JONAS_ROOT/templates/newjb
ant -f build-jb.xml create_jonas_base</screen>

      <para><emphasis role="bold">Windows</emphasis> <screen>set JONAS_BASE=my_jonas_base
cd %JONAS_ROOT%/templates/newjb
ant -f build-jb.xml create_jonas_base</screen>This will copy all the required
      files and create all the needed directories.</para>

      <para></para>
    </listitem>

    <listitem>
      <para>Another way to create a JONAS_BASE template from scratch :</para>

      <para><filename>$JONAS_ROOT/bin</filename> must be set in the system
      path:</para>

      <para><emphasis role="bold">Unix</emphasis> <screen>export JONAS_BASE=~/my_jonas_base
newjb</screen></para>

      <para><emphasis role="bold">Windows</emphasis> <screen>set JONAS_BASE=my_jonas_base
newjb</screen>The JONAS_BASE content created with the <command>newjb</command>
      command is well suited to run the <xi:include href="../variables.xml"
      xpointer="element(appserver)" /> JEE conformance test suite and the
      example applications without any additional configuration.</para>

      <para>In order to customize a JONAS_BASE with specific property values
      (port numbers, services, protocols etc...), you must edit the
      <filename>$JONAS_ROOT/templates/newjb/build-jb.properties</filename>
      file or <filename>$HOME/jb.config/conf/jonas-newjb.properties</filename>
      file before running <command>newjb</command>.</para>

      <para>For further customization that cannot be performed by
      <command>newjb</command> you should modify the generated files in
      <filename>$JONAS_BASE/conf</filename>. For more information see the
      description of the newjb command in <link
      xlink:href="./command_guide.html#commands.newjb">Commands Reference
      Guide</link>.</para>
    </listitem>
  </orderedlist>
</section>
