Mifos Release 1.6.0 Installation on Tomcat-Windows

1) In your web browser, go to https://mariadb.org/download/?t=mariadb&p=mariadb&r=10.6.7&os=windows&cpu=x86_64&pkg=msi&m=liquidtelecom to download MariaDB server v10.6.7.

 2) Run the MariaDB installation file. Click on the Typical button and then click on Next button.

3) During MariaDB installation, use Advanced Configuration > Show Advanced Options and set the MariaDB ROOT Password to MariaDB. Then click on the Save button. This will set your username to root and your password to MariaDB.

1) In your web browser, go to https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.59/bin/to download Tomcat 9.0.59.

 >> Under the section Binary Distributions>>Core, click on the link 32-bit windows zip or 64-bit windows zip (depending on your system architecture) to download.

2) Extract the apache-tomcat-9.0.59.zip.

3) Copy and paste the apache-tomcat-9.0.59 folder to the c:\ drive, then rename it tomcat.

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

• 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-17.0.2).

  Note

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

  
  

• Click the OK button.

• In the System Variables section, scroll down to and select the Path variable.
• Click the Edit button at the bottom of the window.
  
• 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-17.0.2\bin 
  - For MariaDB server path example:- ;C:\Program Files\MariaDB\MariaDB Server 5.7\bin
  
  

  Note

  1. There must be exactly one semi-colon between whatever is already in your PATH variable, and the new C:\Program Files\Java\jdk-17.0.2\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
  2. Java jdk path "jdk-17.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: -Xms512m -Xmx1024m
  

1) Go to https://github.com/apache/fineract/releases/tag/1.6.0 from your web browser and download the release source code and build it following the steps shown here https://github.com/apache/fineract#instructions-to-build-a-war-file 

1) Download HEIDISQL from http://www.heidisql.com/download.php and save the installation file to your computer.

2) Run the Heidisql installation file and setup Heidisql: 

i) Click on local and enter the MariaDB password (mysql) in the Password field. 

ii) Click on the Save button.

iii) Click on the Open button. 

4) Copy the following database command and paste it into the large white box titled Query
create database `fineract_tenants`; create database `fineract_default`; 

5) Click on the Run button to execute the query. 

1) Setting up the Lib folder

a) Download the MariaDB J connector (mariadb-java-client-3.0.3.jar)  jar file from here

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

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. 

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'

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

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          

1) Create .mifosx folder in home directory & paste Pentaho folder into it

Use command prompt for creating .Mifos folder(make directory) i.e md .mifosx

2) Copy PentahoReports folder from downloaded Mifos-platform folder

3) Paste it to .mifosx folder

1) Go to "C:\tomcat\bin" folder, Run "startup.bat" by clicking it.

Note: You can create a shortcut  of "startup.bat" on your desktop and rename it as start mifosx.  

2) Application gets started

3) Once server starts, will display as "Server startup in xxxxx ms"

 5) For the first time access it will display as shown below, please click on proceed:- 

6) Login into Mifos, Provide user name: mifos and password as: password