Skip to content
This repository has been archived by the owner on Feb 19, 2019. It is now read-only.

Installation FAQ's

Jump to bottom
Shreyank Byadagi edited this page Jun 16, 2016 · 68 revisions
  1. I am unable to login to the Community App and get an error message saying "Please try again, your credentials are not valid"
  2. How do I upgrade my existing Mifosx Installation to the latest version?
  3. How do I load sample data for testing out Mifos X?
  4. How do I add custom reports to MifosX
  5. Flyway upgrade failed, how do I debug the same

Unable to login to the Community App

This error is usually encountered when the MifosX platform server you are trying to connect to is not available or you are trying to connect with Invalid Credentials

Troubleshoot the same as follows:

Cross check your credentials

The default username/password are mifos/password

Ensure the platform is running

Try connecting to the Mifos platform with the default credentials and ensure that you get a JSON response Ex: https://localhost:8443/mifosng-provider/api/v1/clients?tenantIdentifier=default&pretty=true

Search for errors in the Tomcat Log

Some of the most commonly found errors are

Incorrect Database Credentials

If you see an error log similar to

Caused by: org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'jdbcTenantDetailsService' defined in file [C:\Tomcat7\apache-tomcat-7.0.53\webapps\mifosng-provider-jpa-pu\WEB-INF\classes\org\mifosplatform\infrastructure\security\service\JdbcTenantDetailsService.class]: Unsatisfied dependency expressed through constructor argument with index 0 of type [javax.sql.DataSource]: : No qualifying bean of type [javax.sql.DataSource] found for dependency: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Qualifier(value=tenantDataSourceJndi)}; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type [javax.sql.DataSource] found for dependency: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Qualifier(value=tenantDataSourceJndi)} at org.springframework.beans.factory.support.ConstructorResolver.createArgumentArray(ConstructorResolver.java:738) ~[spring-beans-3.2.5.RELEASE.jar:3.2.5.RELEASE]

Verify the following

If you find an error similar to Exception sending context initialized event to listener instance of class org.sp ringframework.web.context.ContextLoaderListener org.springframework.beans.factory.BeanCreationException: Error creating bean wit h name 'tenantDatabaseUpgradeService': Invocation of init method failed; nested exception is org.springframework.jdbc.CannotGetJdbcConnectionException: Could no t get JDBC Connection; nested exception is org.apache.tomcat.dbcp.dbcp.SQLNested Exception: Cannot create PoolableConnectionFactory (Access denied for user 'root '@'localhost' (using password: YES))

Verify the following

  • The table "tenants" in "mifosplatform-tenants" has a row for "mifostenant-default". If your database credentials are not "root" and "mysql", update the same accordingly in this row
  • Verify that you have created a database called mifostenant-default

Out of Memory Error

If you see an error similar to http-bio-8443-exec-9" java.lang.OutOfMemoryError: PermGen space

you would have to increase the permgen space for tomcat. There are a number fo ways of doing the same, the simplest being setting the size in an environment variable called JAVA_OPTS

Ex: JAVA_OPTS = -Xms1024M -Xmx1024M -XX:MaxPermSize=256m

Keystore file is tampered or Password is incorrect

If you see and error similar to

SEVERE: Failed to initialize end point associated with ProtocolHandler ["http-bio-8443"] java.io.IOException: Keystore was tampered with, or password was incorrect

Double check steps listed in https://github.com/openMF/mifosx/blob/master/INSTALL.md#234-configure-for-ssl

  1. Ensure that server.xml is updated with the correct path to the Keystore

  2. Ensure that the right password has been supplied in server.xml

Upgrading an existing installation of MifosX

  1. Download the latest version from http://sourceforge.net/projects/mifos/files/latest/download?source=files and unzip its contents

  2. Delete "fineract-provider.war"(Note:If your using Version 16.01.2.RELEASE and below the file name will be mifosng-provider.war) and "fineract-provider"(Note:In Version 16.01.2.RELEASE and below the folder name will be mifosng-provider) folder from tomcat/webapps and replace them with the latest copy of "fineract-provider.war" from the release downloaded in the previous step.

  3. Delete "community-app" and "api-docs" folders from \tomcat\webapps\ROOT and replace the same with the latest versions from the release downloaded earlier.

If you are updating from version 1.24.0 or lower, follow the special instructions at https://github.com/openMF/mifosx/blob/develop/INSTALL.md#2221-special-instructions-for-those-upgrading-from-version-124-or-lower

  1. Restart tomcat ( this automatically updates the database for the latest release)

Adding custom reports

Refer http://www.youtube.com/watch?v=tk7uyjAM37U Or https://www.youtube.com/watch?v=JgTJCiyOsIQ or You can refer the following link https://hackpad.com/Mifos-X-Reporting-Training-zlXGVQerbOv

Debug Flyway upgrade failure

Refer thread at https://groups.google.com/d/msg/mifosdeveloper/coFu1xfq3ys/fipLdXkFrcwJ

Clone this wiki locally