Install the 30-day trial of Pentaho Data Integration and Analytics

The Pentaho Installation Wizard is a streamlined way to install, learn about, and evaluate the Pentaho Suite. With this 30-day trial, you can install and test Pentaho Business Analytics (BA) and Data Integration (DI).

To get started quickly after installation, follow the Pentaho Data Integration (PDI) tutorial.

If you have issues with the 30-day trial, contact the Pentaho Trial Experts.

Moving to development or production is not supported for installations completed with the Pentaho Installation Wizard.

With the Pentaho Installation Wizard you can choose one of two install types:

• Default: Select Keep it simple. Give me everything.

• Custom: Select Let me decide for myself.

Process overview

Installation steps are the same for Windows, Linux, and macOS.

Complete these tasks in order:

1. Acquire a trial license

2. Download the trial software

3. Start the Pentaho Installation Wizard

4. Choose a default installation or custom installation.

5. Verify installation

6. Getting started tutorial

Explore Considerations
You Supply	A computer that meets Pentaho's operating system and hardware requirements.
We Supply	Installation package Oracle JRE Repository platform (PostgreSQL) Repository platform JDBC Driver (PostgreSQL) Web application server (Tomcat)
Technologies Used	Tomcat web application server PostgreSQL database for the Pentaho Repository
Expertise	Basic computer knowledge
Approximate Installation Time	30 minutes

Acquire a trial license

You can obtain a Pentaho trial license to test the product before you buy it. You need internet access to activate a trial license and run the installed trial version. You cannot run it for an extended period while disconnected from the internet.

The temporary license expires 30 days after the start of the evaluation period.

1. Go to the Pentaho download page to request a trial activation ID.

2. Click Start a Free 30 Day Trial to open the trial registration form.

3. Complete the form and click Submit.

   The trial entitlement and activation ID is sent by email.

4. Download and install the Pentaho product.

   When starting the product, the Add License window opens.

   
5. Select Activation Code.

6. Copy the activation ID, paste it into the box, then click OK.

   The Licenses window lists the trial license that is now available.

   

Download the trial software

To download the software, complete these steps.

1. Make sure you are logged in to the computer where you want to install the software.

   You should use an account that can install software.

   • On Windows, this is typically an account with administrator privileges.

   • On Linux, this is also an account with administrator privileges.

2. Navigate to the Pentaho trial download website.

   For a production install, go to the Pentaho EE download site.

3. Click Start a Free 30 Day Trial.

   The Submission Agreement form appears.

4. Fill in the requested information and click Submit.

   The Download Pentaho EE Data Integration & Analytics dialog box appears.

5. Click Download in the Pentaho EE OnPrem section.

   For cloud environments, see Hyperscalers in the Install Pentaho Data Integration and Analytics document.

6. When prompted, choose a directory for the installer and wait for the download to finish.

7. If you are using Linux, make sure you can execute the file.

   Open a terminal, go to the directory where you downloaded the file, then run:

   chmod a+x ./pentaho-business-analytics-10.3.0-x64.bin

Start the Pentaho Installation Wizard

To start the installation wizard, complete the following steps.

Launch the installation wizard from a locally mounted hard drive only. Network-mounted drives (for example NFS) are not supported.

Do one of the following.

• Windows: Open File Explorer, go to the installer, then double-click pentaho-business-analytics-10.3.0-x64.exe.

• macOS: Unpack pentaho-business-analytics-10.3.0-x64.app.tar.gz, then double-click pentaho-business-analytics-10.3.0-x64.app.

• Linux (graphics): Open a terminal, go to the installer, then run:

  ./pentaho-business-analytics-10.3.0-x64.bin

• Linux (no graphics): Open a terminal, go to the installer, then run one of these:

  • GTK text mode:

    ./pentaho-business-analytics-10.3.0-x64.bin --mode text

  • OpenMotif X mode:

    ./pentaho-business-analytics-10.3.0-x64.bin --mode xwindow

Default installation

If you choose Keep it simple. Give me everything., complete the following steps. If you want a custom install, see Custom installation.

You cannot install into a directory that already exists. On Linux, do not install under /opt/. It can cause permissions problems.

1. After you start the wizard, the splash screen appears, then the Pentaho Business Analytics installation is ready! window. Click Next.

   

   Install is ready. Click Next
2. Read the license agreement. Click Accept, then click Next.

3. Select Keep it simple. Give me everything, then click Next.

4. In Installation folder, accept the default directory or enter a different path, then click Next.

   

   Choose Pentaho installation directory
