Versions Compared

Key

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


For Video guide - Click on the below link

...


Info
titleRefer New Document for latest version Installation

To Install/Upgrade to the latest version of Mifos (21.07.01) Refer below document

Mifos X 21.07 Installation Guide (with Pentaho plugin)



For a video guide click on the link below

Widget Connector
width700
urlhttps://www.youtube.com/watch?v=mYVMboSZ9Rs
height200400


Panel

On this page:

Table of Contents
maxLevel3
minLevel3
printablefalse



Prerequisite Software

's

  

 Note:- Below are mandatory prerequisite software's with mentioned versions only


Info
titleNote

the software and versions included below are a mandatory prerequisite

  • JAVA DEVELOPMENT KIT >> VERSION 1.8.0_
65
  • 231 & above                                
  • MYSQL SERVER >> Version 5.5 or 5.6 only - Any version above or below is not recommended in a live production environment  unless you have tested it your self
  • TOMCAT >> Version 7.0.
64
  • 109.0 & above (version 7.0.xx.xx)


  •  

    Install Java 

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

2) In your web browser, go to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html, to download JAVA 1.8.

3) Oracle requires that you read the license agreement, then click the button labeled Accept License Agreement.

4) Click the link to download with respect to you system architect the version for your system architecture i.e. Windows x86 for 32bit or Windows x64 for 64bit. 

5) Save the Java installation file to your computer

6) Run & and install the Java file.


  •  

    Install MySQL  


1) In your web browser, go to http://dev.mysql.com/downloads/mysql/5.5.html#downloads.To  to download MYSQL server v5.5.5v.

Click on download button with respect to you system architect the link to download the version for your system architecture i.e. Windows x86 for 32bit or Windows x64 for 64bit. 

2) You can skip this option by clicking the link at the bottom of the page that says No thanks, just start my download. 
& Click and click on the Save button to save the file to your system.

                                                                                                                               

 3) Run the MySQL installation file. Click on the Typical button and then click on Next button.

 

4) During MySQL installation, use Advanced Configuration > Show Advanced Options &  and set the MySQL ROOT Password to mysql. Then click on the Save button. So your user name will be This will set your username to root and your password will be  to mysql.


  •  

    Install Tomcat

1) In your web browser, go to http://tomcatarchive.apache.org/download-70.cgi to download tomcat 7./dist/tomcat/tomcat-7/v7.0.109/bin/apache-tomcat-7.0.109.zip to download Tomcat 7.0.109. This is downloaded as a folder 

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

Image Removed Image Added  

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

                   

  4) Folder: This is the folder once apache-tomcat-7.0.68, 109 gets extracted: -      


5) Copy & Paste and paste the apache-tomcat-7.0.68 folder to the c:\ ( drive) then Rename it to tomcat , then rename it tomcat.


  •  

    Create Environment Variables 

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

2) Create 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

     provide the Java path (for example:

    -

     C:\Program Files\Java\jdk1.8.0_66


    NOTE: 
    i -

    ).

    Info
    titleNote
    1. If you are running 32-bit Windows, then the path
    would be ex
    1. is:
    -
    1. C:\Program Files (x86)\Java\jdk1.8.0_66
    ii -
    1. 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. 
    1. may be different on your system as it is dependent on the version you have installed.


    Image Modified

  • Click the OK button.
3) Edit Edit the PATH variable:
  • In the System Variables section, scroll down to and select the Path variable.
  • Click the Edit button just belowat the bottom of the window.
  • Click Use your mouse cursor into 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\jdk1.8.0_66\bin 
    - For Mysql server path example:- ;C:\Program Files\MySQL\MySQL Server 5.5\bin


    NOTE: 
    i -



    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\jdk1.8.0_66\bin – don't add a semi-colon if your previous PATH already ended with a semi-colon.
    ii -
    1. 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. 
    1.  may be different on your system as it is dependent on the version you have installed.  


    Image Modified

  • Click the OK button  

4) Create Create the JAVA_OPTS variable: 

  • a. Click Under the User Variables section, click the New... button again, under the User Variables section.
  • b. For Variable Name, enter JAVA_OPTS
  • c. For Variable Value, example enter the system's memory size, for example: -Xms512m -Xmx1024m
    Note: Variable value example can be changed with respect to the system memory size for example: -Xms512m -Xmx1024m 


  •  

    Download Mifos 

1) Go to http://mifos.org/ from your web browser

& Navigate

and navigate to Take Action >> Get Mifos 
Image Modified

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

 

link
Image Modified

3) Click on "Download MifosX Now 


4) Kindly fill the Application form with basic information on Mifos Download FormFill out the Mifos Download Form with your information, then click the Next Page button.(NOTE: You could skip this part, by going . The download will start automatically.


Info
titleNote

You can skip the form by scrolling to the bottom of the page

,then click

and clicking on:

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

) The download will automatically start.

However, we

would like

are able to understand

&

and serve you better if you

can

provide details of your organization

details

.


 

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


Info
titleNote
:-

Or You

could

