Skip to main content
Pentaho Documentation

Prepare for Your Upgrade (JBoss)

Explains how to get ready for your Pentaho upgrade if you are using JBoss.

You'll 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 6.1. We recommend that you read through all related materials before starting the upgrade process.

Before You Begin

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

Task Description
Verify Your Current Version of Pentaho BA and PDI You'll need to start with a working installation of at least Pentaho BA and PDI 5.2.x.

Verify Your System Components are Current

You’ll 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 6.1 upgrade.

Task Description
Review Pentaho 6.1 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 6.1 update.

Component File Name
BA Server biserver‐manual-ee‐6.1.x-yy-dist
DI Server (includes Spoon) pdi‐manual-ee‐6.1.x-yy-dist
Pentaho Analyzer paz‐plugin‐ee‐6.1.x-yy-dist
Pentaho Dashboard Designer pdd‐plugin‐ee‐6.1.x-yy-dist
Pentaho Interactive Reporting pir‐plugin‐ee‐6.1.x-yy-dist
Pentaho Mobile pentaho‐mobile‐plugin‐6.1.x-yy-dist
Report Designer prd‐ee‐6.1.x-yy-dist
Metadata Editor pme‐ee‐6.1.x-yy-dist
Schema Workbench psw‐ee‐3.12.x-yy-dist
Aggregation Designer pad‐ee‐6.1.x-yy-dist
Pentaho Upgrade Utility pentaho-upgrade-utility-6.1.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 6.1 upgrade.