> 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/suporte-pentaho/pentaho-support/pentaho-support-utility.md).

# Utilitário de Suporte Pentaho

{% hint style="info" %}
O Utilitário de Suporte do Pentaho coleta detalhes do ambiente e da configuração em um único arquivo zip que você pode anexar ao seu chamado de suporte. Isso dá à equipe de suporte acesso imediato às informações de contexto de que ela precisa para diagnosticar e resolver seu problema, reduzindo solicitações de ida e volta por arquivos adicionais e minimizando o tempo que você gasta reunindo dados.

O utilitário é compatível com as versões 7.x, 8.x, 9.x e 10.x do Pentaho. Para ver uma lista completa do software e hardware compatíveis, consulte a Referência de Componentes na Documentação do Pentaho.

Há três ferramentas disponíveis para executar o utilitário:

**Plugin do Pentaho Server**: fornece uma interface de usuário no Pentaho Server para coletar informações da instância do servidor em execução no momento.

**Plugin do Pentaho Data Integration**: opera no Spoon para coletar detalhes do seu ambiente PDI.

**Utilitário de Linha de Comando**: oferece uma opção independente para coletar informações do Pentaho Server ou do PDI sem exigir um aplicativo em execução.

Os plugins do servidor e do PDI são os métodos preferenciais para executar o utilitário. Use a ferramenta de linha de comando apenas quando o Pentaho não conseguir iniciar ou quando as políticas da organização proibirem a instalação de plugins.

Se qualquer coletor individual falhar durante a execução, os coletores restantes continuarão sendo executados e o relatório resultante ainda será útil para a equipe de suporte. Você pode identificar coletores com falha revisando os logs do utilitário ou verificando a presença de arquivos .failed no zip de saída.

Alguns arquivos coletados e detalhes de configuração podem conter senhas. Embora o utilitário tente remover todas as senhas durante a coleta, o Pentaho não pode garantir a remoção completa em todos os casos - particularmente para arquivos como kettle.properties.
{% endhint %}

1. Baixe o Utilitário de Suporte do Pentaho.

{% embed url="<https://hcpanywhere.hitachivantara.com/userportal/?v=4.6.1#/shared/public/8eUdzjLlHa7j5R3R/245ce549-c03a-4ee7-adae-d5ea655af8ad>" %}

<figure><img src="/files/f44ccba3b43e55a5cce576a803065370e4f125ed" alt=""><figcaption><p>Utilitários de Suporte</p></figcaption></figure>

2. Selecione o produto Pentaho:

{% tabs %}
{% tab title="Servidor Pentaho" %}
**Para instalar o Plugin do Pentaho Server:**

1. Baixe: `pentaho-support-utility-server-plugin.zip` arquivo.
2. Descompacte este arquivo em: `pentaho-server/pentaho-solutions/system`.

```bash
cd
cd ~/Downloads/'Support Utility'/
unzip pentaho-support-utility-server-plugin-1.0.1.zip -d /opt/pentaho/server/pentaho-server/pentaho-solutions/system
```

{% hint style="info" %}
Se necessário, configure a [expressão regular de remoção de senha](https://support.pentaho.com/hc/en-us/articles/360021624372-How-to-Install-and-Use-Pentaho-Support-Utility#PRCF).
{% endhint %}

3. Reinicie o Pentaho Server.

```sh
cd
cd /opt/pentaho/server/pentaho-server
./stop-pentaho.sh
```

```sh
cd
cd /opt/pentaho/server/pentaho-server
./start-pentaho.sh
```

{% endtab %}
{% endtabs %}


---

# 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/suporte-pentaho/pentaho-support/pentaho-support-utility.md?ask=<question>&goal=<endgoal>
```

`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.