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
Santosh Math edited this page Aug 22, 2014 · 68 revisions

  1. I am unable to login to the Community App Or I get an Error message saying "Please try again, your credentials are not valid"

  2. I encounter an out of Memory Error (the log file shows a message simmilar to "Exception in thread "http-bio-8443-exec-9" java.lang.OutOfMemoryError: PermGen space")

  3. How do I add custom reports to MifosX

  4. I am currently using MifosX 1.23 version as local installation and I want to upgrade it to the Mifos 1.24 version or any latest version available. What are the steps I have to take?

  5. I have installed MifosX locally in my machine. I run tomcat and got the following error, SEVERE: Failed to initialize end point associated with ProtocolHandler ["http-bio-8443"] java.io.IOException: Keystore was tampered with, or password was incorrect

  6. I have installed MifosX first time in my machine. When I started community-app I saw there were pre-existing clients, groups,centers, etc. How they came?

  7. [I have started tomcat and within seconds it started throwing no errors. When I tried to login into MifosX with username and password and its showing invalid credentials. Please help]

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 see and 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

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

Upgrading MifosX To The Latest Version

Please Go through the following steps:

  1. Download the latest version from the below link(Note that below link is showing the latest version MifosX 1.24, at this point of time) http://sourceforge.net/projects/mifos/files/Mifos%20X/

It will be the zipped file and you need to unzip it in any required drive/folder.

  1. Please Delete the "mifosng-provider.war" file present in the tomcat/webapps folder and copy the new "mifosng-provider.war" file from downloaded latest MifosX and paste it in tomcat/webapps folder.

  2. Please delete the "community-app" and "api-docs" folders from \tomcat\webapps\ROOT folder and copy the same folders from downloaded latest MifosX and paste them in tomcat\webapps\ROOT folder.

  3. Finally, delete the "mifosng-provider" folder present in the \tomcat\webapps folder and restart the tomcat Server.

That's it!! You'll be welcomed to the latest version of MifosX

Keystore file is tampered or Password is incorrect

(Assuming you already know how to generate keystore file or if you don't know, please refer the following link, http://tomcat.apache.org/tomcat-7.0-doc/ssl-howto.html#Configuration) There are mainly two reasons for this error.(other reasons may exist)

  1. You have generated a .keystore file but you haven't set its right path in the server.xml file which is present in the \tomcat\conf. Most of the time, .keystore file is generated in your home directory or you can put it in some other directories too, but ensure that you have set the right path for .keystore file in server.xml file and also remember the password you've given while generating .keystore file.

2)You might have given wrong password in the server.xml file, (ie "keystorepass")

  1. [I am currently using Mifos X 1.24 and unable to login to the Platform App.A dialog box pops up that says authentication required when I try to connect or I get an Error message that says:A username and password are being requested by https://localhost:8443. The site says: "Mifos Platform API".When I input my credentials i.e.,[root,mysql] then a "HTTP Status 401 - Bad credentials" message is displayed.I've observed that the mysql server 5.6.20 I'm using also doesn't allow me to connect using telnet(port=3306).It responds with ....mysql_native_password connection to host lost.Similarly I'm unable to login to the Community App.I get a message saying "Please try again, your credentials are not valid"]

Solved: A friend pointed out to me that I was using incorrect credentials to log in vis a vis I should use mifos/password instead of the beguiling root/mysql.If you are new to Mifos it could be a bit tricky to figure it out as it is not mentioned in the install docs that come with the shipping for Mifos X 1.24.

Pre-existing clients,groups, centers, etc on first time start up of MifosX

While you are configuring mysql, you have run the following sql command, which has loaded some pre-sample data

mysql -uroot -pmysql mifostenant-default < database/migrations/sample_data/load_sample_data.sql

Invalid Credentials, Can't login into MifosX

(Consider the following answer as the one of the possibility. There can be several reasons for invalid credentials, though you have entered correct username and password)

It looks like mifosng-provider.war file hasn't run. Please cross verify and make sure that the war file is in tomcat/webapps folder.

Clone this wiki locally