<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [
<!--ArborText, Inc., 1988-1999, v.4002-->
<!ENTITY metainfo SYSTEM "metainfo.sgm">
<!ENTITY options-common SYSTEM "options-common.sgm">
<!ENTITY synopsis-common SYSTEM "synopsis-common.sgm">
<!ENTITY % commonents SYSTEM "smancommon.ent">
%commonents;
<!ENTITY % booktitles SYSTEM "booktitles.ent">
%booktitles;
<!ENTITY Dash "&ndash;">
]>
<?Pub UDT _bookmark _target>
<?Pub Inc>
<refentry id="create-profiler-1">
<refmeta><refentrytitle>create-profiler</refentrytitle><manvolnum>1</manvolnum>&metainfo;
</refmeta>
<refnamediv><indexterm><primary sortas="create-profiler ">create-profiler &mdash;
creates the profiler element</primary></indexterm><indexterm><primary sortas="creates the profiler element">
creates the profiler element &mdash; create-profiler</primary></indexterm>
<refname>create-profiler</refname><refpurpose>creates the profiler element
</refpurpose></refnamediv>
<refsynopsisdiv><title>&synp-tt;</title>
<cmdsynopsis><command>create-profiler</command>&synopsis-common;
<arg>&Dash;&Dash;target <replaceable>target_name</replaceable></arg><arg>&Dash;&Dash;classpath <replaceable>
classpath</replaceable></arg><arg>&Dash;&Dash;nativelibpath <replaceable>
native_library_path</replaceable></arg><arg>&Dash;&Dash;enabled=true</arg>
<arg>&Dash;&Dash;property(name=value)[:name=value]*</arg><arg choice="plain"><replaceable>
profiler_name</replaceable></arg>
</cmdsynopsis></refsynopsisdiv>
<refsect1><title>&desc-tt;</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><title>OPTIONS</title>
<variablelist termlength="medium">&options-common;
<?Pub Caret>
<varlistentry><term><option role="nodash">&Dash;&Dash;target</option></term>
<listitem><para>This option specifies the target on which you are creating
a profiler. Valid values are<itemizedlist>
<listitem><para><literal>server</literal>, which creates the profiler for
the default server instance. This is the default value.</para>
</listitem>
<listitem><para><replaceable>configuration_name</replaceable>, which creates
the profiler for the named configuration</para>
</listitem>
<listitem><para><replaceable>cluster_name</replaceable>, which creates the
profiler for every server instance in the cluster</para>
</listitem>
<listitem><para><replaceable>instance_name</replaceable>, which creates the
profiler for a particular server instance</para>
</listitem>
</itemizedlist></para>
</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 Application
Server 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><title>OPERANDS</title>
<variablelist termlength="medium">
<varlistentry><term><replaceable>profiler_name</replaceable></term><listitem>
<para>Name of the profiler.</para>
</listitem></varlistentry>
</variablelist></refsect1>
<refsect1><title>&exam-tt;</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><title>EXIT STATUS</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><title>&also-tt;</title>
<para><link linkend="delete-profiler-1"><citerefentry><refentrytitle>delete-profiler
</refentrytitle><manvolnum>1</manvolnum></citerefentry></link></para>
</refsect1>
</refentry>
<?Pub *0000004931>
