Skip to main content
Pentaho Documentation

Upgrade

This guide describes how to update from Pentaho Business Analytics (BA) and Pentaho Data Integration (PDI) 5.2.x /6.x to Pentaho 7.0. Our latest release contains multiple new features, platform upgrades, and fixes to improve the efficiency of your Pentaho system.

You will need administrator privileges on the Pentaho Server, know where your data is stored, and how to connect to it in order to upgrade to Pentaho 7.0. We recommend that you read through all related materials before starting the upgrade process.

Before You Begin

Before you begin your Pentaho 7.0 upgrade, you'll need to do a few things.

Task Description
Verify Your Current Version of Pentaho Suite and PDI You will need to start with a working installation of at least Pentaho Suite 5.2.x or PDI 5.2.x.

Verify Your System Components are Current

You will need to make sure that your system components, such as web browsers or repository databases, are up-to-date for Pentaho.
Backup Your Databases Create backups of all Pentaho databases.
BA Databases: DI Databases:
  • hibernate
  • quartz
  • jackrabbit
  • di_hibernate
  • di_quartz
  • di_jackrabbit

 

Download and Configure Info-ZIP (Linux only) Download, install, and configure Info-ZIP open source compression utility using the Info-ZIP documentation. Info-ZIP is available at http://www.info‐zip.org/.

The license is a BSD-style license and is provided for most Linux and Unix variants.

A Windows version of Info-ZIP is preconfigured and included in the Pentaho update package.

Verify That No Users Are Logged into the Server We suggest that you perform this update during off-business hours to minimize impact to your day-to-day operations.

These things are recommended, but not required, for the Pentaho 7.0 upgrade.

Task Description
Review Pentaho 7.0 System Updates
Review Previous Functionality Updates to Determine Upgrade Impacts

Get the Pentaho Upgrade and Utility Files 

Upgrade and utility files are available for download from the Pentaho Customer Support Portal - Downloads page. The portal requires you to log in with the Pentaho support user name and password provided in your Pentaho Welcome Packet.​

Available Update Files

Here is a list of BA and DI files that you should have in order to do a complete Pentaho 7.0 update.

Component File Name
BA Server

biserver-ee-upgrade‐7.0.x.yy-dist

pentaho-server-ee-7.0.x.yy-dist

DI Server

pdi‐ee‐upgrade-7.0.x.yy-dist

pentaho-server-ee-7.0.x.yy-dist

DI Client pdi-e-client-7.0.x.yy-dist
Pentaho Analyzer paz‐plugin‐ee‐7.0.x.yy-dist
Pentaho Dashboard Designer pdd‐plugin‐ee‐7.0.x.yy-dist
Pentaho Interactive Reporting pir‐plugin‐ee‐7.0.x.yy-dist
Pentaho Mobile pentaho‐mobile‐plugin‐7.0.x.yy-dist
Report Designer prd‐ee‐7.0.x.yy-dist
Metadata Editor pme‐ee‐7.0.x.yy-dist
Schema Workbench psw‐ee‐3.13.x.yy-dist
Aggregation Designer pad‐ee‐7.0.x.yy-dist
License Files Pentaho [component] Enterprise Edition.lic

Unzipping Distribution Files

The -dist.zip files include an End-User License Agreement, which you will be prompted to accept prior to extracting the files.

  1. Unzip the selected dist.zip file.
  2. Execute the supplied install.bat or install.sh files.
  3. When prompted, agree to the end-user license agreement.
  4. Choose the location to store the extracted files.

Choose Upgrade Instructions

You are now ready to begin your Pentaho 7.0 upgrade.