ZenPack:Terracotta Server

From Zenoss Wiki
This is the approved revision of this page, as well as being the most recent.
Jump to: navigation, search
Joseph Anderson
Current Maintainer(s)
Joseph Anderson
GNU General Public License, Version 2, or later
ZenPack name
More Information
GitHub page/HomePage
Git sources (for cloning)

Terracotta Server ZenPack

Provides JMX-based monitoring of Terracotta distributed caching software.


The ZenPack Catalog has moved to its new home at https://www.zenoss.com/product/zenpacks as of January 17, 2017. The following information may be out of date, and this page will eventually be removed.


This ZenPack is developed by the Zenoss user community and supported via our online forums. Zenoss, Inc. does not provide direct support for this ZenPack.


Version 2.0- Download
Summary of changes: Version 4.x support, migrated to Construction Kit
Released on 2013/04/02
Requires ConstructionKit ZenPack,zenJavaApp ZenPack
Compatible with Zenoss Core 3.2.x, Zenoss Core 4.2.x
Version 2.1- Download
Summary of changes: updated to support ConstructionKit 2.0, added object relations to other components/devices
Released on 2013/11/05
Requires ConstructionKit ZenPack,zenJavaApp ZenPack
Compatible with Zenoss Core 4.2.x


Developed by: Joseph Anderson Description:

This Monitoring Zenpack provides monitoring of Terracotta distributed caching software. It collects Terracotta-specific metrics via JMX, and provides a modeler script for JMX detection.


ZenPacks.community.ConstructionKit ZenPacks.community.zenJavaApp


"TerracottaServer" OS component and RRD Template "/App/Terracotta" Event Class "TerracottaServerMap" modeler plugin script


   Zenoss Versions Supported: 3.x, 4.x
   External Dependencies: None
   ZenPack Dependencies: ZenPacks.community.ConstructionKit, ZenPacks.community.zenJavaApp
   Installation Notes: zenoss restart after installing this ZenPack.

'zTerracottaServerPortRange' gives a port range that the modeler will scan Add "TerracottaServerMap" to the list of modeler plugins for the desired device/device class


Change History:

   1.0 initial release
   2.0	rebuilt using ConstructionKit for 4.x compatibility

rewrote modeler script to leverage new JavaApp detection logic

   2.1 rebuilt for ConstructionKit 2.0

Tested: This ZenPack was tested with versions 3.2.5 and 4.2.3.

Source: https://github.com/j053ph4/ZenPacks.community.zenTerracotta

Known issues:


Normal Installation (packaged egg)

  1. Download the appropriate egg file for the version of Zenoss you are running.
  2. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  3. Install the ZenPack:
    $ zenpack --install ZenPacks.community.zenTerracotta-*.egg
  4. Restart these services:
    $ zenoss restart

Developer Mode Installation

In order to do a development mode installation you will want to clone the existing git repository, and then use the --link flag with the zenpack command:

  1. Ensure you are logged in as the zenoss user:
    $ sudo su - zenoss
  2. Start by cloning the upstream repository:
    $ git clone git://github.com/j053ph4/ZenPacks.community.zenTerracotta.git
  3. Next, perform the installation:
    $ zenpack --link --install ZenPacks.community.zenTerracotta
  4. Finally, restart these serivices:
    $ zenoss restart


Purplemarker.png New: Don't forget to add yourself to the Zenoss User Map!

blog comments powered by Disqus