can also download other versions directly from: https://sourceforge.net/projects/mifos/files/Mifos%20X/


 

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. 

...

  •  Initialize MySQL data 

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

2) Run the Heidisql installation file & and setup Heidisql: 

i) For local - Provide mysql password as mysqlClick on local and enter the MySQL password (mysql) in the Password field

ii) Click on the Save button.

iii) Click on open the Open button. 

                                                                                                                           

4) Copy the following database command and paste it into the large white box titled Query
create database `mifosplatform-tenants`; create database `mifostenant-default`; use `mifosplatform-tenants`;



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

 

6) On In the heidisql menu bar, click on File>>Load SQL file...

7) Through In the Load SQL file window,:

  • Navigate to the location where you extracted the Mifos application files.
  • Navigate to the database folder , inside that location.
  • Select the file mifospltaform-tenants-first-time-install.sql and click Open.

Run the first-time-install script, by clicking Run Query button & once its . Once it's successful close the heidisql application.


  •  

    Tomcat - Setup

1) Setting up the Lib folder

a) Download the mysql jdbc 5.1.

27

49 jar file from 

httpcentralmavenorgmaven2mysql/mysql-connector-java/5.1.2727jar

zip 

b) Once it's downloaded, copy

&

the file and paste it to the Tomcat>>lib folder

, Go to Tomcat>>lib folder

Info
titleNote
:

If the tomcat-jdbc.jar file is not available in the tomcat>>lib folder

then you could download and paste it from

2) Generate keystore

 Generate a new keystore using java the Java keytool :

>> Open command prompt 
>> Go 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 -keysize 2048
>> iv) Then provide the password. 
For example: 

Provide input
Answer the questions and then type in y for 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>>open to tomcat>>conf, then right click on the server.xml with notepad file and select Open with>>Notepad:


b) Delete everything in it and copy-paste the following right side entire content of the page code:currently in the server.xml file. Copy and then paste the code to the right that starts with <?xml version='1.0' encoding='utf-8'?> and ends with </Server>.

c) Once content the code is pasted in the server.xml , Below mentioned are file, the following variables need to be modified with respect modified to reflect your system & and settings:
i - Key store path should be modified with your key store path location Example:- keystoreFile(for example: keystoreFile="C:/Users/john/.keystore")
ii - Key store password (which was provided while creating the key) , should be modified Example:- keystorePassto include your password (for example: keystorePass="xyz123")
iii - MYSQL credentials should be modified
Example:- username="root" & password="mysql"to reflect the username and password used in step 4 of the Install MySQL section above (for example: username="root" and 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" />

<GlobalNamingResources>
<Resource name="UserDatabase" auth="Container"
type="org.apache.catalina.UserDatabase"
description="User database that can be updated and saved"
factory="org.apache.catalina.users.MemoryUserDatabaseFactory"
pathname="conf/tomcat-users.xml"
/>

<Resource type="javax.sql.DataSource"
name="jdbc/mifosplatform-tenants"
factory="org.apache.tomcat.jdbc.pool.DataSourceFactory"
driverClassName="com.mysql.jdbc.Driver
url="jdbc:mysql://localhost:3306/mifosplatform-tenants"
username="root"
password="mysql"
initialSize="3"
maxActive="10"
maxIdle="6"
minIdle="3"
validationQuery="SELECT 1"
testOnBorrow="true"
testOnReturn="true"
testWhileIdle="true"
timeBetweenEvictionRunsMillis="30000"
minEvictableIdleTimeMillis="60000"
logAbandoned="true"
suspectTimeout="60"
/>
</GlobalNamingResources>

<Service name="Catalina">

<Connector protocol="org.apache.coyote.http11.Http11Protocol"
port="443" maxThreads="200" scheme="https"
secure="true" SSLEnabled="true"
keystoreFile="C:/Users/john/.keystore"
keystorePass="xyz123"
clientAuth="false" sslProtocol="TLS"
URIEncoding="UTF-8"
compression="force"
compressableMimeType="text/html,text/xml,text/plain,text/javascript,text/css"/>

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

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

<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" />
</Host>
</Engine>
</Service>
</Server>

 

4) Save the modified server.xml page

Press Ctrl + S or File>SaveFile>>Save

 5) Close Notepad. 


Info
titleNote

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

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

...

  •  Create .mifosx 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

                  


...

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
titleNeed Help?

If you need help on the Mifos Installation, you could always reach our partners:-

https://mifos.org/directory/

Ex: https://mifos.org/directory/listing/intelligrow-consultancy-services-private-limited/

Welcome to Mifos community, If you are stuck with the Mifos Installation or need training or customization or need any help with respect to mifos please reach to us at:

Sangamesh Nadagoudar,
sangamesh@intelligrow.co or info@intelligrow.co or sangameshintelligrow@gmail.com

+91-9535891298

www.intelligrow.co

We would be happy to help you.



Filter by label (Content by label)
showLabelsfalse
max5
spacesdocs
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel = "kb-how-to-article" and type = "page" and space = "docs"
labelskb-how-to-article

...