Page Comparison

Mifos X Ubuntu Server 1416.04 Installation Guide:

Linux Server for Fineract Platform using Ubuntu Server 1416.04,

Java-JDK (v.1.8.0_65 231 & above),

Tomcat server (v.7.0.68109.0 & above)

MYSQL server (vv5.5 or v5.5 or 5.66 not above or below). and not recommended to use any other version in live production outside of what is provided here

Step 1 - Installing System Updates and Prerequisites:

Run all below mentioned scripts one by one on the ununtu ubuntu console & follow step by step instructions: -

# sudo apt-get update
# sudo apt-get upgrade
# sudo apt-get install python-software-properties
# sudo apt-get install software-properties-common
# sudo add-apt-repository ppa:webupd8team/java
# sudo apt-get update

Install Java :

# sudo apt-get install oracle-java8-installer
OR
# sudo -E add-apt-repository ppa:openjdk-r/ppa
# sudo apt-get update
# sudo apt-get install openjdk-8-jdk

Info

title	java license agreement

On prompting for accepting oracle java agreement, accept the agreement by pressing y(yes) key.

On completion of java installation,one could verify the installed version by & should be 1.8v:-

# java -version

Install mysql-server :

# sudo apt-get install mysql-server

Info

title	mysql password

set mysql root password to: mysql

(Bad for security, but just to get all installed and instructions on how to change it will be provided later in this guide)

You could skip to Appendix A below and setup a custom mifos db user/password right away.

On completion of java installation,one could verify the installed version by & should be 5.5v:-

# mysql --version

Install tomact :

Info

title	Note

The latest tomcat release will change and the link below may become invalid. If wget fails, get the correct link by going to https://tomcat.apache.org/download-70.cgi and under the core section, selecting the link to the tar.gz file. Use it for wget below:-

# sudo wget http://mirrorarchive.reverseapache.netorg/pubdist/apache/tomcat/tomcat-7/v7.0.8685/bin/apache-tomcat-7.0.8685.tar.gz
# sudo mv apache-tomcat-7.0.85109.tar.gz /usr/share
# cd /usr/share
# sudo tar xvf apache-tomcat-7.0.85109.tar.gz
# sudo rm -f apache-tomcat-7.0.85109.tar.gz
# sudo mv apache-tomcat-7.0.85 tomcat7

...

# sudo apt-get install nano

OPTIONAL (date/time settings)

Check date:

# date

and if needed update with

# dpkg-reconfigure tzdata

Step 2 - Tomcat setup

Enabling SSL

...

Info

title	set keystore password

set password to: xyz123

(Bad for security, but just to get all installed and instructions on how to change it will be provided later in this guide)

This gets stored in /usr/share as tomcat.keystore

Updating server.xml configuration file

...

Info

title	nano shortcut keys

Tip: To delete line by line you could use ctrl+k

To exit you could use ctrl+x

To confirm say yes & you could use y

then click on enter button to save

copy and replace below content into it

<?xml version='1.0' encoding='utf-8'?>
<Server port="8005" shutdown="SHUTDOWN">
<Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />
<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" />

</Host>
</Engine>
</Service>
</Server>

...

# cd /usr/share/tomcat7/lib
# sudo wget httphttps://centralrepo1.maven.org/maven2/org/drizzle/jdbc/drizzle-jdbc/1.3/drizzle-jdbc-1.3.jar

Download mysql jdbc connector

Download it from https://dev.mysql.com/downloads/connector/j/,

# wget https://cdndev.mysql.com/get/Downloads/Connector-J/mysql-connector-java-5.1.46.tar.gzj_8.0.31-1ubuntu18.04_all.deb

Then unzip it

#tar -xvf mysql-connector-java-5.1.4649.tar.gz

#rm -r mysql-connector-java-5.1.4649.tar.gz

Then place the .jar in the /usr/share/tomcat7/lib folder.

#sudo mv mysql-connector-java-5.1.4649/mysql-connector-java-5.1.4649-bin.jar /usr/share/tomcat7/lib/

#sudo mv mysql-connector-java-5.1.4649/mysql-connector-java-5.1.4649.jar /usr/share/tomcat7/lib/

#rm -r mysql-connector-java-5.1.4649

The filename above will vary depending on what the latest version of the connector is

...

copy below red colored content into it & exit by pressing ctrl+x then confirm with y for yes.

Tomcat auto-start
#
# description: Auto-starts tomcat
# processname: tomcat
# pidfile:

!/bin/bash
### BEGIN INIT INFO
# Provides:         tomcat
# Required-Start:    $all
# Required-Stop:
# Default-Start:     2 3 4 5
# Default-Stop:
# Short-Description: Auto-starts tomcat
# pidfile: /var/run/tomcat.pid

