How to Setup Tomcat Discovery on Your Turbonomic Instance

Document created by Anson McCook Expert on Jun 4, 2015Last modified by on Aug 3, 2018
Version 12Show Document
  • View in full screen mode

***The following setup is only applicable to users with the Application Control Module or Application Edition running on 5.2 or higher***


If you do not have the Application Control Module or Application Edition, please contact your Customer Experience representative or your Account Executive for licensing.


Ensure your appliance is running 5.2 or higher. Follow these instructions to update:

VMTurbo Latest Update Links & How To Perform an Operations Manager "Offline Update"



In this document we’ll review how to setup discovery of the Tomcat service running within your Turbonomic instance. The high-level steps look something like this:


1) Turn on Remote Management by enabling JMX

2) Open up the Firewall to specified JXM port

For ease of setup, we’ll cover these additional steps.

a. Install Yast Firewall

b. Install Telnet



Turn on Remote Management by Enabling JMX


1) Open up a console or Putty session to your Turbonomic instance.


2) Go to the following directory:


cd /etc/tomcat


3) Create a backup of the tomcat.conf file and server.xml file:


cp tomcat.conf tomcat.conf.original

cp server.xml server.xml.original


4) Open the text editor for tomcat.conf


vi tomcat.conf


5) Toward the bottom you’ll find the line:




6) Beneath that line, add the following text. See Before and After screenshots as reference.

Press “a” to append in the editor and add the following lines:








7) Press “esc” to stop appending


8) Write the file and quit




9) Open the text editor for tomcat.conf


vi server.xml


10) In the section that begins with:

<!-- Security listener. Documentation at /docs/config/listeners.html

  <Listener className="" />



Locate the last <Listener.../>  line, which is:


<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />


11) Beneath that line, add the following text. See Before and After screenshots as reference.

Press “a” to append in the editor and add the following lines:


<Listener className="org.apache.catalina.mbeans.JmxRemoteLifecycleListener" rmiRegistryPortPlatform="7050" rmiServerPortPlatform="7051" />





12) Press “esc” to stop appending


13) Write the file and quit




14) Run the following commands to accept communication for the JMX ports:


iptables -I INPUT 4 -p tcp --dport 7050 -j ACCEPT


iptables -I INPUT 4 -p tcp --dport 7051 -j ACCEPT


15) Download the JMX Remote Lifecycle Listener jar file, available from the link below and attached to this post at the bottom.




(If the link above isn't working, please go to the Apache Tomcat site and download the JMX Remote jar there: Apache Tomcat - Apache Tomcat 7 Downloads)


16) Using an SCP-client, place the catalina-jmx-remote.jar file in the following directory:




17) Restart the tomcat service


service tomcat restart


18) Confirm tomcat started:


service tomcat status


If the service is inactive and not running, try using the catalina-jmx-remote.jar file attached at the bottom of this post (instead of the latest catalina-jmx-remote.jar off the Tomcat website).




Adding the Tomcat target to Turbonomic:


1) Go to the Admin Tab > Workflows > Target Configuration > Application Server > Tomcat


2) Enter in the following information:

Scope/Address: The IP address/FQDN of the single Tomcat instance OR create a custom group in the Policy tab to set the scope to a group of Tomcat applications

Port Number: 7050

Username: admin

Password: admin


4) Select “Add", "Apply", and then “Rediscover”


5) You will eventually be able to see your Tomcat application discovered in the Inventory tab. From here, you will be able to see decisions based on the demand of the application from the virtual machine. Metrics collected include:

- Heap

- Thread Count

- Transactions

- Garbage Collection

- Response Time



2 people found this helpful