-
-
4.1 With Postman
-
For getting started with Mojaloop Testing Toolkit quickly please follow the below steps.
This is the easiest way to run the Mojaloop Testing Toolkit.
The following softwares should be installed on your system to run the toolkit.
- Git
- Docker
Please execute the following lines to build and run the tool.
git clone https://github.com/mojaloop/ml-testing-toolkit
cd ml-testing-toolkit
docker-compose up
To update the Mojaloop Testing Toolkit to the latest version and rebuild, please run the following
cd ml-testing-toolkit
git pull
docker-compose build
docker-compose up
please open
Docker - settings - resources - advanced
Allocate more resources. As shown in example below:
- Drive has not been shared error If the error with similar stacktrace
ERROR: for mojaloop-testing-toolkit Cannot create container for service mojaloop-testing-toolkit: status code not OK but 500: {"Message":"Unhandled exception: Drive has not been shared"}
ERROR: Encountered errors while bringing up the project.
Docker - settings - resources - file sharing
and tick those drives where project have been checked out to (cloned to). I've ticked both, as cloned repo is on drive D.
The following softwares should be installed on your system to run the toolkit.
- Git
- NodeJS
Please execute the following lines to run the testing tool backend service.
git clone https://github.com/mojaloop/ml-testing-toolkit.git
cd ml-testing-toolkit
npm install
npm start
Please execute the following lines to run the frontend service
git clone https://github.com/mojaloop/ml-testing-toolkit-ui.git
cd ml-testing-toolkit-ui
npm install
npm start
The server will start and listen on port 5000. You can send the mojaloop api requests to this port number. The test api server will start on port 5050.
And you can get the web interface on http://localhost:6060/
Once the server is started on a particular port, you can send api requests from the sample postman collection included in this repository to test the basic functionalities like schema validation and version negotiation.
- Install the postman tool
- postman/mojaloop-pdp-testing-tool.postman_environment.json - Import this file as environment in postman.
- postman/mojaloop-pdp-testing-tool.postman_collection.json - Import this file as a collection in the postman.
- Run this whole collection using the "Runner" button at the top.
If you want to test the tool for the whole functionality like schema validation, additional validation and callback generation ..etc, you can initiate a transfer cycle from mojaloop simulator UI.
Please follow the below steps from the ml-testing-toolkit folder
cd simulator
docker-compose up
The above command will start the services scheme-adapter, mojaloop-simulator and mojaloop-simulator-ui.
Open the following URLs in your browser and send a transfer from simulator and observe the toolkit logs in web frontend.
- http://localhost:6060 (Front end for Mojaloop Testing Toolkit)
- http://localhost (Front end for Mojaloop Simulator)
After installation you can interact with the testing toolkit from either web interface or with a command line tool.
For Web interface follow this Usage Guide
For Command line tool follow this CLI User Guide
**If you have your own DFSP implementation you can point the peer endpoint to Mojaloop Testing Toolkit on port 5000 and try to send requests from your implementation instead of using mojaloop-simulator.