How to Setup the Code Base
Step 1: Clone the Messagemessage-gateway source code into your local machine from the GitHub.
On Windows:
| Code Block | ||||||
|---|---|---|---|---|---|---|
| ||||||
$ git clone https://github.com/openMF/message-gateway.git |
On Ubuntu:
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ sudo git clone https://github.com/openMF/message-gateway.git |
Step 2: Open the source code directory (i.e cloned in on your local )machine. Now Git bash it, open Git Bash in this folder (through the right-click context menu).
On Windows:
On Ubuntu:
Now move to Simple change your current directory to the message-gateway directory by entering the following command:
| Code Block | ||
|---|---|---|
| ||
$ cd message-gateway |
How to
buildBuild the Code Base
Step 1: Next, we need to generate the .war file. This can be achieved by using command the commands mentioned below:
On Windows:
| Code Block | ||||
|---|---|---|---|---|
| ||||
$ gradlew clean build -Pprofile=deployable |
On Ubuntu:
| Code Block | ||||
|---|---|---|---|---|
| ||||
~/message-gateway$ sudo chmod 777 gradlew
~/message-gateway$ sudo ./gradlew clean build -Pprofile=deployable |
Step 2: Now create Create a database as with the name `messagegateway`.
Step 3: Now open Open the message-gateway source directory , and navigate to build>> build >> libs. Copy Copy the message-gateway-0.0.1.war file.
On Windows:
On Ubuntu:
| Code Block | ||||
|---|---|---|---|---|
| ||||
~/message-gateway$ cd build ~/message-gateway/build$ cd libs |
Step 4: Next, navigate to Tomcat>>Navigate to Tomcat >> webapps and paste the message-gateway-0.0.1.war file within into this directory.
On Windows:
On Ubuntu:
| Code Block | ||||
|---|---|---|---|---|
| ||||
~/message-gateway/build/libs$ sudo cp message-gateway-0.0.1.war /home/tomcat7/webapps/ |
How to Run
On Windows:
Go to Tomcat>>Navigate to Tomcat >> Bin directory and double click on startup.bat file to bat to start the application.
On Ubuntu:
Now navigate to the Tomcat >>>> bin folder and execute the following command to start the application.:
| Code Block | ||||
|---|---|---|---|---|
| ||||
~/tomcat7/bin$ sudo sh startup.sh |
How to
configureConfigure Message Gateway
| Note | ||
|---|---|---|
| ||
You can download the REST Client from this link: |
Open the REST Client and perform the following steps:
Step 1: When you open the REST client set the URL as: http://localhost:9191/message-gateway-0.0.1/tenants/ . HTTP Method HTTP method should be set to "POST". Finally, in the HTTP request body pass the following data:
| Info | ||
|---|---|---|
| ||
{ NoteNOTE: Pass the appropriate "tenantId" |
When we fire this request, "tenant app key" is generated as a response,this . This is shown in the screenshot below screenshot:
Step 2: In this step, set REST client URL as http://localhost:9191/message-gateway-0.0.1/smsbridges . HTTP Method should be set to "POST". In the HTTP request body, pass the following data:
| Info | ||
|---|---|---|
| ||
{ "countryCode":"+xx", NoteNOTE: 1. phoneNo, providerName, configName, configValue, configName, configValue are to be set based on the individual subscription. |
Pass these HTTP headers in the REST client:
| Header | Value |
|---|---|
| Fineract-Platform-TenantId | {Pass the same Tenant ID that you have set in the previous step} |
| Fineract-Tenant-App-Key | {Pass the same "Tenant app key" that is generated in the previous step} |
Once headers are set, fire the HTTP request.
Step 3: In this step, set REST client URL as http://localhost:9191/message-gateway-0.0.1/sms/. HTTP Method HTTP method should be "POST". In HTTP request body pass the following data.:
| Info | ||
|---|---|---|
| ||
[{ NoteNOTE: (i)
|
Pass the same HTTP headers that we passed in the last step.