# Utilitário de Suporte Pentaho

{% hint style="info" %}
A Pentaho Support Utility 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 base necessárias para diagnosticar e resolver seu problema, reduzindo pedidos de arquivos adicionais e minimizando o tempo que você gasta reunindo dados.

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

Três ferramentas estão disponíveis para executar a utilidade:

**Plugin do Servidor Pentaho**: fornece uma interface dentro do Servidor Pentaho para coletar informações da instância do servidor em execução no momento. 

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

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

Os plugins do servidor e do PDI são os métodos preferidos para executar a utilidade. Use a ferramenta de linha de comando somente quando o Pentaho não conseguir iniciar ou quando as políticas organizacionais proíbem a instalação de plugins.

Se algum coletor individual falhar durante a execução, os coletores restantes continuarão a ser executados e o relatório resultante ainda fornecerá valor à equipe de suporte. Você pode identificar coletores que falharam revisando os logs da utilidade ou verificando por arquivos .failed dentro do zip de saída.

Alguns arquivos coletados e detalhes de configuração podem conter senhas. Embora a utilidade 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. Faça o download da Pentaho Support Utility.

{% 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" %}
{% hint style="info" %}

{% endhint %}

**Para instalar o Plugin do Servidor Pentaho:**

1. Download: `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 senhas](https://support.pentaho.com/hc/en-us/articles/360021624372-How-to-Install-and-Use-Pentaho-Support-Utility#PRCF).
{% endhint %}

3. Reinicie o Servidor Pentaho.

```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: 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/suporte-ao-pentaho/suporte-ao-pentaho/utilitario-de-suporte-pentaho.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.