> 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/pentaho-11-installation-en/pentaho-11-installation-pt-br/instalacao/archive-installation/install-client-tools.md). # Instalar ferramentas cliente {% hint style="info" %} #### **Ferramentas Cliente do Pentaho** Há 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 — Área de Trabalho do Windows * Instalar cada ferramenta manualmente — Linux / Área de Trabalho do 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 da ferramenta 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 do Windows](/pentaho-11-installation-en/pentaho-11-installation-pt-br/instalacao/evaluation-installation.md). {% endhint %}
Pentaho Pro Suite - client tools overview

Pentaho Pro Suite

As etapas a seguir instalam as ferramentas cliente em um desktop Linux. Os nomes dos arquivos ZIP mostrados são exemplos; use suas versões reais. {% hint style="info" %} **Descompacte o Pacote do Cliente Pentaho (ZIP)** Use `pacote unzip` para extrair o ZIP do servidor para o diretório de execução. Isso evita a necessidade da JDK completa (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 %} * Certifique-se de 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 ``` 
~/Pentaho/design-tools
├── design-tools             
    └── data-integration  
    └── metadata-editor   
    └── schema-workbench
{% tabs %} {% tab title="1. Integração de Dados" %} {% hint style="info" %} #### **Pentaho Data Integration (PDI)** O Pentaho Data Integration (PDI) fornece recursos 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 pelo nome exato do arquivo que você baixou. unzip ~/Downloads/'Client Tools'/'PDI (Spoon)'/pdi-ee-11.0.0.0-2xx.zip # Talvez seja necessário ajustar o caminho. ``` 4. Fazer `.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" %} **Notas da interface do desktop do Ubuntu 24.04** Alguns componentes legados da interface no Spoon podem exigir bibliotecas GTK/WebKit que variam conforme a distribuição do 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 ```

Interface do Spoon

{% endtab %} {% tab title="2. Editor de Metadados" %} {% hint style="info" %} #### **Pentaho Metadata Editor (PME)** O Pentaho Metadata Editor cria e gerencia modelos semânticos voltados para o 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 pelo nome exato do arquivo que você baixou. unzip ~/Downloads/'Client Tools'/'Metadata Editor'/pme-ee-11.0.0.0-2xx.zip # Talvez seja necessário ajustar o caminho. ``` 3. Fazer `.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 ```
Pentaho Metadata Editor UI

Pentaho Metadata Editor

{% endtab %} {% tab title="3. Schema Workbench" %} {% hint style="info" %} #### **Schema Workbench (PSW)** O Schema Workbench é usado para criar e testar esquemas de cubo OLAP do 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 pelo nome exato do arquivo que você baixou. unzip ~/Downloads/'Client Tools'/'Schema Workbench'/psw-ee-10.2.0.0-2xx.zip # Talvez seja necessário ajustar o caminho. ``` 2. Fazer `.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 ```
Pentaho Schema Workbench UI

Schema Workbench

{% endtab %} {% tab title="4. Designer de Agregação" %} {% hint style="info" %} #### **Aggregation Designer (PAD)** O Aggregation Designer recomenda e cria tabelas agregadas para otimizar as 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. Fazer `.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 ```
Pentaho Aggregation Designer UI

Aggregation Designer

{% endtab %} {% endtabs %}
Solução de problemas geral (clique para expandir) * O Spoon não inicia ou mostra erros de GTK/WebKit: * Instale as bibliotecas GTK/WebKit (veja a observação abaixo) e tente novamente. * Inicie com sinalizadores SWT/GTK adicionais, se necessário, ou teste em outra distribuição de desktop. * Problemas de fontes/renderização da interface em telas HiDPI: * Tente `GDK_SCALE=2 ./spoon.sh` ou ajuste a escala do seu desktop. * Drivers JDBC ausentes nos clientes: * Copie os JARs de driver necessários para as pastas específicas da ferramenta (consulte os locais dos drivers na página do servidor) e reinicie a ferramenta. * Solicitações de licença ou recurso desativado: * Certifique-se de que o License Manager tenha ativado os direitos 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.
Módulos GTK/WebKit ausentes 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 ```
*** --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://academy.pentaho.com/pentaho-11-installation-en/pentaho-11-installation-pt-br/instalacao/archive-installation/install-client-tools.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.