How to Install Applicare Heap Tracker

The Applicare Heap Tracker is shipped in the $ARCTURUS_HOME/agent/applicare_jvmti directory.

For Windows, the directory contains 32 and 64 bit versions of dll for JDK 6 and JDK 7.

For Linux/Unix/OSX, it contains 2 separate subdirectories (jdk6 and jdk7), each containing the source and make files to build the .so file on the Linux/Unix system that Applicare Heap Tracker is going to be running on.

For Linux/Unix/OSX, HeapTracker.so needs to be built by running the make, as seen below:

# cd /Applicare/agent/jvmti/jdk6

# make

For installation, follow the instructions below:

1. Copy the appropriate dynamic library based on your OS and JDK under  $ARCTURUS_HOME/bin

For Linux/Solaris/Unix:

libapplicare_HeapTracker.so

For Windows: 

libapplicare_HeapTracker$JDK_$ARCH.dll

e.g. with JDK6, 32 bits: libapplicare_HeapTracker6.dll
or with JDK7, 64 bits: libapplicare_HeapTracker7_64.dll

For Mac OSX: 

libapplicare_HeapTracker.dylib

IMP Notes:
       a: For each architecture (32/64) and JDK (6/7), there a specific library.
       b: The JVM won't start if server.name or appllicare.agent.name or weblogic.Name is undefined.

2. Add a new JVM argument: agentpath

For Windows:

-agentpath:%ARCTURUS_HOME%\bin\libapplicare_HeapTracker$JDK_$ARCH.dll

e.g. with JDK6, 32 bits: 

-agentpath:%ARCTURUS_HOME%\bin\libapplicare_HeapTracker6.dll

or with JDK7, 64 bits: 

-agentpath:%ARCTURUS_HOME%\bin\libapplicare_HeapTracker7_64.dll

For Linux/Unix/OSX:

-agentpath:$ARCTURUS_HOME/bin/applicareHeapTracker.so

The final step is to turn on Heap Tracking by going to Configure Dynamic Instrumentation and moving Heap Tracker to Deployed Aspects. Heap Tracking will begin after the JVM restart.

JVM restart is only needed once after adding -agentpath. The Heap Tracker aspect deployment or un-deployment takes effect without a JVM restart as long as -agentpath was in the startup of the JVM before its start.

3. Copy heaptracker.jar to $arcturus_home.

4. Copy jvmti_inclusions.txt and jvmti_exclusions.txt to $arcturus_home.

5. Edit the instrumentations threshold in Applicare.props as follows:

heapTracker.thresholdPercent=90