JBoss.org Community Documentation

Mobicents

User Guide

Abstract

Mobicents is a highly scalable event-driven application server with a robust component model. Mobicents is the first and only Open Source Platform certified for JSLEE 1.0 compliance. It complements J2EE to enable the convergence of voice, video and data in next-generation intelligent applications. Web and SIP can be combined together to achieve more sophisticated and natural user experience.


Preface
1. Document Conventions
2. We Need Feedback!
1. Introduction
1.1. Introduction to the Mobicents Converged Application Server
1.2. Service Building Blocks and Next-Generation Intelligent Networks
1.3. Mobicents Use Cases
2. Installation of the Mobicents Converged Application Server
2.1. Java Development Kit: Installing, Configuring and Running
2.2. Binary Distribution: Installing, Configuring and Running
2.2.1. Pre-Install Requirements and Prerequisites
2.2.2. Downloading
2.2.3. Installing
2.2.4. Configuring (and Setting JBOSS_HOME)
2.2.5. Running
2.2.6. Using
2.2.7. Stopping
2.2.8. Testing
2.2.9. Uninstalling
3. Working with the Mobicents Management Console
3.1. Introduction to the MMC
4. Resource Adapters
4.1. Resource Adapters
4.1.1. Introduction to Resource Adapters
4.1.2. Deploying and Undeploying Resource Adapters
4.2. SIP Resource Adapter
4.2.1. Installing the JAIN SIP Resource Adapter
4.2.2. Configuration of the JAIN SIP Resource Adapter
4.3. The XMPP and Google Talk Resource Adapter
4.3.1. Example: Google Talk Bot
4.4. Asterisk Resource Adapter
4.4.1. Installing the Asterisk Resource Adapter
4.5. J2EE and CA Resource Adapter
4.6. Diameter Resource Adapter
4.6.1. Installing the Diameter Resource Adapter
4.7. Media Resource Adapter
4.7.1. Installing the Media Resource Adapter
4.8. SMPP Resource Adapter
4.8.1. Installing the SMPP Resource Adapter
4.9. Media Gateway Resource Adapter
4.10. JCC INAP Resource Adapter
4.11. HTTP Servlet Resource Adapter
4.11.1. Installing the HTTP Servlet Resource Adapter
4.11.2. Understanding the HTTP Servlet Resource Adapter
4.12. The HTTP Client Resource Adapter
4.12.1. Installing the HTTP Client Resource Adapter
4.12.2. Understanding the HTTP Client Resource Adapter
4.13. Persistence Resource Adapter
4.13.1. Installing the Persistence Resource Adapter
4.14. XCAP Client Resource Adapter
4.14.1. Installing the XCAP Client Resource Adapter
4.15. Rules Resource Adapter
4.15.1. Installing the Rules Resource Adapter
4.16. TTS Resource Adapter
4.16.1. Installing the TTS Resource Adapter
4.17. SAP Resource Adapter
4.18. Third-Party Resource Adapters
5. Mobicents Examples
5.1. Example: End-to-End SIP
5.2. Example: Simple Call-Blocking
6. Mobicents SIP Servlets Server
6.1. Mobicents SIP Servlets Server
6.1.1. Java Development Kit: Installing, Configuring and Running
6.1.2. SIP Servlet-Enabled JBoss Application Server: Installing, Configuring and Running
6.1.3. SIP Servlet-Enabled Tomcat Servlet Container: Installing, Configuring and Running
6.2. Working with the SIP Servlets Management Console
6.3. Advanced Features of Mobicents SIP Servlets
6.3.1. Concurrency and Congestion Control
6.4. High-Availability: SIP Servlets Server Load Balancing, Clustering and Failover
6.4.1. MSS Load Balancer
6.4.2. MSS for JBoss: Clustering Support
6.4.3. MSS for JBoss: Failover Support
6.5. Services for Mobicents SIP Servlets
6.5.1. The Location Service
6.5.2. The Diameter Event-Changing Service
6.5.3. The Call-Blocking Service
6.5.4. The Call-Forwarding Service
6.5.5. The Call-Controller Service
7. Mobicents SIP Presence Service
7.1. Mobicents SIP Presence Service
7.1.1. Architecture of the Mobicents SIP Presence Service
7.1.2. Java Development Kit: Installing, Configuring and Running
7.2. Mobicents XML Document Management Server
7.2.1. Java Development Kit: Installing, Configuring and Running
7.2.2. Installation of the XDM Server
7.2.3. Functional Architecture of the XDM Server
7.2.4. Resources and Further Information about the XDM Server
7.3. Mobicents SIP Presence Server
7.3.1. Java Development Kit: Installing, Configuring and Running
7.3.2. Binary Installation: Installing, Configuring and Running
7.3.3. Functional Architecture of the SIP Presence Server
7.3.4. Resources and Further Information about the SIP Presence Server
7.4. Mobicents_Resource_List_Server
7.4.1. Introduction to the Mobicents Resource List Server
8. Mobicents Media Server
8.1. Mobicents Media Server
8.1.1. Overview of Media Servers
8.1.2. Installation of the Mobicents Media Server
8.2. Mobicents Media Server Architecture
8.2.1. Design Overview and Typical Deployment Scenario
8.2.2. Endpoints
8.2.3. Endpoint Identifiers
8.2.4. Connections
8.2.5. Events and Signals
8.3. MMS Configuration
8.3.1. RTPManager
8.3.2. Announcement Server Access Points
8.3.3. Interactive Voice Response
8.3.4. Packet Relay Endpoint
8.3.5. Conference Bridge Endpoint
8.3.6. MMS STUN Support
8.4. MMS Control Protocols
8.5. MMS Control API
8.5.1. Basic Components of the MMS API
8.5.2. Basic API Patterns: Listeners
8.5.3. Events
8.5.4. MSC API Objects: Finite State Machines
8.5.5. API Methods and Usage
8.6. MMS Event Packages
8.7. MMS Demonstration Example
A. Revision History

