How to set up a Pentaho for Mifos
Pentaho Reports development
Tools required for development
- Eclipse for Java development (Eclipse 3.6 or later)
- Pentaho Design Studio for XACTION development (3.6.0-stable)
- Pentaho Report Designer for reports development (3.6.0-stable)
Tools required for development and staging/production
- Pentaho Data Integration for ETL development (4.0.0-stable)
- Pentaho BI Server (3.7.0-stable)
- MySQL (5.1)
Configure Pentaho BI Server for Mifos
- Installing Mifos BI 1.0
- note that this isn't technically necessary on a dev machine, but doing so will make your setup more like a prod/staging setup
Steps for PPI dev
- Clone the "bi" repository (see Mifos Version Control Guide).
- Setup the Pentaho BI server.
- Import the git repository to Eclipse.
- Create a Mifos (operational/online/OLTP) database, from a dump or following instructions in INSTALL.
- Configure data sources.
- pentaho data integration: edit
simple-jndi/jdbc.properties
- SourceDB should point to Mifos OLTP database
- DestinationDB should point to data warehouse
- mysql connection URL must include
useUnicode=true&characterEncoding=UTF-8
- pentaho data integration: edit
- Load PPI survey.
ppi/PPISurveyINDIA.xml
in the "bi" repository should be copied to whateverGeneralConfig.UploadQGDirectory
is configured to in Mifos ($HOME/.mifos/uploads/questionGroups
by default)- then do: Admin → Activate Question Group and pick INDIA
- Create two clients in Mifos, enter surveys for them
- Create data warehouse. See
initialise_datawarehouse.bat
. - Run
ppi/CreateAndPopulatePpiTables.kjb
using pentaho data integration (Kitchen can run it)
More Mifos-specific reports setup
- symlink/copy BI_CLONE/reports/standardReports to
BISERVER/pentaho-solutions (or a sub-folder in BISERVER/pentaho-solutions) - symlink/copy BI_CLONE/reports/commonActions to BISERVER/pentaho-solutions
- symlink/copy BI_CLONE/reports/dataAccess to BISERVER/pentaho-solutions
- install CDA from http://code.google.com/p/pentaho-cda/
- for 3.6.0, patch CDA following Udai's tip inhttp://thread.gmane.org/gmane.comp.finance.mifos.devel/10466
- symlink/copy BI_CLONE/reports/i18n/org to
BISERVER/tomcat/webapps/pentaho/WEB-INF/classes - restart Pentaho BI server
- symlink/copy BI_CLONE/reports/i18n/org to
PRD/resources- this makes i18n messages show up in the Pentaho Report Designer
Deployment
- scp stuff to a server
Tips
- if you get strange null pointer exceptions trying to run CDF reports, try refreshing resources