5. If you chose to install the Pentaho Server, you are prompted to add a PostgreSQL password. Enter and confirm the password for the postgres user.

   Do not use these characters in the password:

   ' " & < > \

6. Click Next.

7. If the Sample Database window appears, enter a port number, then click Next.

   This prompt appears only if the default ports are not available.

8. In Ready to Install, click Next.

   Installation takes about 30 minutes.

9. When installation is complete, select Pentaho Data Integration to launch Spoon.

   

   Select Pentaho Data Integration
10. Click Finish.

    After PDI starts, you will see the Welcome! window.

    

    Welcome to Pentaho Data Integration

    To get started quickly after installation, follow the Pentaho Data Integration (PDI) tutorial.

If you have trouble with the installation wizard, see the Administer Pentaho Data Integration and Analytics document.

Custom installation

If you choose Let me decide for myself., complete the following steps. If you want the default install, see Default installation.

You cannot install into a directory that already exists. On Linux, do not install under /opt/. It can cause permissions problems.

1. After you start the wizard, the splash screen appears, then the Pentaho Business Analytics installation is ready! window. Click Next.

2. Read the license agreement. Click Accept, then click Next.

3. Select Let me decide for myself, then click Next.

4. In Pentaho Applications, select the components you want to install, then click Next.

5. If you chose to install the Pentaho Server, select whether to include sample content, then click Next.

6. In Installation folder, accept the default directory or enter a different path, then click Next.

7. If you selected the Pentaho Server, enter and confirm a PostgreSQL password for the postgres user, then click Next.

   Do not use these characters in the password:

   ' " & < > \

8. If the Sample Database window appears, enter a port number, then click Next.

9. In Ready to Install, click Next.

10. When installation is complete, select Pentaho User Console and Pentaho Data Integration, then click Finish.

If you have trouble with the installer, see the Administer Pentaho Data Integration and Analytics document.

Verify installation

To verify the installation, review the directory structure and the installation summary file.

1. Open a file explorer or command line tool.

2. Navigate to the install directory and compare it to the structure below.

   pentaho/
   pentaho/design-tools/
   pentaho/design-tools/aggregation-designer/
   pentaho/design-tools/data-integration/
   pentaho/design-tools/metadata-editor/
   pentaho/design-tools/report-designer/
   pentaho/design-tools/schema-workbench/
   pentaho/documentation/
   pentaho/java/
   pentaho/jdbc-distribution/
   pentaho/license-installer/
   pentaho/licenses/pentaho/monetdb/
   pentaho/postgresql/
   pentaho/scripts/
   pentaho/server/

3. Open installation-summary.txt. Make sure it lists the design tools and plugins you installed.

4. Review the file locations below.

   File	Description
   ctlscript.sh	Starts, stops, restarts, and shows the status of Pentaho services. Available on Linux and macOS.
   installation-summary.txt	Contains the information from the summary screen at the end of the installation process.
   uninstall	A script that removes Pentaho Business Analytics.

   Tool/Plugin	Location
   Pentaho Server	pentaho/server/pentaho-server/
   Report Designer	pentaho/design-tools/report-designer/
   Schema Workbench	pentaho/design-tools/schema-workbench/
   Data Integration (Spoon)	pentaho/design-tools/data-integration/
   Metadata Editor	pentaho/design-tools/metadata-editor/
   Aggregation Designer	pentaho/design-tools/aggregation-designer/
   Dashboard Designer	pentaho/server/pentaho-server/pentaho-solutions/system/dashboards/
   Analyzer	pentaho/server/pentaho-server/pentaho-solutions/system/analyzer/
   Interactive Reports	pentaho/server/pentaho-server/pentaho-solutions/system/pentaho-interactive-reporting/
   License Installer	pentaho/license-installer/

   Log	Location
   Pentaho Server Logs for BA configuration	pentaho/server/pentaho-server/logs/
   Tomcat Logs for Pentaho Server for BA configuration	pentaho/server/pentaho-server/tomcat/logs/

   For macOS, copy the JDBC .jar into the location listed for Report Designer.

   JDBC Driver	Location
   Pentaho Server for BA configuration	pentaho/server/pentaho-server/tomcat/lib/
   Report Designer	pentaho/design-tools/report-designer/lib/jdbc/
   Schema Workbench	pentaho/design-tools/schema-workbench/drivers/
   Aggregation Designer	pentaho/design-tools/aggregation-designer/drivers/
   Metadata Editor	pentaho/design-tools/metadata-editor/libext/JDBC/
   PDI client (Spoon)	pentaho/design-tools/data-integration/lib/

   Port Number	Description
   5432	PostgreSQL Server
   8080	Pentaho Server Tomcat Web Server Startup Port
   8012	Pentaho Server Shutdown Port
   9001	HSQL Server Port
   9092	Embedded H2 Database

   Your port numbers might differ. If you installed using the installation wizard, check installation-summary.txt for the actual ports.

