Page Comparison

...

This guide

• is written for Ubuntu 810.10 04 for the 32-bit x86 architecture, but may work on other versions
• attempts to call out steps required for different versions of Ubuntu
• applies to the current Mifos development code in the version control system in "trunk"

...

The default JDK on Ubuntu 8.10 is OpenJDK 6, which Mifos should support (at least one developer is successfully using soylatte, the OpenJDK 6 port to Mac OS X)Ubuntu 8.04's JDK is GNU JDK which Mifos does not support. Earlier versions use Java-5 which Mifos also no longer supports. In either case you need to install .

Oracle/Sun Java-6 JDKis what we recommend for production, so it's the best bet for development, too. Execute the following:

sudo apt-get install sun-java6-jdk subversiongit-core mysql-server

Notes:

• running this command more than once has no effectsun-java6-jdk
• You can make sun-java6-jdk the default for your applications by executing

sudo update-java-alternatives -s java-6-sun

Tomcat

...

7

Mifos requires Tomcat 67.x. Ubuntu 8.10 installs the tomcat6 package, but as of fall, 2008 the package was buggy. Earlier versions of Ubuntu come with Tomcat 5.5, which Mifos no longer supports. Mifos is also not able to work with the Ubuntu Tomcat package in Ubuntu 9.04. We recommend installing Tomcat 6 from a downloaded tarball, but here is a link about how to get the Ubuntu Tomcat package to work on Ubuntu 9.04.Download the latest Tomcat 6.x archive Download Tomcat tarball from http://tomcat.apache.org/ (look under Downloads → Binary distributions → Core) and unpack it. In the instructions that follow, we'll assume you unpacked Tomcat to $HOME/tomcat6tomcat7. If you've put it somewhere else, adjust accordingly.

...

If you run into java.lang.OutOfMemoryError: Java heap space during mvn's e.g. javac invocation, an "export MAVEN_OPTS=-Xmx512m" helps, best appended to your ~/.profile file.

Set up the database

If you are building/deploying a Mifos version prior to 1.6.0, you must work around MIFOS-1513. Create a OPTIONAL: create a file named mifos.cnf in /etc/mysql/conf.d/ and put in it:

[mysqld]
# due to issue 1513
lower_case_table_names = 1
# optional, but saves disk space
innodb_file_per_table

Restart the database for the new settings to take effect.

sudo /etc/init.d/ service mysql restart

Then

• Create mifos and mifostest databases. Use:

  No Format
  ~$ mysql -u root -p mysql> CREATE DATABASE mifos; mysql> CREATE DATABASE mifostest; mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | mifos | | mifostest | | mysql | +--------------------+

• Grant permissions to user 'mifos' (doing these grants more than once has no effect). If you choose a different user name and password, adjust these instructions accordingly:

  No Format
  mysql> GRANT ALL on mifos.* to 'mifos'@'localhost' identified by 'mifos'; mysql> GRANT ALL on mifostest.* to 'mifos'@'localhost' identified by 'mifos'; mysql> FLUSH PRIVILEGES;

• test database connection as user 'mifos'

  No Format
  mysql -u mifos -pmifos mifos ...repeat for other databases

...