Instructions for pulling the sources, building, and starting Fineract CN for the first time.
Step-by-step guide
- Install the following prerequisites on your computer:
- Install Java SDK 8
- Install Maven
- Install git
- Install NodeJS (incl. npm)
- Fork the repositories
- all repositories available at https://github.com/mifosio
- javamoney lib https://github.com/JavaMoney/javamoney-lib
- Clone and build your forks
- Browse to https://github.com/mifosio/demo-server/tree/develop/scripts/Unix (or windows)
- Open the "initial-setup" script in raw mode, then copy and paste the script on to your disk
- Run the script.
- Run Mifos I/O
- Local deployment
- Navigate into the folder build/libs under demo-server on your machine
execute:
java -Ddemoserver.provision=true -jar demo-server-0.1.0-BUILD-SNAPSHOT.jar
After the services all have started, navigate to the root fims-web-app folder and follow the steps mentioned in the README
Be aware this is very resource intensive. All services will be started locally on your machine, and multiple data source, and other supporting processes will be started in embedded mode (Apache Cassandra, Apache ActiveMQ, MySQL, Eureka).
- Cloud deployment
- Before you can start the microservices you need to provide resources that contain:
- Apache Cassandra
- Apache ActiveMQ
- MySQL
- Before you can push the services into your cloud you need to adjust the properties in every application.yml for a service to point to the above installed datasources
- Every Microservice is built with the capability to run on a VM. For this simply copy all microservice jar file to one or multiple VMs and start them using java -jar service-0.1.0-BUILD-SNAPSHOT-boot.jar
- Before you can start the microservices you need to provide resources that contain:
- Local deployment
Gentle reminder
Mifos I/O is not ready to be used in a production environment and is still under heavy development. We expect to have the first functioning version ready in approx. 8 weeks. Until then some functionality will not be available or work properly (e.g. checking accounts, individual loans).
Related articles
Useful external links