TeleStax.orgCommunity Documentation

Chapter 2. Setup

2.1. Pre-Install Requirements and Prerequisites
2.1.1. Hardware Requirements
2.1.2. Software Prerequisites
2.2. Telscale JAIN SLEE MS Control Demo Example Source Code
2.2.1. Release Source Code Building
2.2.2. Development Master Source Building
2.3. Installing Telscale JAIN SLEE MS Control Demo Example
2.4. Uninstalling Telscale JAIN SLEE MS Control Demo Example

2.1. Pre-Install Requirements and Prerequisites

Ensure that the following requirements have been met before continuing with the install.

The Example doesn't change the Telscale JAIN SLEE Hardware Requirements, refer to Telscale JAIN SLEE documentation for more information.

The Example requires Telscale JAIN SLEE properly set, with following list of dependencies deployed/started.

MS Control RA

Its required that MS Control RA is deployed. The MS Control RA is responsible to fire the MS Control Events corresponding to Media Server activity

SIP11 RA

Its required that SIP11 RA is deployed. The SIP RA is responsible to fire the SIP Events like INVITE, BYE etc received from SIP User Agents

Restcomm Media Server

Demo requires Media Server running with MGCP Controler deployed. Refer to MS Control RA documentation for explanation

2.2. Telscale JAIN SLEE MS Control Demo Example Source Code

This section provides instructions on how to obtain and build the MS Control Demo Example from source code.

  1. Downloading the source code

    Important

    Git is used to manage Restcomm JAIN SLEE source code. Instructions for downloading, installing and using Git can be found at http://git-scm.com/

    Use Git to checkout a specific release source, the Git repository URL is NOT AVAILABLE , then switch to the specific release version, lets consider 2.8.27.

    				    [usr]$ git clone NOT AVAILABLE restcomm-jain-slee-media
				    [usr]$ cd restcomm-jain-slee-media
				    [usr]$ git checkout tags/2.8.27

  2. Building the source code

    Important

    Maven 2.0.9 (or higher) is used to build the release. Instructions for using Maven2, including install, can be found at http://maven.apache.org

    Use Maven to build the deployable unit binary.

    				    [usr]$ cd examples/mscontrol-demo
				    [usr]$ mvn install

    Once the process finishes you should have the deployable-unit jar file in the target directory, if Telscale JAIN SLEE is installed and environment variable JBOSS_HOME is pointing to its underlying JBoss Enterprise Application Platform directory, then the deployable unit jar will also be deployed in the container.

Similar process as for Section 2.2.1, “Release Source Code Building”, the only change is the Git reference should be the master. The git checkout tags/2.8.27 command should not be performed. If already performed, the following should be used in order to switch back to the master:

		    [usr]$ git checkout master

2.3. Installing Telscale JAIN SLEE MS Control Demo Example

To install the Example simply execute provided ant script build.xml default target: 

		[usr]$ ant

The script will copy the Example's deployable unit jar to the default Telscale JAIN SLEE server profile deploy directory, to deploy to another server profile use the argument -Dnode= .

2.4. Uninstalling Telscale JAIN SLEE MS Control Demo Example

To uninstall the Example simply execute provided ant script build.xml undeploy target: 

		[usr]$ ant undeploy

The script will delete the Example's deployable unit jar from the default Telscale JAIN SLEE server profile deploy directory, to undeploy from another server profile use the argument -Dnode= .