Info |
---|
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. |
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 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
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...