Sun GlassFish Enterprise Server v3 Prelude Administration Guide

Administering Profilers

Profilers generate information used to analyze server performance. If JVM options are created for a profiler, the options are used to record the settings needed to activate a particular profiler. You can use the create-jvm-options command to create JVM options in the Java configuration or profiler elements of the domain.xml file.

A server instance is associated with a particular profile by the profiler element in the Java configuration.

The following instructions are used to administer profiles:

ProcedureTo Create a Profiler

The remote create-profiler command enables you to create a profiler element in the Java configuration.

  1. Ensure that the server is running.

    Remote commands require a running server.

  2. Create a profiler by using the create-profiler(1) command.

  3. To apply your changes, restart Enterprise Server.

    1. Stop Enterprise Server.

      For instructions, see To Stop a Domain (or Server).

    2. Start Enterprise Server.

      For instructions, see To Start a Domain (or Server).


Example 4–6 Creating a Profiler

The following example command creates a profiler named sample_profiler:


asadmin create-profiler --classpath=/home/appserver/ --nativelibrarypath=/u/home/lib --enabled=false 
--property=defaultuser=admin:password=adminadmin sample_profiler

Information similar to the following is displayed:


Command create-profiler executed successfully.

See Also

To see the full syntax and options of the command, type asadmin create-profiler --help at the command line.

ProcedureTo Delete a Profiler

The remote delete-profiler command enables you to delete a profiler element from the Java configuration.

  1. Ensure that the server is running.

    Remote commands require a running server.

  2. If necessary, notify users that the profiler is being deleted.

  3. Delete the profiler by using the delete-profiler(1) command.

  4. To apply your changes, restart Enterprise Server.

    1. Stop Enterprise Server.

      For instructions, see To Stop a Domain (or Server).

    2. Start Enterprise Server.

      For instructions, see To Start a Domain (or Server).


Example 4–7 Deleting a Profiler

The following example command deletes the profiler named sample_profiler:


delete-profiler sample_profiler

Information similar to the following is displayed:


Command delete-profiler executed successfully.

See Also

To see the full syntax and options of the command, type asadmin delete-profiler --help at the command line.