Mobicents Frequently Asked Questions

What is Mobicents?

Read this overview.

Is Mobicents a SIP Application Server

Yes. Mobicents is the most popular Open Source SIP Application Server for the Java platform.

How to install and run Mobicents?

Follow the Quick Start Guide.

Is Mobicents certified for an industry standard VoIP platform?

Yes, Mobicents is fully certified for JAIN SLEE 1.0.

Mobicents also implements some of the proposed JAIN SLEE 1.1 features. When SLEE 1.1 is finalized, we will make it a priority to ensure compliance with the new standard.

What license is Mobicents distributed under

See this authoritative text.

Where can I find examples?

There is a number of examples available with incremental complexity. You can find them at the mobicents-examples sub-project.

What Resource Adaptors are available in Mobicents

Resource Adaptors allow SLEE applications to interact with external resources via standard or proprietary protocols. Mobicents provides a number of resource adaptors out of the box:

• SIP Resource Adaptor - using the JAIN SIP RI and extended with basic SIP Registrar and Proxy Services
• XMPP/Google Talk Resource Adaptor - using the Smack library. Works in Client and Component Server modes.
• Asterisk Resource Adaptor - using the Asterisk-Java library.
• Java Call Control (JCC) Resource Adaptor implementing the recommendations in Appendix C of JSR 22 - JSLEE 1.0.
• Parlay/Parlay-X Resource Adaptor allowing controlled access to Parlay Gateways.
• J2EE/JCA Resource Adaptor implementing the recommendations in Appendix F of JSR 22 - JSLEE 1.0.
• Diameter Resource Adaptor based on a Java Diameter library by Ivan Skytte Jørgensen
• Media Resource Adaptor - A basic JMF based Media RA and an MGCP RA.
• SMPP Resource Adaptor for SMS messaging
• Media Gateway for media processing
• HTTP Servlet RA to provide the ease of HTTP request-response programming model in SLEE environment
• HTT Client RA provides the client side HTTP standard within the SLEE environment
• Persistence RA A JPA based RA that uses Hibernate
• XCAP Client RA to allow presence aware applications to connect to a hosting XCAP server
• Rules RA based on JBoss Rules
• TTS RA makes use of FreeTTS^? which is speech synthesis system written entirely in the Java programming language

Resource Adaptors currently in development

• MSCML Resource Adaptor using MSCML over SIP to control media server functionality

Additional Resource Adaptors notes

Other Resource Adaptors are available under commercial licenses by third party vendors. If you are looking for a Resource Adaptor that does not ship with Mobicents, feel free to ask on our public forums.

The source code for the RAs can be found in the core CVS tree under /ra or under a separate mobicents sub-project.

How can I get involved?

It is great to hear that you want to join the team!

The first step is to apply for Observer role. It will grant read access to all project and sub-project resources. You will also be able to subscribe and post messages to the mailing lists and forums. Editing Wiki pages will be enabled as well.

Take some time to read the Essential Mobicents Documents, look at the Roadmap and follow the forums for several days.

When you are ready to take a more active role, post a message with the most specific area you think you can contribute to. Try to be realistic as to the time you can commit to. Updating a wiki page is a valuable contribution, so is reporting a bug. Ultimately we would like to see you submit patches and implement new features. No rush. Only do it if its fun.

In order to contribute code, you will need to apply for Developer role.

You will need to have demonstrated an understanding of the codebase and testsuite by participating in the design discussions and submitting patches for bugs/enchancements before we will grant developer access.

Developer role requires you to accept via email the following contributor agreement: Mobicents Individual Contributor Agreement

Before requesting developer access, send the full text of the agreement with an indication of acceptance to the email address specified at the end of the agreement document. Next, apply for Developer role.

Once your request is approved, please post an introduction message to the contributors forum. Tell us about your background and your motivation to join the Mobicents contributors team.

