Mifos on Mac

Owned by UdaiU (Unlicensed)
Last updated: Mar 09, 2013Version comment

This documentation is about installing Mifos on Mac OS 10.8. If you are looking for development then you might want to look into Developer Setup guide.

You would need to install Java, MySQL and Jetty Server to run Mifos.

Install Java 1.6

It is possible that you already have Java installed on the system.

Open terminal to check if you have java already installed

$ java -version
java version "1.6.0_17"
Java(TM) SE Runtime Environment (build 1.6.0_17-b02)
Java HotSpot(TM) 64-Bit Server VM (build 23.7-b01, mixed mode)

Since you have typed java in terminal and if you don't have java then Mac will automagically ask to install it since you are asking for it.

Install MySQL 5.1

http://dev.mysql.com/doc/refman/5.1/en/macosx-installation-pkg.html

http://dev.mysql.com/doc/refman/5.1/en/macosx-installation-startupitem.html

If you are not good with the terminal they you might want to try a MySQL GUI tool.

http://dev.mysql.com/downloads/workbench/5.2.html

NOTE: make user you note down the root user password before completing the process.

Create Mifos database and user.

Login to mysql terminal client using root password. (ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/tmp/mysql.sock' means you haven't installed mysql properly, reinstall it by paying attention to mysql guide)

$ mysql -u root -p
(enter root password)
> CREATE DATABASE mifos;
> GRANT ALL on mifos.* to 'mifos'@'localhost' identified by 'mifos';
> GRANT ALL on mifos.* to 'mifos'@'%' identified by 'mifos';

just to test the connection run this to be sure things are working

$ mysql -u mifos -pmifos mifos

Assuming that you have downloaded the latest Mifos zip file and extracted it.

Go to that folder from terminal. You will see some folders like db and a war file.

from that folder run these to setup mifos database.

mysql -D mifos -u mifos -pmifos < db/sql/base-schema.sql
mysql -D mifos -u mifos -pmifos < db/sql/base-data.sql
mysql -D mifos -u mifos -pmifos < db/sql/init_mifos_password.sql

Install Jetty

Download Jetty from here http://archive.eclipse.org/jetty/7.3.1.v20110307/dist/

Extract it, put it where you would like to, we will call that location as JETTY_FOLDER (absolute path).

From the Mifos zip take the WAR file and put it in JETTY_FOLDER/webapps

$ edit ~/.bashrc

Add these in the end of the file.

export JETTY_HOME=JETTY_FOLDER
export JAVA_HOME=/Library/Java/Home/
export JAVA_OPTIONS="-Xms1024M -Xmx1024M -XX:MaxPermSize=256m"

Now, from terminal after you make the change.

source ~/.bashrc
JETTY_FOLDER/bin/jetty.sh start

 

Go to http://localhost:8080/mifos/ in browser and login 

User - mifos

Password - testmifos

Â