This tutorial explains how to profile Java code running with Apache JServ 1.1.
We advise you to use the wizard for Apache JServ that OptimizeIt features, which performs automatically the steps described in this tutorial. This wizard can be started from OptimizeIt by selecting the Tool/Application server integration/Apache JServ menu.

In this document:
     <OptItDir> is the directory where OptimizeIt has been installed (ex: c:\OptimizeIt\OptimizeIt302D).
     <JServDir> is the directory where Apache JServ has been installed (ex: c:\Program Files\Apache JServ 1.1).

1) Configuring Apache JServ

Changing virtual machine parameters Copying the OptimizeIt servlet Restarting JServ

2) Start the OptimizeIt servlet

Once this operation is done, you should see a message in your web browser indicating that OptimizeIt's audit system is running.

3) Attaching from OptimizeIt

Now that Java Web Server is running with OptimizeIt profiler, you can start OptimizeIt and attach to the virtual machine. Note: OptimizeIt does not have a "detach" function. If you press the stop button in OptimizeIt, the servlet engine exits and restarts automatically. After doing this, you need to invoke the OptimizeIt servlet to restart the profiler.

4) Filtering resources used by JServ

OptimizeIt provides filters for filtering resources used by JServ. In order to use filters, you must create an OptimizeIt setting for the profiling session,  turn on the JServ filter, and then attach by using the Attach now button or pressing the play button. Note: OptimizeIt settings can be saved for subsequent usage. This is done by using the save menu.

5) Starting OptimizeIt profiler from your Java code

While the OptimizeIt servlet is convenient to start profiling quickly, you may want to automatically start OptimizeIt profiler with one of your servlet. That way, you don't have to invoke the OptimizeIt servlet to start the audit system before testing your servlets.

Starting OptimizeIt profiler can be easily done by using OptimizeIt's API. OptimizeIt's API is documented in OptimizeIt user manual, chapter 9. The following code demonstrates how to start the profiler from your servlet:
 
 

import intuitive.audit.Audit;
...
static boolean isProfilerStarted = false;

 if(!isProfilerStarted) {
        /* Start OptimizeIt's profiler */
        Audit.start(1470, Audit.PROFILERS_ALWAYS_ENABLED);

   isProfilerStarted = true;
  }

...
 
 

Note: you will need to add <OptItDir>\lib\optit.jar to your CLASSPATH to compile this code

Once OptimizeIt's profiler is running, you can start OptimizeIt and attach to the servlet engine.
 
 

Copyright (c) 1997, 1998, 1999, 2000 Intuitive Systems Inc. All rights reserved. Specifications subject to change without notice.
OptimizeIt is a trademark of Intuitive Systems, Inc.
Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. All other brand
names and products are trademarks or registered trademarks of their respective holders.