Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Introduction to the Upgrade Guide for 5.4


Introduction to the upgrade process.

This document describes how to update from Pentaho Business Analytics (BA) 5.1.x, 5.2.x, or 5.3.x to 5.4 and from Pentaho Data Integration (DI) 5.1.x, 5.2.x, or 5.3.x to 5.4. The 5.4 release contains multiple fixes to improve the efficiency of your Pentaho system.

·      Click here to view the fixes in Pentaho 5.4.x

  • If you are upgrading from versions prior to BA 4.8.x or DI 4.4.x of the software, visit previous versions of the documentation to upgrade incrementally, version by version, until you get to PDI version 4.4.x or BA version 4.8.x of the software. 
  • If you are upgrading from versions BA 4.8.x or DI 4.4.x of the software, follow the instructions in the BA Migration and DI Migration documents to migrate to version 5.4.x. You do not need to complete any other instructions in this guide.
  • If you are upgrading from versions BA or DI 5.0.x of the software, follow the instructions in the  Upgrade BA Systems and Upgrade DI Systems  before you complete the steps in this document. When you are finished, return to this document (Upgrade BA and DI) to upgrade from 5.1.x, 5.2.x, or 5.3.x to 5.4.


In addition to the installation steps, the update process uses a set of backup and recovery scripts to aid in the backup, recovery, and transfer of your system’s existing configuration files. We recommend that you read through this entire document before you perform the installation steps.  Becoming familiar with the entire update process allows you to create a strategy which can increase your likelihood of a successful update experience.

We recommend that you initially perform this update in a development test environment before upgrading your production environment. To minimize the impact to your day-to-day operations, we suggest that you perform this update during off-business hours. If you need assistance, contact Technical Support. If you need help tailoring the update process for your environment, contact Concierge or Consulting Services.


This document is written for IT administrators who know where their data is stored and how to connect to it, as well as details about the computing environment and how to use a command prompt to issue commands for Microsoft Windows or Linux.

Logon Credentials

You must have a user ID with administrator privileges to install this update. For Linux, log on as the user who installed the system to successfully complete some tasks. It is recommended that you create a user account named 'pentaho' on the server computer for installation tasks. For Windows, log on as a user with administrator privileges to complete installation tasks. This link provides you with more information on creating a user account for installation tasks.