Sun GlassFish Enterprise Server 2.1 Developer's Guide

The JProbe Profiler

Information about JProbeTM from Sitraka is available at

After JProbe is installed using the following instructions, its libraries are loaded into the server process.

ProcedureTo Enable Remote Profiling With JProbe

  1. Install JProbe

    For details, see the JProbe documentation.

  2. Configure Enterprise Server using the Admin Console:

    1. In the developer profile, select the Enterprise Server component and the JVM Settings tab. In the cluster profile, select the JVM Settings component under the relevant configuration. Then select the Profiler tab.

    2. Edit the following fields before selecting Save and restarting the server:

      • Profiler Name – jprobe

      • Profiler Enabled – true

      • Classpath – (leave blank)

      • Native Library Path – JProbe-dir/profiler

      • JVM Option – For each of these options, select Add, type the option in the Value field, then check its box




      Note –

      If any of the configuration options are missing or incorrect, the profiler might experience problems that affect the performance of the Enterprise Server.

      When the server starts up with this configuration, you can attach the profiler.

  3. Set the following environment variable:


    See Step 6 for instructions on how to create the JPL file.

  4. Start the server instance.

  5. Launch the jpprofiler and attach to Remote Session. The default port is 4444.

  6. Create the JPL file using the JProbe Launch Pad. Here are the required settings:

    1. Select Server Side for the type of application.

    2. On the Program tab, provide the following details:

      • Target Server – other-server

      • Server home Directory – as-install

      • Server class File – com.sun.enterprise.server.J2EERunner

      • Working Directory – as-install

      • Classpath – as-install/lib/appserv-rt.jar

      • Source File Path – source-code-dir (in case you want to get the line level details)

      • Server class arguments – (optional)

      • Main Package – com.sun.enterprise.server

      You must also set VM, Attach, and Coverage tabs appropriately. For further details, see the JProbe documentation. After you have created the JPL file, use this an input to JPROBE_ARGS_0.