Skip to main content
Hitachi Vantara Lumada and Pentaho Documentation

Install PDI


Explains how to install and uninstall DI.


After you have prepared your environment, use the Wizard to install Pentaho Data Integration. You only need to perform two tasks.
  • Install PDI with the Wizard - Run the installation wizard to install PDI.
  • Verify Installation - Review the directory structure to ensure that PDI was installed correctly.

If you need to uninstall the software, information on how to do that appears below the installation tasks.

Install PDI with the Wizard

Use the wizard to install PDI. The wizard installs PDI software, the Tomcat web application server, and PostgreSQL, which is the default database that houses the DI Repository. The DI Repository holds audit, scheduling, and solution content data.

Installation instructions are the same for the Windows, Linux, and Mac platforms.

To install the software, complete these steps.

  1. Make sure that you are logged into the computer on which you want to install PDI. You should be logged on with an account that allows you to install software. On Windows, this is typically an account that has administrator privileges. On Linux, use the pentaho account that you created during the previous step.
  2. Download the correct installation wizard's file for your operating system.
    • Windows: pdi-5.0.0-x64.exe
    • Linux: pdi-5.0.0-x64.bin
    • Mac:
  3. If you are using Linux, make sure that you have the appropriate permission to execute the file. Open a Terminal window, navigate to the directory where you just downloaded the file, then enter the following at the prompt.
  4. If you are using Linux, make sure that you have the appropriate permission to execute the file. Open a Terminal window, navigate to the directory where you just downloaded the file, then enter the following at the prompt.
    chmod a+x ./pdi-<filepath>--check--</filepath>{{contentVars.BAvernum3}}-x64.bin
  5. Do one of these things to launch the installation wizard.
    1. If you are using Windows: Open Windows Explorer and navigate to the installation file you just downloaded. Double-click the pdi-5.0.0-x64.exe file to launch it.
    2. If you are using Mac: Double-click the installation app.
    3. If you are using Linux and your computer can display graphics: Open a Terminal window and navigate to the installation file you just downloaded. Enter this command at the prompt, then press Enter.
    4. If you are using Linux and your computer cannot display graphics: Open a Terminal window and navigate to the installation file you just downloaded. At the prompt enter one of these commands, then press Enter. Enter this command if you have GTK libraries on your system and want to use the GTK Toolkit:
      ./pdi---check--{{contentVars.BAvernum3}}-x64.bin --mode text
      Enter this command if you do not have GTK libraries on your system or if you want to use OpenMotif instead:
      ./pdi---check--{{contentVars.BAvernum3}}-x64.bin --mode xwindow
  6. The Pentaho Wizard Splash Screen appears, then the Welcome window. Click Next.
  7. Read the license agreement. To continue, accept the license agreement, then click Next .
  8. When the Installation Folder window appears, do one of these things.
    1. Accept the default directory and click Next to continue.
    2. Enter a different directory by entering the path in the text box or click Browse to navigate to the place where you want PDI to be installed. Click Next to continue.
    Note: You cannot install into a directory that already exists. If you try, you will get an error message. If you are using Linux, we do not recommend that you install the software in the /opt/ directory. The complicated permissions requirements and general isolation from the rest of the system can cause unintended issues to arise if the software is installed there.
  9. When the PostgreSQL postgres user password window appears, enter the password you want to assign to the PostgreSQL database's admin user. Do not use these characters in the password because the Wizard cannot process them:
    '  "   &    <   >  \  
  10. Click Next to continue. The Ready to Install window appears. Click the Next button to install the software. The Generating Evaluation Licenses window appears as evaluation licenses are installed. If they are not able to install, a window appears that shows the reasons the evaluation licenses were not installed.
  11. The Installation in Progress window appears. Make sure the software installs completely before moving on to the next step.
    Note: An error occurs if the DI Server port numbers (9092, 9080, 9443, and 5432) are not available on your system and if the additional ports that the wizard has tried are not available. If the wizard cannot find an available port, you are prompted to enter port numbers you want to use.
  12. The Installation Complete window appears. Click the Open Pentaho Data Integration and Begin in Instaview options to view Spoon. Click Finish to end the process.
  13. Spoon and Instaview are launched.
  14. If you have trouble with the installer, check the Troubleshooting documentation.

    Note: Once the installation wizard is complete, the DI Server are running with the default parameters. Terminal windows might remain open after installation. If you close them, the DI Servers stop. On Windows, the DI Server are installed as system services, meaning that they start when you start your computer, and they stop when you shut down your computer. Spoon and other tools must be manually run. In the next step of these instructions there are links to documentation that explains how to start and stop servers manually.

Verify Installation

To verify that the installation occurred properly, review the software directory structure.
  1. Open a file explorer window like Windows Explorer or a command line tool such as the Command Prompt or Terminal windows.
  2. Navigate to the directory where you installed PDI, then compare this directory structure with yours.
  3. Open the installation-summary.txt file. Make sure that the design tools and plugins that you installed are listed.
  4. Review the following locations of files and directories before going to the next step.

    Top-level files:

    These files are found in the top-level /pentaho directory:

    • Starts, stops, restarts, and shows the status of Pentaho services. Available on Linux only.
    • installation-summary.txt: Contains the information from the summary screen at the end of the installation process.
    • uninstall: A script that removes what has been installed.

    Locations of specific programs

    • DI Server: /pentaho/server/data-integration-server/
    • Spoon: /pentaho/design-tools/data-integration/
    • License Installer: /pentaho/license/

    Location of logs:

    • DI Server Logs: pentaho/server/data-integration-server/logs/
    • Tomcat Logs for DI Server: pentaho/server/data-integration-server/tomcat/logs/

    Location of JDBC drivers:

    • DI Server: pentaho/server/data-integration-server/tomcat/lib
    • Spoon: pentaho/design-tools/data-integration/lib/

    Default Port Numbers (your port numbers might differ if these ports are already used for other programs):

    • 5434: PostgreSQL Server
    • 9080: DI Server Port
    • 9001: HSQL Server Port
    • 9092: Embedded H2 Database
    • 50000 or 50006: Monet Database Port

    Note: The license installer can also be found in the data-integration directory. All of these license installers perform the same functions, but are available in separate places to account for instances where only specific parts of the Pentaho suite are installed to a particular server or workstation. It does not matter which one you use. You can also install licenses through the User Console if you have already installed the BA Server. See the next step for more information on licenses.

Uninstall Pentaho

If you need to uninstall Pentaho, complete these steps.
  1. Navigate to the pentaho directory, and run the uninstall file.
  2. The Uninstall Wizard is launched.
  3. When prompted, indicate whether you want to delete the data files.
  4. When prompted at the end of the process, restart your computer.