Help Docs

Install Java agent on JBoss AS 4.2x & above

This application server is only compatible with APM Insight Java agent versions below 5.7.0.
  1. Extract the zip file to a new directory to find agent jar and its configuration files.
  2. Open apminsight.conf file in any text editor and add license.key value, which can be obtained from Site24x7 APM Insight page. Refer here to fine tune the agent settings.

For JBoss AS 4.x, 5.x, 6.x servers:

  1. For Windows, open <JBOSS_HOME>\bin\run.bat in any text editor and add the following entry at the top and save.
    set JAVA_OPTS=-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar %JAVA_OPTS%
  2. For Linux, open <JBOSS_HOME>/bin/run.sh in any text editor and add the following entry at the top and save.
    export JAVA_OPTS="$JAVA_OPTS -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar"

For JBoss AS 7.x servers:

  1. In standalone setup:
    Edit <JBOSS_HOME>/bin/standalone.bat(In Linux, standalone.sh) file to add the following java arguments to the existing JAVA_OPTS.
    --Djboss.modules.system.pkgs=org.jboss.byteman,com.manageengine -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
  2. In domain setup:
    Edit <JBOSS_HOME>/domain/configuration/Host.xml file and locate <servers> tag and add the mentioned tags under your desired <server name="your_server" ...> tag.
    < system-properties>
    <property name="jboss.modules.system.pkgs" value="org.jboss.byteman,com.manageengine" boottime="true"/>
    </system-properties>
    <jvm name="insight">
    <jvm-options>
    <option value="-javaagent:<agent_directory_full_path>/apminsight-javaagent.jar" />
    </jvm-options>
    </jvm>
  3. Save the file and start the JBoss Application Server.

Was this document helpful?

Shortlink has been copied!