Certain words in this manual are represented in different fonts, styles, and weights. This highlighting indicates that the word is part of a specific category. The categories include the following:

Courier font

Courier font represents commands, file names and paths, and prompts .

When shown as below, it indicates computer output:

Desktop       about.html       logs      paulwesterberg.png
Mail          backupfiles      mail      reports

bold Courier font

Bold Courier font represents text that you are to type, such as: service jonas start

If you have to run a command as root, the root prompt (#) precedes the command:

# 
                              gconftool-2 
                           


                        
italic Courier font

Italic Courier font represents a variable, such as an installation directory: install_dir /bin/

bold font

Bold font represents application programs and text found on a graphical interface .

When shown like this: OK , it indicates a button on a graphical application interface.

Additionally, the manual uses different strategies to draw your attention to pieces of information. In order of how critical the information is to you, these items are marked as follows:

Note

A note is typically information that you need to understand the behavior of the system.

Tip

A tip is typically an alternative way of performing a task.

Important

Important information is necessary, but possibly unexpected, such as a configuration change that will not persist after a reboot.

Caution

A caution indicates an act that would violate your support agreement, such as recompiling the kernel.

Warning

A warning indicates potential data loss, as may happen when tuning hardware for maximum performance.

The Mobicents Communication Platform is the best architecture for creating, deploying and managing services and applications integrating voice, video and data across a range of IP and communications networks. The Mobicents Communication Platform drives convergence by leveraging the following four core capabilities.

Core Capabilities of the Mobicents Converged Application Server

Mobicents JAIN SLEE

Mobicents JAIN SLEE provides a highly-scalable event-driven application server with a robust component model and a fault-tolerant execution environment. Mobicents JAIN SLEE is the first and only Open Source Platform certified for JSLEE 1.0 compliance. It complements J2EE to enable the convergence of voice, video and data in next-generation intelligent applications. Web and SIP can be combined together to achieve more sophisticated and natural user experience.

Mobicents Media Server

The Mobicents Media Server is an open sourced server based on the Java Media Framework implementation, and aimed to:

Mobicents Presence (XDM) Server

The first free and open source implementation of an XML Document Management (XDM) server, as defined in the Open Mobile Alliance (OMA) specifications. This functional element of next-generation IP communication networks is responsible for handling the management of users' XML documents stored on the network side, such as presence authorization rules, contact and group lists (also known as resource lists), static presence information, and much more.

The JBoss Microcontainer

The JBoss Microcontainer is the state-of-the-art hosting environment in which higher-level containers reside. It provides service registration, configuration and dependency management, classloading isolation control, package versioning, deployment, thread pooling and many other fundamental building blocks necessary for highly-scalable, fault-tolerant middleware servers.

In the scope of telecommunications' Next Generation Intelligent Networks (NGINs), Mobicents fits in as a high-performance core engine for Service Delivery Platforms (SDPs) and IP Multimedia Subsystems (IMSes).

Mobicents enables the composition of Service Building Blocks (SBBs) such as call control, billing, user-provisioning, administration, and presence-sensing features. The JAIN SLEE [1] specification allows popular protocol stacks such as SIP to be plugged in as resource adapters. The SLEE Service Building Blocks have many similarities to Enterprise Java Beans (EJBs), and naturally accommodate integration with enterprise applications, the Web, Customer Relationship Management (CRM) and Service-Oriented Architecture (SOA) end points.

Out-of-the-box monitoring and management of Mobicents components is achieved via SLEE standard-based Java Management Extensions (JMXes) and Simple Network Management Profile (SNMP) interfaces.

Beyond telecommunications, Mobicents is applicable to a wider variety of problems demanding high-volume, low-latency signaling. Examples include financial trading, online gaming, RFID sensor network integration, and distributed control.

The Mobicents Converged Application Server has a wide variety of use cases, including all of the following domains:

VoIP Call Control Services

Voice-over-Internet Protocol (VoIP) services are some of the primary use cases for Mobicents. Examples of VoIP services include call routing, forwarding, termination, voice mailbox, conferencing and user provisioning.

Instant Messaging Services
Online Multi-Player Games

SLEE is a great platform for Massively Multi-Player (MMP games. The following are some of the principle requirements for MMP servers, provided by the leader of Java.net Games community:

  1. Worst-case latencies from end-to-end in the back-end system, including all database operations, of no more than 100 ms.

  2. A programming model that allows the game programmer to program simple persistent objects, with no more work than any other standard Java object, and have them execute on data events coming into the system. These objects must be "real objects" in the simulation sense of the term.

  3. A programming model that is optimistically parallel while appearing to the programmer as a single-threaded event-driven model. Each event has to be ACID-transactional (Atomicity, Consistency, Isolation, Durability), and atomic unto itself. The programmer cannot be required to be aware in any way of multiple threads, database access, or locking. It must be inherently and transparently race-condition-proof and deadlock-proof.

  4. It must scale to massive numbers of simultaneous users (5-to-6 figures) online simultaneously accessing the same database of objects.

  5. It needs to provide failover, fault-tolerance and efficient load-balancing. The last is critical. Game applications are cost-sensitive. Without the ability to load-balance the potentially heavy loads of multiple apps over banks of low-cost computers used to maximal efficiency, the economic model falls apart.

If you are familiar with SLEE, then you have already noticed that these requirements closely track the fundamental SLEE design principles.

Here are some pointers to books, blogs and papers on the subject of Massive Multi-Player games:

Financial Day Trading

Financial trading is a well-understood problem domain demanding highly-available, fast-response technology to serve billions of trading calls per day. Each trading call is a concise message identifying the trader, ticker and price. Day trading applications fit nicely on top of event-driven containers.

First Responder Communication Networks

We live in an unsafe world. Project P25 is focused on public safety communications digital radio interoperability. It is spurred on by growing concern which has driven many countries' governmentsincluding the US Federal Governmentto reorganize in order to create focused positions to address homeland security. The National Institute of Standards and Technology (NIST) is building a test system for Radio-Frequency subsystem interoperability Standard, which is based on these three protocols: the Session Initiation Protocol (SIP), the Service Discovery Protocol (SDP), and the Real-time Transport Protocol (RTP). The reference implementation and test system will be built as SLEE services.

Sensor Network Integration and RFID

Gartner predicts that sensor technologies will be part of our everyday life by the year 2015. Sensors will be everywhere: as RFID tags on consumer products, devices monitoring tire pressure, location-tracking tags carried by workers in sensitive or hazardous environments, etc. In addition, all enterprise activities will be monitored using enterprise tools connected to the network; by 2010 these, as embedded Internet devices, will represent 95% of all Internet-connected systems.

Pervasive sensor technologies will transform the objective of IT from providing support for fundamentally manual processes to automating the execution of tasks in response to a continuously-changing environment monitored by sensors. This requires a new kind of architecture capable of delivering extreme transaction processing.



[1] JAIN SLEE stands for Java API for Intelligent Network Service Logic and Execution Environment architecture. JSLEE (Java Service Logic Execution Environment) is a short synonym for JAIN SLEE.

The Mobicents Converged Application Server can be installed by downloading the ready-to-go binary distribution, or, alterately, the source code can be obtained using the Subversion version control system (VCS) and then Mobicents can be built from source. Installing the binary distribution is recommended for most users, and obtaining and building the source code distribution is recommended for those who want access to the latest revisions and capabilities.

Mobicents is written in Java; therefore, before running any Mobicents server, you must have a working Java Runtime Environment (JRE) or Java Development Kit (JDK) installed on your system. In addition, the JRE or JDK you are using to run Mobicents must be version 5 or higher[2].

Should I Install the JRE or JDK?

Although you can run the Mobicents servers using the Java Runtime Environment, we assume that most Mobicents users are developers interested in developing Java-based, Mobicents-driven solutions. Therefore, in this guide we take the tact of showing how to install the full Java Development Kit.

Should I Install the 32-Bit or the 64-Bit JDK, and Does It Matter?

Briefly stated: if you are running on a 64-Bit Linux or Windows platform, you should consider installing and running the 64-bit JDK over the 32-bit one. Here are some heuristics for determining whether you would rather run the 64-bit Java Virtual Machine (JVM) over its 32-bit cousin for your application:

  • Wider datapath: the pipe between RAM and CPU is doubled, which improves the performance of memory-bound applications when using a 64-bit JVM.

  • 64-bit memory addressing gives virtually unlimited (1 exabyte) heap allocation. However large heaps affect garbage collection.

  • Applications that run with more than 1.5 GB of RAM (including free space for garbage collection optimization) should utilize the 64-bit JVM.

  • Applications that run on a 32-bit JVM and do not require more than minimal heap sizes will gain nothing from a 64-bit JVM. Barring memory issues, 64-bit hardware with the same relative clock speed and architecture is not likely to run Java applications faster than their 32-bit cousin.

Note that the following instructions detail how to download and install the 32-bit JDK, although the steps are nearly identical for installing the 64-bit version.

Downloading

You can download the Sun JDK 5.0 (Java 2 Development Kit) from Sun's website: http://java.sun.com/javase/downloads/index_jdk5.jsp. Click on the Download link next to "JDK 5.0 Update <x>" (where <x> is the latest minor version release number). On the next page, select your language and platform (both architecture—whether 32- or 64-bit—and operating system), read and agree to the Java Development Kit 5.0 License Agreement, and proceed to the download page.

The Sun website will present two download alternatives to you: one is an RPM inside a self-extracting file (for example, jdk-1_5_0_16-linux-i586-rpm.bin), and the other is merely a self-extracting file (e.g. jdk-1_5_0_16-linux-i586.bin). If you are installing the JDK on Red Hat Enterprise Linux, Fedora, or another RPM-based Linux system, we suggest that you download the self-extracting file containing the RPM package, which will set up and use the SysV service scripts in addition to installing the JDK. We also suggest installing the self-extracting RPM file if you will be running Mobicents in a production environment.

Installing

Important

You do not need to install a -compat package in addition to the JDK if you installed the self-extracting RPM file! The -compat package merely performs the same SysV service script set up that the RPM version of the JDK installer does.

Configuring

Configuring your system for the JDK consists in two tasks: setting the JAVA_HOME environment variable, and ensuring that the system is using the proper JDK (or JRE) using the alternatives command. Setting JAVA_HOME usually overrides the values for java, javac and java_sdk_1.5.0 in alternatives, but we will set them all just to be safe and consistent.

Setting the JAVA_HOME Environment Variable

After installing the JDK, you must ensure that the JAVA_HOME environment variable exists and points to the location of your JDK installation.

Setting the JAVA_HOME Environment Variable on Linux

You can determine whether JAVA_HOME is set on your system by echoing it on the command line:

~]$ echo $JAVA_HOME

If JAVA_HOME is not set already, then you must set its value to the location of the JDK installation on your system. You can do this by adding two lines to your personal ~/.bashrc configuration file. Open ~/.bashrc (or create it if it doesn't exist) and add a line similar to the following one anywhere inside the file:

export JAVA_HOME="/usr/lib/jvm/jdk1.5.0_<version>"

You should also set this environment variable for any other users who will be running Mobicents (any environment variables exported from ~/.bashrc files are local to that user).

Setting the JAVA_HOME Environment Variable on Windows
Setting java, javac and java_sdk_1.5.0 Using alternatives
Selecting the Correct System JVM on Linux

On systems with the alternatives command, including Red Hat Enterprise Linux and Fedora, you can easily choose which JDK (or JRE) installation you wish to use, as well as which java and javac executables should be run when called.

As the root user , call /usr/sbin/alternatives with the --config java option to select between JDKs and JREs installed on your system:

root@localhost ~]$ /usr/sbin/alternatives --config java

There are 3 programs which provide 'java'.

  Selection    Command
-----------------------------------------------
   1           /usr/lib/jvm/jre-1.5.0-gcj/bin/java
   2           /usr/lib/jvm/jre-1.6.0-sun/bin/java
*+ 3         /usr/lib/jvm/jre-1.5.0-sun/bin/java


Enter to keep the current selection[+], or type selection number:

In our case, we want to use the Sun JDK, version 5, that we downloaded and installed, to run the java executable. In the alternatives information printout above, a “plus” (“ + ”) next to a number indicates the one currently being used. As per alternatives' instructions, pressing Enter will simply keep the current JVM, or you can enter the number corresponding to the JVM you would prefer to use.

Repeat the procedure above for the javac command and the java_sdk_1.5.0 environment variable, as the root user :

~]$ /usr/sbin/alternatives --config javac
~]$ /usr/sbin/alternatives --config java_sdk_1.5.0
Testing

