2.12.2 create-profiler

Synopsis

asadmin [asadmin-options] create-profiler [--help]
    [--target target] [--classpath classpath]
    [--nativelibrarypath native_library_path] [--enabled={false|true}]
    profiler_name

Storage location

Application Server installation directory/javaee/glassfish/bin

Function

The create-profiler subcommand creates the profiler element. A server instance is tied to the profiler by the profiler element in the Java configuration. Only one profiler exists at a time. If you attempt to create a profiler while one already exists, an error message is displayed. For changes to take effect, the server must restarted. This command is supported in remote mode only.

Only one profiler exists at a time. If you attempt to create a profiler while one already exists, an error message is displayed.

Precondition

DAS has to be in a running state.

Arguments

--help | -?

Displays the help text for the subcommand.

--target target_name

Specifies the target on which you are creating a profiler.

Type: String

The following values can be specified:

• server

  Creates the profiler for the default server instance. This is the default value.

• configuration_name

  Creates the profiler for the named configuration.

• cluster_name

  Creates the profiler for every server instance in the cluster.

• instance_name

  Creates the profiler for a particular server instance.

Default value: server

--classpath classpath

Specifies the Java classpath string classes needed by the profiler.

Type: String

The following values can be specified:

• Specify the classpath in string needed by profiler

Default value: N/A

--nativelibrarypath native_library_path

This path is automatically constructed to be a concatenation of Java EE Server installation relative path for its native shared libraries, standard JRE native library path, the shell environment setting (LD_LIBRARY_PATH on UNIX) and any path that may be specified in the profile element.

Type: String

The following values can be specified:

• Specify the nativelib path

Default value: N/A

--enabled={false|true}

Enables the profiler by default.

Type: Boolean

The following values can be specified:

• true

• false

Default value: true

profiler_name

Specifies the name of the profiler.

Type: String

The following values can be specified:

• Specify the profiler name

Default value: N/A

asadmin create-profiler --target instance1 --classpath /home/appserver/ 
--nativelibrarypath /u/home/lib --enabled=false sample_profiler

Exit Status

Exit Status	Explanation
0	command executed successfully.
1	error in executing the command.