JRun 3.0 and TrueTime / TrueCoverage / Memory Profiler



How do I get TT/TC/MP to work with JRun 3.0?


JRun 3.0 and DevPartner/J

JRun 3.0 may be launched automatically on system startup (using "JRun Services"), or manually using a shortcut to JRun.exe from the Start menu.

JRun 3.0 includes an 'Admin Server' and one or more JRun servers; at install time this only includes the 'Default Server'.

The following instructions describe the steps to take to profile java programs (JSP's, servlets, EJB's) running within the Default Server. If you set up additional servers you will need to profile each one individually. The following instructions do assume that you haven't modified the JVM that JRun uses. If you have, additional steps may be required.

One time setup instructions

The following steps must be performed only once for each JRun Server you wish to profile. They are harmless to leave in place while you are not profiling the server.

  1. Start and log in to the JRun Application Management Console and Server Administrator.
  2. For the server you wish to profile (eg. 'JRun Default Server'), choose the 'Java Settings' page.
  3. Click on Classpath and add:
    C:\Program Files\Compuware\PCShared

    as a new line at the bottom. (If you installed DevPartner/J into an alternate location, you will need to specify it here). Choose Update to commit this change.

  4. Click on Library Path and append to the ; delimited list:
    C:\Program Files\Compuware\PCShared

    For instance, the entire library path might look similiar to this:

    {servlet.jnipath};{ejb.jnipath};C:\Program Files\Compuware\PCShared
  5. Choose Update to commit this change.

Profiling the default server

The following steps will lead you through actually gathering profiling information from the JRun Default Server.

  1. Completely stop the server you wish to profile.

    This means that the server itself (javaw.exe) must be stopped and the controlling JRun.exe must not be running. (This is easy to determine, the JRun tray icon for 'Default Server' will be gone if JRun has been completely stopped).

    The easiest way to do this is to just choose Stop from the Default Server tray icon. If JRun is running as a service, you will need to stop the service from the Services Control Panel.

  2. Start the DevPartner Agent Manager to profile All Java Programs. On the Start > Programs menu, choose DevPartner and then DevPartner Agent Manager. Select Enabled only for TrueTime (or the product you wish to use) in the Just-In-Time Profiling for all Java programs dropdown.
  3. Start the JRun.exe controller for the Default Server. On the Start > Programs menu, choose JRun 3.0 and JRun Default Server. It will not work if you attempt to start the server in some other way (for instance, from JRun Services or the JRun Server Administrator).
  4. DevPartner/J should pop up a recording controls window (such as 'TrueTime Recording Controls').

    After you've hit a few of your pages, you can take a snapshot or simply stop the Default Server to get a session file. You can disable the DevPartner Agent Manager now to prevent it from profiling other Java programs you wish to run.

Old KB# 11048
Comment List
Related Discussions