How To Build Apache Fineract CN

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

This guide assumes that default OS is Debian/Ubuntu flavours of Linux although they can be easily adapted to other hosts.

What You Will Need

Install Google Chrome On Ubuntu 16.06 LTS
Ensure that you have Oracle Java SDK 8. You can use this tutorial to do that.
Install git using This Article
Install MySQL 5.7 Using This Guide
Install maven using mkyong & Ensure that artifacts are in $USER_HOME/.m2/repository
Use sdkman to install Gradle 4.5
Install cassandra 3.11 using this guide
Ensure you have Node 6.10.0+ and NPM 3+ installed.
Install Node packages using npm i

Clone The Repositories

Fork the Apache Fineract CN repositories to yourGithubHandle
Run the script THRICE using `bash script.sh yourGithubHandle`,

Feedback Note : Ensure that you get BUILD SUCCESSFUL ( 33 times ) after iteration for EACH repository. Also ensure that artifacts with appropriate names show up in $USER_HOME/.m2/repository/org/apache/fineract/cn/

Orchestrate Microservices Using The demo-server

cd into `integration-tests/demo-server/build/libs/`. You will use Use A. OR B. below to build the demo-server jar.
A. You could use the demo-server using the microservice datastores . Use the command `java -jar -Ddemoserver.provision=true demo-server-0.1.0-BUILD-SNAPSHOT.jar`

OR

B. You could use your local data stores , i.e. locally-installed MySQL and Cassandra ( with the demoserver.persistent environment variables ) to build the demo-server. Note that your username and password for mysql and cassandra which you’ve installed on your machine will be useful at this point. Make sure Cassandra and MySQL services are started. Run the following command;

`java -Ddemoserver.provision=false -Ddemoserver.persistent=true -Dcustom.cassandra.contactPoints=127.0.0.1:9042 -Dcassandra.cluster.user=cassandra -Dcassandra.cluster.pwd=password -Dcustom.mariadb.host=localhost -Dcustom.mariadb.user=root -Dcustom.mariadb.password=mysql -jar demo-server-0.1.0-BUILD-SNAPSHOT.jar`

Be Patient While This Runs. When Your Logs Start Showing;

“INFO o.e.jetty.server.AbstractConnector - StoppedServerConnector@1bdb0376{HTTP/1.1,[http/1.1]}

Identity Service: http://localhost:2021/identity/v1

Office Service: http://localhost:2023/office/v1

Customer Service: http://localhost:2024/customer/v1

Accounting Service: http://localhost:2025/accounting/v1

Portfolio Service: http://localhost:2026/portfolio/v1

Deposit Service: http://localhost:2027/deposit/v1

Teller Service: http://localhost:2028/teller/v1

Reporting Service: http://localhost:2029/reporting/v1

Cheque Service: http://localhost:2030/cheques/v1

Payroll Service: http://localhost:2031/payroll/v1”