The information on this page has been converted into XML user documentation.  The information may be outdated.  Refer to the JAIN SLEE Server User Guide for detailed information regarding the Converged Demo.

The idea is to have a converged application that shows how JEE application can leverage Mobicents to have voice, message and data transfer seamlessly. This example is built using the Seam and JAIN SLEE service deployed on Mobicents.

Converged Application makes use of Sip RA, TTS RA and MediaRA

1. Application Flow 

• Once User places an order, he/she receives call to confirm for the same.
• User presses 1 and order state remains as OPEN and flow continues. If User presses 2 order gets CANCELLED and flow completes

• If order is less than 100$ it gets approved automatically as per the rule set by jBPM and User receives call to set delivery date and time.

• If order is greater than 100$, Admin has to either approve or reject the order.

• If Admin doesn't log on the site and take necessary action, call is initiated to Admin and Admin preses DTMF to take necessary action
• Admin presses 1 and order state changes to PROCESSING and flow continues. If Admin presses 2 order gets CANCELLED and flow completes.
• User id for Admin is 'manager' and password is 'password'
  

• Once order is approved by Admin, a call is initiated to User to set the date and time for delivery
• Please note that for orders greater than 100$ call to User to set delivery date and time is only initiated if Admin logs on to system and approves. This is becuase the logic is tied with jBPM process and I haven't yet taken care that in SBB.
  

• User sets delivery date and time by punching numbers on his/her phone. As soon as this is done user can see the delivery date and time set on 'My Orders' tab and click on 'Show Details' for corresponding order.

• Once again the ball roles on to Admin, and he/she has to log in the site and mark the order for Shipping

• As soon as Admin marks the order for Shipping, call is initiated to User to remind him/her date and time when the shipment will arrive.

2. Binary

 

To Download the Mobicents binary follow the link
http://forums.java.net/jive/thread.jspa?threadID=41451

2.1 Folder Structure

The Mobicents v1.2.0.BETA3 parent folder contains

/jboss-4.2.2.GA : Contains the Mobicents core, Mobicents Management Console (MMC) and Media Server as service on top of JBoss AS 4.2.2.GA
/resources        : Contains the Resource Adaptors shipped with this binary
/examples        : Contains the converged-demo example along with other examples

 

2.2 Steps to deploy the application

 

• Start the server. Open console, go to mobicents-all-1.2.0.BETA3-jboss-4.2.2.GA/jboss-4.2.2.GA/bin and type ./run.sh -c default -b <the ip address of your m/c> (For win OS c:\run -c default -b ip)
• Open console and go to mobicents-all-1.2.0.BETA3-jboss-4.2.2.GA/examples/converged-demo. Type 'ant deploy-all' and it will deploy the example as well as all related RA's too (SIP, media, tts) and will also deploy the ShoppingDemo-dev-ds.xml (ds specific for this example)

Once the server is started point your browser to http://jboss bind address:8080/ShoppingDemo/ and do the shopping :) 

Before shopping create a new account (does not matter what username/password you choose in first step) and make sure that you enter the SIP address for Phone field as shown in diagram below (sip:abhayani@10.65.6.188:5059)

 

Note : The admin SIP Address in binary is hard coded to sip:abhayani@127.0.0.1:5059. So if you are testing with two sip phones please make sure that Admin is logged in as 'sip:abhayani@127.0.0.1:5059' on your SIP Phone on same machine as that of Mobicents Server. Example can also be tested with one SIP Phone only as users in which case there will be no calls to Admin.

 

For SIP Phone settings look at link  SIP Phone Settings for Converged Demo 

 

 

 
 

• After creation of account once you check out the cart a call will be received on SIP Phone for confirmation.

 

• You can check your Order Status via 'My Orders' tab
• After 300000 milli secs ( value specified for order.approval.waitingtime in convergeddemo.properties ) call is received by Admin to confirm the order for Shipping or Cancel
  

 

3. From the Source 

3.1 Where is the code? 

Check out the http://mobicents.googlecode.com/svn/trunk/
 

The checkout project should have
/docs
/release
/servers
/tools

We are interested in
/servers/jain-slee/examples/converged-demo
/servers/jain-slee/resources/media
/servers/jain-slee/resources/sip
/servers/jain-slee/resources/persistence
/servers/jain-slee/resources/tts

 

3.2 Folder Structure of converged-demo

/pojo       : Contains the EJB3 Entity beans used by SBB for persistence
/release  : Used for binary release
/slee       : Contains all the SBB and Mobicents Service related code
/utility     : The utility classes used by SBB's
/Web      : Contains all SEAM (web) related code
build.xml : Build file
example.properties : Properties file to configure the environment for demo

 

Mobicents is now ported to maven. Follow the link to set up maven http://groups.google.com/group/mobicents-public/web/quick-start-guide-with-maven-2

 

3.3 Steps to start the Shopping Demo

• Start your JBoss AS with Mobicents

•  

  • Note : Before starting JBoss AS make Arjuna Transaction capable of handling multiple one phase resources. For this you need to set 'com.arjuna.ats.jta.allowMultipleLastResources' property to 'true' in jboss-4.2.0.GA/server/all/conf/jbossjta-properties.xml. For example

    <properties depends="arjuna" name="jta">

       <property name="com.arjuna.ats.jta.allowMultipleLastResources" value="true"/>

       ......

      ...........

      .................

    </properties>

 

Follow link http://wiki.jboss.org/wiki/Wiki.jsp?page=Multiple1PC if you want to know more about Multiple 1 Phase Commit

 

Note : Remember to set JBOSS_HOME system property

• Deploy sip RA

• sip RA should be deployed by calling 'mvn install'
  
• By default sip RA will bind to address used to start JBoss AS
  

• Deploy media RA

MediaRA should be deployed by calling 'mvn install' from /servers/jain-slee/resources/media

 

• Deploy persistence RA 

persistence RA should be deployed by calling 'mvn install' from /servers/jain-slee/resources/persistence

 

• Deploy tts RA

tts RA should be deployed by calling 'mvn install' from /servers/jain-slee/resources/tts

 

• Configuration changes for demo SBB Services

Look at convergeddemo.properties for explanation

For SIP Phone settings look at link  SIP Phone Settings for Converged Demo

 

• Deploy converged-demo
  

• Deploy the Mobicents Furniture Demo by calling 'mvn install' from /servers/jain-slee/examples/converged-demo
  

• Do the shopping :)