svn co https://slee-sip-ra.dev.java.net/svn/slee-sip-ra/trunk slee-sip-ra

A package can be donwloaded from here: sf.net

1. Chose �Add a new SIP Account�;

• • At the �Domain� field put �nist.gov�;
  • Check the boxes �Register with domain�, �Use as Outbound Proxy� and �Manual Override�;
  • For the �Host� field put the IP Address where Mobicents is running; If the SIP RA is listening in a port different than 5060, you must put the �IP:port�;
  • Uncheck the boxes �Manual Override�. (Check it only if you want to use another port to communicate);
  • After this, check the �Enable this SIP account� box and hit OK

• • For the �Registar domain� field put the IP Address where Mobicents is running; If the SIP RA is listening in a port different than 5070, you must use that port.

$ ant deployall
Buildfile: build.xml

management-init:
     [echo] Mobicents SLEE Management tasks defined

init:

compile-ratype:

compile-ra:

package-ra:
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ra\META-INF
     [copy] Copying 30 files to d:\java\jprojects\slee-sip-ra\stage\ra
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\stage\sip-resource-adaptor.jar
   [delete] Deleting directory d:\java\jprojects\slee-sip-ra\stage\ra

unit-ra:
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ra-unit
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ra-unit\library
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ra-unit\META-INF
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\stage\sip-local-ra.jar
   [delete] Deleting directory d:\java\jprojects\slee-sip-ra\stage\ra-unit

package-ratype:
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ratype\META-INF
     [copy] Copying 2 files to d:\java\jprojects\slee-sip-ra\stage\ratype
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\stage\sip-resource-adaptor-type.jar
   [delete] Deleting directory d:\java\jprojects\slee-sip-ra\stage\ratype

package-events:
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\events\META-INF
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\stage\sip-events.jar
   [delete] Deleting directory d:\java\jprojects\slee-sip-ra\stage\events

unit-type:
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ratype-unit\META-INF
     [copy] Copying 2 files to d:\java\jprojects\slee-sip-ra\stage\ratype-unit
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\stage\ratype-unit\library
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\stage\sip-ra-type.jar
   [delete] Deleting directory d:\java\jprojects\slee-sip-ra\stage\ratype-unit

siprabuild:

deploy:
     [echo] Installing SipRA.
[slee-management] 2007-03-09 17:31:59 org.mobicents.ant.tasks.InstallTask run
[slee-management] INFO: DeployableUnitID[0]
[slee-management] 2007-03-09 17:32:00 org.mobicents.ant.tasks.InstallTask run
[slee-management] INFO: DeployableUnitID[1]
[slee-management] 2007-03-09 17:32:00 org.mobicents.slee.container.management.jmx.SleeCommandInterface invokeOperation
[slee-management] INFO: Loading properties: null
[slee-management] 2007-03-09 17:32:00 org.mobicents.ant.tasks.CreateRaEntityTask run
[slee-management] INFO: No response
[slee-management] 2007-03-09 17:32:00 org.mobicents.ant.tasks.ActivateRaEntityTask run
[slee-management] INFO: No response
[slee-management] 2007-03-09 17:32:00 org.mobicents.ant.tasks.CreateRaLinkTask run
[slee-management] INFO: No response

deployall:

build-sip-proxy-service-jars:
    [mkdir] Created dir: d:\java\jprojects\slee-sip-ra\sip-services\build\sip
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\sip-services\build\sip\registrarsbb.jar
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\sip-services\build\sip\proxysbb.jar
     [copy] Copying 1 file to d:\java\jprojects\slee-sip-ra\sip-services\build\sip
      [jar] Building jar: d:\java\jprojects\slee-sip-ra\sip-services\build\sip\proxyservice.jar
     [move] Moving 1 file to d:\java\jprojects\slee-sip-ra\sip-services\examples
     [echo] SIP Examples Build Dir = ./build/sip

management-init:
     [echo] Mobicents SLEE Management tasks defined

proxy-service-deploy:
[slee-management] 2007-03-09 17:32:01 org.mobicents.ant.tasks.InstallTask run
[slee-management] INFO: DeployableUnitID[2]
     [echo] Proxy Service deployed
[slee-management] 2007-03-09 17:32:01 org.mobicents.ant.tasks.ActivateServiceTask run
[slee-management] INFO: No response
     [echo]  proxy service activated

BUILD SUCCESSFUL
Total time: 4 seconds

For more information:
, please refer to the page:

Comments

Comments on how to bind a proxy with an IP other than 127.0.0.1 and change registar from nist.gov as you want

1. vi $MOBICENTS_HOME/ra/sipra/ra/src/org/mobicents/slee/resource/sip/sipra.properties
make the change: javax.sip.IP_ADDRESS=a.b.c.d //the ip you want to bind with your proxy.

