Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

Version 1 Current »

  1. Objective

Provide clear instructions in order to Install the Mifos Platform 24.04.30 Release on a Windows 11 Home x86_64 Operating System, these instructions should ideally be executed by users with basic technical skills.

  1. Target Audience

Username

User description

General Public

User should have basic knowledge about Software Installation on Windows.

  1. System requirements

Hardware:

  • 8Gb RAM 

  • 2 vCPUs (Intel x86 64bits or AMD x86 64bits)

  • 32Gb Storage 

Software:

  • Windows 11 Home x86_64 Operating System

  • Apache Tomcat 10.1

  • Java JDK Zulu version 17 LTS

  • MariaDB 11.3

  1. 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.

  1. Instructions

  1. Install MariaDB server

Go to MariaDB Download Web Page and select the version 11.3 for  Windows.

https://mariadb.org/download/

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.

  1. Set the Apache Fineract’s environment variables

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.

  1. Install Java Zulu JDK 17

Go to Java Zulu JDK Download Web Page

https://www.azul.com/downloads/#downloads-table-zulu 

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.

  1. Get the Apache Tomcat version 10.1 which is the Application Server required to run Mifos X 

Go to Apache Tomcat Download Web Page

https://tomcat.apache.org/download-10.cgi 

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

  1. Delete the Apache Tomcat ROOT folder content and copy on it the content of the Webapp Mifos Release 24.04

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-24.04.30.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.

  1. Download zip file from SourceForge https://sourceforge.net/projects/mifos/files/Mifos%20X/mifosplatform-24.04.30.RELEASE.zip/download 

When you enter the download link, the file will automatically start downloading

We locate the downloaded zip file

We unzip the zip file

We enter the path where the decompressed file is saved

We locate the unzipped file

  1. Copy the Apache Fineract binary

Go to the mifosplatform-24.04.30.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.

  1. Verify the Mifos Platform 24.04.30 Release

Open the Mifos X 24.04 User Interface on a web browser

http://localhost:8080 

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.

  • No labels