Mifos 21.07.02 Installation on Tomcat-Windows

Prerequisite Software

Note

the software and versions included below are a mandatory prerequisite

JAVA DEVELOPMENT KIT >> VERSION 15.0.2 later versions not tested
MYSQL SERVER >> Version 5.7 later versions not tested
TOMCAT >> Version 9.0.80 later versions not tested

For First time installations, kindly stick to the versions below and only change after you have succeeded
tomcat 9.0.xx
Mysql 5.7.xx
JDK 15.0.xxx

Prerequisite Software

Note

the software and versions included below are a mandatory prerequisite

JAVA DEVELOPMENT KIT >> VERSION 15.0.2 later versions not tested
MYSQL SERVER >> Version 5.7 later versions not tested
TOMCAT >> Version 9.0.80 later versions not tested

For First time installations, kindly stick to the versions below and only change after you have succeeded
tomcat 9.0.xx
Mysql 5.7.xx
JDK 15.0.xxx

1) Before beginning, uninstall any existing versions of Java currently on your computer.

2) In your web browser, go to https://www.oracle.com/java/technologies/javase/jdk15-archive-downloads.html

Download and Install jdk-15.0.2_windows-x64_bin.exe

1) In your web browser, go to https://dev.mysql.com/downloads/windows/installer/5.7.html to download MYSQL server v5.7.

Or you can directly download the installer file for (windows 64bit) from my drive here

2) Run the MySQL installation file. Click on the Typical button and then click on Next button.

3) During MySQL installation, use Advanced Configuration > Show Advanced Options and set the MySQL ROOT Password to mysql. Then click on the Save button. This will set your username to root and your password to mysql.

1) In your web browser, go to https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.80/bin/to download Tomcat 9.0.80.

>> Under the section Binary Distributions>>Core, click on the link 32-bit windows zip or 64-bit windows zip (depending on your system architecture) to download.

2) Extract the apache-tomcat-9.0.80.zip.

3) Copy and paste the apache-tomcat-9.0.80 folder to the c:\ drive, then rename it tomcat.

1) Open your Environment Variables:
Start Menu > Control Panel > System and Security > System > Advanced System Settings > Environment Variables.

2) Create the JAVA_HOME variable:

Click on the New button, under the User Variables section.
For Variable Name, enter JAVA_HOME
For Variable Value, provide the Java path (for example: C:\Program Files\Java\jdk-15.0.2).
Click the OK button.

3) Edit the PATH variable:

In the System Variables section, scroll down to and select the Path variable.
Click the Edit button at the bottom of the window.
When you click edit you will see the image similar to what is shown below below
Following the numbering shown above click New, a newline will be added at the bottom. and the line below
C:\Program Files\Java\jdk-15.0.2\bin
Following the numbering shown above click New, another newline will be added at the bottom. and the line below
C:\Program Files\MySQL\MySQL Server 5.7\bin
In case you have other softwares that use other java version its best to move the path by using the option of Move Up see image below
Once you are done click OK button

4) Create the JAVA_OPTS variable:

a. Under the User Variables section, click the New... button again.
b. For Variable Name, enter JAVA_OPTS
c. For Variable Value, enter the system's memory size, for example: -Xms2048m -Xmx4096m -XX:MaxMetaspaceSize=256m

5) Create the CATALINA_HOME variable:

a. Under the User Variables section, click the New... button again.
b. For Variable Name, enter CATALINA_HOME
c. For Variable Value, enter this C:\tomcat

6) Create the CATALINA_OPTS variable:

a. Under the User Variables section, click the New... button again.
b. For Variable Name, enter CATALINA_HOME
c. For Variable Value, enter this -Xms2048m -Xmx4096m