Remedy - AR System Server - How to enable JMX to FTS plugin

Knowledge Article

Remedy - AR System Server - How to enable JMX to FTS plugin
If you have FTS performance issues, one of the most common troubleshooting practices is that you connect to the FTS plugin through jvisualVM to collect thread and heap dumps. 
Remedy AR System Server
AR System
8,x 9.x
Remedy AR System Server
AR System
8,x 9.x
How can i enable FTS plugin to be able to connect through JvisualVM to collect thread and heap dumps?
This knowledge article may contain information that does not apply to version 21.05 or later which runs in a container environment. Please refer to Article Number 000385088 for more information about troubleshooting BMC products in containers.

1. First locate armonitor config file (armonitor.cfg - Windows | armonitor.conf - Linux)
Most common OOTB locations are:
  • Linux - /etc/arsystem/<servername>/armonitor.conf
  • Windows - C:\Program Files\BMC Software\ARSystem\Conf\armonitor.cfg
2. Once you have located the armonitor file, open it with your favorite editor (nodpad, vi) 
Look for the string "pluginsvr\fts"
  • Linux Example - /opt/java/path/here/java -Xmx2048 -classpath /opt/bmc/ARSystem/plugisnvr/fts/secondary:/opt
  • Windows Example - C:\Program Files\java\path\here\java -Xmx2048 -classpath "C:\Program Files\BMC Software\ARSystem\pluginsvr\fts\secondary;C:\Program Files\
3. Modify armonitor config file  by adding the following options between -Xmx tag and -classpath:
 "-Dcom.sun.management.jmxremote.port=8004 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false "
 
It should look something like this
  • Linux Complete should look something like this - /opt/remedy/jre1.6.0_25/bin/java -Xmx6144m -Dcom.sun.management.jmxremote.port=8004 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -classpath /opt/remedy/ARSystem/pluginsvr/fts/secondary:/opt/remedy/ARSystem/pluginsvr/fts/core:/ opt/remedy/ARSystem/pluginsvr:/opt/remedy/ARSystem/pluginsvr/arpluginsvr81_build00 1.jar: com.bmc.arsys.pluginsvr.ARPluginServerMain -x <server hostname> -i /opt/remedy/ARSystem -m
 
  • Windows Complete should look something like this - "C:\Program Files\Java\jdk1.8.0_73\jre\bin\java" -Xmx3072m -Dcom.sun.management.jmxremote.port=8004 -Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false -classpath "C:\Program Files\BMC Software\ARSystem\pluginsvr\fts\secondary;C:\Program Files\BMC Software\ARSystem\pluginsvr\fts\core;C:\Program Files\BMC Software\ARSystem\pluginsvr;C:\Program Files\BMC Software\ARSystem\pluginsvr\arpluginsvr81_build00 1.jar" com.bmc.arsys.pluginsvr.ARPluginServerMain -x <server hostname> -i "C:\Program Files\BMC Software\ARSystem" -m
4. In this example above we have enabled jmx on the fts plugin and the jmx port for this plugin will be 8004

5. Restart ARServer for the change to take effect.

6. All that is required now to move forward is run jvisualVM and establish a connection on port 8004. 

7. To establish connection to the jvisualVM tool follow the steps below:
File > Add JMX Connection
  1. On the Connection: field add <server hostname>:8004
  2. No login credentials are required for this type of setup.
  3. Select No SSL required 
  4. If all is correct you should now see a new jmx connection to the left navigation menu 
8. Once this is all completed you can follow the last piece of this Community post to take a heap dump
 
Remedy AR System Server
AR System
8,x 9.x
Attachment(s):