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
- Install Hyperic
- Deploy the cipango-plugin.xml like defined in JMX Plugin Tutorial
- start Hyperic agent and server
- Start cipango with a JMX RMI connector
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>