Page History

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

...

title	This is not yet Fineract code

...

Keep in mind that Fineract CN is not yet officially a part of Apache. If you want to build the current project code, see Fineract Build Instructions

Step-by-step guide

Install the following prerequisites on your computer:
Install Java SDK 8
Add JAVA_HOME to your path, instruction can be found here
(for macOS: export JAVA_HOME=$(/usr/libexec/java_home)
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 directory
The script needs a parameter <username from the github fork>. So you run the script as "initial-setup <username>"

...

Run the script.

...

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

Execute:

...

-server-0.1.0-BUILD-SNAPSHOT.

...

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).

...

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