<?xml version="1.0" encoding="UTF-8"?>
<!--
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  - JASMINe
  - Copyright (C) 2012 Bull S.A.S.
  - Contact: jasmine@ow2.org
  -
  - This library is free software; you can redistribute it and/or
  - modify it under the terms of the GNU Lesser General Public
  - License as published by the Free Software Foundation; either
  - version 2.1 of the License, or any later version.
  -
  - This library is distributed in the hope that it will be useful,
  - but WITHOUT ANY WARRANTY; without even the implied warranty of
  - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  - Lesser General Public License for more details.
  -
  - You should have received a copy of the GNU Lesser General Public
  - License along with this library; if not, write to the Free Software
  - Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307
  - USA
  -
  -
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  - $Id$
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-->
<sect1 version="5.0" xml:lang="en" xml:id="jasmineprobe.config_server" 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">

  <title>JASMINe Probe's platform configuration</title>
  <para>
    JASMINe Probe application runs within OSGi based JOnAS application server.
    Complete documentation on JOnAS server configuration can be found in <ulink url="http://jonas.ow2.org/JONAS_5_3_0_M5/doc/doc-en/html/configuration_guide.html"/>.
  </para>
  <para>
    The configuration provided for JASMINe Probe corresponds to a JOnAS 'micro' profile (only a few services are activated, like <emphasis>registry</emphasis>,
    <emphasis>security</emphasis> and <emphasis>jmx</emphasis> mandatory services, and a deployment service called <emphasis>depmonitor</emphasis>) or to 'jaxrs-jonas' profile
    (with two more services, <emphasis>web</emphasis> and <emphasis>jaxrs</emphasis>) .
  </para>
  <para>
    The <emphasis>jmx</emphasis> service provides an MBean server that has registered MBeans for JVM and JOnAS management.
    In addition, a JASMINe Probe registered MBean having OBJECT_NAME <emphasis>jasmine:dest=probe-manager</emphasis> exposes operations for JASMINe Probe artifacts management.
    This MBean is used by the JASMINe Probe's JMX Client <xref linkend="jasmineprobe.tools_jmx_client"/>.
  </para>
  <para>
    In order to allow remote access to the MBean server, a JMX RMI connector is available at the platform start-up. By default, the connector's URL is
    <emphasis>service:jmx:rmi:///jndi/rmi://localhost:4098/jrmpconnector_jasmine-probe</emphasis>. The connector's address changes if one of the following JOnAS
    configuration parameters are modified:
  </para>
  <para>
    <itemizedlist>
     <listitem>
       <para>The JOnAS server name. By default i's set to <emphasis>jasmine-probe</emphasis> in the jasmine-probe.sh (or jasmine-probe.bat) script (-n option for jonas start)</para>
     </listitem>
     <listitem>
       <para>The JASMINe Probe's host name can be used instead of <emphasis>localhost</emphasis> to allow execution of JMX Client on a remote host.</para>
     </listitem>
     <listitem>
       <para>RMI port number is set to 4098 by default (see <emphasis>carol.jrmp.url</emphasis> in <emphasis>carol.properties</emphasis> file within <emphasis>conf</emphasis> directory).</para>
     </listitem>
   </itemizedlist>
  </para>
  <para>
    Remote management may require security. The <emphasis>jmx</emphasis> service can be secured, for example, with password authentication. See <emphasis>jonas.properties</emphasis> file within <emphasis>conf</emphasis> directory
    for details.
  </para>
  <para>
    The default configuration provides Tomcat 7 as the <emphasis>web</emphasis> service implementation. The HTTP port is set to 9000 (see <emphasis>tomcat7-http-connector.xml</emphasis> file in <emphasis>conf</emphasis> directory).
  </para>
</sect1>