Finally, to make sure that you are using the correct JDK or Java version (5 or higher), and that the java executable is in your PATH, run the java -version command in the terminal from your home directory:

~]$ java -version
java version "1.5.0_16"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.5.0_16-b03)
Java HotSpot(TM) Client VM (build 1.5.0_16-b03, mixed mode, sharing)
Uninstalling

There is usually no reason (other than space concerns) to remove a particular JDK from your system, given that you can switch between JDKs and JREs easily using alternatives, and/or by setting JAVA_HOME.

Uninstalling the JDK on Linux

On RPM-based systems, you can uninstall the JDK using the yum remove <jdk_rpm_name> command.

Uninstalling the JDK on Windows

On Windows systems, check the JDK entry in the Start menu for an uninstall command, or use Add/Remove Programs.

The Mobicents JAIN SLEE Server binary distribution is comprised of—and comes bundled with—all of the following components:

  • the JBoss Application Server, version 4.2.2 GA

  • the Mobicents JAIN SLEE Server

  • the Mobicents Media Server

  • the Mobicents SIP Servlets Server

  • the Mobicents SIP Presence Service

  • a large number of resource adapters

  • multiple demonstration examples

When you download the Mobicents JAIN SLEE Server binary distribution, you can also choose to verify the integrity of the zip file you download, which is both preferred and safer. If you are setting up Mobicents in a production environment (as opposed to, say, merely playing around with Mobicents' capabilities on your personal machine), we recommend verifying the integrity of the downloaded distribution. The first procedure following shows you how to simply download the Mobicents JAIN SLEE Server binary distribution, while the second procedure following details how to download and verify the installation zip file.

Procedure 2.3. Downloading Without Verifying

Procedure 2.4. Downloading and Verifying

  1. The preferred—and safer—way to obtain the JAIN SLEE Server binary distribution is to download the binary zip file as well as its corresponding sha1 file, and use the sha1 file to verify the integrity of the zip file. To do this, first go to http://www.mobicents.org/jainsleedownload.html and, at the top of the page, click on the here in “Browse all files here ” link. The most recent releases are located near the top. Download both the zip file and its attendant sha1 file. For example, if you wanted to download the Mobicents JAIN SLEE Server version 1.20 Release Candidate 1, you would download both of the following files:

    • mobicents-all-1.2.0.CR1-jboss-4.2.2.GA.zip

    • mobicents-all-1.2.0.CR1-jboss-4.2.2.GA.zip.sha1.asc

  2. Next, verify the integrity of the zip file with the sha1 file, which contains a checksum which is used to do precisely this, and which can alert you if the file has been changed since it was uploaded, or if it was corrupted upon download.

    On a Linux system you can use the sha1sum command to verify the integrity of the binary distribution zip file.

    On a Windows system you will need to download a sha1sum-generating program such as the sha1sum.exe program. This program will generate a checksum that you can compare with the sum in the sha1 file.

    If the two checksums are identical, then the downloaded binary distribution zip file's integrity is assured, and it is safe to proceed with installation.

    Beware of a Corrupted or Compromised Zip File!

    If the two checksums are not identical, it means that the downloaded zip file was corrupted upon download, or has been changed since it was last uploaded to the server. In this case, you should first re-download the two files (the zip file and the sha1 file) and compare once more. If this second comparison fails, it could indicate a problem with the install file, and you should contact the Mobicents team by email to alert them to the conflict.

Once the requirements and prerequisites have been met and you have downloaded the binary distribution zip file, you are ready to install Mobicents. Follow the instructions below for your platform, whether Linux or Windows.

Procedure 2.5. Installing the Mobicents Binary Distribution on Linux

  1. First, move to the directory to which you downloaded the binary distribution zip file. For this example, we'll assume you're currently in your home directory, and that you downloaded the zip file to a subdirectory of it, referred to as <downloads>.

    ~]# cd <downloads>
  2. In <downloads>, create a subdirectory to hold the unzipped Mobicents files. It is good practice to include the version number in this directory name; if you do so, remember to correctly match it with the version of the Mobicents binary distribution you downloaded.

    <downloads>]$ mkdir "mobicents-<version>"
  3. Move the downloaded zip file into the directory you just created:

    <downloads>]$ mv "mobicents-jainslee-server-1.2.0.CR2-jboss-4.2.2.GA.zip" "mobicents-<version>"
  4. Move into that directory:

    <downloads>]$ cd "mobicents-<version>"
  5. Finally, use Java's jar -xvf command to extract the contents of the zip file into the current directory, thus completing the install:

    mobicents-<version>]$ jar -xvf "mobicents-jainslee-server-1.2.0.CR2-jboss-4.2.2.GA.zip"
    • Alternatively, if Linux's unzip utility is present on your system or is installable, you can use it in lieu of Java's jar -xvf command:

      mobicents-<version>]$ unzip "mobicents-jainslee-server-1.2.0.CR2-jboss-4.2.2.GA.zip"

      Tip

      You can also use unzip's -d <unzip_to_location> option to extract the zip file's contents to a location other than the current directory.

  6. To free disk space, you may want to delete the zip file once you've extracted its contents:

    mobicents-<version>]$ rm "mobicents-jainslee-server-1.2.0.CR2-jboss-4.2.2.GA.zip"

