<?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="admin.install">

  <info><title>Installing JonasAdmin</title></info>

      <para>
        As with any web application, JonasAdmin requires a servlet server to be installed.
        Make sure that the <code>web</code> service is listed in the <code> jonas.services </code> property
        in the <filename> jonas.properties </filename>
      configuration file.</para>

      <para>
        Designed as a web application, JonasAdmin is packed in a WAR and installed under the
        <filename>
          JONAS_BASE/deploy/
        </filename>
         directory.
      </para>


      <para>Once the server started, JonasAdmin is automatically deployed if the <emphasis role="bold">depmonitor</emphasis>
      service is activated. Otherwise, JonasAdmin can be deployed manually using the
      <link xlink:href="command_guide.html#commands.jonas.jonasadmin">
          jonas admin
      </link> command.
      </para>

      <para>
        When accessing JonasAdmin, the administrator must provide identification and authentication.
         The
        <filename>
          jonas-realm.xml
        </filename>
         configuration file contains a memory realm definition named
        <code>
          memrlm_1
        </code>
        , which is referenced in both
        <filename>
          tomcat6-server.xml
        </filename>
         (for Tomcat) and
        <filename>
          jetty.xml
        </filename>
         (for Jetty) configuration files. The default user name (
        jonas
        ) and password (
        jonas
        ) corresponding to the
        <code>
          admin
        </code>
         role can be modified here.
      </para>
</section>
