Mifos X Ubuntu Server 14.04 Installation Guide: Linux Server for Fineract Platform using Ubuntu Server 14.04, Java-JDK (v.1.8.0_65 & above), Tomcat server (v.7.0.68.0 & above) MYSQL server (v.5.5 or 5.6). |
...
# sudo apt-get update
# sudo apt-get upgrade
# sudo apt-get install python-software-properties
# sudo add-apt-repository ppa:webupd8team/java
# sudo apt-get update
Install Java :
# sudo apt-get install oracle-java8-installer
Info | ||
---|---|---|
| ||
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 | ||
---|---|---|
| ||
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)
On completion of java installation,one could verify the installed version by & should be 5.5v:- # mysql --version |
Install tomact :
# sudo wget http://a.mbbsindia.com/tomcat/tomcat-7/v7.0.68/bin/apache-tomcat-7.0.68.tar.gz
# cd /usr/share
# sudo tar xvf /home/ubuntu/apache-tomcat-7.0.68.tar.gz
# sudo mv apache-tomcat-7.0.68 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 | ||
---|---|---|
| ||
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/tomcat7 as tomcat.keystore |
Updating server.xml configuration file
...
Info | ||
---|---|---|
| ||
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 red colored content into it
<?xml version='1.0' encoding='utf-8'?> <GlobalNamingResources> <Service name="Catalina"> <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> <Engine name="Catalina" defaultHost="localhost"> <Realm className="org.apache.catalina.realm.LockOutRealm"> <Realm className="org.apache.catalina.realm.UserDatabaseRealm" <Host name="localhost" appBase="webapps" </Host> |
...
# cd /usr/src
# sudo wget https://sourceforge.net/projects/mifos/files/Mifos%20X/fineractplatform-16.03.03.RELEASE.zip
# sudo apt-get install unzip
# sudo unzip fineractplatform-16.03.03.RELEASE.zip
# cd fineractplatform-16.03.03.RELEASE
Info |
---|
For latest release you can download from or If wget/download fails, this link:- http://sourceforge.net/projects/mifos/files/Mifos%20X/ ) |
Initialize MySQL data
# mysql -u root -p
...
# 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 | ||
---|---|---|
| ||
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
|
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 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 | ||
---|---|---|
| ||
Congratulations! Mifos: Platform application should be available @ https://[server ip address]/mifosngfineract-provider/api/v1/offices?tenantIdentifier=default&pretty=true Community application should be available @ https://[server ip address]/community-app?baseApiUrl=https://[server ip address]/mifosngfineract-provider/api/v1/ username: mifos password: password |
Info | ||
---|---|---|
| ||
Appendix A - To change mysql username/passwordChange Mifos default mysql password:
1. Go |
...
to http://[yourserverip]/phpmyadmin and login
|