You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Next »

Instructions for pulling the sources, building, and starting Fineract CN for the first time.

Step-by-step guide

  1. Install the following prerequisites on your computer:
    1. Install Java SDK 8
    2. Install Maven
    3. Install git
    4. Install NodeJS (incl. npm)
  2. Fork the repositories
    1. all repositories available at https://github.com/mifosio
    2. javamoney lib https://github.com/JavaMoney/javamoney-lib
  3. Clone your forks
    1. Browse to https://github.com/mifosio/demo-server/tree/develop/scripts/Unix (or windows) 
    2. Open the "initial-setup" script in raw mode, then copy and paste the script on to your disk
    3. Run the script.
  4. Run Mifos I/O
    1. Local deployment
      1. Navigate into the folder build/libs under demo-server on your machine
      2. execute: java -Ddemoserver.provision=true -jar demo-server-0.1.0-BUILD-SNAPSHOT.jar

      3. 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).
    2. Cloud deployment
      1. Before you can start the microservices you need to provide resources that contain:
        1. Apache Cassandra
        2. Apache ActiveMQ
        3. MySQL
      2. 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
      3. 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

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

  • No labels