<?xml version="1.0" encoding="UTF-8"?>
<!--
  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
  - JASMINe
  - Copyright (C) 2011-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.target_create" 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>Target Definition</title>

    <para>
      In order to define a target, users have to specify:
      <itemizedlist>
       <listitem>
         <para><emphasis role="bold">name</emphasis>: a user defined name that uniquely identifies the target</para>
       </listitem>
       <listitem>
         <para><emphasis role="bold">type</emphasis>: only <emphasis>jmx</emphasis> supported</para>
       </listitem>
       <listitem>
         <para><emphasis role="bold">properties</emphasis>: defines parameters necessary to establish connection with the target</para>
         <para>
            <itemizedlist>
             <listitem>
               <para><emphasis role="bold">url</emphasis>: JMX URL (required)</para>
             </listitem>
             <listitem>
               <para><emphasis role="bold">user</emphasis>: only required when the jmx server is secured</para>
             </listitem>
             <listitem>
               <para><emphasis role="bold">password</emphasis>: only required when the jmx server is secured</para>
             </listitem>
            </itemizedlist>
         </para>
       </listitem>
     </itemizedlist>
    </para>

     <para><emphasis role="bold">Examples:</emphasis></para>
     <screen>
  &lt;!-- the standalone jasmine-probe server --&gt;
  &lt;target name="agent0" type="jmx"&gt;
    &lt;property key="url" value="service:jmx:rmi:///jndi/rmi://localhost:4099/jrmpconnector_jasmine-probe"/&gt;
  &lt;/target&gt;
  &lt;!-- the jasmine-monitoring server --&gt;
  &lt;target name="jasmine" type="jmx"&gt;
    &lt;property key="url" value="service:jmx:rmi:///jndi/rmi://localhost:1199/jrmpconnector_jasmine-monitoring"/&gt;
  &lt;/target&gt;
  &lt;!-- a jonas server with secured jmx --&gt;
  &lt;target name="sec_jonas" type="jmx"&gt;
    &lt;property key="url" value="service:jmx:rmi:///jndi/rmi://localhost:1099/jrmpconnector_jonas"/&gt;
    &lt;property key="user" value="jonas"/&gt;
    &lt;property key="password" value="jonas"/&gt;
  &lt;/target&gt;
</screen>

</sect1>