Optionally you can also join some of the mailing lists, which provide email notifications and archive for CVS check-ins, issue tracking, and continuous build&test reports.

Mobicents Users Forum

If you have questions about using Mobicents, please direct them to the Mobicents Users Forum.

Mobicents Contributors Forum

If you want to discuss new design ideas or enhancements to Mobicents, please post on the Mobicents Contributors Forum.

Bug Reports, Patches & Feature Requests

You can use the issue tracking system for bug reports and feature requests for Mobicents. Please be respectful and do your homework. Make sure that the issue you are about to post has not been reported before.

Please submit patches in

patch

When you report a bug, you will significantly improve the chances of someone looking at it, if you also submit an automated test case in TCK format or JUnit that exposes the problem. Read this brief tutorial explaining How to Write a Test Case.

Which JDK version is required?

Mobicents compiles and runs on JDK 1.5 or higher.

Is Mobicents based on the JSLEE Reference Implementation?

No. Mobicents is a clean room JSLEE implementation. It has no dependencies on the JSLEE RI.

Mobicents does leverage the JBoss microkernel and can run alongside the JBoss J2EE^? Application Server.

Which versions of JBoss does Mobicents run on?

Mobicents is currently being tested with JBoss AS 4.2.x.

What JBoss components does Mobicents use?

Mobicents uses the following JBoss components:

• JMX Microkernel for core service IoC and management
• JNDI for SLEE service registration
• JTA for Transaction Management
• TreeCache^? for High Availability state replication

Mobicents DOES NOT use EJB nor JMS as part of the core architecture. SBBs and Event Routing are implemented from scratch for light weight, high volume signaling as intended by the JSLEE Expert Group.

Does Mobicents run on other application servers such as WebSphere^?, WebLogic^?, JONAS

We haven't tried. It should be possible, because JBoss allows to be trimmed down to a microkernel and essential Mobicents services. Mobicents itself leverages standard Java APIs for the most part. In a few cases it uses non-standard open source libraries where standard APIs do not exist for the problem at hand.

How about performance?

As of version 1.2b1 we have reports of the following performance results:

• 100 SIP calls per second (cps) on single CPU @ 2GHz; Linux
• 370 SIP calls per second on 4 way Netra 440; Sun/Solaris

Note: 1 SIP cps ~ 5 tps, because each SIP call has 5-6 transactions involved.

So the peak performance reported is around 1000-1200tps.

If you want to verify this for yourself, here is how to set things up: Mobicents benchmarking

Where can I read about best practices for writing applications for SLEE or Mobicents

The following page provides a list of best programming practices: Mobicents/SLEE best practices

What are typical Use Cases for Mobicents

See Mobicents Use Cases

How does JAIN SLEE relate to SIP Servlet and Parlay/OSA

The following resources discuss the subject:

• About JAIN SLEE, SIP Servlets, and Parlay/OSA on Ivelin's blog
• A SLEE for all Seasons; White paper by Open Cloud
• JAIN SLEE and SIP Servlet; White paper at jainslee.org
• JAIN SLEE and OSA/Parlay; White paper at jainslee.org
• Parlay Java API Rulebook Overview;

  Presentation by Kieran McPeake, AePona

• JAIN Overview; Presentation by Sun Microsystems, Japan
• Java in Communications; Presentation by Steven Grover, Sun Microsystems

How to deploy a Mobicents component when the server starts up

• Follow this link: http://code.google.com/p/mobicents/wiki/SleeDeployerFAQ

Interacting with SLEE from Java SE and Java EE

• How to utilize Mobicents connectivity features. Remote connectivity from Java SE and Java EE.

Mobicents Management Console

How to persist profiles

• Follow this link: Persisting Profiles in Mobicents

Logging

• Log4J and the sip RA - How to turn off verbose logging from sip RA

Lessons learned

• About SIP addresses and local domains

-- Main.abhayani - 08 Dec 2007

Test