Configuring the DevTest Agent on JBOSS

Document ID : KB000010337
Last Modified Date : 14/02/2018
Show Technical Document Details

DevTest Agent installation in JBoss


JBoss 7.x improved the server performance significantly by implementing modular development. Instead of going with OSGi, they implemented their own JBoss modules, a precursor to what should be a JSR 294 (Java modules) compliant implementation. But as it stands now, this is simply a vendor-specific module implementation.

As a result, our agent classes are no longer available in bootclass loader by default. We need to make few changes in JBoss 7.x bootstrap files to make DevTest agent work.


All supported DevTest platforms.

The run.bat file is not there any more. You have standalone.bat, appclient.bat, and various other batch files depending on how you want to run JBoss. The following example shows how to run JBoss 7.x in standalone mode with the pure LISA Java agent on Windows.


  1. Open JBOSS-HOME\bin\standalone.bat.
    1. Search for;
      1. rem Setup JBoss specific properties
      2. set %JAVA_OPTS%
    2. Just below those lines, add: set JAVA_OPTS=-javaagent:<your lisa path>\LisaAgent2.jar=url=tcp://localhost:2009,name=JbossAgent %JAVA_OPTS%
  2. Open JBOSS_HOME\bin\standalone.conf.bat
    1. Search for set "JAVA_OPTS=%JAVA_OPTS% -Djboss.modules.system.pkgs=org.jboss.byteman"
    2. Replace it with set "JAVA_OPTS=%JAVA_OPTS% -Djboss.modules.system.pkgs=com.itko,org.jboss.byteman"
Additional Information:

Not applicable.