Help Docs

Install Java agent in Jira Server

Note
Refer to this help page for the previous steps.
  1. Extract the zip file to a new directory to find agent jar and its configuration files
  2. Open the apminsight.conf file in any text editor, enter your license.key (which can be obtained from the Site24x7 APM Insight page), configure the application.name and agent.server.port values as required, and save the file. Refer here to fine-tune the agent settings.
    Note

    If multiple Java applications or instances are running on the same host, configure application-specific properties, such as application.name and agent.server.port, as JVM system properties instead of configuring them in the apminsight.conf file. For more information, refer to this KB article.

  3. For Windows,
Edit the file < installation_directory>/atlassian/jira/bin/catalina.bat to add the following JVM argument
set "JAVA_OPTS=%JAVA_OPTS% -javaagent:{full_path_to_agent_directory}/apminsight-javaagent.jar -Datlassian.org.osgi.framework.bootdelegation.extra=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.*"
  1. For Windows Services,
  • Follow the Jira documentation to open Jira JVM configuration window 
  • Once the window is opened, navigate to Java tab and Java Options field
  • Add the following arguements
-javaagent:[full_path_to_agent_directory]/apminsight-javaagent.jar -Datlassian.org.osgi.framework.bootdelegation.extra=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.*
  1. For Linux,
Edit the file <installation_directory>/atlassian/jira/bin/catalina.sh to add the following JVM argument
JAVA_OPTS="$JAVA_OPTS -javaagent:{full_path_to_agent_directory}/apminsight-javaagent.jar -Datlassian.org.osgi.framework.bootdelegation.extra=com.manageengine.*,sun.*,org.apache.xerces,org.apache.xerces.*"
  1. Restart the Jira Server

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!