Start and stop the PDI client on Windows

If you installed PDI on Windows using the installation wizard, start Spoon from: Start > All Programs > Pentaho Enterprise Edition > Design Tools > Data Integration.

Start and stop the Pentaho Server for configuration on Windows

When you ran the installation wizard on Windows, the Pentaho Server deployed in an included Apache Tomcat application server. Manage Pentaho and Tomcat from: Start > All Programs > Pentaho Enterprise Edition > Server Management.

Use one of these menu items:

• Start Pentaho Server

• Stop Pentaho Server

The installer also registered services for:

• Pentaho Server

• Data Integration

• Pentaho Repository

You can start and stop these services from Control Panel > Administrative Tools > Services.

Start and stop the Pentaho Server for configuration on Linux

When you ran the installation wizard on Linux, the Pentaho Server deployed in an included Apache Tomcat application server. Use /pentaho/ctlscript.sh to start and stop services.

Common arguments:

• start

• stop

• restart

• status

• help

Common services:

• pentahoserver

• postgresql

Examples:

./ctlscript.sh start pentahoserver
./ctlscript.sh status pentahoserver
./ctlscript.sh status postgresql
./ctlscript.sh help

Adjust Java VM memory limits for an installation on Windows

Windows users might see out-of-memory errors. Increase the Java VM memory allocation to fix them.

These steps apply when you installed with the installation wizard.

1. Stop the Pentaho Server. See Start and stop the Pentaho Server for configuration on Windows.

2. Double-click pentahoserverw.exe in server\pentaho-server\tomcat\bin to open Pentaho Server Properties.

   You might need to select Run as Administrator.

3. Select the Java tab.

   

   Windows Properties dialog box
4. Set:

   • Initial memory pool: 6144 MB

   • Maximum memory pool: 8192 MB

5. Start the Pentaho Server. See Start and stop the Pentaho Server for configuration on Windows.

If the JVM refuses to start, you might need to add RAM, stop memory-intensive services, or lower the maximum memory limit.

Adjust Java VM memory limits for a graphical installation on Linux

These steps apply when you installed using the installation wizard, your computer can display graphics, and you are running Linux.

1. Stop the server. See Start and stop the Pentaho Server for configuration on Linux.

2. Go to pentaho-server/tomcat/scripts.

3. Edit ctl.sh.

4. Locate the line under start tomcat, which looks like this:

   export JAVA_OPTS="... -Xms128m -Xmx768m -XX:MaxPermSize=256m ..."

5. Set the memory to a minimum of 4096 MB and a maximum of 6144 MB, based on available system memory.

6. Start the server. See Start and stop the Pentaho Server for configuration on Linux.

If the JVM refuses to start, add RAM, stop memory-intensive services, or lower the maximum memory limit.

Increase Pentaho Server memory limit for installations on Windows

If you installed the Pentaho Server on Windows using the installation wizard, you can increase the server memory limits by editing the Tomcat Java settings.

For Linux, see Increase Pentaho Server memory limit for installations on Linux.

1. Stop the Pentaho Server if it is running. See Start and stop the Pentaho Server for configuration on Windows.

2. Type services.msc into the Windows Search box.

3. Find the Pentaho Server entry and note the service name.

   It should be pentahoserver.

4. In C:\\pentaho\\server\\pentaho-server\\tomcat\\bin\\, rename tomcat8w.exe to match the service name.

   Example: pentahoserverw.exe.

5. Double-click the renamed file to open the Properties window.

   You might need to select Run as Administrator.

6. Select the Java tab.

7. Set:

   • Minimum: 4096 MB

   • Maximum: 6144 MB

8. Start the Pentaho Server. See Start and stop the Pentaho Server for configuration on Windows.

If the JVM refuses to start with increased limits, add RAM, stop memory-intensive services, or reduce the maximum memory limit.

See also: Increase the PDI client memory limit.

Increase Pentaho Server memory limit for installations on Linux

If you installed PDI on Linux using the installation wizard, you can increase memory limits by editing a variable in a Pentaho-supplied script.

For Windows, see Increase Pentaho Server memory limit for installations on Windows.