case $1 in
start)
sh


### END INIT INFO

case $1 in
start)
sh /usr/share/

tomcat7

tomcat9/bin/startup.sh

;;


stop)


sh /usr/share/

tomcat7

tomcat9/bin/shutdown.sh

;;


restart)


sh /usr/share/

tomcat7

tomcat9/bin/shutdown.sh


sh /usr/share/

tomcat7

tomcat9/bin/startup.sh

;;


esac


exit 0

Then Execute on Terminal the command below

# sudo chmod 755 /etc/init.d/tomcat7

...

Download and extract Fineract platform:

Info
For latest release you can download from or If wget/download fails, this link:- http://sourceforge.net/projects/mifos/files/Mifos%20X/ )

# cd /usr/src
# sudo wget https://jaist.dl.sourceforge.net/project/mifos/Mifos%20X/mifosplatform-18.03.01.RELEASE.zip# sudo apt-get install unzip
# sudo unzip mifosplatform-18.03.01.RELEASE.zip
# cd fineractplatform-18.03.01.RELEASE

...

# mysql -u root -pmysql mifosplatform-tenants < database/mifospltaform-tenants-first-time-install.sql

Optional - If you want to load sample data, otherwise you could skip this par:

# mysql -u root -p mifostenant-default < database/migrations/sample_data/load_sample_data.sql

Step 4 - Activate Mifos

Copy fineract-platform and community app into Tomcat's webapps folder:

...

Info

title	pentahoReports & upload directory

Pentaho Reports

If /pentahoReports is not copied into /root/.mifosx, penatoh reports,ex:accounting reports will fail with:

Income Statement.prpt","defaultUserMessage":"Unable to create key: No loader was able to handle the given key data: /usr/share/tomcat7/.mifosx/pentahoReports/Income Statement.prpt","userMessageGlobalisationCode":"error.msg.reporting.error","parameterName":null,"value"

Upload Directory

.fineract directory gets created automatically, if not created then Clients > Upload Documents will fail with: "Error error.msg.document.save" (firebug, network tab)

Access to this directory should be restricted to authorized personnel only.
While all accounting related information is stored in a database, submitted documents are simply stored in orginal format as uploaded. Mifos will store user uploaded files/documents relating to clients,loans,etc in .fineract/

and finally to start

# sudo /etc/init.d/tomcat7 start

Setup is complete and mifos should be running. OPTIONAL:

*in separate terminal you may watch your Mifos(logs) come to life like In case if it throws error ClassNotFoundException org.apache.catalina.core.JasperListener you need to remove the below line from server.xml

Code Block

language	text
title	server.xml

<Listener className="org.apache.catalina.core.JasperListener" />

OPTIONAL:
*in separate terminal you may watch your Mifos(logs) come to life like this:

# tail -f /usr/share/tomcat7/logs/catalina.out

(if all is good, after a while of loading, you should see something like: Root WebApplicationContext: initialization completed in 45876 ms)

Info

title	It's Done!

Congratulations!

You could access Mifos X through any internet browser:-

@ https://server ip address

or if you are using server port number as 8443 then you could access it @ https://localhost:8443

With these credentials:-

username: mifos

password: password

Additional info:-

Platform application should be available @ https://[public DNS]/fineract-provider/api/v1/offices?tenantIdentifier=default&pretty=true
API docs should be available @ https://[public DNS]/api-docs/apiLive.htm

Info

title	Optional title - Appendix A

Appendix A - To change mysql username/password

Change Mifos default mysql password:

# apt-get install phpmyadmin

1. Go to http://[yourserverip]/phpmyadmin and login

2. Click on Privileges, then Add a new User

3. Pick a username/password and create it. Assign full privileges globally, or on mifosplatform-tenants & mifostenant-default databases.

4. On the left, select/open mifosplatform-tenants database,
you should see a table with a single column , click "edit" infront of it.

Locate:
schema_username
schema_password

And set user/pass created in step #3.

Finally, edit

/opt/tomcat/conf/server.xml
username="root"
password="mysql"

And set user/pass created in step #3 here as well.

You can now set new mysql root password, without braking mifos.

Restart tomcat. Finish.

sudo /etc/init.d/tomcat7 restart

Info

title	Need 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.

Versions Compared

Old Version 110

New Version Current

Key

Step 1 - Installing System Updates and Prerequisites:

Step 2 - Tomcat setup

Then Execute on Terminal the command below

Step 4 - Activate Mifos

Appendix A - To change mysql username/password