Installation

Windows

Start profilerJ-1.4.1.msi and follow instructions. 

Other platforms

Expand the archive profilerJ-1.4.1.zip (.gz, .tar respectively)  to a directory of your choice (e.g. /var/opt/profilerj). 

Deployment

Add the following statements to the startup-script of the java application you want to profile:

for Unix:

-Xbootclasspath/a:"<Installation-Path>/com.terrasoft.jrc.agent.jar" -javaagent:"<Installation-Path>/com.terrasoft.jrc.agent.jar=suspend=y"

for Windows:

-Xbootclasspath/a:"<Installation-Path>\com.terrasoft.jrc.agent.jar" -javaagent:"<Installation-Path>\com.terrasoft.jrc.agent.jar=suspend=y"

Example:

java -Xbootclasspath/a:"C:\Program Files\Terrasoft\ProfilerJ\com.terrasoft.jrc.agent.jar" -javaagent:"C:\Program Files\Terrasoft\ProfilerJ\com.terrasoft.jrc.agent.jar=suspend=n" -cp foo.jar com.terrasoft.foo

When you start your application it will pause execution until you resume it (see ProfilerJ GUI). Set "...suspend=n" if the application shouldn't stop but continue execution. To prevent the application from exiting, set waitonexit=y.

To activate JMX support, you will have to add  -Dcom.sun.management.jmxremote