Hitachi Vantara Pentaho Community Wiki

Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin


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


Include Page
Warning - Pentaho 5.2, 5.3, and


5.4 - Configuration
Warning - Pentaho 5.2, 5.3, and 5.4 - Configuration

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 within 90 days of general availabilityafter 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:

NOTE: Pentaho is pre-configured for Apache Hadoop 0.20.2. If you are using this distribution and version, no further configuration is required.

  • If the Hadoop Distribution that you want to use is not listed, visit our 5.1 and /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 pageConfigurations for more information.

Note:  For instructions on preparing the shim to connect to a Kerberos cluster, see our Mindtouch documentation here:

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.


YARN shims require additional configuration.  See Additional Configuration for YARN Shims for more detail. 

MapR users need to do further configuration as described in Additional Configuration for MapR Shims.

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

Future Release Roadmap

The Support for the following Hadoop Configurations are planned for post 5.3 upcoming patch or future release.

  • HDP 2.2CDH 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!