Use the instructions in this section to prepare for and set up monitoring of a Tomcat or other Java/JMX server.
When you start your Tomcat server, you must enable JMX access with these commands:
JAVA_OPTS="-Dcom.sun.management.jmxremote.port=12346"
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.authenticate=false"
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.ssl=false" \
export JAVA_OPTSNote
If you prefer to use a WebLogic or JBoss server, see the configuration notes located at:
http://dev.zenoss.org/trac/browser/trunk/zenpacks/ZenPacks.zenoss.ZenJMX/notes.txt
Look at the list of loaded Zen Packs to verify that the ZenJMX ZenPack is installed. Select Advanced > Settings from the menu bar, and then select ZenPacks in the left panel.
Use these instructions to set up Zenoss to monitor a Tomcat server.
Add the Java server device to your preferred device class.
Tip
You might, for example, set up a Java Servers class under the Server device class and add the device in that location.
When adding the device, de-select the Model option (In this case, the SNMP model will not add significant additional information.)
Navigate to the newly added Java server device.
In the left panel, select Device under Monitoring Templates.
From the Action menu, select Bind Templates.
The Bind Templates dialog appears.
Select the ZenJMX template (loaded with the ZenJMX ZenPack) from the Available list and move it to the Selected list, and then click Save.
The ZenJMX monitoring template is added to the list of monitoring templates.
In the next set of steps, you will change some of the parameters of the data sources. These data sources are provided through Java, and must be fine-tuned for Zenoss. These sample steps illustrate changing the Heap memory Data Source.
Select the ZenJMX monitoring template in the left panel.
In the Data Sources area, double-click ZenJMX Heap Memory.
The Edit Data Source dialog appears.
Ensure that the Enabled option is selected.
In the JMX Connection and Metadata Information area, make sure that the value of the Management Port field is set to the same value as the management port on your Java server.
In the JMX Remote Authentication Information area, make sure that:
If you have remote authentication enabled on your server, you have also enabled it in Zenoss.
Zenoss and server values match.
Click Save.
To see where the JMX information appears in the device model, navigate to the device through the device list, and then click Graphs in the left panel.
These performance graphs should appear on the page:
ZenJMX Non-Heap Memory
ZenJMX Heap Memory
ZenJMX Open File Descriptors
ZenJMX Thread Count
The graphs are created by ZenJMX. When they are initially loaded, they will not display actual data.
