This documentation relates to last stable version of Cipango.
visit the last unstable documentation home.

Hyperic integration

Hyperic is a monitoring web application.

An hyperic plugin has been developped to supervised Cipango.

Plugin installation

Cipango configuration

JMX

Cipango Hyperic plugin requires a JMX connector.
This can be achieve by starting Cipango using the following configuration file with the command
java -jar start.jar etc/cipango-jmx.xml etc/cipango.xml

cipango-jmx.xml
<?xml version="1.0"?>
<!DOCTYPE Configure PUBLIC "-//Mort Bay Consulting//DTD Configure//EN" "http://jetty.mortbay.org/configure.dtd">

<Configure id="Server" class="org.cipango.Server">

    <!-- =========================================================== -->
    <!-- Initialize mbean server                                     -->
    <!-- =========================================================== -->
    <!-- Use the jdk 1.5 platformMBeanServer -->
    <Call id="MBeanServer" class="java.lang.management.ManagementFactory" name="getPlatformMBeanServer"/>
  
    <!-- =========================================================== -->
    <!-- Initialize the Cipango MBean container                      -->
    <!-- =========================================================== -->
    <Get id="Container" name="container">
      <Call name="addEventListener">
        <Arg>
          <New class="org.mortbay.management.MBeanContainer">
            <Arg><Ref id="MBeanServer"/></Arg>
            <Call name="start" />
          </New>
        </Arg>
      </Call>
    </Get>

    <!-- ================================================================== -->
    <!-- Get or Create RMI registry                                         -->
    <!-- ================================================================== -->
    <!-- Get an already existing registry
    <Call class="java.rmi.registry.LocateRegistry" name="getRegistry"/>
    -->
    <!-- Create registry -->
    <Call class="java.lang.System" name="setProperty">
      <Arg>java.naming.factory.initial</Arg>
      <Arg>com.sun.jndi.rmi.registry.RegistryContextFactory</Arg>
    </Call>
    <Call class="org.cipango.util.RmiRegistryHelper" name="createRegistry">
      <Arg>1099</Arg>
    </Call>


    <!-- ================================================================== -->
    <!-- add a remote JMX connector                                         -->
    <!-- ================================================================== -->
    <Call id="jmxConnector" class="javax.management.remote.JMXConnectorServerFactory" name="newJMXConnectorServer">
      <Arg>
        <New class="javax.management.remote.JMXServiceURL">
          <Arg>service:jmx:rmi:///jndi/rmi://localhost/cipangombeanserver</Arg>
        </New>
      </Arg>
      <Arg/>
      <Arg><Ref id="MBeanServer"/></Arg>
      <Call name="start"/>
    </Call>

</Configure>

Statistics

The plugin also collects statistics on message received and sent.

To enabled statistics in Cipango, add at the end of cipango.xml, the following lines

  <Set name="allStatsOn">true</Set>

Plugin documentation