Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation


This article categorizes troubleshooting recommendations and solutions.

The recommended initial approach for troubleshooting components within Pentaho is to use logging to monitor operations within transformations, jobs, database connections, and the server. You can monitor transformations, jobs, and database connections through logging in PDI. For the Pentaho Server, the log file is pentaho.log, which is in the pentaho-server/logs folder. The contents of this file can help you track down why the server failed to start or work properly.

NoteIf you used a manual install, pentaho.log resides under pentaho-server/tomcat/logs. If you are using JBoss, the pentaho.log resides in the JBoss folder structure under pentaho-server/logs.

Besides analyzing logs, a number of Pentaho customers and partners have posted problems and solutions they have encountered in the past. The following common categories contain descriptions of these problems and how to resolve them:

General issues
Installation and upgrade issues
Security Issues
Pentaho Server issues
Data integration issues
Pentaho Repository issues
Big Data issues
Analysis issues
Report Designer and Reporting engine issues
Metadata issues