Mifos Pentaho Plugin - Installation Instruction on Linux Ubuntu 24.04 LTS - Docker Compose - MariaDB

Owned by Victor Romero
Last updated: Jun 07, 2024
2 min read

  1. Objective

 

Provide clear instructions for installing the Pentaho reporting plugin for the Mifos platform on a Docker Compose operating system. Ideally, these instructions should 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 Linux.

 

 

 

 

  1. System requirements

 

Hardware:

  • 8Gb RAM 

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

  • 32Gb Storage 

 

Software:

  • Ubuntu 24.04 LTS

  • Docker Compose

  • Mifos Platform Release 24.04.30 (Apache Fineract 1.10.0)

  • MariaDB 11.2+

 

 

 

  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. We start Docker compose

We start the docker compose service with the command:

 

docker compose pull && docker compose down && docker compose up -d && docker compose logs -f

Validate that Mifos X Release 24.04.30 is up and running entering the following url  http://localhost in a Web Browser

 

 

  1. Set a Fineract Pentaho environment variable

Enter the docker-compose.yml file with the following command:

 

vi docker-compose.yml

We enter the variable:

 

FINERACT_PENTAHO_REPORTS_PATH=/app/pentahoReports

In the volumes section we add the values ​​where the report plugins will be found:

 

-./reports/pentahoReports/:/app/pentahoReports/

      -./reports/libs/:/app/plugins/

 

We create a new folder where we copy files:

 

mkdir reports

 

 

  1. Download zip file from SourceForge https://sourceforge.net/projects/mifos/files/mifos-plugins/FineractPentahoPlugin/FineractPentahoPlugin-1.10.zip/download

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

We locate the downloaded zip file

We unzip the zip file

We locate the unzipped folder

 

 

  1. Copy the Fineract Pentaho binary

Copy the files into the libraries of the Apache Fineract application which is located at cp -Rf /home/fintecheandomx/mifos/FineractPentahoPlugin-1.10.0/MariaDB/* .

 

  1. Restart the Docker compose service

We restart the Docker compose with the command:

 

docker compose pull && docker compose down && docker compose up -d && docker compose logs -f

 

  1. Verify the Mifos Platform 24.04.30 Release

Validate that Mifos X Release 24.04.30 is up and running entering the following url  http://localhost in a Web Browser

Sign in with the default credentials:

 

User: mifos

 

Password: password

We enter the "All" reports section

We are looking for a report that can be used with Mifos Pentaho plugin.

 

For example:

 

Expected Payments By Date - Basic (Pentaho) 

 

Fill out the required data and click on the "Run Report" button

The report will be generated and shown in the web application.

 

 

This is a basic setup to demonstrate the use of the Mifos Pentaho Plugin.

 

Please secure the application connections, the data, and change the default login credentials.

 

Enjoy and give us feedback.

 

If you require some help please contact us. These are the channels available 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.

Remember that these installation instructions are for a quick way to get the Mifos X Platform up and running very quickly. You have to protect the sensitive data in motion/rest, secrets, connections, credentials, etc. based on your local requirements.