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 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:
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
Cheque Service: http://localhost:2030/cheques/v1
Payroll Service: http://localhost:2031/payroll/v1”
Test The Fims Web App
Open a new terminal And cd into ‘integration-tests/fims-web-app'
Run ‘npm i’
Feedback Note :
If there are packages like @angular-devkit or @rxjs which you aren’t installed, then do so manually at this point;
Run ’npm run dev’
̂̂̂̂> fims@0.1.0 dev /home/ikamga/Documents/Three/Code/integration-tests/fims-web-app
> ng serve --verbose --proxy-config proxy.conf.json
** NG Live Development Server is listening on localhost:4200, open your browser on http://localhost:4200/ ** ̂
……
……
……
index.html 3.69 kB 0
chunk {0} index.html 1.03 kB [entry] [rendered]
webpack: Compiled successfully.
Feedback Note : webpack: Compiled successfully.
Open http://localhost:4200 on fims - backoffice
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
...
- Apache Cassandra
- Apache ActiveMQ
- MySQL
...
title | Gentle reminder |
---|
...
Related articles
Content by Label | ||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...