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

• 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

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

• Media Resource Adaptor - A basic JMF based Media RA and an MGCP RA.

• Media Gateway for media processing

Resource Adaptors currently in development

Additional Resource Adaptors notes

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

• SMPP Resource Adaptor for SMS messaging
• MSCML Resource Adaptor using MSCML over SIP to control media server functionality

What are typical Use Cases for Mobicents

See Mobicents Use Cases

What is Mobicents?

Read this overview.

Is Mobicents a SIP Application Server

Yes. Mobicents is a robust container for SIP applications.

• 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.

• Parlay/Parlay-X Resource Adaptor allowing controlled access to Parlay Gateways.

• Diameter Resource Adaptor based on a Java Diameter library by Ivan Skytte Jørgensen
• Media Resource Adaptor based on MGCP, including JMF implementation

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

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.

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 a JBoss software.

• XMPP/Google Talk Resource Adaptor - using the Smack library. Works in Client and Component Server modes.

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.

How to install and run Mobicents?

Follow the Quick Start Guide.

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.

How can I get involved?

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 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:

Logging

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

Lessons learned

• About SIP addresses and local domains

• SIP Resource Adaptor - using the JAIN SIP RI and extended with basic SIP Registrar and Proxy Services
• XMPP 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.

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.

What Resource Adaptors are available in Mobicents

At present Mobicents offers SIP, XMPP, Asterisk and JCA adaptors. They allow SLEE applications to interact with external sources supporting one of the implemented protocols. The RA source can be found in CVS under /ra.

• 15 SIP calls per second (cps) on single CPU @ 2GHz; Linux
• 50 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 250-300tps.

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

Which JDK version is required?

Mobicents compiles and runs on JDK 1.4 or higher.

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.

How to persist profiles

• Follow this link: Persisting Profiles in Mobicents

Is Mobicents certified for an industry standard VoIP platform?

Which versions of JBoss does Mobicents run on?

Mobicents is currently being built on JBoss 3.2.6. When time permits we would like to make sure that it runs on JBoss AS 4.x as well.

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.

Please, read the essential Mobicents documentation, follow the forums for several days and then post a message with the most specific area you think you can help at. 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 fix bugs and help implement new features. No rush. Only do it if its fun for you.

How can I contribute?

When requesting developer access, include the full text of the agreement with an indication of acceptance. You need to have demonstrated an understanding of the codebase and testsuite by submitting patches for bugs/enchancements before we will grant developer access.

How to deploy a Mobicents component when the server starts up

HOW TO

How to deploy a Mobicents component when the server starts up

• Follow this link: Deploying Mobicents components on server startup

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

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

-- Main.ivelin - May 2005

How about performance?

It is too early to tell. We are designing Mobicents to be scalable and highly available. The only meaningful indication of performance at this time though are the time and memory metrics for TCK runs. It takes about 15 minutes to run all passing (320+) TCK tests. The java process of the Mobicents server stabilizes its memory consumption at around 280MB after one TCK run on Windows XP Pro, Sun JDK 1.4.2.

Which versions of JBoss does Mobicents run on?

Mobicents is currently being built on JBoss 3.2.6. When time permits we would like to make sure that it runs on JBoss AS 4.x as well.

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.

What license is Mobicents distributed under

LGPL, with some exceptions for the NIST contributed code which is under the general public domain. Simply said the most restricting license you need to be aware of is LGPL. Other popular open source software that uses the same license, includes JBoss AS, jgroups, and Hibernate.

How close is Mobicents to JAIN SLEE certification?

As of April 2005, we are at about 70% pass rate for the TCK tests.

How can I help

Read the essential Mobicents documentation, follow the forums for several days and then post a message with the most specific area you think you can help at. 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 fix bugs and help implement new features. No rush. Only do it if its fun for you.

-- Main.ivelin - 17 Apr 2005