Installing Java agent in WildFly 9.x and above

1. Extract the ZIP file to a new directory to find the agent's JAR file and its configuration files.
2. Configure the properties such as license key, application name and port in the apminsight.conf file located in the extracted folder.
3. Follow either of the following based on your setup:
   1. Stand-alone setup
   2. Domain setup

Stand-alone setup

1. Edit the <WILDFLY_HOME>/bin/standalone.conf.bat file (in Linux, the standalone.conf 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. Save the file and restart the WildFly server.

Video

Here's a quick video on how to install a Site24x7 APM Insight Java agent in WildFly server 9.x and above (standalone setup).

Domain setup

You can add the Site24x7 APM Insight Java agent to the WildFly server via either of the following methods:

• By updating the Host.xml file
• From the admin console

By updating the Host.xml file

Follow the step below to add the Site24x7 APM Insight Java agent to the WildFly server by updating the configuration file:

1. Edit the <WILDFLY_HOME>/domain/configuration/Host.xml file, locate the <servers> tag, and add the following tags under your desired <server name="your_server" ...>tag.

   <system-properties>

2. Save the file and restart the WildFly server

From the admin console

Follow the steps below to add the Site24x7 APM Insight Java agent to the WildFly server(s) from the WildFly admin console:

1. Launch the WildFly application server console.
2. Go to the Runtime tab, click Hosts, then choose the host with the desired server group(s).
3. Select the server and click View.
   
   
4. Go to the JVMs tab and click Add.
   
   
5. In the pop-up menu, provide a desired name for the JVM, then click Add.
   
   
6. Select the added JVM and click Edit.
   
   
7. In the JVM Options field, add the agent's JAR file path in the following format, press the Enter key, then click the Save button.

   -javaagent:{agent_jar_folder}/apminsight-javaagent.jar

    

   

    

   A successfully modified message will be shown.

   

    

8. Restart the WildFly application server (in domain mode). The Site24x7 APM Insight Java agent will now be hooked to the appropriate WildFly server.