Archive Installation

Recommended installation option ..

Introduction

The workshop 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.

1. Before You Begin:

   • Read the overview of installation options in the Pentaho Installation article to ensure that this method is the best installation option for you.

   • Check the Components Reference to verify that your server computer, Pentaho Repository database, and web browser meet Pentaho’s requirements for this version of the software.

   • Uninstall any evaluation version of Pentaho.

2. Requirements:

   • You’ll need a server device that meets the hardware and software requirements specified in the Components Reference.

   • Ensure you have either the Oracle Java Runtime Environment (JRE) or Oracle Java Development Kit (JDK) installed.

   • Choose a Pentaho Repository database (PostgreSQL, MySQL, MS SQL Server, or Oracle). You’ll need to supply, install, and configure your chosen database yourself.

3. Installation Steps:

   • Linux Environment:

     • Create the 'Pentaho / Install' user - ensure has the required permissions.

     • Set up the Linux directory structure.

     • Install Java.

     • Install the Pentaho Repository host database.

     • Download and unpack the installation files.

     • Set environment variables. Detailed instructions can be found here.

   • Windows Environment:

     • Create the Windows directory structure.

     • Install Java.

     • Install the database that will host the Pentaho Repository.

     • Download and unpack the installation files. More details are available here.

4. Start the Pentaho Server:

   • After completing the above steps, start the Pentaho Server and install your licenses.