Provide clear instructions in order to Install the Mifos Platform 23.12.31 Release on a Windows 11 Home x86_64 Operating System, these instructions should ideally be executed by users with basic technical skills.
Target Audience
Username | User description |
General Public | User should have basic knowledge about Software Installation on Windows. |
System requirements
Hardware:
|
Software:
|
Deployment Architecture
This is a graphical representation of the components that will be installed, they are highlighted in yellow, and the others put in the graphic as a reference and they can be used for extending the functionality.
Instructions
| |
Go to MariaDB Download Web Page and select the version 11.3 for Windows. | |
Double click on the file that was downloaded | |
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button. | |
Read the license and check the box “I accept the terms in the License Agreement” and click on the “Next” button. | |
Select the software that will be installed as it is shown in the Screenshot. And click on the “Next” button. | |
Set the root password, in this case we are setting it as: skdcnwauicn2ucnaecasdsajdnizucawencascdca Make sure to set the same password in the environment variables in the following section. | |
Select the 3306 port. Please make sure that it is free uninstalling old MySQL or MariaDB installations, if you do this make sure to backup your data. | |
Click on the “Install” button. | |
Depending on your hardware setting, it could take some time to complete. | |
Once the process is completed click on the “Finish” button. | |
Using the Windows application launcher, execute the “HeidiSQL” application. It will show an initial screen like this one. | |
Create a connection to the localhost: IP: 127.0.0.1 Port: 3306 User root Password: skdcnwauicn2ucnaecasdsajdnizucawencascdca And click on the “Open” button | |
In the left menu, you can browse the default schemas. It is required to create two: fineract_tenants fineract_default | |
Rick click on the left menu > Create New > Database | |
Create new database Name: fineract_tenants Collation: utf8mb4_unicode_ci Click on the “Accept” button. | |
Create new database Name: fineract_tenants Collation: utf8mb4_unicode_ci Click on the “Accept” button. | |
| |
In the Windows Application Launcher look for the System Variables Edition functionality | |
On the bottom of the window, look for “Env Variables” | |
In the “Env Variables”, add a new entry: Name: FINERACT_DEFAULT_TENANTDB_PWD Value: skdcnwauicn2ucnaecasdsajdnizucawencascdca Click on the “Accept” button. | |
In the “Env Variables”, add a new entry: Name: FINERACT_HIKARI_PASSWORD Value: skdcnwauicn2ucnaecasdsajdnizucawencascdca Click on the “Accept” button. | |
In the “Env Variables”, add a new entry: Name: FINERACT_SERVER_SSL_ENABLED Value: false Click on the “Accept” button. | |
In the “Env Variables”, add a new entry: Name: FINERACT_SERVER_PORT Value: 8080 Click on the “Accept” button. | |
Export the environment variables required by Apache Fineract in order to use the root password that was set in the MariaDB Installation, also we are disabling the SSL because this is a demonstration. We encourage you to use the secure connection by enabling HTTPS. | |
| |
Go to Java Zulu JDK Download Web Page | |
Select the Java 17 LTS Windows version, there are two options, we are going to download the Windows Installer (msi file extension) | |
Double click on the file that was downloaded | |
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button. | |
Select the options as it is shown in the Window (including the JAVA_HOME option) and click on the Next button. | |
Click on the Next button in order to start the Installation process. | |
Once completed the process you can click the Finish button. It could take a few seconds or some minutes, depending on your PC hardware settings. | |
in order to verify that the JDK Zulu has been installed, open a cmd terminal. | |
On the terminal execute the following command: java -version It should have a similar output as the screenshot. | |
| |
Go to Apache Tomcat Download Web Page | |
Select the binary for Windows Service Installer | |
Double click on the file that was downloaded | |
The Installation Wizard will help us to have a graphical UI for the process. Click on the Next button. | |
Read the license and click on the “I agree” button. | |
Check the options as per the Screenshot and click on the “Next” button. | |
Check the options as per the Screenshot and click on the “Next” button. For the example we have created a simple Tomcat Administrator and its password, this is optional. | |
Verify the path of the Zulu Java 17 Installation and click on the “Next” button. | |
Verify the location of the Apache Tomcat Installation and click on the “Next” button. This location is important because we will use it later for copying the Mifos WebApp files and the Apache Fineract war file. | |
Complete the Installation, checking the “Run Apache Tomcat” option and click the “Finish” button. | |
Apache Tomcat Service will start. It could take a few seconds or some minutes, depending on your PC hardware settings. | |
Once completed you can check that Tomcat is running opening a Web browser and go to http://localhost:8080 A web page will be displayed | |
| |
Execute the File Explorer with Aministrator’s privileges then navigate to the Apache Tomcat Location that was defined in the previous step. | |
You will get a warning message about the access grants to the Apache Tomcat Folder. Click on the “Continue” button. | |
Select all the files and folders inside the Apache Tomcat “ROOT” folder and delete them. | |
Go to the mifosplatform-23.12.31.RELEASE folder that was unzipped and select the content of the “webapp” folder. Copy the files and folders on it. | |
Go back to the Apache Tomcat “ROOT” folder and paste the files that were selected in the previous step. | |
| |
Go to the mifosplatform-23.12.31.RELEASE folder that was unzipped and select the fineract-provider.war file and copy it. | |
Paste fineract-provider.war in the Apache Tomcat “webapps” folder. It will be deployed and at the end it will create a “fineract-provider” folder. Please wait some minutes, the Apache Fineract deployment process and its first time running will take some minutes to complete. | |
| |
Open the Mifos X 23.12 User Interface on a web browser The credentials for login: user: mifos password: password | |
Once you can enter into the Mifos WebApp the initial page will look like this one. Enjoy and give us feedback. If you require some help please contact us. This are the channels availale to get in contact: https://mifos.org/resources/community/communications/ Please include screens, logs (use a paste tool like https://privatebin.net/ ), description of the issue with all the details that you can share. Please be careful and avoid to include sensitive data. | |