JBoss.orgCommunity Documentation

Chapter 2. Setup

2.1. Pre-Install Requirements and Prerequisites
2.1.1. Hardware Requirements
2.1.2. Software Prerequisites
2.2. Mobicents JAIN SLEE USSD Gateway Application Source Code
2.2.1. Release Source Code Building
2.2.2. Development Trunk Source Building
2.3. Folder structure of Mobicents JAIN SLEE USSD Gateway Application
2.4. Rule engine configuration
2.5. Guvnor configuration
2.5.1. Creating resources
2.5.2. Creating rules

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

  1. Downloading the source code

    Use SVN to checkout a specific release source, the base URL is http://mobicents.googlecode.com/svn/tags/applications/ussdgateway, then add the specific release version, lets consider 1.0.0.BETA1.

    [usr]$ svn co http://mobicents.googlecode.com/svn/tags/applications/ussdgateway/1.0.0.BETA1 slee-application-ussdgateway-1.0.0.BETA1
  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 binary.

    				    [usr]$ cd slee-application-ussdgateway-1.0.0.BETA1
    				    [usr]$ mvn install
    				    

    Once the process finishes you should have the deployable-unit jar file in the target directory, if Mobicents JAIN SLEE is installed and environment variable JBOSS_HOME is pointing to its underlying JBoss Application Server 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 SVN source code URL, which is https://mobicents.googlecode.com/svn/trunk/applications/ussdgateway.

Installing Mobicents USSD Gateway creates a mobicents-ussd-gateway directory that contains gateway configuration, libraries required for boot and running, example rules definition file (.drl) etc. You need to know your way around the distribution layout to locate the drools file's to add new rules. The figure "view of Mobicens USSD Gateway" illustrates the installation directory of the Gateway.

Rule engine (Drools) is configured with USSDGatewayChangeSet.xml file. Its content alters how rule set is loaded and maintained within engine. There are two ways of maintaining rules:

Guvnor is deployed along with USSD Gateway Application. To access it simply go to http://<your server>/drools-guvnor/ . This will bring initial info screen or login screen - depends on configuration.

If you have not configured the security you can directly login without providing any user id or password.

In case Guvnor has not been used(it is a new repository) you will get a message asking if you would you like to install a sample repository? Its upto you to install the sample repository. If you say yes, you would get sample repository which you can refer to have better understanding of Guvnor

Once you log-in follow the bellow steps:

This concludes configuration of Guvnor . Note that this has to be done only once.