| ||
|---|---|---|
Following are Mandatory Prerequisite Software's /Services and easy installation links | ||
|
| |
| 2. nodeJs 6.10 and above |
| |
| 3. Cassandra 3.11 and above | It is Quite Tricky to Install Only Cassandra on Windows, Follow the below steps for easy installations
2. Second follow this Setup steps of Cassandra on Windows locally.docx document for proper installation of downloaded file . NOTE: The latest cassandra version has installation glitch for now, it is better to go with 3.11.4. | |
| 4. Python 2.7 and above |
2. Python is required to run Cassandra query shell(cqlsh). 3. copy after installing python2.7 all files inside “bin” directory of cassandra-3.11.4. | |
| 5.Postgreys | 1. Download PostgreSQL windows installer from https://www.enterprisedb.com/downloads/postgres-postgresql-downloads 2. follow this PostgreySQL installation.docx document for installation. | |
| 6.ActiveMQ 5 and above |
| |
| 7.Postman |
| |
Make sure Cassandra, PostgreSQL and ActiveMQ are running all the time.
| ||||
|---|---|---|---|---|
| Steps to Generate and print RSA keys | ||||
Step 1. Clone the project fineract_cn_lang
| Step 2. Build and publish to maven local execute the following commands in cmd
| |||
Step 3. Generate application.-properties file execute the following command under the cloned folder
| Step 4. Verify the property file File should contain details similar to this
| |||
| |||||
|---|---|---|---|---|---|
Each Microservice which we wish to provision needs to be built, published to maven local and deployed. Instructions for deploying the core functional set of Microservices is as follows, the procedure for deploying other Microservices would be similar Apache Fineract-CN suite of projects will list you all the Projects under Fineract-CN
| |||||
Service 1. Provisioner Step 1. Clone the project fineract_cn_provisioner
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-provisioner\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file (location - fineract-cn-lang\build\libs) | ||||
Service 2. Identity Step 1. Clone the project fineract_cn_identity
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-identity\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file(location - fineract-cn-lang\build\libs) | ||||
Service 3. Office Step 1. Clone the project fineract_cn_office
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-office\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file(location - fineract-cn-lang\build\libs) | ||||
Service 4. Customer Step 1. Clone the project fineract-cn-customer
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-customer\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file(location - fineract-cn-lang\build\libs) | ||||
Service 5. Deposit Step 1. Clone the project fineract-cn-deposit-account-management
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-deposit-account-management\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file(location - fineract-cn-lang\build\libs) | ||||
Service 6. Accounting Step 1. Clone the project fineract-cn-accounting
| Step 2. Build and publish to maven local execute the following commands in cmd
Step 3. command to run the service
configuration > application.yaml file under "fineract-cn-accounting\service\build\resources\main" location contains the default configuration properties like server port and database related credentials. any properties which has to be changed, should be modified in application.yaml before executing step 3. second option is to explicitly mention the changes on step 3 command, any properties on this command will override the default values in application.yaml For example 1.if you have set a different password for postgres then we need to include "--postgresql.password=newpassword" 2.if you want to change the server port we need to include "--server.port=newport" >system.XX properties values of step 3 will be available under application-dev.properties file(location - fineract-cn-lang\build\libs) | ||||
| |||
|---|---|---|---|
| In this step we will be creating the initial tenant, provision services for the same and will be creating a login user for the tenant. | |||
Step 1. Provisioning the Microservices postman-initial-requests folder: contains postman-request-collection and postman-environment that defines the variables which will be holding values received from the responses. location ProvisioningFineractCN/Fineract-Initial-Setup-Environment.postman_environment.json Start Postman and load both files into Postman using the Import option
Step 2. "Fineract-Initial-Requests" API collection will appear on the left sidebar on successful import, once you open the collection, you will see the list of API's as in the image below.
Step 3. Select the environment "Fineract-Initial-Setup-Environment" in the environment drop-down (top right corner in Postman) Step 4. The "Eye" icon on the top right corner(next to environment drop-down) will list all the Default values and Current values on the variables, user can edit the current values depending on their requirement (example: if port number is of provisioner is changed from 2020 to 2200, then current value of Variable "provisionerUrl" must be changed to "localhost:2200")
Step 5. Execute the requests one by one by selecting them in the collection and then pressing "Send". First API should return the response like below, you may have to verify each step from first properly if you don't get the response token. It is Important to get this step right, in order to proceed further for successful setup as this token will be used in other API requests.
Important notes
| |||
| ||
|---|---|---|
Prerequisites: Setup fineract-cn-fims-web-app , Navigate to http://localhost:4200 in your browser and enter the credentials of the user you want to sign in with. The following user-profile is available in fims-web-app after above setup was completed successfully:
| ||
| |
|---|---|