Skip to end of metadata
Go to start of metadata

How to install WSO2 External Gateway Release 

Setting up the Deployment

The deployment consists of configuring 2 products:

  1. WSO2Telco External_Gateway 
  2. WSO2 ESB

Configuring WSO2 TELCO EXTERNAL GATEWAY

 Download WSO2 TELCO EXTERNAL GATEWAY from website: https://wso2telco.com/gateways/external-gateway

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

Service providers can subscribed to published apis created by the external gateway admins. The external gateway application approval workflow   visualized in the figure 1.

 

                                                                                      

           figure 1

 

Start WSO2 TELCO EXTERNAL GATEWAY and goto Publisher app

Create APIs for necessary use-cases and configure the 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_EXTERNAL_GATEWAY_HOME/repository/deployment/server/jaggeryapps/manage/site/conf/site.json
  • TELCO_EXTERNAL_GATEWAY_HOME/repository/conf/workflow.properties
  • TELCO_EXTERNAL_GATEWAY_HOME/repository/resources/workflow-extensions.xml


MSISDN Blacklist, Whitelist

 

For MSISDN blacklist,whitelist features, please add the following handlers to "api-synapse.xml" (TELCO_EXTERNAL_GATEWAY_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"/>


Example - 

<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>

 

Configuring WSO2 ESB

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 
     mnc-resolver.jar 
     msisdn-validator.jar 
     operator-service.jar 
     subscription-validator.jar
     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
     com.wso2telco.dep.spend.limit.mediator.jar 
     mediator.jar
     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:

 

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


Start WSO2 ESB and upload CApp files (WSO2.Telco related files are bundled with wso2telco_ext_gw_mediation-v2.0.0.zip) (Refer: https://docs.wso2.com/display/ESB481/Creating+and+Deploying+a+Carbon+Application)


 

                                                       

  • No labels