Skip to main content
Pentaho Documentation

Prepare Your Windows Environment for Installation

Overview

Explains how to prepare your computers for installation.

Install the Pentaho Repository Host Database

The DI Repository houses data needed for Pentaho tools to provide scheduling and security functions.  It also stores transformations and jobs.  You can host the Pentaho Repository on these databases.

  • PostgreSQL
  • MySQL
  • Oracle
  • MS SQL Server

To install the Pentaho Repository's host database, do these things.

  1. Check the Supported Technologies section to determine which versions of databases Pentaho supports.
  2. Download and install the database of your choice. 
  3. Verify that the database is installed correctly.

Install Java 

Install a supported version of Java.

  1. Check the Supported Technologies list to see which version of Java Pentaho supports.
  2. Download the supported version of the JRE or JDK from the Oracle site and install it. 

Download and Unpack Installation Files

The Pentaho DI Server software, data files, and examples are stored in pre-packaged .zip files. You will need to manually copy these files to correct directories. 

Make sure your users can write to the directory where you install the Pentaho suite.

  1. Download the following installation file from the Pentaho Customer Support Portal in the archive build folder.
  • DI Server Installation File: pdi-ee-server-6.1.0-dist.zip
  1. Unzip the DI Server Installation file.
  2. To unpack the file, run install.bat .  The IZPak window appears.  
  3. Read the license agreement, select I accept the terms of this license agreement, and click Next.
  4. In the Select the installation path text box, enter the place where you want to create the pentaho directory, then click Next.
  5. A message indicating that a target directory will be created appears.  Click OK.
  6. When the installation progress is complete click Quit.
  7. Navigate to the pentaho directory and create a server subdirectory.
  8. Move the data-integration-server directory into the server directory.  When you are finished, the directory structure should look like this:
  • pentaho\jdbc-distribution
  • pentaho\license-installer
  • pentaho\server\data-integration-server

Set Environment Variables

Set the PENTAHO_JAVA_HOME  and PENTAHO_INSTALLED_LICENSE_PATH environment variables. If you do not set these variables, Pentaho will not start correctly. 

If you are using a JRE, set the JRE_HOME home environment variable as well.

  1. Set the path of the PENTAHO_JAVA_HOME variable to the path of your Java installation, like this.
    SET PENTAHO_JAVA_HOME=C:\Program Files\Java\jdk7
    
  2. Set the path of the  PENTAHO_INSTALLED_LICENSE_PATH variable to the path of your installed licenses, like this.
    SET PENTAHO_INSTALLED_LICENSE_PATH=C:\Users\pentaho\.pentaho\.installedLicenses.xml
    
  3. Log out and in again, then verify the variables have been properly set.

Next Step

You've finished preparing your environment.  Go to Configure Your Repository Database to continue.