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

Compare with Current View Page History

« Previous Version 6 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
      1. Add JAVA_HOME to your path, instruction can be found here
    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 and build 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. Note: If you're running in your local machine, you may have to disable Firewall access to ports 2020 to 2029.
      4. Wait until all the services have started.  You will see a listing of service URLs to stdout once all services are up.  Note that you need to leave the services running in order to get the Fineract CN web page login to work.
      5. Navigate to the root fims-web-app folder and follow the steps mentioned in the README.

      6. The login credentials for the present are built into the codebase and are the following:

        tenant: playground
        User: operator
        Pass: init1@l
        (the password is init1@<lower case L>)

         

        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

 

Useful external links

Deploying spring boot jars

  • No labels