Hitachi Vantara Pentaho Community Wiki

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


How to set up and configure Pentaho (Kettle, Pentaho Data Integration, Pentaho Business Analytics Suite) for your specific Hadoop distribution.

This page applies to Pentaho Suite versions 5.2 and later. For 5.1 or earlier, go here

Pentaho supports different versions of Hadoop distributions from several vendors such as Cloudera, Hortonworks, and MapR. To support this many versions, Pentaho uses an abstraction layer, called a shim, that connects to the different Hadoop distributions. A shim is a small library that intercepts API calls and redirects or handles them, or changes the calling parameters. Periodically, Pentaho develops new shims as vendors develop new Hadoop distributions and versions. These big data shims are tested and certified by Pentaho engineers. The following steps will help you get Pentaho set up to work with your Hadoop cluster.

titleShim support policy

Pentaho provides Enterprise Edition support for distributions by Cloudera, Hortonworks and MapR. It is Pentaho's intention to support new distro's and versions by these vendors as soon as we can after release. This support is made available via monthly service packs.

Due to the rapid pace of development and frequency of releases on the part of the distro vendors, Pentaho can only test and fully support the last two major releases for each vendor. There is no reason that previous shims would stop working as new ones are released but we have to draw the line at 2.


Check for Pentaho Hadoop Distribution Support 

Our support matrix in our documentation lists the currently-supported Hadoop distributions.  Make sure that the Hadoop distribution you want to use is supported:


  • If the Hadoop Distribution that you want to use is not listed, visit our 5.1/5.2 and 5.0 pages; a previous version of our software might support older Hadoop Distributions.  Downloads appear there as well.
  • You can request that Pentaho develop a shim for a distribution by contacting sales or filling out a Jira ticket or if you are an EE subscription customer, you can contact Pentaho Support.
  • You can develop a shim yourself. Check out the Hadoop Configuration page for more information.

Set Active Hadoop Distribution

These steps apply for the PDI and BA Servers as well as the Spoon, Report Designer, and Metadata Editor design tools.


CDH 5 users who want to configure CDH 5 to use Map Reduce 1 instead of Map Reduce 2, follow the instructions in Additional Configuration for using MR1 with CDH5.

Future Release Roadmap

The following Hadoop Configurations are planned for post 5.3 delivery.

  • HDP 2.2
  • CDH 5.3

Next Steps

Now that you've configured Pentaho for your Hadoop distribution, there are many things you can do.  Here are a few links to get you started!