Previous Topic: Install the Pure Java AgentNext Topic: Options for Agent Parameters String


Install the Native Agent

This topic describes how to install the native version of the DevTest Java Agent.

Note: Investigate the target environment ahead of time and ensure that it has been tested, or test it yourself. Most Java agent issues are OS or JVM-dependent, instead of application-dependent. Be sure to follow the instructions in this documentation. If that does not help, review Java Agent Troubleshooting before contacting Support.

If you want to create TIBCO BusinessWorks baselines, install the native agent. In addition, add the heap option to the agent parameters string and set the value to true.

The following table contains the file names of the platform-dependent library modules for the native agent:

Module

File Name

Windows (32-bit JVM)

JavaBinder.dll

Windows (64-bit JVM)

JavaBinder.amd64.dll

Mac OS X (x86/x64) 32/64-bit

libJavaBinder.jnilib

Linux (x86) 32-bit

libJavaBinder.x86.so

Linux (x64) 64-bit

libJavaBinder.x64.so

Solaris (x86) 32-bit

libJavaBinder.solaris.x86.so

Solaris (x64) 64-bit

libJavaBinder.solaris.x64.so

Solaris (Sparc) 32-bit

libJavaBinder.solaris.sparc32.so

Solaris (Sparc) 64-bit

libJavaBinder.solaris.sparc64.so

HP-UX (RISC) 32-bit

libJavaBinder.hp-ux.sl

Follow these steps:

  1. Obtain the following files from the LISA_HOME\agent directory:
  2. Place the files anywhere on your disk that has read permissions from the Java application and is not automatically loaded in the application classpath (such as \WEB-INF\lib directories).
  3. Go to the platform-specific agent installation section and follow the instructions for the platform that you are using. You will specify an agent parameters string in the following format:
    -agentpath:<path_to_JavaBinder_file>=jar=file:<path_to_LisaAgent.jar>[,url=<broker_url>][,name=<agent_name>]
    
  4. Start the Java application.