Procedure 2.6. Installing the Mobicents Binary Distribution on Windows

  1. For this example, we'll assume that you downloaded the binary distribution zip file to the My Downloads folder. First, using Windows Explorer, create a subfolder in My Downloads to extract the zip file's contents into. When you name this folder, it is good practice to include the version number; if you do so, remember to correctly match it with the version of the Mobicents binary distribution you downloaded. In these instructions, we will refer to this folder as mobicents-<version>.

  2. Double-click the downloaded zip file, selecting as the destination folder the one you just created to hold the zip file's contents.

  3. At this point, you may want to move the folder holding the Mobicents binary files (in this example, the folder named mobicents-<version>) to another location. This step is not strictly necessary, but it is probably a good idea to move the Mobicents folder from My Downloads to a user-defined location for storing runnable programs. Any location will suffice, however.

  4. You may also want to delete the zip file after extracting its contents in order to free disk space:

    C:\Users\Me\My Downloads\mobicents-<version>delete "mobicents-jainslee-server-1.2.0.CR2-jboss-4.2.2.GA.zip"

Configuring the Mobicents JAIN SLEE Server consists in setting the JBOSS_HOME environment variable.

Before running the Mobicents server you are installing, you should consider if you need to set the JBOSS_HOME environment variable. Setting it (or re-setting it to the new value) will always work. Whether or not you need to set JBOSS_HOME depends on the following factors:

  • If you are installing a binary Mobicents server and JBOSS_HOME is not set on your system, then you do not need to set it, but doing so will do no harm.

  • If you are installing a binary Mobicents server and JBOSS_HOME is (already) set on your system, then you need to make sure it points to the location of the new Mobicents server.

  • If you are installing a Mobicents server from source which uses the JBoss Application Server, then you must set JBOSS_HOME.

