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

Pentaho configuration

This guide presents basic configuration tasks for the Pentaho Server, data connections, the Pentaho design tools, and Hadoop cluster connections so you can get started creating ETL solutions and data analytics. These configuration tasks can be performed through the PUC (Pentaho User Console), the PDI (Pentaho Data Integration) client, or edits to shell scripts and property files. A Pentaho administrator user name and password is required to perform configuration tasks through the user console.

These tasks are for IT and Pentaho administrators as described in the following definitions:

  • IT administrator

    Installs, configures, and upgrades the Pentaho Server. An IT administrator knows where the data is stored, how to connect to it, details about the computing environment, and how to use the command line on Microsoft Windows or Linux.

  • Pentaho administrator

    Responsible for creation and management of users and roles along with managing workstations so the ETL specialists and business analysts can create, publish, and share content.

NoteThis guide assumes you have installed the Pentaho software.

Tasks to be performed by an IT administrator

As an IT administrator, you need to configure the Pentaho Server and define what security to use. If your team is working with big data, you will also need to set up a connection to a Hadoop cluster.

Configure the Pentaho Server

Basic server configuration tasks include starting and stopping the Pentaho Server, increasing the server's memory limit, and specifying data connections.

Learn more

Define security for the Pentaho Server

You also need to establish a security plan for your Pentaho system.

Learn more

Use password encryption with Pentaho

Strengthen security by using encrypted passwords for Pentaho applications.

Learn more

Set up the Pentaho Server to connect to a Hadoop cluster

If you are an IT administrator working with big data, you will need to configure the Pentaho Server to connect to a Hadoop cluster.

Learn more

Tasks to be performed by a Pentaho administrator

As a Pentaho administrator, you need to configure data connections, manage the Pentaho Server, and set up the BA (Business Analytics) or PDI (Pentaho Data Integration) design tools.

Define data connections

Use the Database Connection dialog box in PUC and PDI to define database connections.

Learn more

Assign permissions to use or manage database connections

Specify which data to make visible to selected users and roles.

Learn more

Manage users and roles

If you are using basic Pentaho security, the Pentaho administrator may be tasked with creating and managing users and roles, including assigning permissions to allow users to access the content they need.

With PUC

Switch between user and role settings to add, delete, and edit users and roles in PUC.

Learn more

With the PDI client

Control users and roles in the Pentaho Repository with the PDI client.

Learn more

Configure the design tools and utilities

Before using design tools and utilities, you need to perform configuration tasks for each workstation running these tools.

Learn more