Versions Compared

Old Version 19

changes.mady.by.user Francis Guchie

Saved on

compared with

New Version 20

changes.mady.by.user Francis Guchie

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      later versions not tested                           
  • MYSQL SERVER >> Version 5.7  later versions not tested
  • TOMCAT >> Version 9.0.80    later versions not tested

    For First time installations, kindly stick to the versions below and only change after you have succeeded 
    tomcat 9.0.xx
    Mysql 5.7.xx
    JDK 15.0.xxx  


  •  

    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

...

  •  

    Create Environment Variables 

1) Open your Environment Variables:
Start Menu > Control Panel > System and Security > System > Advanced System Settings > Environment Variables.

2) Create the JAVA_HOME variable:
  • Click on the New button, under the User Variables section.
  • For Variable Name, enter JAVA_HOME

  • For Variable Value, provide the Java path (for example: C:\Program Files\Java\jdk-15.0.2).

    Info
    titleNote
    1. If you are running 32-bit Windows, then the path is: C:\Program Files\Java\jdk-15.0.2
    2. Java jdk path "jdk-15.0.2" may be different on your system as it is dependent on the version you have installed.

  • Click the OK button.
3) Edit the PATH variable:
  • In the System Variables section, scroll down to and select the Path variable.
  • Click the Edit button at the bottom of the window. The image below is from Windows 7 or before ( For windows 10 and above the layout or the path is different
    Image Modified
  • Use your mouse cursor and click inside the Variable Value box. 
    Using your keyboard's right-arrow or End key, move all the way to the far right of the current text in Variable Value.

  • Add the following text onto the end of the existing Variable Value text: 
    - For Java path example:- ;C:\Program Files\Java\jdk-15.0.2\bin 
    - For Mysql server path example:- ;C:\Program Files\MySQL\MySQL Server 5.7\bin

    Info
    titleNote
    1. There must be exactly one semi-colon between whatever is already in your PATH variable, and the new C:\Program Files\Java\jdk-15.0.2\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
    2. Java jdk path "jdk-15.0.2" may be different on your system as it is dependent on the version you have installed.  


  • Click the OK button  

4) Create the JAVA_OPTS variable: 

  • a. Under the User Variables section, click the New... button again.
  • b. For Variable Name, enter JAVA_OPTS
  • c. For Variable Value, enter the system's memory size, for example: -Xms2048m -Xmx4096m -XX:MaxMetaspaceSize=256m

5) Create the CATALINA_HOME variable: 

  • a. Under the User Variables section, click the New... button again.
  • b. For Variable Name, enter CATALINA_HOME
  • c. For Variable Value, enter the system's memory size, for example: this C:\tomcat9tomcat

6) Create the CATALINA_OPTS variable: 

  • a. Under the User Variables section, click the New... button again.
  • b. For Variable Name, enter CATALINA_HOME
  • c. For Variable Value, enter the system's memory size, for example: this -Xms2048m -Xmx4096m



  •  

    Download Mifos 

1) Go to http://mifos.org/ from your web browser and navigate to Take Action >> Get Mifos 

2) Click on the "DOWNLOAD IT ON YOUR OWN" link

3) Click on "Download MifosX Now"  


4) Fill out the Mifos Download Form with your information, then click the Next Page button. The download will start automatically.


Info
titleNote

You can skip the form by scrolling to the bottom of the page and clicking on:

No thanks. I would just like to download Mifos without providing additional information.

However, we are able to understand and serve you better if you provide details of your organization.


 

5) You will automatically be redirected to a download page for Mifos on the Sourceforge website. Here you will be prompted to download a ZIP file containing the Mifos application.


Info
titleNote

Or You can also download other versions directly from here


 

6) Once you have download the Mifos ZIP file, extract it to a new folder on your computer.  Remember this location, as you will need to refer to it later. 

...

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 and community-app as well


Info
titleNOTE
If only some reports are not working, please raise a bug here with all the details, it would be great if you could fix and send a PR or any of the community member would pick it up for fixing.


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

...