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
Code Block |
---|
$ 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)
Code Block |
---|
$ 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
Code Block |
---|
$ 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.
Code Block |
---|
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
Code Block |
---|
$ edit ~/.bashrc |
Add these in the end of the file.
Code Block |
---|
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.
Code Block |
---|
source ~/.bashrc
JETTY_FOLDER/bin/jetty.sh start |
Go to http://localhost:8080/mifos/ in browser and login
User - mifos
Password - testmifos