#
# JASMINe
# Copyright (C) 2010 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$
# --------------------------------------------------------------------------
#
    ====================
    JOnAS dummmy service
    ====================


Introduction
------------

This module is a dummy iPOJO bundle which allows to register dummy mbeans
in the MBean Server associated to the JOnAS server ie JASMINe-Probe server.

The registered dummy mbeans are defined in a properties configuration file.


============================
!!!! A REVOIR !!!!!
============================


Installation
------------

To install the dummy bundle in the JASMINe-Monitoring server, just do :
- cp jasmine-monitoring-tests/modules/dummyservice/src/plan/dummy.xml $JASMINE_HOME/deploy
- cp /jasmine-monitoring-tests/modules/dummyservice/target/dummyservice-${VERSION}.jar \
      $JASMINE_HOME/repositories/maven2-internal/org/ow2/jasmine/monitoring/jasmine-monitoring-integration-tests-modules/dummyservice/${VERSION}

Configuration
-------------
A configuration properties file is used to describe the mbeans to register.
The name of this configuration properties file can be set via the system property 'dummy-mbeans.conf' (ie -Ddummy-mbeans.conf=my-dummy-conf-file.properties),
and this file must be add in the JONAS_BASE/conf directory.
Note that in case of the 'dummy-mbeans.conf' proerty is not set, the 'default-dummy-mbeans.properties' file embedded in the jar is used.


Probes example:
---------------

    <probe status="started" cmd="stat" filter='jasmine_tests:type=Basic,*,name=mbdefault' period="10">
        <target>myself</target>
        <output>eventswitch</output>
    </probe>
    <probe status="started" cmd="stat" args="-rate VIncremented -delta VIncremented -rate VSinusoidal -delta VSinusoidal" filter='jasmine_tests:type=Basic,*,name=mbdefault*' period="10">
        <target>myself</target>
        <output>eventswitch</output>
    </probe>

    <probe status="started" cmd="stat" filter='jasmine_tests:type=Basic,category=A,*' period="10">
        <target>myself</target>
        <output>eventswitch</output>
    </probe>
    <probe status="started" cmd="stat" args="-rate VIncremented -delta VIncremented -rate VSinusoidal -delta VSinusoidal" filter='jasmine_tests:type=Basic,category=A,*' period="10">
        <target>myself</target>
        <output>eventswitch</output>
    </probe>


Configuration graphs for the 'Basic' dummy mbean example
--------------------------------------------------------

See graphs_dummy_mbean_tmpl.xml which is a template with a parameter for the name of the 'Basic' dummy mbean.
