Skip to main content
Pentaho Documentation

Install BA Version 5.1

Overview

Explains how to install BA Version 5.1.

After you have created an upgrade plan, shut down BA Version 5.0.x, then install BA version 5.1.

Shut Down BA Server Version 5.0.x

Back up the BA Repository and stop all BA components, as well as the web application server.

  1. Stop all BA components.
  2. Stop the BA Repository.
  3. Stop the web application server.
  4. Back up the BA Repository using the directions provided by your database vendor (PostgreSQL, MySQL, or Oracle). 
  5. Verify that the web application server has been stopped by doing one of the following.
  • If you are a Linux user run this command from a terminal window.  

If you have deployed the BA Server on JBoss, substitute jboss for tomcat in the following code.

$>  ps -ef | grep tomcat
  • If you are a Windows user open the task manager and search for the Tomcat6.exe or a JBoss process. If you are on Windows 7 or Windows 2008, you can access Services and see if it shows as running or stopped.  
  1. If you installed the BA Server on Windows using the Installation Wizard, you need to stop the repository database, which runs as a Windows service.  To do this, access the Windows Administrative Tools > Services Manager then stop the Pentaho Solution Repository service. 
 

Install Version 5.1 of the BA Server

Install version 5.1 of the BA Server using the Wizard, Install with Your Own Repository, or Manual method.  Use the same method you used to install version 5.0.x of the software.  You can assign ports during installation.  Default ports are listed in the following table.

Component Start Up Port
PostgreSQL 5432
MySQL 3306
Oracle 1521
BA Server 8080
Data Integration Server 9080

Use the Wizard

Use this method only if you used the Wizard to install 5.0.x.

  1. Back up your /pentaho directory.
  2. Rename the /pentaho directory to pentaho-old.
  3. Follow the instructions in the Install All Components guide.  
  4. Stop the new PostgreSQL database.
  5. Stop the BA Server.
  6. Navigate to system/jackrabbit/repository and delete everything under it.
  7. Switch the Postgres port to your old 5.0.x one OR backup all of the data from the old Postgres and restore it into the new one.
  8. Start the BA Server.

Use the Install with Your Own Repository Method 

Use this method only if you used the Install with Your Own Repository method to install 5.0.x.  (This method is also known as the Archive installation method.)

  1. Back up your /pentaho directory. 
  2. Rename the /pentaho directory to pentaho-old.
  3. Follow the instructions in the Install BA Server with Your Own Repository guide.

Use the Manual Method

Use this method only if you used the manual method to install version 5.0.x of BA.

  1. Back up your /pentaho directory and pentaho.war.
  2. Rename the /pentaho directory to pentaho-old.
  3. Follow the instructions in the Use Manual BA Installation guide.

Install Version 5.1 of the Client Tools

To upgrade the Pentaho client tools on user workstations, download and run the Wizard installer or install the individual client tool packages.  When you install you must:

  1. Rename or remove the old client tools.
  2. Use the instructions in the Install Only BA Tools guide.

The only Pentaho client tools that store user settings are Report Designer and Pentaho Data Integration (Spoon). When you upgrade these programs, the new instance detects the custom settings from the old instance and uses them automatically.  No settings or content files are stored in the /pentaho/design-tools/report-designer/ or /pentaho/design-tools/data-integration/directories (or the subdirectories for any other client tools).  Custom user settings are stored in these directories.

  • Report Designer$HOME/.pentaho
  • Spoon$HOME/.kettle