Search
The Open Source SLEE and SIP Server

Mobicents Sip Servlets

This page is obsolete : More detailed and better looking installation instructions are available from the Mobicents Sip Servlets User Guide

Throughout this page you can click on the images to see them larger.

Description

Jopr is an enterprise management solution for JBoss middleware projects and other application technologies. This pluggable project provides administration, monitoring, alerting, operational control and configuration in an enterprise setting with fine-grained security and an advanced extension model. It provides support for monitoring base operating system information on six operating systems as well as management of Apache, JBoss Application Server and other related projects.

See the jopr website for more information
or See the jopr embedded website

This documentation provides information on how to enable the management of Mobicents Sip Servlets Servers through Jopr with our custom Jopr plugin.
Note that 2 versions of Jopr are available. One embedded which is more targeted to dev environment and the full one more targeted for production envrionment, We will showcase both throughout this documentation page

Features

With the Mobicents Sip Servlet jopr plugin, you can currently see metrics related to your deployed applications and manage the SipApplicationDispatcher which is a central piece in the Mobicents Sip Servlets Architecture since it has the responsibility of dispatching the SIP requests and responses (that is gets from the underlying jain-sip stack) to the deployed Sip Servlets applications.

On the SipApplicationDispatcher, you can define the Concurrency

and Congestion Control settings

(More information on Mobicents Sip Servlets Concurrency and Mobicents Sip Servlets Congestion Control ) and also you can see graphically the total number of SIP requests/responses processed by the server, the number of pending messages to be processed in all queues and the current percentage of memory used by the container.

On your deployed applications, you can see http (since your applications can be converged applications) and sip metrics.
Regarding the http metrics, you can get the same ones as those provided by the Tomcat Jopr plugin
Regarding the SIP metrics, for each application, be it a pure SIP application, a converged HTTP/SIP application or a SIP application embedded in an EAR, you can see the following metrics :

  • Currently Active Sip Sessions and Sip Application Sessions
  • Maximum number of Active Sip Sessions and Sip Application Sessions
  • Number of sip sessions created for the sipapp and Sip Application Sessions
  • Number of expired sip sessions and Sip Application Sessions
  • Number of sip sessions and Sip Application Sessions rejected
  • Sip Session and Sip Application Sessions Average alive time
  • Max Sip Session and Sip Application Sessions alive time

Installation Instructions

Jopr for Development

The Embedded Jopr called also JBoss Administration console is available from here and works with Mobicents Sip Servlets starting from version 0.7.
If you want to install it from the source, follow those instructions :

  • Follow the Embedded Jopr installation instructions to install the latest version of Embedded Jopr.
  • Instead of dropping the embedded-jopr.war in $JBOSS_HOME/server/default/ directory, create a directory called embedded-jopr.war in $JBOSS_HOME/server/default/deploy directory and unzip the embedded-jopr.war in it
  • Get the Mobicents Sip Servlets Jopr Plugin from the source code : svn checkout http://mobicents.googlecode.com/svn/trunk/servers/sip-servlets/jopr-plugin mss-jopr-plugin
  • In mss-jopr-plugin, do a mvn clean install
  • Then copy the generated jopr-mobicents-sip-servlets-plugin-1.1-SNAPSHOT.jar from the target directory to the $JBOSS_HOME/server/default/deploy/embedded-jopr.war/plugins/
  • Start your JBoss Application Server (you can start it on localhost)

Jopr for Production

Note that those instructions works equally to install the Mobicents Sip Servlets Jopr plugin for RHQ or JON

  • Follow the jopr installation instructions to install the latest version of jopr.
  • Stop the jopr server and agent if they are running
  • Get the Mobicents Sip Servlets Jopr Plugin from the source code : svn checkout http://mobicents.googlecode.com/svn/trunk/servers/sip-servlets/jopr-plugin mss-jopr-plugin
  • In mss-jopr-plugin, do a mvn clean install
  • Then copy the generated jopr-mobicents-sip-servlets-plugin-1.1-SNAPSHOT.jar in the target directory to the jopr-server-2.1.0.GA/jbossas/server/default/deploy/rhq.ear/rhq-downloads/rhq-plugins/
  • Start the jopr server then the agent
  • Start your JBoss Application Server in making sure that you specify the binding address when starting such sh run.sh -b 192.168.0.10 (the JBoss AS will not get recognized on localhost)

Usage Instructions

Jopr for Development

  • Log in to the jopr console on and login as admin (user=admin, password=admin)
  • From the tree on the left side of the screen, under Services , click on MobicentsSipServlets link then click on the jboss.web:type=SipApplicationDispatcher link to see the metrics coming in.
  • To get the metrics coming in, you will need to use an example application such as location service by example so that the SipApplicationDispatcher process requests.
  • To see Metrics about your application, click on your application under Converged SIP/Web Application (SAR/WAR) link.
  • Then select the Metrics tab to actually see the metrics of your application.

Jopr for Production

Note that those instructions works equally to use the Mobicents Sip Servlets Jopr plugin for RHQ or JON

  • Log in to the jopr console on and from the Dashboard Tab, in the Auto Discovery portlet, import your server (by example deruelle-laptop JBossAS 4.2.3.GA default (192.168.0.12:1099)) from under localhost.
  • Then from the Dashboard, in the Recently Added Resources portlet, click on the server,
  • Then on the new Monitor view click on the JBossWeb Server link
  • Then click on the SipApplicationDispatcher link to see the metrics coming in.
  • To get the metrics coming in, you will need to use an example application such as location service by example so that the SipApplicationDispatcher process requests.
  • To see Metrics about your application, click on the Converged SIP/Web Application (SAR/WAR) link.
  • Then click on your application.
  • You will need to click on the Configure link for the Monitor Tab to select the metric data you want to see
  • and then select the MetaData tab to actually see the metrics of your application.

Mobicents Sip Servlets

Overview
Documentation
Frameworks
Examples
Contribute
Community