Skip to main content

Pentaho+ documentation has moved!

The new product documentation portal is here. Check it out now at


Hitachi Vantara Lumada and Pentaho Documentation

Archive installation

Parent article

This guide walks you through installation of the Pentaho Server on a Tomcat web application server supplied by Pentaho and configuration of the Pentaho Repository database of your choice.

The archive installation method provides you with a preconfigured Tomcat web application server. This method is most useful when you do not already have a web app server. As such, the archive installation method is an easier and quicker installation process versus a manual installation. This method is an archive by virtue of its being an image or "snapshot" of a Pentaho configuration built on Tomcat.

An archive installation is also useful if you already have existing Pentaho data or repositories that you created with a previous version of Pentaho or that you created with an evaluation installation of Pentaho. The archive installation method is an easy way to bring your existing Pentaho data into your production version.

Before you begin

Review these prerequisites before you start the archive installation.

This guide assumes that you have:

  • Read the overview of installation options in the Pentaho installation article to ensure that this method is the best installation option for you.
  • Checked the Components Reference to ensure that your server computer, Pentaho Repository database, and web browser meet Pentaho's requirements for this version of the software.
  • Uninstalled any evaluation version of Pentaho.

IT administrators who know where the 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 must supply the server device that meets the hardware and software requirements indicated in the Components Reference, as well as a supported operating system and JRE or JDK. Additionally, you will need a text editor and a ZIP tool to complete some of the steps in this installation process.

The Pentaho Repository contains solution content, scheduling, and audit tables needed for the Pentaho Server to operate. You can house the Pentaho Repository on PostgreSQL, MySQL, MS SQL Server, or Oracle. With this installation option, you must supply, install, and configure your chosen database yourself.

Login Credentials

You must be logged on to an account that has administrative privileges to perform the tasks in these sections. Additionally, Linux users need to use the root account for some tasks.

Requirements for Archive Installation

An archive installation requires these items and expertise:

You SupplyEach of the following items must meet or exceed the requirements in the Components Reference:
  • Computer with a supported operating system and hardware configuration.
  • Oracle Java Runtime Environment (JRE) or Oracle Java Development Kit (JDK).
  • Pentaho Repository database (PostgreSQL, MySQL, MS SQL Server or Oracle). You can also use a preexisting Pentaho repository platform.
  • Pentaho Repository database JDBC Drivers (PostgreSQL, MySQL, MS SQL Server or Oracle).
We Supply
  • Installation package.
  • The web application server (Tomcat).
Technologies Used
  • Tomcat web application server (provided by Pentaho).
  • A PostgreSQL, MySQL, MS SQL Server, or Oracle database.
  • Knowledge of your networking environment, including database port numbers if they differ from the default and IP address.
  • Permission to access installation directories.
  • Root or administrative access.
Approximate Installation Time
  • 60 to 90 minutes.
You can download the Pentaho software from the

Archive installation process

The archive installation process consists of the following steps, depending on the operating system used for your environment:

  1. Prepare Your Environment: Either Windows or Linux
  2. Prepare Repository: You can select one of the following database types for your Pentaho Repository:
  3. Start the Pentaho Server: The final step is to start the Pentaho Server and install your licenses.

Manual installation of the Pentaho client tools

After you install and start the Pentaho Server, you can manually install the Pentaho client tools on different workstations.

Once you have installed both the Pentaho Server and client tools, configure the Pentaho Server and design tools so that you can install licenses, log on to the Pentaho Server, set up data sources, and choose a security method.


See our list of common problems and resolutions.