Skip to main content
Pentaho Documentation

Prepare Environment


Provides prerequisites for installation.

Image of the DI installation steps.

To prepare the computer on which you plan to install the BA design tool and plugins, complete these tasks.

Install Java JRE or JDK

Make sure that the version of the Java Runtime Environment (JRE) or the Java Development Kit (JDK) that Pentaho needs to run is installed on your system. You do not need to uninstall other versions of Java if you already have them running on your system. These instructions explain how to check for your default version of Java that is running on your computer and where to get the required version if you need one.

  1. Check the supported technologies list to see which version of the JRE or JDK is needed for the software.
  2. If you have not done so already, log into the computer on which you plan to install the software. Ensure that you have the appropriate permissions to install software.
  3. Open a Terminal or a Command Prompt window. Enter this command.
    java -version
  4. If the version of Java does not match the version needed to run Pentaho software, check your system to see if there are other versions of Java installed.
  5. If the version of Java that you need to run Pentaho software is not on your system, download it from the Oracle site and install it.

Set Environment Variables

Set the PENTAHO_JAVA_HOME variable to indicate the path to the Java JRE or JDK that Pentaho should use. If you do not set this variable, then Pentaho will not start correctly.

To set environment variables, you should be logged into an account that has administrator-level privileges. For Linux systems, you must be logged into the root user account.

Set Windows PENTAHO_JAVA_HOME Variable

  1. From the Start menu, right-click Computer, then select Properties from context menu.
  2. Click Advanced System Settings. The System Properties window appears.
  3. In the System Properties window, click the Advanced tab, then click Environment Variables.
  4. To set the PENTAHO_JAVA_HOME variable do this.
    1. In the System Variable section, click New.
    2. In the window that appears, type PENTAHO_JAVA_HOME in the name field.
    3. In the value field, enter the directory where your Oracle JDK or Oracle JRE is stored. For example your Java JRE is in the Program Files\Java\jre7 directory, type this.
      C:\Program Files\Java\jre7
    4. Click OK.
  5. Click Apply Changes.
  6. Log out, then log back in.
  7. To verify that the variables have been properly set, open a Command window and type this.

Set Linux PENTAHO_JAVA_HOME Variable

  1. Open a terminal window and log in as root.
  2. Open the /etc/environment file with a text editor. Note:The vi and gedit text editors are available on most Linux machines. For example, to open the /etc/environment file with gedit, type this.
    gedit /etc/environment
  3. Indicate where you installed Java in your /etc/environment file by typing this. Note: Substitute /usr/lib/jvm/java-7-sun with the location of the JRE or JDK you installed on your system.
    export PENTAHO_JAVA_HOME=/usr/lib/jvm/java-7-sun
  4. Save and close the file.
  5. Log out, then log back in for the change to take effect.
  6. Verify that the variables are properly set by opening a Terminal window and typing this.
    env | grep PENTAHO_JAVA_HOME