Troubleshooting Tomcat
The following content was extracted from the Support Manual compiled by SunGard Technology Services in December 2010:
- 1 How to start the tomcat server of MIFOS application?
- 2 How to solve “Not Found Error” (Whenever running Mifos or Application not starting properly)?
- 3 How to re-deploy Mifos application?
- 4 How to upgrade Mifos from older to newer version?
- 5 How to solve upgrade error while accessing URL?
- 6 How to change the default configuration, accounting and database settings of Mifos?
- 7 How to solve “503” error when accessing the URL?
How to start the tomcat server of MIFOS application?
In order to start the MIFOS tomcat application, go to the path where tomcat folder is saved. Then navigate to below location
C:\apache-tomcat-6.0.18\bin\startup.bat
Start the startup.bat file and your tomcat will be started.
Here C:\ - root directory, where your tomcat folder is there.
In order to avoid navigating to the above location daily, user can create the shortcut of the above “start.bat” file on the desktop. Next time onwards, user just needs to double click the shortcut created on desktop. The tomcat will be started automatically.
Below is the screenshot to create shortcut.
Note: On Linux/ Ubuntu machines, you can use the following file for starting the tomcat
C:\apache-tomcat-6.0.18\bin\startup.sh
Creation of tomcat startup shortcut
After clicking the startup.bat, the following screen will appear.
When the above server start up message comes, the tomcat is started.
In order to stop the tomcat, at the same location the user is required to click the “shutdown.bat” or “shutdown.sh” file.
How to solve “Not Found Error” (Whenever running Mifos or Application not starting properly)?
Following steps needs to be replicated –
Shut down tomcat. Delete the war file from the following location
“C:\apache-tomcat-6.0.18\webapps\ “
Delete the work folder also.
“C:\apache-tomcat-6.0.18\work”
Drop the database.
Mysql> drop database <database_name>;
Create and load an empty database of Mifos.
Mysql> create database <database_name>;
Mysql> use <database_name>
Mysql>source <complete path of the file which you want to execute to create mifos schema together with file name>
Usually the file that creates the schema of MIFOS are (you will find these in source folder)
create_mifos_db.sql
init_mifos_password.sql
latest-data.sql
latest-schema.sql
Copy the war file from the correct location in
“C:\apache-tomcat-6.0.18\webapps\ “
Restart tomcat.
Note:
Database steps are executed only when there is no customized data in Mifos initially. If yes, do not perform the steps. Just execute the rest ones.
Always remember that in your root directory, enough disk space should be there to deploy the Mifos WAR file completely. If space is less than what expected, the tomcat will start throwing error on application unexpectedly. So, always have around 10 GB of space should be there in your root directory.
How to re-deploy Mifos application?
To re-deploy the MIFOS with latest WAR or due to some issues with current WAR, the following steps need to be followed
Shut down tomcat. Delete the war file from the following location
“C:\apache-tomcat-6.0.18\webapps\ “
Delete the work folder also
“C:\apache-tomcat-6.0.18\work”
Copy the new WAR file at
“C:\apache-tomcat-6.0.18\webapps\ “
Restart tomcat.
How to upgrade Mifos from older to newer version?
The Mifos teams adds more functionalities to the application with each new release and version of Mifos. In order to replace the existing application with the newer version (latest one), follow the below steps:
Database level changes are also included in the latest WAR file and your current Mifos database automatically gets updated, if there are any changes at schema level.
To upgrade the MIFOS application:
Shut down tomcat. Delete the war file from the following location
“C:\apache-tomcat-6.0.18\webapps\ “
Delete the work folder also
“C:\apache-tomcat-6.0.18\work”
Copy the new WAR at