1. Stop the server. See Start and stop the Pentaho Server for configuration on Linux.

2. Go to pentaho-server/tomcat/scripts.

3. Edit ctl.sh.

4. Locate the line under start tomcat, which looks like this:

   export JAVA_OPTS="-Dpentaho.installed.licenses.file=/opt/pentaho/.installedLicenses.xml -Xms128m -Xmx768m -XX:MaxPermSize=256m -Dsun.rmi.dgc.client.gcInterval=3600000 -Dsun.rmi.dgc.server.gcInterval=3600000"

5. Set the memory to a minimum of 4096 MB and a maximum of 6144 MB, based on available system memory.

6. Start the server. See Start and stop the Pentaho Server for configuration on Linux.

See also: Increase the PDI client memory limit.

Increase the PDI client memory limit

As a best practice, increase PDI's memory limit so Spoon can perform memory-intensive tasks. You must increase the memory limit for both the Pentaho Server and the PDI client.

Instead of modifying the PDI client startup script, you can set the environment variable PENTAHO_DI_JAVA_OPTIONS to -Xmx2g -XX:MaxPermSize=256m on your client.

Uninstalling the Pentaho Suite after evaluation

To uninstall the Pentaho Suite after evaluation:

1. Go to the pentaho directory and run the uninstall file.

2. Follow the Uninstall Wizard.

3. When prompted, choose whether to delete the data files.

4. Restart your computer.

Before you install a production version of Pentaho, uninstall the evaluation version first.

Getting started tutorial

To get started quickly after installation, follow the Pentaho Data Integration (PDI) tutorial.

Tutorials

Review these tutorials to start using PDI, reporting tools, and dashboards.

If you are new to PDI, start with Getting Started with PDI.

Within this tutorial, you can also view:

• PDI Transformation Tutorial

• PDI Job Tutorial

• Getting started with PDI and Hadoop

The Getting Started with Analyzer, Interactive Reports, and Dashboard Designer tutorial covers product features, best practices, and troubleshooting.

Within that tutorial, you can also view:

• About Pentaho business analytics tools

• Get started with Pentaho Reporting tools

• Quick tour of the Pentaho User Console

• Get started with Interactive Reports

• Get started with Analyzer Reports

• Get started with Dashboard Designer

• Next steps

The Getting started with Report Designer tutorial includes step-by-step report creation instructions.

Within that tutorial, you can also view:

• About Pentaho Report Designer

• Create a report with Report Designer

Remove sample data from the Pentaho Server

By default, you have access to a sample data source and example content. When you are ready to move to development or production, remove the sample content.

To remove sample data and content:

1. Stop the Pentaho Server.

2. Delete samples.zip from /pentaho-server/pentaho-solutions/system/default-content.

   If you performed a manual WAR build and deployment, the path is /pentaho-server/pentaho-solutions/system.

3. Edit /pentaho/WEB-INF/web.xml inside the deployed pentaho.war.

   For archive installs, the path is usually /pentaho-server/tomcat/webapps/pentaho/WEB-INF/web.xml.

4. Remove the hsqldb-databases section:

   <!-- [BEGIN HSQLDB DATABASES] -->
       <context-param>
           <param-name>hsqldb-databases</param-name>
           <param-value>sampledata@../../data/hsqldb/sampledata</param-value>
       </context-param>
   <!-- [END HSQLDB DATABASES] -->

5. Remove the hsqldb-starter section:

   <!-- [BEGIN HSQLDB STARTER] --> 
   <listener> 
   <listener-class>org.pentaho.platform.web.http.context.HsqldbStartupListener</listener-class> 
   </listener> 
   <!-- [END HSQLDB STARTER] -->

6. Remove the SystemStatusFilter.

   This filter shows status messages useful only for development and testing.

   <filter>
       <filter-name>SystemStatusFilter</filter-name>
       <filter-class>com.pentaho.ui.servlet.SystemStatusFilter</filter-class>
       <init-param>
           <param-name>initFailurePage</param-name>
           <param-value>InitFailure</param-value>
           <description>This page is displayed if the PentahoSystem fails to properly initialize.</description>
       </init-param>
   </filter>

7. Remove the filter mapping:

   <filter-mapping>
       <filter-name>SystemStatusFilter</filter-name>
       <url-pattern>/*</url-pattern>
   </filter-mapping>

8. Save and close web.xml.

9. Delete the /pentaho-server/data/ directory.

10. Restart the Pentaho Server, then sign in to the Pentaho User Console as an administrator.

    On Browse Files, delete the sample folders under Public.