The following instructions detail how to set JBOSS_HOME on both Linux and Windows.

Once installed, you can run the Mobicents JAIN SLEE Server by executing the one of the startup scripts in the <topmost_directory>/jboss-4.2.2.GA/bin directory (on Linux or Windows), or by double-clicking the run.bat executable batch file in that same directory (on Windows only). However, we suggest always starting the JAIN SLEE Server using the terminal or Command Prompt because you are then able to read—and act upon—any startup messages, and possibly debug any problems that might arise. In the Linux terminal or Command Prompt, you will be able to tell that the JAIN SLEE Server started successfully if the last line of output is similar to the following (ending with “Started in 25s:527ms”):

16:29:15,442 INFO  [ManagementConsole] Mobicents Management Console initialized
16:29:15,551 INFO  [Http11Protocol] Starting Coyote HTTP/1.1 on http-127.0.0.1-8080
16:29:15,586 INFO  [AjpProtocol] Starting Coyote AJP/1.3 on ajp-127.0.0.1-8009
16:29:15,622 INFO  [Server] JBoss (MX MicroKernel) [4.2.2.GA (build: SVNTag=JBoss_4_2_2_GA date=200710221139)] Started in 25s:527ms

Detailed instructions are given below, arranged by platform.

Just as there are multiple ways to run the JAIN SLEE Server, there are multiple ways to stop it. Detailed instructions for stopping the JAIN SLEE Server are given below, arranged by platform. Note that if you properly stop the server, you will see the following three lines as the last output in the Linux terminal or Command Prompt:

16:44:29,745 INFO  [Server] Shutdown complete
Shutdown complete
Halting VM


[2] At this point in time, it is possible to run most Mobicents servers, such as the JAIN SLEE Server, using a Java 6 JRE or JDK. Be aware, however, that presently the Mobicents XML Document Management Server does not. We suggest checking the Mobicents web site, forums or discussion pages if you need to inquire about the status of running the Mobicents XML Document Management Server with Java 6.

Once Mobicents is running, you can access the management console by pointing your browser to http://localhost:8080/management-console/ . If you are working with a remote machine, replace localhost with the name of the remote machine's host, and 8080 with the correct port.

The management console screen has the following components:

  • The Main Menu, on the left.

  • The Current View, on the right.

  • The Log Console, on the bottom.


New views my be selected by clicking on the Main Menu items. The Log Console displays important and relevant notifications when operations are executed, such as error and status messages.

The initial management console view, which can also be accessed by clicking on SLEE at the top of the Main Menu, displays a status message indicating whether Mobicents is currently running or not, and provides controls to start, stop, and shut down the Mobicents Converged Application Server.

Deployable Units

This view can be selected by clicking on Deployable Units from the Main Menu, and shows a list of all deployable units that can be deployed with the Mobicents Converged Application Server.


A tab bar at the top of the view allows one to browse, search for, and install deployable units.

Components

The next view on the Main Menu is the Components view, which displays a list of component types, such as services, SBBs, resource adapters, etc., and their current count. Clicking on a component type will cause the management console to show a list of components for that type. From there, you can click on the different components to see their details.


Services

The Services view shows the list of available services, their state, whether ACTIVE or INACTIVE, and all currently possible actions for that resource adapter, such as activate, deactivate or remove.