2. vi $MOBICENTS_HOME/ra/sipra/ra/src/org/mobicents/slee/resource/sip/passwords.xml
make the change at the second line: //the original value is nist.gov
a.b.c.d is the registar's IP. Because we will install the registar and proxy on the same mechine a.b.c.d, we have to make such changes.

3. change $MOBICENTS_HOME/thirdparty/sip-services/src/org/mobicents/slee/services/sip/common/SipConfigImpl.java
public String[] getLocalDomainNames() {

return new String[]{"a.b.c.d","ascc.lucent.com","leon.ascc.lucent.com"}; //the original value is "nist.gov",...
}
in the same class, change the host from 127.0.0.1 to a.b.c.d
// private static String host = "127.0.0.1"; the original
private static String host = "a.b.c.d"; //the new value

4. change $MOBICENTS_HOME/thirdparty/sip-services/src/org/mobicents/slee/services/sip/registrar/Registrar.java
private String[] localDomainNames = {"a.b.c.d", "antd.nist.gov", "nist.gov;transport=udp"}; //the original value is "nist.gov"

5. ant clean, ant make, ant auto-deploy-sip, run.sh -c all -b a.b.c.d

6. let two softphones registed on a.b.c.d realm/domain. Then you can make a phone call.

1. Click on New on Profiles Tab and give Profile name: ivelin Your screen should look like this

• Pass the 'ResourceAdaptorID[jainsip#NIST#1.1]' as first parameter
• 'SipRA' as second parameter
• Third parameter can be empty. However if you are leaving third parameter empty you cannot make use of createResourceAdaptorEntity operation which takes String as parameter

Setting up the first phone using SJphone

You can download SJphone from here

Follow these steps:

1. Click on New on Profiles Tab and give Profile name: ivelin Your screen should look like this
2. Enter the info needed in the fields:
   • In SIP Proxy the setting should be as soon in image.
   • At 'Proxy Domain' field put 'nist.gov'
   • At 'User Domain' field put 'nist.gov'
   • Check 'Register with proxy'. Let 'Proxy is strict outbound' be unchecked
   • Check 'Use seprate register'
   • For the ‘Registar domain’ field put the IP Address where Mobicents is running; If the SIP RA is listening in a port different than 5070, you must use that port.
   • Let 'Unregister contact address only' be unchecked
   • Click OK
   • It should ask for Account: Enter ivelin and Password : somepasswd

Your SJphone setting should look like the ones on the following screenshot:

• cd to $MOBICENTS_HOME

• $MOBICENTS_HOME/ra/sipra/stage/sip-ra-type.jar
• $MOBICENTS_HOME/ra/sipra/stage/sip-local-ra.jar
• go to the ResourceAdaptorMBean^? from the main Agent View under slee. * create the Resource Adaptor Entity. Call it SipRA^? give it the property file to configure itself. * Activate it. using Mbean interface. Use the name SipRA^? in the Entity name.

• build and deploy the sip resource adaptor (see previous step ) otherwise this will not work.

Simple SIP PBX - An End to End example with Mobicents;

_DRAFT _

NOTE: In a later version the command changed from proxy-service-deploy to sip-proxy-service-deploy.

The code can be obtained from the Java.net project site: https://jain-sip.dev.java.net/.

There is a good Getting Started page for the viewer. http://snad.ncsl.nist.gov/proj/iptel/src/nist-sip/jain-sip/docs/tools/tracesviewer/README.html

Point the trace viewer to the file debuglog.txt, which can be located in the directory where run.bat (or run.sh) is located. (Yes, this file should be written to the log directory instead. Feel free to submit the patch.)

The trace viewer will generate a diagram, which looks much like a UML sequence diagrams:

Where to download the code?

• ant proxy-service-deploy

SIP - A HTTP-Like Signaling Protocol

Obtaining, Installing and Starting Mobicents

• ant sip-proxy-service-deploy

1. Enter the info needed in the fields:
   • Enter 'ivelin' in these three fields - 'Display name', 'User name' and 'Authorization user name'
   • At the ‘Domain’ field put ‘nist.gov’;

1. Enter "mmsipuser@nist.gov" for Sign-in name

1. Go to File menu, Sign In As: mmsipuser@nist.gov. Click OK.

Here is how to do it step by step.

1. In MS Messenger, go to Actions, start Voice Conversation
2. A dialog may appear with the message "Sorry you have no contacts".
3. Click on the "Other" tab.
4. Enter ivelin@nist.gov
5. Select the SIP service from the drop down menu
6. Click OK.

