# Instalar Ferramentas do Cliente

{% hint style="info" %}

#### **Ferramentas Cliente do Pentaho**

Existem dois métodos para instalar as ferramentas de design do Business Analytics (BA). Você pode usar qualquer um destes métodos:

* Assistente de Avaliação do Pentaho Business Analytics — Desktop Windows
* Instalar cada ferramenta manualmente — Linux / Desktop Windows

O Assistente de Avaliação é a maneira mais fácil de instalar ferramentas de design, utilitários ou plugins em estações de trabalho clientes. A instalação manual permite colocar os arquivos das ferramentas de design onde for necessário. Escolha uma implantação que corresponda às suas restrições de DevOps e de desktop.
{% endhint %}

{% hint style="warning" %}
Base: Ubuntu 24.04 LTS com Java 21 (OpenJDK). Para Windows, veja: [Instalação no Windows](/pentaho-11-installation-en/pentaho-11-installation-pt-br/instalacao/evaluation-installation.md).
{% endhint %}

<figure><img src="/files/0f9ef399a14819e6f79ab5eaeefe9aea2afe8d05" alt="Pentaho Pro Suite - client tools overview"><figcaption><p>Pentaho Pro Suite</p></figcaption></figure>

Os passos a seguir instalam as ferramentas cliente em um Desktop Linux. Os nomes de arquivo ZIP mostrados são exemplos; use suas versões reais.

{% hint style="info" %}
**Descompacte o Pacote de Cliente do Pentaho (ZIP)**

Use `pacote unzip` para extrair o ZIP do servidor para o diretório runtime. Isso evita a necessidade do JDK completo (o JRE não inclui a ferramenta `jar` ).

* `pdi-ee-11.0.0.0-237.zip` - Pentaho Data Integration

* `pad-ee-11.0.0.0-237.zip`   - Pentaho Aggregation Designer

* `psw-ee-11.0.0.0-237.zip`   - Pentaho Schema Workbench

* `pme-ee-11.0.0.0-237.zip`   - Pentaho Metadata Editor

* `prd-ee-11.0.0.0-237.zip`   - Pentaho Report Designer
  {% endhint %}

* Garanta que `pacote unzip` está instalado:

```bash
sudo apt update -y && sudo apt install -y unzip
```

1. Crie o diretório base do Pentaho: \~`/Pentaho/design-tools`.

```bash
cd
mkdir -p ~/Pentaho/design-tools
```

<pre><code>~/Pentaho/design-tools
├── design-tools             
    └── data-integration  
    └── metadata-editor   
<strong>    └── schema-workbench      
</strong></code></pre>

{% tabs %}
{% tab title="1. Data Integration" %}
{% hint style="info" %}

#### **Pentaho Data Integration (PDI)**

Pentaho Data Integration (PDI) fornece capacidades de ETL para capturar, limpar e transformar dados.
{% endhint %}

1. Localize `pdi-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'PDI (Spoon)'
```

3. Extraia `pdi-ee-11.0.0.0-237.zip`

```bash
cd
cd ~/Pentaho/design-tools

# Substitua <version> pelo nome exato do arquivo que você baixou.
unzip ~/Downloads/'Client Tools'/'PDI (Spoon)'/pdi-ee-11.0.0.0-2xx.zip
# Pode ser necessário ajustar o caminho.
```

4. Torne `.sh` arquivos executáveis.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

5. Verifique a estrutura:

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
  {% endhint %}

***

{% hint style="warning" %}
**Observações sobre a interface do Ubuntu 24.04 desktop**

