JMX

Cipango JMX is based on Jetty JMX.

To start Cipango with JMX support, add the cipango-jmx.xml configuration file as follows:

java -jar start.jar --ini=start-cipango.ini --pre=etc/cipango-jmx.xml

SNMP

Compilation

By default, the SNMP is not compiled.

cd extra/snmp
mvn install

The SNMP module is using the SNMP4J library including the snm4j-agent-jmx which is distributed under the GPL license

Usage

To start cipango with SNMP support

java -jar start.jar etc/cipango-jmx.xml etc/cipango.xml etc/cipango-snmp.xml

MIB

Currently, there is no dedicated MIB defined for Cipango.
The SNMP agent publishes the standard MIB for the Java virtual machine (Java VM) instrumentation.

Currently, the following OIDs are exposed

OID

name

type

description

1.3.6.1.4.26588.1.10.1.0

messageReceived

Counter32

Total number of message received (stats must be enabled)

1.3.6.1.4.26588.1.10.2.0

messageSent

Counter32

Total number of message sent(stats must be enabled)

1.3.6.1.4.26588.1.10.3.0

sipVersion

OctetString

Cipango version

Web Console

The Cipango console is a Web application which allows to monitor Cipango.

The console can be used to display the following informations:

It also allows to perform the following actions:

Adding console support

To run cipango with console, start Cipango with:

java -Dcom.sun.management.jmxremote  -jar start.jar --ini=start-cipango.ini --pre=etc/cipango-jmx.xml etc\cipango-callflow.xml

Using the console

The console is available at the fllowing URL: http://localhost:8080/cipango-console/

Replace localhost:8080 by the host and port set for HTTP configuration

Authentication

Authentication is enabled by default.

The default login is jetty with password jetty

Login and password could be changed by editing the file $jetty.home/etc/realm.properties like described in Jetty realms.