Mifos Troubleshooting Guide

In case of the Mifos application is not loading on the browser or unable to login to the application please follow the below steps.

1. Check if MySQL is up and running ps -eaf | grep mysql xxxx xxxx xxxx 0 xx:xx pts/0    00:00:00 grep --color=auto mysql "Then it means that SQL is not up and running" cd /opt/mysql OR cd /opt/mariadb sudo -umysql ./bin/mysqld &
 * Run the below command
 * If the output has only one line similar to the below:
 * Go to the MySql folder
 * If that folder does not exist then go to MariaDB folder
 * Run the below command to start the DB

2. Check if Tomcat is up and running ps -eaf | grep tomcat xxxx xxxx xxxx 0 xx:xx pts/0    00:00:00 grep --color=auto tomcat "Then it means that Tomcat is not up and running" tstart tstart: command not found sudo /opt/tomcat/bin/startup.sh tlog tlog: command not found sudo tail -F /opt/tomcat/logs/catalina.out "Make sure that the log has the line similar to the below:" webapps/fineract-provider.war] has finished in [xx,xxx] ms "And also that there are no errors in the log above this line" In case of any error logs are seen follow the fix for specific errors given in this page. vlog vlog: command not found sudo vim /opt/tomcat/logs/catalina.out
 * Run the below command
 * If the output has only one line similar to the below:
 * Run the below command to start the server
 * If the above output is:
 * Then run the below command
 * Ensure that the server has started with the command
 * If the above command output is:
 * Then run the command:
 * In case the log files needs to be examined fully the use the command:
 * If the above command output is:
 * Then run the command:
 * Now open the browser on your machine and access the application

3. In case when the application is opened in the browser it is not getting loaded even after long time then check for port vconf vconf: command not found sudo vim /opt/tomcat/conf/server.xml sudo ufw status ufw is inactive sudo ufw enable
 * Check tomcat port
 * If the above command output is:
 * Then run the command:
 * Note down all the numbers in that file (Port numbers)
 * These ports needs to be allowed to connect for which either ufw or iptables needs to be used
 * If the output is
 * Enable ufw

sudo ufw status "If the noted ports are not listed in the allowed list then:" sudo ufw allow port_number "Ensure that all necessary ports are added to the allow list" ufw: command not found sudo iptables -nvL sudo iptables netstat netstat -l sockstat -l netstat -lntu sudo iptables -A INPUT -p tcp --dport  -j ACCEPT
 * If the ufw command output is:
 * Use iptables to allow the Ports. Use the below commands to check if the port is in the allowed list
 * If it is not in the allowed list the use the below command to allow the port. Run once for each port.
 * Now open the browser on your machine and access the application

4. Unable to login to the application Couldn't connect to server. Make sure you are using correct settings.
 * In case the application opens in the browser, when login credentials is entered and the below error message is displayed on the browser:
 * Chances are that the certificate is not passed. Follow the certificate passing procedure and then try again.


 * Even after passing the certificate if the same error exists then check tomcat as:
 * 1) Tomcat has not started
 * 2) Conflict due to multiple tomcats started (Use ps command to check and kill all and start only one again)
 * 3) Tomcat started but not fineract-provider (Check logs for specific error)