Page History

Step 1: 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  Nginx using this guide

• Install Node packages using npm i 

Step 2: Clone The Repositories

• Fork the Apache Fineract CN repositories to yourGithubHandle

• Run the script using `bash script.sh yourGithubHandle`, 

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

Step 3: Orchestrate Microservices Using The demo-server

...

ii. `java -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`

Tip: On average the build will take at least 30 - 40 mins to when building on 8 (x86-64) dedicated cores, 32 GB of memory and an SSD drive

Be Patient While This Runs. When Your Logs Show Up;

……

……

……

Tip: These endpoints below signifies the completion of the build. Only after this has occurred can you move to the next step

“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

Group Service: http://localhost:2032/group/v1

Notification Service: http://localhost:2033/notification/v1

Step 4: /v1” Test The Fims Web App

Open a new terminal And cd into ‘integration-tests/fineract-cn-fims-web-app'

...

Login to the platform using the credentials,

Tenant : playground

Username : operator

Password : init1@l 

Feedback Note : You should be on fims - backoffice at http://localhost:4200/quickAccess

Summary : Congratulations! You’ve Successfully Ran Apache Fineract CN

Tips for the next build

Clean up your tmp folder after every build

Use: sudo rm -fr /tmp/*

Ensure that all relevant ports are free.

Relevant ports: 3306, 4200, 61616, 2021, 2022, 2022, 2023, 2024, 2025, 2026, 2028, 2029, 2030, 2031, 2032, 2033

To view all ports: netstat -plnt

To free specific ports: kill -9 {port number} {port number}

Restart the system if necessary. 

Related articles

...