Sun Java System Application Server Platform Edition 9 Developer's Guide

The JProbe Profiler

Information about JProbeTM from Sitraka is available at http://www.quest.com/jprobe/.

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 3.0.1.1.

    For details, see the JProbe documentation.

  2. Configure Application Server using the Admin Console:

    1. Select the Application Server component, the JVM Settings tab, and 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

        -Xbootclasspath/p:JProbe-dir/profiler/jpagent.jar

        -Xrunjprobeagent

        -Xnoclassgc


      Note –

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


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

  3. Set the following environment variable:


    JPROBE_ARGS_0=-jp_input=JPL-file-path
    

    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 – install-dir

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

      • Working Directory – install-dir

      • Classpath – install-dir/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.