In this article we will explain how to configure JENNIFER agent with JBoss 7.
From JBoss 7, they adopt OSGI class loader and added Domain management structure. The following diagram shows the new directory structure of JBoss 7 Standalone and domain.

JBoss AS 7 in domain mode spawns multiple JVMs which build up the domain. Besides the AS instances, two more processes are created: The Domain Controller which acts as management control point of the domain and the Host Controller which interact with the domain controller to control the lifecycle of the AS instances.

Standalone Installation

The installation process of JENNIFER agent is the same as the installation of previous versions:

1. Go to JENNIFER agent directory and execute the pre-install script (preinstall.sh)
2. Follow the instruction on the pre-install script

After the pre-install script is done, add JENNIFER agent configuration to standalone startup script:

• Go to JBoss bin directory (e.g., /home/was/jboss7/bin)
• Open standalone.sh using your favorite editor.
• Add JENNIFER agent post-install configurations

JAVA_OPTS=“-Xbootclasspath/p:/home/jennifer/agent/lwst.jdk.jar:/home/jennifer/agent/lwst.boot.jar -Djennifer.config=/home/jennifer/agent/JB7.conf -javaagent:/home/jennifer/agent/lwst.javaagent.jar $JAVA_OPTS”

• Save the changes and close the file.
• Finally, we need to add the following option to standalone.conf file for supporting OSGI class loader, open standalone.conf using your favorite editor.
• Add the following

JAVA_OPTS=“-Djboss.modules.system.pkgs=org.jboss.byteman,com.javaservice $JAVA_OPTS”

• Save the changes and close the file.
• Start JBoss and confirm that JENNIFER agent is running.

Domain Installation

host.xml includes each AS instance configuration. You can set JENNIFER agent setting with element under each instance you wants to monitor.

• Go to JBoss domain directory and then configuration directory (e.g., /home/was/jboss7/domain/configuration).
• host.xml includes each AS instance configuration. You can set JENNIFER agent within the element(s) under each instance you want to monitor.
• Open host.xml using your favorite editor.
• Under server tag add the following options:

< server name=“server-one” group=“main-server-group” >
< jvm name=“default” >
< jvm-option >
< option value=“-Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=n”/ >
< option value=“-Xbootclasspath/p:/home/jennifer/agent/lwst.boot.jar;
/home/jennifer/agent/jennifer.boot.jar;/home/jennifer/agent/lwst.jdk.jar”/ >
<option value=“-Djennifer.config=/home/jennifer/agent/JB7.conf”/ >
< option value=“-javaagent:/home/jennifer/agent/lwst.javaagent.jar”/ >
< /jvm-option >
< /jvm >
< /server >

• Save the changes and close the file.
• Go to JBoss bin directory (e.g., /home/was/jboss7/bin)
• We need to add the following options to domain.conf file for supporting OSCGI class loader, open domain.conf using your favorite editor and add the following:

JAVA_OPTS=“-Djboss.modules.system.pkgs=org.jboss.byteman,com.javaservice $JAVA_OPTS”

• Save the changes and close the file
• Start JBoss and confirm that JENNIFER agent is running.