Up-gradation of Mifos X on windows


On this page:

Step 1)

Stop running tomcat server

If you have installed tomcat as service then, stop Apache tomcat service. 


If you have installed tomcat manually, you could use ctrl+c and stop the server.

Step 2)

Uninstall Java7 

You could go to control panel and uninstall Java

Step 3)  

Install Java 

You could follow the link:- http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, to download JAVA 1.8 & install.  

Update Environmental variables for Java  

  • Create Environment Variables 

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

2) Create 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\jdk1.8.0_66
    i - If you are running 32-bit Windows, then the path would be ex:- C:\Program Files (x86)\Java\jdk1.8.0_66
    ii - Java jdk path "jdk1.8.0_66" will be with respect to the installed version and it may not be the same as mentioned in the above example.  
  • Click the OK button.

Step 4) 

Uninstall existing Tomcat 

If you have installed tomcat as service, then you could uninstall tomcat service. 


If you have installed tomcat manually, then you could delete all the tomcat directories.  

Step 5) 

Install tomact : 

  • Install Tomcat

1) In your web browser, go to http://tomcat.apache.org/download-70.cgi to download tomcat 7.

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


2) Extract apache-tomcat-7.0.68.zip:- 


  4) Folder: apache-tomcat-7.0.68, gets extracted:-      


5) Copy & Paste apache-tomcat-7.0.68 folder to c:\(drive) then Rename it to tomcat 

Step 6) 


  • Tomcat - Setup

1) Setting up Lib folder

a) Download drizzle jdbc 1.3 jar file from http://central.maven.org/maven2/org/drizzle/jdbc/drizzle-jdbc/1.3/drizzle-jdbc-1.3.jar

b) Once it's downloaded copy & paste it to lib folder, Go toTomcat>>lib folder. 

Note: If tomcat-jdbc.jar file is not available in the tomcat>>lib folder then you could download and paste it from:http://www.java2s.com/Code/JarDownload/tomcat-jdbc/tomcat-jdbc.jar.zip

2) Generate keystore

 Generate a new keystore using java keytool :

>> Open command prompt 
>> Go to the path where your JAVA>>bin folder is located. 
>> Run this command to generate the key: keytool -genkey -alias tomcat -keyalg RSA
>> Then provide the password. 
For example: 

Provide input and type in y for the last question to confirm. 

Note: 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>>open server.xml with notepad:

b) Delete everything in it and copy-paste the following right side entire content of the page code:

c) Once content is pasted in server.xml,Below mentioned are to be modified with respect to your system & settings:
i - Key store path should be modified with your key store path location Example:- keystoreFile="C:/Users/john/.keystore"
ii - Key store password (which was provided while creating the key), should be modified Example:- keystorePass="xyz123"
iii - MYSQL credentials should be modified
Example:- username="root" & password="mysql"                                                                                                     

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.JasperListener" />
<Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />
<Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />
<Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

<Resource name="UserDatabase" auth="Container"
description="User database that can be updated and saved"

<Resource type="javax.sql.DataSource"
validationQuery="SELECT 1"

<Service name="Catalina">

<Connector protocol="org.apache.coyote.http11.Http11Protocol"
port="443" maxThreads="200" scheme="https"
secure="true" SSLEnabled="true"
clientAuth="false" sslProtocol="TLS"

<Engine name="Catalina" defaultHost="localhost">

<Realm className="org.apache.catalina.realm.LockOutRealm">
<Realm className="org.apache.catalina.realm.UserDatabaseRealm" resourceName="UserDatabase"/>

<Host name="localhost" appBase="webapps" unpackWARs="true" autoDeploy="true">

<Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
prefix="localhost_access_log." suffix=".log"
pattern="%h %l %u %t &quot;%r&quot; %s %b" />


4) Save modified server.xml page

Press Ctrl + S or File>Save. 

 5) Close Notepad. 

Step 7) 


  • Download Mifos 

1) Go to link here, for latest version:



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. 

Step 8) 

  • Drop Mifos into Tomcat folder

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

1-a) Copy "fineract-provider.war" file from downloaded fineract-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) api-docs to tomcat>>webapps>>ROOT folder

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



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


4) Copy & replace pentaho folder into .mifosx folder 

 Step 9) 

  • Start Mifos   

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"


4) You could access through any internet browser:- 



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


6) Login into Mifos, by providing your credentials




You could access Mifos X through any internet browser:- 

https://server ip address  with you earlier credentails

Note: Since in this instruction page, we have provided port number as 443 in server.xml page so need to provide port number. Since we have renamed community-app as ROOT no need to provide /community-app



Related articles