WSO2 ESB Mediation Logic for Gateway Release
Build Status :
The deployment consists of configuring 2 products:
- wso2esb
- wso2telcohub
Download a fresh WSO2 ESB 5.0.0 pack from website: http://wso2.com/products/enterprise-service-bus/
Add following .jar files to ESB as described (WSO2.Telco related files are bundled with wso2telco_ext_gw_mediation-v2.0.0.zip):
- To ESB_HOME/repository/components/dropins
dbutils.jar (repository: WSO2Telco/core-util)
mnc-resolver.jar (repository: WSO2Telco/core-util)
msisdn-validator.jar (repository: WSO2Telco/core-util)
operator-service.jar (repository: WSO2Telco/component-dep)
subscription-validator.jar (repository: WSO2Telco/component-dep)
javax.persistence_1.0.0.jar (external: http://www.java2s.com/Code/Jar/j/Downloadjavaxpersistence100jar.htm)
json_3.0.0.wso2v1.jar (external: http://maven.wso2.org/nexus/content/repositories/wso2-public/org/json/wso2/json/3.0.0.wso2v1/json-3.0.0.wso2v1.jar)
- To ESB_HOME/repository/components/lib
oneapi-validation.jar (repository: WSO2Telco/component-dep)
com.wso2telco.dep.spend.limit.mediator.jar (repository: WSO2Telco/mediation-dep)
mediator.jar (repository: WSO2Telco/mediation-dep/mediation-old)
mysql-connector-java-5.1.36-bin.jar (external: http://central.maven.org/maven2/mysql/mysql-connector-java/5.1.36/mysql-connector-java-5.1.36.jar)
Add following configuration files:
-
mediator-conf.properties to ESB_HOME/repository/conf (repository: https://github.com/WSO2Telco/component-dep/blob/master/features/com.wso2telco.dep.hub.core.feature/src/main/resources/config/mediator-conf.properties)
-
MobileCountryConfig.xml to ESB_HOME/repository/conf (repository: https://github.com/WSO2Telco/component-dep/blob/master/features/com.wso2telco.dep.hub.core.feature/src/main/resources/config/MobileCountryConfig.xml)
-
spendLimit.xml to ESB_HOME/repository/conf (repository:https://github.com/WSO2Telco/component-dep/blob/master/features/com.wso2telco.dep.hub.core.feature/src/main/resources/config/spendLimit.xml)
-
oneapi-validation-conf.properties to ESB_HOME/repository/conf (repository:https://github.com/WSO2Telco/component-dep/blob/master/features/com.wso2telco.dep.hub.core.feature/src/main/resources/config/oneapi-validation-conf.properties)
NOTE: If using an older verion of the product, ensure that you have checked out the matching version tag before copying above configurations.
Configuring datasources
- Add following database references: proddepdb and prodUMdb (with suitable user credentials) at ESB_HOME/repository/conf/datasources/masterdatasources.xml
proddepdb : http://docs.wso2telco.com/display/HG/Setup+DEP+database
prodUMdb : http://docs.wso2telco.com/display/HG/Setup+++User+Manager+database
Important: Same databases are referred while setting up wso2telcohub
Clone this repository and build using maven ($ mvn clean install)
There will be 5 CApp files (.car files) created in following locations
* mediation-dep-gw/com.wso2telco.dep.gw.common/commongw_capp/target/commongw_capp.car
* mediation-dep-gw/com.wso2telco.dep.gw.locationapi/locationapigw_capp/target/locationapigw_capp.car
* mediation-dep-gw/com.wso2telco.dep.gw.paymentapi/paymentapigw_capp/target/paymentapigw_capp.car
* mediation-dep-gw/com.wso2telco.dep.gw.smsapi/smsapigw_capp/target/smsapigw_capp.car
* mediation-dep-gw/com.wso2telco.dep.gw.ussdapi/ussdapigw_capp/target/ussdapigw_capp.car
Start WSO2 ESB and upload CApp files (Refer: https://docs.wso2.com/display/ESB481/Creating+and+Deploying+a+Carbon+Application)
- Download WSO2 TELCO HUB (for Gateway) from website: http://wso2telco.com/hub
- Configure databases and workflow. (If database has already created, you only need to add relevant configurations).
Database configurations: http://docs.wso2telco.com/pages/viewpage.action?pageId=1507746
Workflow configurations: http://docs.wso2telco.com/display/HG/Install+workflows
-
Start WSO2 TELCO HUB and goto Publisher app
-
Create APIs for necessary use-cases and configure endpoint to ESB APIs. API context should be as follows:
- payment
- ussd
- location
- smsmessaging
If WSO2 Telco Hub is port offset, change the port numbers at the following files accordingly (Ref: http://docs.wso2telco.com/display/HG/Offsetting+Product)
- TELCO_HUB_HOME/repository/deployment/server/jaggeryapps/manage/site/conf/site.json
- TELCO_HUB_HOME/repository/conf/workflow.properties
- TELCO_HUB_HOME/repository/resources/workflow-extensions.xml
For MSISDN blacklist,whitelist features, please add the following handlers to "api-synapse.xml" (TELCO_HUB_HOME//repository/deployment/server/synapse-configs/default/api/)file with following handlers.
<handler class="com.wso2telco.dep.verificationhandler.verifier.BlacklistHandler"/>
<handler class="com.wso2telco.dep.verificationhandler.verifier.WhitelistHandler"/>
Eg:
<handlers>
<handler class="org.wso2.carbon.apimgt.gateway.handlers.common.APIMgtLatencyStatsHandler"/>
<handler class="org.wso2.carbon.apimgt.gateway.handlers.security.CORSRequestHandler">
<property name="apiImplementationType" value="ENDPOINT"/>
</handler>
<handler class="org.wso2.carbon.apimgt.gateway.handlers.security.APIAuthenticationHandler"/>
<handler class="com.wso2telco.dep.verificationhandler.verifier.BlacklistHandler"/>
<handler class="com.wso2telco.dep.verificationhandler.verifier.WhitelistHandler"/>
<handler class="org.wso2.carbon.apimgt.gateway.handlers.throttling.APIThrottleHandler">
<property name="policyKey" value="gov:/apimgt/applicationdata/tiers.xml"/>
<property name="policyKeyApplication"
value="gov:/apimgt/applicationdata/app-tiers.xml"/>
<property name="id" value="A"/>
<property name="policyKeyResource"
value="gov:/apimgt/applicationdata/res-tiers.xml"/>
</handler>
<handler class="org.wso2.carbon.apimgt.usage.publisher.APIMgtUsageHandler"/>
<handler class="org.wso2.carbon.apimgt.usage.publisher.APIMgtGoogleAnalyticsTrackingHandler">
<property name="configKey" value="gov:/apimgt/statistics/ga-config.xml"/>
</handler>
<handler class="org.wso2.carbon.apimgt.gateway.handlers.ext.APIManagerExtensionHandler"/>
</handlers>