A Quick Start Guide to Mobicents

How to install and run a Mobicents binary distribution

Where to download the distro

To download the binary distribution, follow the link on the mobicents front page, which links to the latest version. It will read something like " Mobicents Suite x.y.z Released".

Once you download the server, unzip it in a new directory on your disk. Make sure the full path to the directory does not contain white spaces.

How to start the server

• Go to the directory where you unpackaged the server
• From there run: ./bin/run.<sh|bat> ( use "-b IP_Address" if you don't want to use default 127.0.0.1)
  • an example for Windows:
  • cd c:\devtools\mobicents
  • bin\run.bat -b 192.168.1.1

How to build and run Mobicents from source code

• Mobicents uses Apache Maven to handle the build process since version 1.2.0BETA2 . Detailed instructions can be found at http://groups.google.com/group/mobicents-public/web/quick-start-guide-with-maven-2

• To start the server execute run.sh/run.bat, as for the binary release, in $JBOSS_HOME/bin

The SLEE 1.0 Technology Compatibility Kit (TCK)

• For development convenience, the TCK is included in the Mobicents CVS module along with the appropriate license files and credits to the original authors.
• The TCK is pre-configured to run against an active Mobicents server on the local machine.

Run the TCK and Custom Tests

• start Mobicents
• in your command line go to dir core/legacy/tests inside Mobicents maven project
• execute "ant"
• If you want to filter tests then use -Dtests= testpattern, where testpattern is a file pattern such as tests/sbb/abstractclass or tests/sbb/abstractclass/Test522Test
• Here is a full command line example, which runs one particular test - Test522Test

      ant -Dtests=tests/sbb/abstractclass/Test522Test

      Buildfile: build.xml

     ...

      tests-slee-tck-internal:
           [echo] slee.tck.testsuite=${slee.tck.testsuite}
           [echo] Starting TCK with params:  -batch 'testsuite ...
           [echo] Excluding tests listed in file: ${slee.tck.testsuite}/jain-slee-tck-1_0.jtx
           [java] Starting test suite...
           [java] Test results: passed: 1
           [java] Results written to C:\work\mobicents\jain-slee-1.0-tck\tckwork.
           [java] Report written to C:\work\mobicents\jain-slee-1.0-tck\reports
           [echo] SLEE TCK report available at C:/work/mobicents/jain-slee-1.0-tck/reports/report.html

      BUILD SUCCESSFUL
      Total time: 4 seconds

• No tests should fail
• NOTE: The tests that are excluded from test runs are located in $project_home/jain-slee-1.0-tck/testsuite/jain-slee-tck-1_0.jtx

Tasks TODO

Look at the TODO list and pick a task that you want to work on. Send a message to the contributors forum that you are interested to work on a certain task. Specify how much time you can dedicate and what portion of the task you can complete.

Tips for Debugging the SLEE Container

• You can debug the container by using logging ( preferred by old hacks ) or by running a debugger. Here are some instructions on how to set up to run a debugger.
• go to $JBOSS_HOME/bin and edit run.sh or run.bat and look for the following line
• rem JPDA options. Uncomment and modify as appropriate to enable remote debugging. Note suspend=y line
  • set JAVA_OPTS= -Xdebug -Xnoagent -Xrunjdwp:transport=dt_socket,address=8787,server=y,suspend=y %JAVA_OPTS%
• start jboss with these options
• On Eclipse, Click on the little Run menu, then on "Debug..."
• Click on Remote Java App ( maybe double click to get a new instance and name it Mobicents )
• On the connect Tab
  • for connection type, standard, socket
  • for host localhost
  • for port 8787
  • Check Allow Termination
  • on the Source tab select mobicents and jain-slee-1.0-tck(optional)
  • Apply, close
• Now Click on Run menu, Debug As, Mobicents
• Ctrl+Shift+T ( brings up a list of types )
• start typing [DeploymentMBeanImpl]
• open it up goto install() and set a breakpoint there
• Run a tck test and see the server break there.

-- MudumbaiRanganathan - 25 Mar 2005

-- Main.ivelin - 01 May 2005

-- Main.eduardomartins - 26 Sept 2007

-- Main.vralev - 24 Nov 2007