<!--Arbortext, Inc., 1988-2008, v.4002-->
<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD SolBook 3.5//EN" [
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "common.ent">
%commonents;
]>
<?Pub UDT _bookmark _target>
<?Pub EntList bull rArr sect>
<?Pub Inc>
<refentry id="create-profiler-1"><?Pub Tag atict:info tracking="off" ref="2"><?Pub Tag
atict:user user="hl34125" fullname=""><?Pub Tag atict:user user="pmdavies"
fullname=""><?Pub Tag atict:user user="ah95648" fullname="">
<!-- @(#)create-profiler.1 1.9 07/04/25 SMI; -->
<refmeta><refentrytitle>create-profiler</refentrytitle><manvolnum>1</manvolnum>
<refmiscinfo class="date">30 Jan 2007</refmiscinfo>
<refmiscinfo class="sectdesc">&man1;</refmiscinfo>
<refmiscinfo class="software">&software;</refmiscinfo>
<refmiscinfo class="arch">generic</refmiscinfo>
<refmiscinfo class="copyright">Copyright (c) 2007, Sun Microsystems, Inc.
All Rights Reserved</refmiscinfo>
</refmeta>
<refnamediv><indexterm><primary>create-profiler</primary></indexterm><indexterm>
<primary>creates the profiler element</primary></indexterm>
<refname>create-profiler</refname><refpurpose>creates the profiler element</refpurpose>
</refnamediv>
<refsynopsisdiv><title></title>
<synopsis><command>create-profiler</command> &synopsis-common; [<option
role="double-dash">target</option> <replaceable>target_name</replaceable>]
 [<option role="double-dash">classpath</option> <replaceable>classpath</replaceable>] [<option
role="double-dash">nativelibpath</option> <replaceable>native_library_path</replaceable>]
 [<option role="double-dash">enabled</option>=true] [<option role="double-dash">property
</option>(name=value)[:name=value]*]
 <replaceable>profiler_name</replaceable></synopsis>
</refsynopsisdiv>
<refsect1 role="description"><title></title>
<para>Creates the profiler element. A server instance is tied to a particular
profiler, by the profiler element in the Java configuration. Changing a profiler
requires you to restart the server.</para>
<para>This command is supported in remote mode only.</para>
</refsect1>
<refsect1 role="options"><title></title>
<variablelist termlength="medium">&options-common;
<varlistentry><term><option role="double-dash">target</option></term>
<listitem><para>This option specifies the target on which you are creating
a profiler. Valid values are</para>
<itemizedlist>
<listitem><para><literal>server</literal>&hyphen; Specifies the default server
instance as the target.  <literal>server</literal> is the name of the default
server instance and is the default value.</para></listitem>
<listitem><para><replaceable>configuration_name</replaceable>&hyphen; Specifies
a particular configuration as the target for creating the profiler.</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>&hyphen; Specifies
a particular cluster as the target for creating the profiler.</para></listitem>
<listitem><para><replaceable>instance_name</replaceable>&hyphen; Specifies
a particular server instance as the target for creating the profiler.</para>
</listitem>
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry><term><option>-classpath</option></term>
<listitem><para>Java classpath string that specifies the classes needed by
the profiler.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-nativelibpath</option></term>
<listitem><para>This path is automatically constructed to be a concatenation
of the <?Pub Caret>installation relative path for its native shared libraries,
standard JRE native library path, the shell environment setting (<filename>LD_LIBRARY_PATH
</filename> on UNIX) and any path that may be specified in the profile element.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-enabled</option></term>
<listitem><para>Profiler is enabled by default.</para>
</listitem>
</varlistentry>
<varlistentry><term><option>-property</option></term>
<listitem><para>Name/value pairs of provider specific attributes.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="operands"><title></title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>profiler_name</replaceable></term>
<listitem><para>Name of the profiler.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="examples"><title></title>
<example><title>Using create-profiler</title>
<screen>asadmin> <userinput>create-profiler --user admin --passwordfile password.txt 
--host localhost --port 4848 --classpath /home/appserver/
--nativelibpath /u/home/lib --enabled=false
 --property defaultuser=admin:password=adminadmin sample_profiler</userinput>
Created Profiler with id = sample_profiler</screen>
<para>Where: <filename>sample_profiler</filename> is the profiler created.</para>
</example>
</refsect1>
<refsect1 role="exit-status"><title></title>
<variablelist termlength="medium">
<varlistentry><term>0</term>
<listitem><para>command executed successfully</para>
</listitem>
</varlistentry>
<varlistentry><term>1</term>
<listitem><para>error in executing the command</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="see-also"><title></title>
<para><olink targetdoc="ASREFMAN" targetptr="delete-profiler-1">delete-profiler(1)
</olink></para>
</refsect1>
</refentry>
