Versions Compared

Old Version 6

changes.mady.by.user Emmanuel Irabor

Saved on

compared with

New Version 7

changes.mady.by.user Emmanuel Irabor

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.



Prerequisite Software   


Info
titleNote

the software and versions included below are a mandatory prerequisite

  • JAVA DEVELOPMENT KIT >> VERSION 15.0.2 & above                                
  • MYSQL SERVER >> Version 5.7
  • TOMCAT >> Version 9.0.38 & above


  •  

    Install Java 

1) Before beginning, uninstall any existing versions of Java currently on your computer. 

2) In your web browser, go to https://www.oracle.com/java/technologies/javase/jdk15-archive-downloads.html 

Download and Install jdk-15.0.2_windows-x64_bin.exe

...

  •  

    Tomcat - Setup

1) Setting up the Lib folder

a) Download the mysql jdbc 8.0.21 jar file from here

b) Once it's downloaded, copy the file and paste it to the Tomcat>>lib folder. 

Info
titleNote

If the tomcat-jdbc.jar file is not available in the tomcat>>lib folder it can be downloaded from: http://www.java2s.com/Code/JarDownload/tomcat-jdbc/tomcat-jdbc.jar.zip


2) Generate keystore

 Generate a new keystore using the Java keytool :

i) Open Command Prompt 
ii) Navigate to the path where your JAVA>>bin folder is located. 
iii) Run this command to generate the key: 

keytool -genkey -alias tomcat -keyalg RSA

or

keytool -genkey -keyalg RSA -keysize 2048 -alias tomcat

-(add a key size parameter of size 2048 as some browsers will not display the UI)
iv) Then provide the password. 
For example: 


Answer the questions and then type y after the last question to confirm. 


Info
titleNote

Once the keystore is created, it should be placed in your home directory. For Example: C:/Users/john/.keystore


3) Configure server.xml page,

a) Go to tomcat>>conf, rename to server.xml file as server.bkp

b)Download server.xml file from here and move the downloaded file to the folder 'tomcat>>conf'

c) Once the file is copied, the following variables need to be modified to reflect your system and settings:
i) Key store path should be modified with your key store path location (for example: keystoreFile="C:/Users/john/.keystore")
ii) Key store password (which was provided while creating the key) should be modified to include your password (for example: keystorePass="xyz123")
iii) MYSQL credentials should be modified to reflect the username and password used in step 4 of the Install MySQL section above (for example: username="root" and password="mysql")                                                                                                     

...

Info
titleNote

If your any of the server port connections are using port number 8443, then you need to change your port number to 443 in server.xml:

port="8443" maxThreads="200" scheme="https" to port="443" maxThreads="200" scheme="https" 


  •  

    Drop Mifos into Tomcat folder

1) fineract-provider.war to tomcat>>webapps folder

1-a) Copy "fineract-provider.war" file from downloaded Mifos-platform folder 

       

  

1-b) Paste it to tomcat\webapps folder

                 

2) Community-app to tomcat>>webapps folder

2-a) Copy "community-app" folder from downloaded Mifos-platform>>apps folder: 

       

2-b) Paste it to tomcat\webapps


2-c) Rename existing ROOT folder to OLDROOT under tomcat\webapps\

2-d) Rename community-app folder to ROOT



3) web-app to tomcat>>webapps folder

2-a) Copy "web-app" folder from downloaded Mifos-platform>>apps folder: 

       

2-b) Paste it to tomcat\webapps

4) api-docs to tomcat>>webapps>>ROOT folder

4-a) Copy "api-docs" folder from downloaded Mifos-platform>>api-docs folder: 

       

4-b) Paste it to tomcat\webapps\ROOT folder          





...

Info
  • Platform application should be available @ https://[public DNS]/fineract-provider/api/v1/offices?tenantIdentifier=default&pretty=true, and this API should return JSON format text with office details
  • API docs should be available @ https://[public DNS]/api-docs/apiLive.htm


Info
titleFAQs

FAQ 1:- If you are able to log-in to the application successfully, but Pentaho reports are not working


1. Check if the Pentaho jars are properly copied to the  'tomcat\webapps\fineract-provider\WEB-INF\lib' folder
2. Run Pentaho reports on new UI (web-app). To Access new UI:- https://localhost:8443/web-app ( or any port number which you are using)
- if you have successfully configured the Pentaho Plugin, then you should be able to view the Pentaho reports on web-app


Info
titleNOTE
On Windows machine, Pentaho reports are working only on web-app UI, community-app has some issues which need to be fixed.
Any Interested volunteers can help on this issue (ticket link is here with more details)


FAQ 2:- Pentaho reports are working fine, only a few are throwing the error "Failed to load content using value C:\Users\hp1\Desktop\MIfosX_unofficial_logo.png"

1.This is error is because the logos were not removed from some reports when we upgraded the Pentaho version to 7.00.6.25
2. If you come across such reports, you could simply remove the logo and send PR and contribute to the community or you can work around this by placing a logo inside of pentahoReports folder and name it   'MIfosX_unofficial_logo.png'  to resolve the error on your installation.


FAQ 3:- Not able to login / Connectivity Issue on Community-app


1. Check if all the prerequisite Softwares installed are of the right version
2. check the tomcat startup log which will always point to the root cause of the issue
3. If you are not able to analyze the log file, please share the log file along with all other details with the community for help.

FAQ 4:- Not able to log-in through web-app UI

1. Check if you are able to login successfully with community-app UI
- If you are able to login through community-app, then check the server drop-down selection on the web-app UI and make sure it is correct.
- Clear all browser cache or use private browser.
- If you are not able to login through community-app then follow FAQ 3

...