 |
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
- 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
The output should be something like this:
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
|