Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

BA Migration Introduction


Introduces the BA Migration Guide.

This section explains how to migrate version 4.8.x of the Pentaho Business Analytics (BA) Server, plugins, and design tools to version 5.x.x  Version 5.x.x contains major usability, stability, and architectural improvements. This version also includes many bug fixes and new features, as well as enhanced support for Big Data.

Note: To migrate the Pentaho Data Integration (DI) Server, plugins, and design tools see Migrate DI Systems.

We recommend that you read through all migration documentation before you perform tasks.  Familiarity with the entire process can help you plan your strategy and increase the likelihood of a successful migration experience. If you need assistance with the migration process, contact Technical Support. If you have need additional help tailoring the migration process for your environment, contact Concierge or Consulting Services.

Note: If you have a pre-4.8.x version of BA Server and you want to migrate to version 5.x.x, you must do so incrementally, version by version, until you reach version 4.8.x.  Upgrade instructions appear in the documentation for each version of the software.  After you have upgraded to version 4.8.x, you can use these instructions to migrate to version 5.x.x.


You need a working version of BA Server version 4.8.x.


The topics in this section are written for IT administrators who know where data is stored, how to connect to it, details about the computing environment, and how to use the command line to issue commands for Microsoft Windows or Linux. You also need the appropriate accesses and permissions to install and migrate software.


You need these tools to perform migration tasks.

  • Pentaho-supplied Migration Tool. Instructions for how to obtain this tool appear in the Prepare Environment section.
  • File Difference tool of your choice.
  • Zip or Archive tool of your choice.
  • Text editor of your choice.

Login Credentials

You need access to an account that has administrative privileges. Additionally, Linux users might need to use the root account for some tasks.