After a few seconds the eyeBeam client should begin ringing. Pick up the green hand set and try the voice channel.

NOTE: on linux/unix use run.sh instead of run.bat

1. Point your web browser to http://localhost:8080/jmx-console
2. In the text box under "ObjectName Filter", enter slee:*
3. You should see a list of SLEE MBeans. The page should looks like this:

1. Chose ‘Add a new SIP Account’;
2. Put the info needed in the fields;

1. At this point your phone should register with Mobicents;

Follow these steps:

1. Go to SIP settings, Tools/Options/Accounts/SIP.
2. Choose Configure Settings
3. Choose UDP
4. Enter your IP address
5. Click on OK
6. Enter "mmsipuser" for Sing in name
7. Click OK
8. Go to File menu, Sign In As: mmsipuser. Click OK.

If MS Messenger brings up an error dialog, then the phone did not register and you will need to troubleshoot.

Deploying SIP Resource Adaptor

SIP RA deployment manual

Deploying SIP Proxy Service

• ant proxy-service-deploy

An alternative SIP soft client that is distributed for free is the Microsoft Messenger (different than MSN Messenger shipping with Windows). It can be downloaded from http://www.microsoft.com/downloads/details.aspx?FamilyID=A8D9EB73-5F8C-4B9A-940F-9157A3B3D774&displaylang=en. To configure SIP settings, go to Tools/Options/Accounts/SIP.

• Chose ‘Add a new SIP Account’;
• Put the info needed in the fields;
  • At ‘Domain’ field put ‘nist.gov’;
  • Check the boxes ‘Register with domain’, ‘Use as Outbound Proxy’ and ‘Manual Override’;
  • For the ‘Host’ field put the IP Address where Mobicents is running; If the SIP RA is listening in a port different than 5060, you must put the ‘IP:port’;
  • Uncheck the boxes ‘Manual Override’. (Check it only if you want to use another port to communicate);
  • After this, check the ‘Enable this SIP account’ box and hit OK
  • Leave the remaining options (Firewall/NAT, Server-side Storage, etc) with their default values;
• At this point your phone should register with Mobicents;

IP Telephony In the Large

There's two parts to IP Telephony. Call Setup or Signaling and Media. For two phones to communicate, both signaling and media must be standardized. It is important to understand the role of signaling because it is signaling that triggers Services. We will not discuss media in this paper . There are two standardized signaling protocols in wide use in IP Telephony -- SIP and H.323. SIP has gained dominance over H.323 and hence we discuss it here. One should note that the SLEE is able to support a wide variety of signaling protocols including custom protocols such as those used by Skype.

SIP - A HTTP-Like Signaling Protocol

SIP, the Session Initiation Protocol, is a signaling protocol for Internet conferencing, telephony, presence, events notification and instant messaging. SIP was developed within the Internet Engineering Task Force (IETF) MMUSIC (Multiparty Multimedia Session Control) working group, with work proceeding since September 1999 in the IETF SIP working group. SIP is widely deployed. It has been adopted by large coprporations such as Microsoft ( in the MSN Client ) and Cisco and industry consortiums such as 3GPP as the next generation signaling protocol of choice. SIP Can be thought of as a peer to peer adaptation of HTTP / Mail - it borrows headers and mechanisms from these protocols. SIP provides the necessary protocol mechanisms so that end systems and proxy servers can provide services such as call forwarding, personal mobility and terminal capability negotiation. SIP addresses users by an email-like address and re-uses some of the infrastructure of e-mail delivery. SIP addresses (URLs) can also be embedded in web pages.

Java VoIP middleware - An End to End example with Mobicents

Java VoIP middleware - An End to End example

Overview

Components of this example

Mobicents architecture

SIP

SLEE

JBoss

Settting up Mobicents

Testing the Mobicents server

Settting up the phones

Handset settings

Registering presence with Mobicents

Handset settings

Registering presence with Mobicents

Making the Call

Dialing out

Answering

Establishing Conversation

Hanging up

Analyzing the call

Using the SIP Trace Viewer

Hey, it's as simple as HTTP

Closing remarks

Related links

Where to download the code?

Creating a simple PBX with Mobicents

Overview

Mobicents architecture

Components of the Simple PBX

Two Phones

One Mobicents Server

Settting up Mobicents

Obtaining and Installing Mobicents

Starting Mobicents

Checking that Mobicents is up

Monitoring the Mobicents console log

Settting up the phones

Obtaining phones

Setting up the first phone

Phone settings

Registering presence with Mobicents

Setting up the second phone

Registering presence with Mobicents

Calling Registering the phones with Mobicents

Registering the first phone

Registering the second phone

Where to download the code?

Related links

-- IvelinIvanov - 07 Mar 2005