Help APM Add Java Agent Install Java agent on JBoss EAP

Installing Java Agent in JBoss EAP 6.2.x & above

Installing Java Agent in JBoss EAP 6.2.x & above

  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.
  3. For 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
  4. For 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>
  5. Save the file and start the JBoss EAP server.

Installing Java Agent in JBoss EAP 6.2.x &above through Management Console

  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.
  3. Login to JBoss EAP management console as 'Management Releam' user
  4. Select Hosts > Server Configurations > <Your Server> > JVM Configuration tab
    JVM configuration
  5. Click on Edit button to create a JVM Configuration for the server. In JVM optionstext box, add the following lines (each JVM option must be separated by a new line)
    -javaagent:<agent_directory_full_path>/apminsight-javaagent.jar
    APM Java
    Click on save button, you will see Added/Modified JVM Config message at top of the page. If the message doesn't appear, check your configuration carefully and save it again.
  6. Select System Properties tab.
    System Properties

    Click Add button and fill in with values
    Name : jboss.modules.system.pkgs
    Value : org.jboss.byteman,com.manageengine
    Boot-Time : Check

    And click Save button
    Save changes
  7. Finally, start/restart your configured server instance from “Runtime” tab at top left corner of the page
Was this document helpful?
Thanks for taking the time to share your feedback. We’ll use your feedback to improve our online help resources.

Help APM Add Java Agent Install Java agent on JBoss EAP