GETTING STARTED

In order to work with Mobicents source code you need to download and install the following technologies: 

	·         Sun JDK 1.5+ from http://java.sun.com (or from a Linux repository) 

·         Ant 1.7.0+ from http://ant.apache.org

·         Maven 2.0.9+ from http://maven.apache.org 

.	JBoss AS 4.x from http://www.jboss.org/jbossas/ (don't forget to setup JBOSS_HOME environment variable)    

·         One Java IDE (see below for configuration) with Subversion support

o        Eclipse 3.1+ from http://www.eclipse.org (recommended) 

o        Install one Subversion team support plugin:

§         Subversive plugin from http://www.polarion.org

§         Subclipse plugin from http://subclipse.tigris.org

o        Install Web Tools from http://www.eclipse.org for XML support (or MyEclipse)

·         One separate Subversion client (optional if already supported in the IDE) It's possible and even handy to combine multiple Subversion clients.

o        Subversion (shell client) from http://subversion.tigris.org

o        Tortoise for Windows explorer from http://tortoisesvn.tigris.org

o        Any Subversion client referenced in Links on http://subversion.tigris.org

o        Getting the sources for mobicents from http://code.google.com/p/mobicents/source/checkout

o        Getting the source for mobicents plugins from https://mobicents-svn.dev.java.net/svn/mobicents-svn/plugins/  

CHECKOUT & BUILDING 

When checking out first decision is whether you want the sources for the whole Mobicents platform or just a specific server. To checkout all mobicents modules get the Mobicents sources from the SVN repository in Google Code (http://code.google.com/p/mobicents/source/checkout), if you just want a server then add "servers/" and the server name (media, sip-presence or sip-servlets).

 

Note that currently the jain-slee trunk is unstable code, due to version 2.x developments, thus if you want to build this server from source you should checkout instead the last version tag (e.g. /tags/mobicents-jainslee-server-1.2.1.GA) or the 1.x series branch at /branches/servers/jain-slee/1.x.y.

To build the Mobicents JAIN SLEE 1.2.x server do mvn install in servers/jain-slee.

Maven will build the Mobicents JAIN SLEE Core and Tools, installing the binaries into your local Maven 2 repository and into JBoss AS. Note that the first time you run maven it will download all dependencies and cache them in your local repository,  this operation can take "some" time and may even not work at all due to connection problems. If you get an error please try again until it succeeds.

Mobicents comes pre-configured for JBoss AS default server configuration, if you need to use a different one please use <node<default</node> property in the Mobicents project root pom.xml, or redefine it in servers/jain-slee pom.xml.

To uninstall Mobicents from JBoss just run mvn clean

Besides the Mobicents Core and Tools the server also includes Resource Adaptors and Examples, generally to build and deploy a component you run  mvn install, and to uninstall and clean a component you run  mvn clean.

Some of the most used examples depend on Mobicents Media Server, thus those can be found in servers/media directory tree.

Ant scripts are also provided to complex components that require other components deployed. As an example, Converged Demo requires the Mobicents Media Server and multiple Resources Adaptors installed, the ant script deploys/undeploys everything using ant deploy-all or ant undeploy-all. 

 

Regarding building other servers, please follow link for instructions:

Mobicents Media Server

Mobicents Presence Server (part of SIP Presence Service)

Mobicents Sip Servlets

Mobicents XDM Server (part of SIP Presence Service)

CONFIGURING YOUR FAVORITE IDE

 ECLIPSE

1. Make sure Eclipse is CLOSED to add M2_HOME variable. Do this by executing

 

• mvn -Declipse.workspace=YOUR_RELATIVE_PATH_TO_ECLIPSE_WORKSPACE eclipse:add-maven-repo

2. Open Eclipse, in the File menu select Import, then "General->Existing Projects into Workspace", next and finally browse to select the project(s) you want to add. Each server has their own Eclipse project on its root directory (servers/jain-slee, servers/media, servers/sip-presence). For sip-servlets please see its documentation.

3. If it's your first checkout you probably now have project(s) full of errors due to referenced libraries missing, that's ok, open command line in each project root folder and do

• mvn mobicents:eclipse

This command will fetch all libraries from remote Maven repositories into your local Maven repository. If it fails due to not finding a specific dependency please try again, probably you had a network error in Maven.

 

If your favorite IDE is not Eclipse you may have a little more work to do:        

o        NetBeans

o        see http://maven.apache.org/netbeans-module.html

o        IntelliJ IDEA

o        see http://maven.apache.org/plugins/maven-idea-plugin/