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" boot-time="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
   
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
   
   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.
   
   
   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
   
7. Finally, start/restart your configured server instance from “Runtime” tab at top left corner of the page