Explains how to prepare your computers for installation.
Create the Pentaho User
Create a pentaho user account that has administrative privileges. You will use this account to complete the rest of the installation instructions.
Make sure your users can write to the directory where you install Pentaho.
- Create an administrative user on computer that will host the DI Server and name it pentaho.
- Verify that you have the appropriate permissions to read, write, and execute commands in the pentaho user's home directory.
Install the Pentaho Repository Host Database
The Pentaho Repository houses data needed for Pentaho tools to provide scheduling and security functions. The repository also stores metadata and models for reports that you create. You can choose to host the Pentaho Repository on these databases.
- MS SQL Server
To install the Pentaho Repository's host database, do these things.
- Check the Supported Technologies section to determine which versions of the databases Pentaho supports.
- Download and install the database of your choice.
- Verify that the Pentaho Repository database is installed correctly.
Install a supported version of Java.
Download and Unpack Installation Files
The PDI Server software, data files, and examples are stored in pre-packaged .zip files. You will need to manually copy these files to correct directories.
- Download the following installation and plug-in files from the Pentaho Customer Support Portal in the archive build folder.
- DI Server Installation File: pdi-ee-server-5.0.0-dist.zip.
- Unzip the DI Server Installation file.
- To unpack the file, run install.sh. The IZPak window appears.
If you are unpacking the file in a non-graphical environment, open a Terminal or Command Prompt window and type
java -jar installer.jar -console and follow the instructions presented in the window.
- Read the license agreement, select I accept the terms of this license agreement, and click Next.
- In the Select the installation path text box, enter the place where you want to create the pentaho directory, then click Next.
- A message indicating that a target directory will be created appears. Click OK.
- When the installation progress is complete click Quit.
- Navigate to the pentaho directory and create a server subdirectory.
- Move the data-integration-server directory into the server directory. When you are finished, the directory structure should look like this:
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.
- Set the path of the PENTAHO_JAVA_HOME variable to the path of your Java installation, like this.
- Set the path of the PENTAHO_INSTALLED_LICENSE_PATH variable to the path of the installed licenses, like this.
- Log out and in again, then verify the variables have been properly set.
You've finished preparing your environment. Go to Configure Your Repository Database to continue.