Mobicents Sip Servlets -

Mobicents Sip Servlets

Call Forwarding

Service Description

When an INVITE receiving a request, the Call Forwarding service checks if the To address is in the list of hard-coded addresses that needs to be forwarded.

If that's the case, then the application acts as a B2BUA and create a new call leg to the new destination. When the the response will be received from the new call leg, it will ACK it and response to the original call leg. If no Ack is received it should tear down the new call leg with a BYE. When the BYE is received it answers OK directly and 'forwards' the BYE on the new call leg.

The contacts to forward are for now hard-coded addresses, and should later evolve towards a database.

Here is the list of contacts to forward :

sip:receiver@sip-servlets.com
sip:receiver@127.0.0.1

How to activate it

From the binary

You can find the war file corresponding to this example

Mobicents Sip Servlets 2.X : here .
Mobicents Sip Servlets 1.X : here .
Drop the downloaded war file into your tomcat_home/webapps directory or jboss_home/server/default/deploy directory

Get the corresponding dar configuration file .
To understand what the dar configuration file is used for, check the Application Router Documentation .
Drop it in your tomcat_home/conf/dars directory or jboss_home/server/default/conf/dars directory.
To use this dar file for this service, specify in the Service xml tag, darConfigurationFileLocation attribute of the tomcat_home/conf/server.xml file or jboss_home/server/default/deploy/jboss-web.deployer/server.xml , the following :
conf/dars/call-forwarding-b2bua-servlet-dar.properties

You can now run your container (Tomcat or Jboss).

From the source

Please check out the call-forwarding example located under

Mobicents Sip Servlets 2.X : location
Mobicents Sip Servlets 1.X : this location
from the svn repository. Follow the instructions in the README.txt to build and run the example.

How to play with it

Start two SIP Phones of your choice such as one of the account name should be forward-receiver on ip address 127.0.0.1 and port 5090

The SIP phones don't have to be registered.

From the first phone, make a call to sip:receiver@sip-servlets.com you should have the phone "forward-receiver" ringing.