Integrating OptimizeIt in Sybase EAServerAuthor: Samir Nigam, EAServer Engineering, Sybase
This document describes how to integrate OptimizeIt software (Profiler, Thread Debugger, Code Coverage) in Sybase EAServer. Details in this document are developed for Borland OptimizeIt version 4.1 and 5.5 running in Sybase EAServer version 4.2.2 and 5.0 (beta release) using Sun JDK 1.3.1 and 1.4.1 on Microsoft Windows 2000. Parts of this document are adopted from OptimizeIt documentation. We assume that you have already installed OptimizeIt software appropriately.
What is OptimizeIt
Borland OptimizeIt is a software engineering tool for identifying performance related issues in a Java program. OptimizeIt Suite includes OptimizeIt Profiler, OptimizeIt Thread Debugger and OptimizeIt Code Coverage to pinpoint performance and reliability problems in Java code including memory leaks, performance bottlenecks, and thread problems. For further information, please check Borland website.
How OptimizeIt Works
OptimizeIt is divided into 2 parts:
In order to integrate OptimizeIt with EAServer, you need to start the Audit System in the virtual machine of EAServer. Once the Audit System is started, you can start the OptimizeIt GUI and attach to the audit system. At that point, you can get the testing information for your Servlets, JSPs and EJBs just by executing them. The following sections explain how to configure EAServer to run with the Audit System and how to interact with the Audit System running in the virtual machine of EAServer.
EAServer Configuration Changes
Virtual Machine Startup Parameters
Following changes are needed in EAServer startup script (%JAGUAR%\bin\serverstart.bat) and Server properties file (%JAGUAR%\Repository\Server\Jaguar.props).
Modify EAS_CLASSPATH_P1 to add <OptimizeIt_Directory>\lib\optit.jar.
Modify EAS_BOOTCLASSPATH_P1 to add <OptimizeIt_Directory>\lib\optit.jar and <OptimizeIt_Directory>\lib\oibcp.jar.
Modify EAS_PATH_P1 to include <OptimizeIt_Directory>\lib directory.
server property “com.sybase.jaguar.server.jvm.options” (edit Jaguar.props
or via Jaguar Manager) to add the following values.
This version supports JDK 1.3 only. Please add following to the above mentioned server property:
If you are using JDK 1.3.1 classic VM:
If you are using JDK 1.3.1 or 1.4.x, or want to use JDK 1.3.1 with Hotspot VM:
Please make sure that “com.sybase.jaguar.server.jvm.nojit” is set to true in server properties file.
Adding OptimizeIt Servlet to EAServer (OptimizeIt 4.1 only)
Note About Security Issues
You may need to grant all permissions to OptimizeIt application for proper execution in EAServer. You can set these permissions by modifying the policy file in %JAVA_HOME%\jre\lib\security\java.policy. The JAVA_HOME directory is typically %JAGUAR%\jdk\<jdk of your choice>.
Example: The following lines are added to the above mentioned policy file:
grant codeBase "file:<OptimizeIt_Directory>\lib\optit.jar"
This concludes one-time steps required to integrate OptimizeIt in EAServer.
Enabling OptimizeIt Audit System in EAServer at runtime
Following steps are required to activate OptimizeIt system in EAServer when it is started.