Page History

...

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
         

         (for macOS: export JAVA_HOME=$(/usr/libexec/java_home)

   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) 
4. Open the "initial-setup" script in raw mode, then copy and paste the script on to your

...

1. directory
   1. The script needs a parameter <username from the github fork>. So you run the script as "initial-setup <username>"

1. 1. Run the script.
2. Run Mifos I/O
   1. Local deployment
      1. Navigate into the folder build/libs under demo-server on your machine.

      2. Execute:

         Code Block
         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>)

          

         Info
         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
         
         

...