2.4 KiB
Installation Mifos Platform
This file describes how to install mifos platform for use in a production or test environment.
The two ways to get up and running with mifos platform is:
- Use Amazon AWS and mifosplatform public AMI to spin up a new instance in the cloud
- Manually install the prerequisite software on your own machine, follow setup instructions and use release artifacts to get platform running yourself.
1. Amazon Public AMI
Launch instance ami-65e6e011
- Mifos X Public AMI 1
- Ubuntu11.10, tomcat7.0.21 (with SSL),MySql 5.1.62, Java 1.6_30, Mifos X Platform
2. Manual Installation
2.1 Prerequisite Software
Before running mifos platform you must have the following software installed:
- Oracle Java - JDK/JRE 1.6 (NOT 1.7) (http://www.oracle.com/technetwork/java/javase/downloads/index.html)
- Oracle MySQL - (http://dev.mysql.com/downloads/)
- Apache Tomcat 7 - (http://tomcat.apache.org/download-70.cgi)
2.2 MySQL Setup
Assumption: MySQL server is now installed.
You should know your password for MySQL root user. If you wish you can change it by doing:
mysqladmin -u root -p 'oldpassword' password newpassword
The mifosplatform settings default to a mysql root user with username: root, password: mysql
If you have never installed mifosplatform before follow section 2.2.1 for first time setup of database, otherwise read section 2.2.2 on database upgrades.
2.2.1 First Time Database setup
Mifos platform has support for hosting multiple tenants so we use two database schemas:
- mifosplatform-tenants: which is responsible for persisting the tenant information which is used when deciding what schema each incoming request in the platform should route to. It acts as a registry which contains the details of all the tenant databases, and their connection information, which is used by MifosX to connect to the appropriate tenant.
- mifostenant-default: All tenant specific schemas follow the pattern mifostenant-xxxx, out of the box the default schema is used.
Step one: create mifosplatform-tenants database
mysql -uroot -pmysql
create database `mifosplatform-tenants`;
exit
Step two: