Installation JBoss

This page provides information on how inspectIT can be used with the JBoss application server.

Instrumentation

There are two possibilities how to set-up and use inspectIT with the JBoss application server. The first solution is to start the JBoss application server stand-alone with a start-up script. The second one is to integrate inspectIT in the start-up process, integrated in the eclipse development environment.

Stand-alone solution

JBoss provides the file run.sh in the /bin directory to set the environment for starting up JBoss. inspectIT can be easily integrated within this file. A best practice is to define variables holding the references to the inspectIT installation and configuration folders.

set INSPECTIT_AGENT_HOME="[path-to-inspectit-agent]"
export INSPECTIT_AGENT_HOME

set INSPECTIT_CONFIG_HOME="$[path-to-config-folder]"
export INSPECTIT_CONFIG_HOME

set INSPECTIT_JAVA_OPTS="-Xbootclasspath/p:${INSPECTIT_AGENT_HOME}/inspectit-agent.jar -javaagent:${INSPECTIT_AGENT_HOME}/inspectit-agent.jar -Dinspectit.config=${INSPECTIT_CONFIG_HOME}"
export INSPECTIT_JAVA_OPTS

# integrate inspectit java options with the java options of JBoss
set JAVA_OPTS="${INSPECTIT_JAVA_OPTS} ${JAVA_OPTS}"

Eclipse

To integrate inspectIT into the startup-process of the JBoss Applicationserver you have to edit the launch configuration of the JBoss application server. Please ensure that you have installed the JBoss server tools which you can find in the specific repository.

Open the "servers" view in eclipse and double-click on the JBoss application server instance. The server configuration overview is being displayed.

Click on "open launch configuration" and add the following line before the existing content in the "VM arguments" Textbox:

"-javaagent:[path-to-inspectit-agent]" "-Dinspectit.config=[path-to-config-folder]"

Finally it should look similar to the following configuration: