This documentation relates to an unstable version of Cipango.
visit the current release documentation home.
Managing Cipango
JMX
Cipango JMX is based on Jetty JMX.
Since Cipango 3, JMX support is enabled by default as jetty-jmx.xml
is included in start.ini
.
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.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 |
The SNMP module as not been ported to cipango 3 yet
Web Console
The Cipango console is a Web application which allows to monitor Cipango.
The console can be used to display the following informations:
- System status
- SIP, HTTP, Diameter, SNMP configuration
- SIP and HTTP statistics
- SIP and HTTP message logs
- Servlets status and mappings
- System properties
It also allows to perform the following actions:
- Start and stop SIP Servlet applications
- Deploy new SIP Servlet applications
- Activate SIP, HTTP and diameter message logging.
Using the console
The console is available at the following URL: http://localhost:8080/cipango-console/
Replace localhost:8080 by the host and port set for HTTP configuration
Authentication
Authentication is enabled by default and allowed only to user with role admin.
The default login is admin
with password admin
Login and password could be changed by editing the file $jetty.home/etc/realm.properties
like described in Jetty realms.
To disable authentication, the security-constraint
and login-config
elements should be commented in the file src/main/webapp/WEB-INF/web.xml
.