> For the complete documentation index, see [llms.txt](https://academy.pentaho.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://academy.pentaho.com/solution-architect-path-sandbox/solution-architect/installation.md).

# Installation

The second course of the Solution Architect path: install Pentaho 11 from the archive on Linux, add plugins and client tools, harden it and apply a service pack.

{% hint style="warning" icon="eye" %}
**SANDBOX — draft page.** Built from `architect-install-certified` 0.1.15 in Pentaho Content Manager. Module and lesson names, the reading-or-workshop kinds and the times come straight from each lab's manifest. Items marked REPLACE-ME need an owner's confirmation.
{% endhint %}

The essential baseline for a Solution Architect: install the whole Pentaho 11 platform yourself, end to end. By the end you'll have a licensed Pentaho Server on Tomcat 10 with its repository on PostgreSQL 17, the server plugins and client tools your teams use, a hardened configuration, and the latest service pack applied.

{% columns %}
{% column %}

<p align="center"><i class="fa-file-lines" style="color:green;">:file-lines:</i><br><strong>12 lessons</strong><br><em>across 4 modules</em></p>
{% endcolumn %}

{% column %}

<p align="center"><i class="fa-flask" style="color:orange;">:flask:</i><br><strong>8 workshops</strong><br><em>hands-on labs</em></p>
{% endcolumn %}

{% column %}

<p align="center"><i class="fa-clock" style="color:cyan;">:clock:</i><br><strong>~5h 10m</strong><br><em>a day, or three evenings</em></p>
{% endcolumn %}
{% endcolumns %}

{% hint style="success" icon="server" %}
Every workshop is hands-on. Nothing is pre-installed — installing the Pentaho platform is the course. The Lab Guide walks you through each step on a Linux machine you prepare yourself.
{% endhint %}

***

<h3 align="center">Before you start</h3>

{% columns %}
{% column %}
{% hint style="success" icon="circle-check" %}
**What you'll need**

A Pentaho Support Portal account (your organisation's principal account) to download the Enterprise packages, and comfort with the Linux command line and `sudo`. No prior Pentaho installation experience is assumed.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="info" icon="tag" %}
**Built against**

The Pentaho 11.0 GA archive packages (`11.0.0.0-237`, the build every course on the Academy runs) on Ubuntu 24.04 LTS, with Java 21 (OpenJDK), PostgreSQL 17 and Tomcat 10. The Upgrade & Patches workshop then applies service pack 3 (`11.0.0.3-312`) — this is the only course on the Academy that takes the build beyond 11.0.0.0-237.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

***

{% hint style="info" icon="server" %}

#### What you'll build

A complete Pentaho 11 installation from the archive: the machine prepared with the `pentaho` user, Java 21 and PostgreSQL 17; the Pentaho Server unpacked, connected to its Jackrabbit, Quartz and Hibernate repository databases, started and licensed; Analyzer, Interactive Reporting, Dashboard Designer, Pipeline Designer and Semantic Model Editor added from the Plugin Manager; the design tools and EE Kettle plugins installed on the client side; and the server hardened and patched to service pack 11.0.0.3-312.
{% endhint %}

<figure><img src="https://4232202144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeIhSpTGdExnuti9odGI%2Fuploads%2Ftl6N1DMwybIIWxh68x7d%2Finstallation-what-you-build.svg?alt=media" alt="The finished installation: an Ubuntu 24.04 LTS server with the pentaho user and Java 21 runs the licensed Pentaho Server 11 on Tomcat 10, patched to 11.0.0.3-312 and hardened, with the User Console on 8080, HTTPS on 8443 and its plugins; its repository is in PostgreSQL 17 (jackrabbit, quartz, hibernate). A designer&#x27;s desktop with Spoon, EE Kettle plugins and four more design tools uses it"><figcaption><p>The end state: the server, its repository and the client desktop</p></figcaption></figure>

***

<h3 align="center">Skills you'll gain</h3>

<table data-view="cards"><thead><tr><th></th><th></th></tr></thead><tbody><tr><td><i class="fa-sparkles" style="color:blue;">:sparkles:</i> <strong>Pentaho 11 overview</strong></td><td>What's new in Pentaho 11 · client tools, Pentaho Server, Carte, Pan and Kitchen · the ports they use · the Enterprise packages from the Pentaho Support Portal</td></tr><tr><td><i class="fa-server" style="color:blue;">:server:</i> <strong>Prepare the server</strong></td><td>Ubuntu 24.04 LTS · the pentaho installation user · Java 21 · PostgreSQL 17 and pgAdmin</td></tr><tr><td><i class="fa-download" style="color:blue;">:download:</i> <strong>Install Pentaho Server</strong></td><td>The archive installation · Jackrabbit, Quartz and Hibernate repository databases · JDBC drivers · context.xml · start-up and licensing</td></tr><tr><td><i class="fa-puzzle-piece" style="color:blue;">:puzzle-piece:</i> <strong>Server plugins</strong></td><td>Plugin Manager · Analyzer, Interactive Reporting and Dashboard Designer · Pipeline Designer · Semantic Model Editor · the Scheduler and Carte</td></tr><tr><td><i class="fa-shield-halved" style="color:blue;">:shield-halved:</i> <strong>Harden and tune</strong></td><td>HTTPS · ports and context path · session timeout · removing the sample data and Home widgets</td></tr><tr><td><i class="fa-box-open" style="color:blue;">:box-open:</i> <strong>Service packs</strong></td><td>Pentaho Upgrade Installer · SP3 to 11.0.0.3-312 · the server and the client tools · putting back the plugins and drivers it removes</td></tr><tr><td><i class="fa-desktop" style="color:blue;">:desktop:</i> <strong>Client tools</strong></td><td>Spoon, Report Designer, Metadata Editor, Schema Workbench and Aggregation Designer · client plugins · EE Kettle plugins</td></tr></tbody></table>

***

<h3 align="center">Course outline</h3>

<p align="center"><i class="fa-file-lines" style="color:green;">:file-lines:</i> reading · <i class="fa-flask" style="color:orange;">:flask:</i> hands-on workshop</p>

{% hint style="info" icon="circle-info" %}
Full lessons unlock once you're enrolled — this is the outline only. Workshop times are the lab guides' own estimates; the three reading pages are estimated from their content.
{% endhint %}

<table data-search="false"><thead><tr><th width="382">Module</th><th width="115" align="center">Reading</th><th width="132" align="center">Workshops</th><th width="100" align="right">Time</th></tr></thead><tbody><tr><td>Getting Started</td><td align="center">1</td><td align="center">—</td><td align="right">~5m</td></tr><tr><td>Overview</td><td align="center">2</td><td align="center">1</td><td align="right">~30m</td></tr><tr><td>Archive Installation</td><td align="center">1</td><td align="center">5</td><td align="right">~3h 55m</td></tr><tr><td>Install Client Tools</td><td align="center">—</td><td align="center">2</td><td align="right">~40m</td></tr><tr><td><strong>Total</strong></td><td align="center"><strong>4</strong></td><td align="center"><strong>8</strong></td><td align="right"><strong>~5h 10m</strong></td></tr></tbody></table>

{% stepper %}
{% step %}

### <i class="fa-rocket" style="color:blue;">:rocket:</i> Getting Started

`1 reading · ~5m`

How to get the most out of this guide. Nothing to pre-install — installing the Pentaho platform is this course.

<details>

<summary>See the full breakdown</summary>

<table data-search="false"><thead><tr><th width="79"></th><th>Lesson</th><th width="90">Time</th></tr></thead><tbody><tr><td><i class="fa-file-lines" style="color:green;">:file-lines:</i></td><td>Before You Start</td><td>~5m</td></tr></tbody></table>

</details>
{% endstep %}

{% step %}

### <i class="fa-sparkles" style="color:blue;">:sparkles:</i> Overview

`2 readings · 1 workshop · ~30m`

What's new in Pentaho 11 — the modern UI, security improvements and deployment changes that frame why the install looks the way it does. Then download the Enterprise packages from the Pentaho Support Portal, and map each component you'll install to its place in the platform.

<figure><img src="https://4232202144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeIhSpTGdExnuti9odGI%2Fuploads%2F1sHDdkvC1v3EdFKWj88v%2Fpdi-client-server.svg?alt=media" alt="Pentaho Data Integration as client and server: Spoon, with its Designer, Scheduler, Repository Browser and DB Explorer, sends .ktr and .kjb files to the Pentaho Server, whose Data Integration topology has an engine, a repository, the Quartz scheduler, security and monitoring and keeps its data in a system database; Pan, Kitchen and Carte run work standalone, without the server"><figcaption><p>Pentaho client / server architecture for data integration</p></figcaption></figure>

<details>

<summary>See the full breakdown</summary>

<table data-search="false"><thead><tr><th width="79"></th><th>Lesson</th><th width="90">Time</th></tr></thead><tbody><tr><td><i class="fa-file-lines" style="color:green;">:file-lines:</i></td><td>What's New</td><td>~10m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Pentaho Support Portal</td><td>~5m</td></tr><tr><td><i class="fa-file-lines" style="color:green;">:file-lines:</i></td><td>Components</td><td>~15m</td></tr></tbody></table>

</details>
{% endstep %}

{% step %}

### <i class="fa-server" style="color:blue;">:server:</i> Archive Installation

`1 reading · 5 workshops · ~3h 55m`

Archive-based deployment on Linux, end to end: prepare the environment, install the Pentaho Server on Tomcat 10 with PostgreSQL, add the server plugins, run the post-install tasks, and apply a service pack.

<figure><img src="https://4232202144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeIhSpTGdExnuti9odGI%2Fuploads%2FlT6Qv9h6jkEEVSdSyklU%2Farchive-installation-module.svg?alt=media" alt="The Archive Installation module: the Overview reading, then five workshops. Prepare Environment (~40m) sets up the pentaho user, Java 21 and PostgreSQL 17; Install Pentaho Server (~1h) unpacks it, creates the repository databases, starts and licenses it; Server Plugins (~45m), Post Installation Tasks (~40m) and Pentaho Upgrade and Patches (~45m) to 11.0.0.3-312 follow, each with its checkpoint"><figcaption><p>The Archive Installation module, workshop by workshop, with the checkpoint for each</p></figcaption></figure>

<figure><img src="https://4232202144-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPeIhSpTGdExnuti9odGI%2Fuploads%2F9StrTHUzXwsh2CFo5lzI%2Farchive-install-flow.svg?alt=media" alt="The archive installation in sixteen stages, each beside the check that shows it worked. Lesson 05 prepares the machine: the pentaho user, the paths, Java 21, PostgreSQL 17, the pentaho role and pg_hba.conf. Lesson 06 unpacks the server, creates and checks the repository databases, starts it, logs in and applies the license; plugins, hardening, the service pack and client tools follow"><figcaption><p>The archive installation, stage by stage, with the check for each</p></figcaption></figure>

<details>

<summary>See the full breakdown</summary>

<table data-search="false"><thead><tr><th width="79"></th><th>Lesson</th><th width="90">Time</th></tr></thead><tbody><tr><td><i class="fa-file-lines" style="color:green;">:file-lines:</i></td><td>Overview</td><td>~5m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Prepare Environment</td><td>~40m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Install Pentaho Server</td><td>~1h</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Server Plugins</td><td>~45m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Post Installation Tasks</td><td>~40m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Pentaho Upgrade &#x26; Patches</td><td>~45m</td></tr></tbody></table>

</details>
{% endstep %}

{% step %}

### <i class="fa-desktop" style="color:blue;">:desktop:</i> Install Client Tools

`2 workshops · ~40m`

Install the Pentaho design tools — Data Integration (Spoon), Report Designer, Metadata Editor, Schema Workbench and Aggregation Designer — and the EE Kettle plugins, so practitioners can connect to and work against the server you deployed.

<details>

<summary>See the full breakdown</summary>

<table data-search="false"><thead><tr><th width="79"></th><th>Lesson</th><th width="90">Time</th></tr></thead><tbody><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Client Plugins</td><td>~25m</td></tr><tr><td><i class="fa-flask" style="color:orange;">:flask:</i></td><td>Enterprise Plugins</td><td>~15m</td></tr></tbody></table>

</details>
{% endstep %}
{% endstepper %}

***

<h3 align="center">Exam &#x26; accreditation</h3>

{% columns %}
{% column %}
{% hint style="info" icon="clipboard-check" %}
**The course exam**

40 questions drawn at random from a pool of 60, covering Pentaho 11 installation, components, ports, prerequisites, post-install tasks, upgrades and client tools. The pass mark is 80%. It's open-book: browse any module or ask the AI assistant while you work. The exam opens once the Lab Guide has checked that your Pentaho Server is installed and its login page answers.
{% endhint %}
{% endcolumn %}

{% column %}
{% hint style="warning" icon="award" %}
**Certification**

This course is the second step on the Certified Solution Architect learning path: DI Developer, then Installation, then the Containers, High Availability and Enterprise Security Speciality courses, leading to the Certified Solution Architect credential.

Pass the exam and you can download your course accreditation — Pentaho Installation. It states your name, the course and the Pentaho version you studied against, and is valid for two years. It counts towards the Certified Solution Architect certification.

The certification itself is closed by a proctored exam — unlike this course exam, which is open-book and not proctored.
{% endhint %}
{% endcolumn %}
{% endcolumns %}

{% hint style="info" icon="user-shield" %}
The proctored exam is described on the [Solution Architect path page](https://academy.pentaho.com/solution-architect-path-sandbox/solution-architect.md).
{% endhint %}

***

<p align="center"><a href="https://academy.pentaho.com/solution-architect-path-sandbox/speciality-courses/containers.md" class="button primary" data-icon="arrow-right">Next: Containers</a></p>

<p align="center"><a href="https://academy.pentaho.com/solution-architect-path-sandbox/solution-architect.md" class="button secondary" data-icon="arrow-left">Back to the Solution Architect path</a></p>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://academy.pentaho.com/solution-architect-path-sandbox/solution-architect/installation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