Alguns componentes legados da interface em Spoon podem exigir bibliotecas GTK/WebKit que variam conforme a flavor de desktop. No Ubuntu 24.04, se o Spoon relatar módulos GTK/WebKit ausentes, siga as instruções: [Módulos GTK/WebKit ausentes](#missing-gtk-webkit-modules)
{% endhint %}

6. Inicie o PDI (Spoon):

```bash
cd
cd ~/Pentaho/design-tools/data-integration
./spoon.sh
```

<figure><img src="/files/c575aafa49b61e520ddacf9128bc07b3320e814f" alt=""><figcaption><p>Interface do Spoon</p></figcaption></figure>
{% endtab %}

{% tab title="2. Metadata Editor" %}
{% hint style="info" %}

#### **Pentaho Metadata Editor (PME)**

Pentaho Metadata Editor cria e gerencia modelos semânticos amigáveis ao negócio.
{% endhint %}

1. Localize `pme-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'Metadata Editor'
```

2. Extraia `pme-ee-11.0.0.0-237.zip`.

```bash
cd
cd ~/Pentaho/design-tools

# Substitua <version> pelo nome exato do arquivo que você baixou.
unzip ~/Downloads/'Client Tools'/'Metadata Editor'/pme-ee-11.0.0.0-2xx.zip
# Pode ser necessário ajustar o caminho.
```

3. Torne `.sh` arquivos executáveis.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

4. Verifique a estrutura:

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
  {% endhint %}

5. Inicie o PME:

```bash
cd
cd ~/Pentaho/design-tools/metadata-editor
./metadata-editor.sh
```

<figure><img src="/files/91904d2e9f91816d55f6d2785bac9e879416031f" alt="Pentaho Metadata Editor UI"><figcaption><p>Pentaho Metadata Editor</p></figcaption></figure>
{% endtab %}

{% tab title="3. Schema Workbench" %}
{% hint style="info" %}

#### **Schema Workbench (PSW)**

Schema Workbench é usado para criar e testar esquemas de cubos OLAP Mondrian.
{% endhint %}

1. Localize `psw-ee-11.0.0.0-237.zip`.

```bash
ls -1 ~/Downloads/'Client Tools'/'Schema Workbench'
```

2. Extraia `psw-ee-11.0.0.0-237.zip`.

```bash
cd
cd ~/Pentaho/design-tools

# Substitua <version> pelo nome exato do arquivo que você baixou.
unzip ~/Downloads/'Client Tools'/'Schema Workbench'/psw-ee-10.2.0.0-2xx.zip
# Pode ser necessário ajustar o caminho.
```

2. Torne `.sh` arquivos executáveis.

```bash
cd
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

3. Verifique a estrutura:

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
* schema-workbench
  {% endhint %}

4. Inicie o PSW:

```bash
cd
cd ~/Pentaho/design-tools/schema-workbench
./workbench.sh
```

<figure><img src="/files/00a908dc8a6d8c1ebe583d98515e7c94346a9009" alt="Pentaho Schema Workbench UI"><figcaption><p>Schema Workbench</p></figcaption></figure>
{% endtab %}

{% tab title="4. Aggregation Designer" %}
{% hint style="info" %}

#### **Aggregation Designer (PAD)**

Aggregation Designer recomenda e constrói tabelas agregadas para otimizar consultas do Analyzer.
{% endhint %}

1. Extraia `pad-ee-*.zip`.

```bash
cd ~/Pentaho/design-tools
unzip ~/Downloads/'Client Tools'/'Aggregation Designer'/pad-ee-10.2.0.0-222.zip
```

2. Torne `.sh` arquivos executáveis.

```bash
cd ~/Pentaho/design-tools
find . -iname "*.sh" -exec chmod +x {} \;
```

3. Verifique a estrutura:

{% hint style="info" %}
\~/Pentaho/design-tools/

* data-integration
* jdbc-distribution
* license-installer
* metadata-editor
* schema-workbench
* aggregation-designer
  {% endhint %}

4. Inicie o PAD:

```bash
cd ~/Pentaho/design-tools/aggregation-designer
./startaggregationdesigner.sh
```

<figure><img src="/files/e76d6369cff5788bb2efd056ad24152b99119ec3" alt="Pentaho Aggregation Designer UI"><figcaption><p>Aggregation Designer</p></figcaption></figure>
{% endtab %}
{% endtabs %}

<details>

<summary>Solução geral de problemas (clique para expandir)</summary>

* Spoon não inicia ou exibe erros de GTK/WebKit:
  * Instale as bibliotecas GTK/WebKit (veja a nota abaixo) e tente novamente.
  * Inicie com flags adicionais SWT/GTK se necessário, ou teste em uma flavor de desktop diferente.
* Problemas de fontes/renderização da interface em telas HiDPI:
  * Tente `GDK_SCALE=2 ./spoon.sh` ou ajuste o escalonamento do seu desktop.
* Drivers JDBC ausentes nos clientes:
  * Copie os JARs de driver necessários para as pastas específicas da ferramenta (veja os locais dos drivers na página do Servidor) e reinicie a ferramenta.
* Solicitações de licença ou recurso desabilitado:
  * Certifique-se de que o License Manager tenha ativado as autorizações do cliente; verifique `PENTAHO_LICENSE_INFORMATION_PATH` se necessário.
* Inicialização lenta ou erros de falta de memória:
  * Aumente `-Xms`/`-Xmx` no `*.ini` ou no script de inicialização.

</details>

<details>

<summary>Módulos GTK/WebKit ausentes</summary>

Você precisará adicionar uma versão da release Jammy anterior:

1. Adicione o repositório de pacotes.

```bash
sudo apt-get install -qq software-properties-common
```

2. Adicione a entrada do repositório.

```bash
sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 3B4FE6ACC0B21F32
sudo add-apt-repository 'deb [trusted=yes] http://cz.archive.ubuntu.com/ubuntu bionic main universe'
```

3. Atualize os repositórios.

```bash
sudo apt-get update
```

5. Instale o pacote.

```bash
sudo apt-get install -qq libwebkitgtk-1.0-0
```

```bash
sudo apt-get install libcanberra-gtk-module
```

6. Inicie o PDI.

```bash
cd
cd ~/Pentaho/design-tools/data-integration
./spoon.sh
```

</details>

***


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://academy.pentaho.com/pentaho-11-installation-en/pentaho-11-installation-pt-br/instalacao/archive-installation/install-client-tools.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.