Deployment

Requirements

• JRE 8 (Java version 1.8)

Installation

There are three steps to installation:

1. Placing the two agent JAR files in a location accessible to all applications that will be monitored.

2. Creating a configuration file for each of the applications being monitored.

3. Starting those applications with an additional -javaagent argument to the JVM.

Files provided by germain

• apm-agent.jar

• apm-agent-runtime.jar

• agent.properties

• germain.java.security

Configuration files

The agent.properties file is a generic template that can be copied and filled in for each application. Suggestion: name each copy agent-[APPLICATION_NAME].properties so they can all reside in the same folder. See the section on configuration for the meaning of each property.

JVM Argument

Any scripts used to start the existing Java applications need to be modified to pass an additional -javaagent argument to the JVM.

-javaagent:[PATH_TO_AGENT_JAR_FILE]=[PATH_TO_PROPERTIES_FILE]

IBM JVM only JVM Argument:

If you are using the IBM JVM you will need to add the following to any scripts used to start the existing Java applications to include the germain.java.security file.

-Djava.security.properties=/[PATH_TO_SECURITY_FILE]/germain.java.security