Help Docs

Installing Java agent in WildFly 9.x and above

Note
Refer to this help page for the previous steps.
  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

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.
Note

 

  • The same steps can be repeated to add the agent to different servers running under the domain.
  • If the group of servers in domain mode is spread across different hosts, then you must repeat steps 1 and 2 for each host.

 

Was this document helpful?

Would you like to help us improve our documents? Tell us what you think we could do better.


We're sorry to hear that you're not satisfied with the document. We'd love to learn what we could do to improve the experience.


Thanks for taking the time to share your feedback. We'll use your feedback to improve our online help resources.

Shortlink has been copied!